Guia Rápido
-
Instalar o cliente do HSM, de acordo com a sua plataforma
-
Configurar as variáveis de ambiente básicas
- DFENCE_PKCS11_IP: Endereço IP do HSM
- DFENCE_PKCS11_USER: Nome do usuário do HSM
- DFENCE_PKCS11_AUTO_RECONNECT: 1
Para informações adicionais consulte a seção de configuração.
É possível configurar as variáveis de ambiente via Propriedades de Sistema.
Nota
Uma atalho para abrir as Propriedades de Sistema é pressionar as teclas Win + R e em seguida executarsysdm.cpl
.
- Selecionar a aba Avançado e clicar em Variáveis de ambiente.
- Criar as novas variáveis de ambiente do usuário.
É possível configurar as variáveis de ambiente no arquivo de profile do usuário conforme o ambiente específico (ex: ~/.bash_profile
, ~/.profile
, ~/.login
etc) adicionando e fazendo as devidas substituições:
.
.
.
export DFENCE_PKCS11_IP=ip_hsm
export DFENCE_PKCS11_USER=id_usuario_hsm
export DFENCE_PKCS11_AUTO_RECONNECT=1
Integrando com Aplicações
As aplicações que fazem uso de PKCS#11 precisam apenas de duas informações:
- A localização da biblioteca PKCS#11 Dinamo;
- a senha do usuário do HSM configurado na PKCS#11.
A biblioteca PKCS#11 Dinamo é copiada para a máquina durante a instalação do cliente do HSM. O nome do arquivo é tacndp11.dll
.
No windows a biblioteca PKCS#11 estará na subpasta <diretório de instalação>\HSM Dinamo\sdk\c
. Caso tenha utilizado a versão 64-bits do instalador, também estará disponível a versão 32-bits na pasta <diretório de instalação>\HSM Dinamo\sdk\32-bit
.
Exemplos:
-
C:\Program Files\Dinamo Networks\HSM Dinamo\sdk\c\tacndp11.dll
-
C:\Program Files\Dinamo Networks\HSM Dinamo\sdk\32-bit\tacndp11.dll
A biblioteca PKCS#11 Dinamo é copiada para a máquina durante a instalação do cliente do HSM. O nome do arquivo é libtacndp11.so
.
A biblioteca PKCS#11 estará na pasta de bibliotecas do sistema.
Exemplos:
/usr/lib64/libtacndp11.so
/usr/lib/libtacndp11.so