Introdução

O objetivo do assembly .NET é prover de forma segura, consistente e escalável uma camada de comunicação entre as aplicações que utilizam a tecnologia .NET e o hardware criptográfico HSM Dinamo. Essa camada provê funções equivalentes à API C++ onde se permite o acesso tanto à funções criptográficas primitivas (assinatura ou criptografia), como a funções nos módulos do HSM como assinatura de NFe - Nota Fiscal eletrônica, módulo de comunicação SPB - Sistema Brasileiro de Pagamentos e o módulo EFT - Eletronic Funds Transfer.

Observação: As sessões do HSM possuem afinidade sessão-thread. O que significa que a mesma sessão não pode ser utilizada em várias threads ao mesmo tempo.

As chamadas da API .NET são encaminhadas à biblioteca nativa do HSM.

--- title: Arquitetura API .NET --- flowchart TD A(Applicação .NET) B(Assembly
Dinamo .NET) C(tacndlib.dll) A <---> B <---> C

Atenção: É um pré-requisito da execução do assembly .NET existir a DLL tacndlib.dll no path do sistema. O instalador coloca essa DLL no windows na pasta \Windows\System32. Apenas essa dependência é necessária, sendo possível elaborar um script de forma a levar essa DLL e o sistema executar sem a necessidade de instalação completa do pacote MSI - HSM Client.

Também é possível baixar ou instalar diretamente um pacote HSM Dinamo NuGet.

As interfaces de programação em diferentes linguagens disponíveis para o HSM:

Informações como características, inicialização, gerenciamento, integração e outras podem ser encontradas na documentação técnica do HSM.