01. DADOS GERAIS
Produto: | TOTVS Logística Recintos Aduaneiros
|
---|---|
Linha de Produto: | Linha Logix |
Segmento: | Logística |
Módulo: | Serviço de Integração - Recintos Aduaneiros |
Função: | Serviço de redirecionamento de chamadas à API do PU Siscomex |
Ticket: | |
Requisito/Story/Issue (informe o requisito relacionado) : | DLOGPORTOS-17270 |
02. SITUAÇÃO/REQUISITO
Para a comunicação com a API do Portal Único Siscomex é necessário criar uma conexão criptografada utilizando certificado digital, sendo assim, foi desenvolvido um módulo apache que faz um intercambio entre os módulos do TOTVS Logística Recintos Aduaneiros e o PU Siscomex sem a necessidade de instalar certificado digital em cada terminal de computador que precisa acessar as informações disponibilizadas através dessa API.
03. SOLUÇÃO
A solução, um módulo para o servidor web Apache, deve ser instalado e configurado em servidor da infraestrutura local de rede.
- Sistema operacional Microsoft Windows Server 2012 64bits ou superior;
- 100MB de espaço em disco;
- Apache Server 2.4 para ambientes Windows 64 bits;
- REDIS 5.0.14 ou superior para ambientes Windows 64 bits.
Nota: Tanto o servidor web Apache quanto o servidor de banco de dados REDIS devem ser instalados previamente. Para mais informações sobre como instalar cada um destes requisitos, consulte a seção Demais Informações deste documento.
Para a instalação da solução, basta copiar o módulo mod_tragw.so para o diretório modules do Apache e incluir no arquivo conf\httpd.conf as configurações do módulo, como segue:
LoadModule tragw_module modules/mod_tragw.so
<Location /api/sara/gw/v1>
SetHandler mod_tragw-handler
</Location>
Na pasta "C:\TOTVS\SARA\etc" criar o arquivo "login.xx.conf" onde "xx" será usado como identificador do "ambiente/base sara" a que se destina a instalação, permitindo assim várias instancias na mesma máquina.
Exemplo:
Para ambientes de produção e homologação para Guarulhos o nome para os arquivos ficariam como login.gru_prod.conf e login.gru_homolog.conf respectivamente.
O conteúdo do arquivo conf segue abaixo:
URLBase=https://portalunico.siscomex.gov.br
CRTFilePath=C:\SARA\Services\Config\Cert\cert.pem
KeyFilePath=C:\SARA\Services\Config\Cert\privatekey.pem
RootCertFilePath=C:\SARA\Services\Config\Cert\publiccert.pem
Role-Type=DEPOSIT
issuer=Recintos Aduaneiros
audience=SARA
subject=CCT
Também é necessário criar/configurar parâmetros no SARA com as configurações usadas no arquivo conf acima, como segue:
GATEWAY_AUDIENCE com o mesmo valor de "audience";
GATEWAY_ISSUER com o mesmo valor de "issuer";
GATEWAY_SUBJECT com o mesmo valor de "subject", e;
GATEWAY_HOSTNAME com o endereço configurado para acessar o apache, exemplo: "http://localhost/api/sara/gw/v1/prd".
Após efetuada a configuração dos parâmetros de operação do serviço, basta acessar o gestor de serviços do servidor e comandar a (re)inicialização da instância do servidor Apache.
04. DEMAIS INFORMAÇÕES
Para uma perfeita integração com o sistema TOTVS Recintos Aduaneiros, este deve estar em sua versão 12.1.2311 ou superior.
Sobre o Apache para Windows: https://simplificandoredes.com/instalar-apache-em-windows/
Sobre o REDIS para Windows: https://github.com/tporadowski/redis/releases