Páginas filhas
  • 3642593 DLOGTMS01-3423 DT Mudança de Certificado Para Comunicação Com Sistema Pamcard

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

MUDANÇA DE CERTIFICADO PARA COMUNICAÇÃO COM SISTEMA PAMCARD


Linha de Produto:

Logix

Segmento:

Supply Chain - Logística

Módulo:

TMS - Gestão de Transportes

Função:

TMS00002 - Contrato de frete

TMS20003 - Painel de contratos de frete

Situação/Requisito:

Conforme modificações internas da Pamcary, a emissão do certificado antigo não está mais sendo efetuada. Para tal, os sistemas que se comunicam com o sistema Pamcard devem se adaptar para utilizar o mesmo certificado utilizado para emissão de documentos junto a SEFAZ (como NFe, CTe, MDFe, entre outros).

Solução/Implementação:

Conversão do arquivo “.PFX” para arquivos “.PEM”

Atualmente o Framework Logix não possui funcionalidade para conversão de arquivos PFX para arquivos PEM. Estamos com uma issue para estudo da possibilidade de desenvolvimento disto, porém, ainda sem previsão , e sem uma certeza se o Framework Logix, ou alguma outra área técnica, irá assumir esta funcionalidade.de liberação oficial. Para resolver o problema pode ser utilizada a ferramente OPENSSL, mencionada a seguir.

Instalação do programa OPENSSL

  • Acesse http://slproweb.com/products/Win32OpenSSL.html e instale a versão de acordo com seu sistema operacional.
  • Após instalado, copie o arquivo “pfx” para a do seu certificado com extensão “pfx”, e cole na pasta “bin” onde o OpenSSL foi instalado.
  • Abra o prompt de comando e acesse esta mesma pasta.
  • Execute os comandos abaixo para gerar:
    • Arquivo com Certificados: "CAMINHO ONDE O OPENSSL FOI INSTALADO">openssl openssl pkcs12 -in "NOME ARQUIVO CERTIFICADO".pfx -out "FILIAL TMS10005".pem -nokeys –cacerts
      Obs: Após gerado o arquivo “.PEM”, mova o último bloco “BEGIN CERTIFICATE” para o topo do arquivo. Esta ordenação dos blocos pode interferir no momento de uso da chave privada, e por consequência, gerar erro.
    • Arquivo com Chave Privada: "CAMINHO ONDE O OPENSSL FOI INSTALADO">openssl openssl pkcs12 -in "NOME ARQUIVO CERTIFICADO".pfx -out "FILIAL TMS10005".pem –nocerts –nodes

Os comandos mencionados acima foram os que funcionaram nos testes internos na Totvs. Porém, como os certificados podem ser gerados de formas diferentes, os comandos para conversão também podem ser outros, conforme mencionamos abaixo.

Observações sobre a geração do arquivo “PEM” para o Certificado:

  • O arquivo “PEM” pode ser gerado somente com o arquivo denominado “Client”, através do comando “-clcerts”.
  • O arquivo “PEM” pode ser gerado somente com o arquivo denominado “CA”, através do comando “-cacerts”.

Observações sobre a geração do arquivo “PEM” para a Chave Privada:

  • O arquivo “PEM” pode ser gerado com a Chave Privada criptografada, através dos comandos “-des” ou “-des3”.
  • O arquivo “PEM” pode ser gerado sem criptografia da Chave Privada, através do comando “-nodes”.
  • O arquivo “PEM” também pode ser gerado no formato RSA. Este é um dos formato, junto ao formato "-nodes", são os formatos atualmente funcionais na comunicação entre os sistemas Totvs e o Pamcard.

Maiores detalhes de comandos para geração dos arquivos "PEM", podem ser consultados em:

Outros comandos para geração dos arquivos “PEM podem ser consultados em
Parâmetro “STARTPATH”
Arquivo appserver.ini/totvsappserver.ini e parâmetro “STARTPATH”

Abra o arquivo “appserver.ini”/"totvsappserver.ini" e procure pela variável “StartPath”. Este será o diretório para onde os arquivos “.pem” deverão ser copiados (tanto do certificado quanto da chave privada).

Aproveitando que o arquivo “appserver.ini” está aberto, inclua o trecho abaixo, para que o sistema armazene os arquivos XML enviados e recebidos, facilitando assim uma análise dos dados que estão transitando entre Logix e Pamcard. A variável “XMLSAVEALL” irá salvar arquivos XML com descrição “snd” (enviados pelo Logix) e “rcv” (retornados pelo Pamcard) na mesma pasta da variável “StartPath”.

[WEBSERVICES]

Enable=1

ENVIRONMENT=AMBIENTE LOGIX ONDE A COMUNICAÇÃO COM O PAMCARD OCORRERÁ

Logix=1

TRACEHOST=1

XMLSAVEALL=1

FWTRACELOG=1 

FWLOGMSG_DEBUG=1 

trace=1 

conout=1 

fwframe_tracelog=1


Após realizados os testes, ou quando for mais conveniente, as variáveis podem ser removidas/comentadas.

TMS10005 - Administradoras de pagamento eletrônico de frete

Neste programa informe a senha do certificado, pois ela será utilizada durante a comunicação com o Pamcard.

Altere também a URL para a nova URL do WebService do Pamcard.

Obs:  Os caminhos dos certificados se tornaram obsoletos neste momento, pois conforme item anterior, eles obrigatoriamente devem ser armazenados no diretório mapeado pela variável “StartPath”. Porém, estes campos serão mantidos sem previsão de remoção.

TMS00002 - Contrato de frete

TMS20003 - Painel de contratos de frete

Estes programas foram adaptados para efetuar a comunicação com o WebService Pamcard, de acordo com a URL determinada no programa TMS10005.

Quando a URL for a antiga, seja para ambiente de Homologação ou Produção, estes programas vão continuar utilizando o certificado emitido pela própria Pamcary, e enviarão o XML seguindo a estrutura antiga.

Quando for a URL nova, seja para ambiente de Homologação ou Produção, estes programas irão utilizar o certificado e chave privada no formato "PEM" (conforme mencionado no começo deste documento), bem como irão seguir a nova estrutura dos arquivos XML.

Tickets relacionados:

3642593

Requisito:DLOGTMS01-3423