HSM - Hardware Secure Module

O objetivo do pacote é prover de forma segura, consistente e escalável uma camada de comunicação entre as aplicações que utilizam a tecnologia NodeJS e o hardware criptográfico HSM Dinamo fabricado pela Dinamo Networks. Esta camada provê funções criptográficas primitivas (assinatura, criptografia) e também funções dos módulos especialistas do HSM: blockchain, assinatura de XML para NFe (Nota Fiscal eletrônica), SPB (Sistema Brasileiro de Pagamentos) e EFT (Eletronic Funds Transfer).

APIs

Os detalhes das APIs do pacote estão disponíveis na Documentação da API Javascript.

Instalação

npm i @dinamonetworks/hsm-dinamo

Para as APIs que operam funções com smart cards é necessária a instalação completa do software do HSM com a opção de Remote, além de uma leitora USB certificada e cartões compatíveis.

Configuração

As informações sobre configuração de log estão disponíveis na Página de Setup da Documentação.

Utilização

// Importa o cliente Dinamo HSM
const { hsm } = require("@dinamonetworks/hsm-dinamo");

// Define os parâmetros de conexão com o HSM
const options = {
  host: "127.0.0.1",
  authUsernamePassword: {
    username: "master",
    password: "12345678",
  },
};

// Você também pode se conectar usando variáveis de ambiente
// HSM_HOST - Host do HSM
// HSM_PORT - Porta do HSM
// HSM_USERNAME - Nome de usuário do HSM
// HSM_PASSWORD - Senha do usuário do HSM

async function hsmConnect() {
  // Connecta ao HSM
  const conn = await hsm.connect(options);

  // Conexão estabelecida
  console.log("HSM connected");

  // Desconecta do HSM
  await conn.disconnect();
}

// Execute a função hsmConnect
hsmConnect();

Exemplos

Diversos exemplos utilizando as APIs do pacote podem ser consultados na Página de Exemplos da documentação.

Notas de Lançamento

As informações sobre versões de software estão disponíveis nas Notas de Lançamento.

Documentação do HSM

A documentação técnica completa do HSM (configuração, administração, integração etc) pode ser consultada na Documentação do HSM.