Api Client Certificado (Fase 01 patch 98176)
Será adicionada uma nova API responsável pela busca e armazenamento dos certificados.
Essa API será publicada em um novo site no IIS, utilizando a porta 8120.
A publicação será realizada automaticamente após a aplicação do patch de atualização.
O banco de dados de certificados permanecerá o mesmo, sendo criada apenas uma nova tabela chamada CERTIFICADOEMPRESA.
Além disso, serão adicionadas duas novas colunas na tabela CERTIFICADO:
•NUMEROSERIE
•DATAALTERACAO
A atualização das tabelas será executada automaticamente durante a aplicação do patch.
Pré-requisitos para o correto funcionamento da API
É necessário que os seguintes componentes estejam instalados no servidor:
Ajustes manuais após a instalação da atualização
Após a instalação, será necessário ajustar o arquivo appsettings.json com as seguintes informações no seguinte diretório: C:\inetpub\wwwroot\eForms\Webs\ApiClientCertificado
1. Configuração do Provider
"DataBaseProvider": ""
•Para SQL Server: não é necessário alterar o valor.
•Para Oracle e Informix: é obrigatório ajustar o nome do banco conforme o ambiente.
2. Ajuste da ConnectionString do Banco de Certificados
O preenchimento será manual, seguindo os modelos abaixo:
SQL Server
Password=P@ssw0rd;Data Source=localhost;Initial Catalog=NDD_CERTIFICADOS;User ID=sa;connection timeout=150;
Oracle
User Id=NDD_CERTIFICADOS;Password= NDD_CERTIFICADOS;Data Source=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=xe)));
Informix
Database=ndd2;Host=localhost;Server=ol_informix1410;Service=9090;Protocol=onsoctcp;User ID=informix;Password=P@ssw0rd;Connection Timeout=60;
Configuração no Settings (Aplicação)
Na aba de Configurações Gerais > Certificado, será necessário ajustar a URL da API:
http://localhost:8120
Informação Importante
O fluxo de atualização via Settings, via emonitor e o uso do certificado pelo mmc continuam funcionando da mesma forma.
Para ambientes que utilizam Informix, é necessário instalar o Client SDK na versão 4.50, garantindo a comunicação correta entre a API e o banco de dados.
Api Client Certificado (Fase 02 patch 99000)
Para realizar a fase 2, é necessário seguir os passos abaixo para atualização da API Cliente Certificado:
1. Pré-requisitos
Certifique-se de que os seguintes componentes estejam instalados no servidor:
2. Ajuste da ConnectionString do Banco de Certificados
Para esta versão da API Client Certificado, será necessário adicionar o parâmetro TrustServerCertificate=True na ConnectionString utilizada para conexão com o SQL Server.
Exemplo de ConnectionString:
Password=P@ssw0rd;Data Source=localhost;Initial Catalog=NDD_CERTIFICADOS;User ID=sa;Connection Timeout=150;TrustServerCertificate=True
3. Após realizar a atualização, é necessário executar a ferramenta Ferramenta_Migracao_AlfaNumerico_Certificado para ajustar as informações no banco de dados do Certificado.
Essa ferramenta foi criada para migrar os dados de CNPJ para as novas colunas referentes ao banco do certificado. As colunas que devem ser populadas são:
CNPJSTR
CNPJBASE
CNPJORDEM
CNPJDV
CNPJEMPRESASTR
CNPJEMPRESABASE
CNPJEMPRESAORDEM
CNPJEMPRESADV
Download da ferramenta:
Ferramenta_Migracao_AlfaNumerico_Certificado
4. Ajustes necessários
Abra o arquivo appsettings. Nele haverá as seguintes configurações:
{
"ConnectionStringBancoNDDCertificadoSql": null,
"ConnectionStringBancoNDDCertificadoOracle": "User Id=NDD_CERTIFICADOS;Password=NDD_CERTIFICADOS;Data Source=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=xe)));",
"TipoBanco": 1, // 0 = SQL; 1 = Oracle
"EnderecoRedis": "localhost:6379,connectTimeout=30000,abortConnect=False,connectRetry=5",
"HoraInicialExecucaoSchedulador": 10,
"MinutoInicialExecucaoSchedulador": 7,
"HoraFinalExecucaoSchedulador": 10,
"MinutoFinalExecucaoSchedulador": 8,
"QuantidadeLoteProcessadoPorCiclo": 1000
}
Pontos que precisam ser ajustados
ConnectionString para SQL Server
Caso o banco seja SQL Server, utilize o seguinte modelo de string de conexão:
Data Source=BR-COTH-SPCDBL2.cloudndd.local;Initial Catalog=CentralFront_SPC01;Persist Security Info=True;Integrated Security=SSPI;Trusted_Connection=yes;MultipleActiveResultSets=true
ConnectionString para Oracle
Caso o banco seja Oracle, utilize esta string de conexão:
User Id=NDD_CERTIFICADOS;Password=NDD_CERTIFICADOS;Data Source=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=xe)));
Configurações de horário do agendador
Os campos não devem conter zeros à esquerda.
"HoraInicialExecucaoSchedulador": 10 → Hora em que a ferramenta deve iniciar
"MinutoInicialExecucaoSchedulador": 7 → Minuto em que a ferramenta deve iniciar
"HoraFinalExecucaoSchedulador": 10 → Hora em que a ferramenta deve finalizar
"MinutoFinalExecucaoSchedulador": 8 → Minuto em que a ferramenta deve finalizar
Execução
Após realizar todos os ajustes de configuração, execute o seguinte executavel que esta na pasta da ferramenta:
NDD.Atualizacao.Cnpj.Alfanumerico.NDDCertificado.Host
o Log de execução da ferramenta esta configurado para o seguinte diretorio:
C:\NDDTemp\Logs\FerramentaAtualizacaoAlfanumericoNDDCertificado