Foi desenvolvido o programa Parâmetros para Consumo das APIs do Governo que permite parametrizar os parâmetros que serão utilizados para o consumo das APIs governamentais. (html.mcd.govApiParams) - Parâmetros para Consumo das APIs do Governo: 
A empresa é um campo não editável, que traz automaticamente o valor da empresa logada no sistema. Os campos apresentam em suas descrições internas os formatos de extensão que devem ser preenchidos ao final de cada informação (Ex: chavecertificado.pem). Caso não sejam fornecidas essas extensões, o programa irá preenchê-las automaticamente. Detalhamento dos campos Tipo Certificado: Este campo indica qual o tipo de certificado digital será utilizado. Se é PEM, um formato que utiliza de um arquivo chave para o certificado ou se é PFX, um outro formato de certificado digital que funciona com uma senha. Caminho cURL: Este campo é o caminho completo até o arquivo executável do cURL, componente que realiza as requisições para as APIs do portal da Conformidade Fácil. Esse campo deve ser obrigatoriamente preenchido quando o sistema operacional do servidor RPW for Windows. O motivo é que o cURL padrão do Windows não possui suporte ao uso de SSL nas requisições, o que é necessário para trabalhar com certificados digitais. O arquivo executável do cURL deve poder ser acessado a partir do servidor RPW de escolha para execução do programa. Para verificar se o seu cURL possui suporte ao SSL, basta digitar o seguinte comando na linha de comando: curl --version. O resultado deve ser semelhante a imagem abaixo: 
Para realizar a instalação de uma versão do cURL que possua suporte a SSL acesse: https://curl.se/windows/. O campo deve conter o caminho completo até a instalação do cURL. Exemplo: C:\ProgramData\chocolatey\bin\curl.exe. Para descobrir o caminho de instalação do seu cURL no Windows, basta digitar o seguinte comando na linha de comando: where curl. O resultado deve ser semelhante a imagem abaixo: 
Caminho Arquivo Certificado: Este campo deve conter o caminho completo até o arquivo do certificado digital que será utilizado, independente do seu tipo. Esse arquivo deve estar em um diretório que possa ser acessado a partir do servidor RPW. Exemplo: C:\Users\testes\certificado_digital.pfx ou C:\Users\testes\certificado_digital.pem. Chave Certificado: Este campo deve conter o caminho completo até o arquivo de chave do seu certificado digital do tipo .pem. Caso seu tipo de certificado seja .pfx, o preenchimento desse campo não é necessário. Esse arquivo deve estar em um diretório que possa ser acessado a partir do servidor RPW. Exemplo: C:\Users\testes\certificado_digital.key. Senha Certificado: Este campo deve conter a senha do seu certificado digital do tipo .pfx. Caso seu tipo de certificado seja .pem, o preenchimento desse campo não é necessário. Esse arquivo deve estar em um diretório que possa ser acessado a partir do servidor RPW.
Para realizar as requisições e receber o retorno correto da API do portal da Conformidade Fácil, é necessário que os certificados digitais inseridos nesta tela de parâmetros estejam válidos. |
Para maiores informações sobre o funcionamento da API, veja o documento de referência do programa: consumoApiGov - Consumo das APIs do portal da Conformidade Fácil | 