TOTVS Logística Recintos Aduaneiros

Árvore de páginas


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.

  1. Sistema operacional Microsoft Windows Server 2012 64bits ou superior;
  2. 100MB de espaço em disco;
  3. Apache Server 2.4 para ambientes Windows 64 bits;
  4. 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