Histórico da Página

CONTEÚDO

1. Visão Geral
2. Exemplo de utilização
3. Tela XXX
   1. Outras Ações / Ações relacionadas
      
4. Tela XXX
   1. Principais Campos e Parâmetros
      
5. Pré-requisitos
6. Configuração do HSM Dinamo
   
7. Configuração dos parâmetros na Wizard TSS no módulo de Faturamento Protheus
   
8. DocumentaçõesTabelas utilizadas

01. VISÃO GERAL

Âncora
geral geral

02. EXEMPLO DE UTILIZAÇÃO

03. TELA XXXXX

Outras Ações / Ações relacionadas

...

04. TELA XXXXX

Principais Campos e Parâmetros

Este documento tem como finalidade orientar a configuração do certificado digital no TSS utilizando o módulo de segurança criptográfica HSM Dinamo através da wizard de configuração do módulo SIGAFAT (Faturamento) do Protheus.

Os documentos homologados para este certificado são:

• NF-e
• NFC-e
• NFS-e
• MDF-e
• MD-e
• GNRE
• CT-e
• CT-e OS
• E-Social
• REINF

02. PRÉ-REQUISITOS

Âncora
requisitos requisitos

1 - Modulo de Segurança Dinamo. versão: v4.2.3

2 - Totvs Appserver (TSS e Protheus). versão: 19.3.1.1

3 - RPO com os fontes D-1 (TSS e Protheus) referentes a 15/12/2020, versão da lib: 20201123, data da Lib: 20201106_171455

03. CONFIGURAÇÃO DO HSM DINAMO

Âncora
configuracao configuracao

O Download do Dinamo HSM (client) pode ser realizado diretamente do site do fabricante no seguinte endereço: https://docs.dinamonetworks.com/soft_client/downloads

A configuração do Dinamo deve ser solicitada à equipe de suporte da certificadora pois necessita do apontamento do servidor e de credenciais para acesso:

Image Added

Após a configuração é necessário a criação das variáveis de ambiente para utilização da biblioteca PKCS#11, a documentação das variáveis podem ser consultadas em https://docs.dinamonetworks.com/integration/pkcs11/configuration. 

Variáveis utilizadas na homologação:

Image Added

Obs: DFENCE_PKCS11_IP e DFENCE_PKCS11_USER são os mesmos valores utilizados na configuração do client (IP e usuário respectivamente).

04. CONFIGURAÇÃO DOS PARÂMETROS NA WIZARD TSS NO MÓDULO DE FATURAMENTO DO PROTHEUS

Âncora
wizard wizard

A configuração do certificado HSM Dinamo é realizado através da Wizard de Configuração do TSS, para mais informações acesse: https://tdn.totvs.com/x/U4g_Aw

Na etapa de configuração de certificado utilizar os seguintes parâmetros:

Em tipo de certificado selecione HSM

Inserir a Label e a senha do certificado, o usuário é cadastrado nas variáveis de ambiente conforme especificado acima.

Em caminho e arquivo do módulo HSM selecione a dll referente a biblioteca PKCS#11 (tacndp11.dll), exemplo: C:\Program Files\Dinamo Networks\HSM Dinamo\sdk\c\tacndp11.dll

Image Added

Após avançar é exibido uma mensagem informando os dados do certificado.

Image Added

No rootpath do TSS é criado uma pasta chamada HSM, na mesma será incluído o certificado em arquivo .pem com o código da entidade:

Image Added

No arquivo appserver.ini do TSS são adicionados as chaves MODULE, CertificateClient e KeyClient na seção SSLConfigure:

Image Added

05. DOCUMENTAÇÕES

Âncora
documentacoes documentacoes

PKCS11 Instalação: https://docs.dinamonetworks.com/integration/pkcs11/instalation

Module TOTVS TEC: https://tdn.totvs.com/x/6opc

CertificateClient: https://tdn.totvs.com/x/5Ipc

KeyClient: https://tdn.totvs.com/x/6Ipc

HsmGetCertFile: https://tdn.totvs.com/x/U7dICw

Wizard de Configuração TSS: https://tdn.totvs.com/x/AuTzEQ

...

...

<!-- esconder o menu --> 


<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: nonesidebar;
}
#main {
    padding-left: 10px43px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !importantvisible;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>