Quick Guide
-
Install the HSM client according to your platform
-
Setting basic environment variables
- DFENCE_PKCS11_IP: IP address of the HSM
- DFENCE_PKCS11_USER: HSM user name
- DFENCE_PKCS11_AUTO_RECONNECT: 1
For more information, see the configuration section.
You can configure the environment variables via System Properties.
Note
A shortcut to open the System Properties is to press the Win + R and then runsysdm.cpl
.
- Select the Advanced tab and click on Environment variables.
- Create the user's new environment variables.
You can configure the environment variables in the profile according to the specific environment (e.g: ~/.bash_profile
, ~/.profile
, ~/.login
etc) by adding and making the appropriate substitutions:
.
.
.
export DFENCE_PKCS11_IP=ip_hsm
export DFENCE_PKCS11_USER=id_usuario_hsm
export DFENCE_PKCS11_AUTO_RECONNECT=1
Integrating with Applications
Applications that use PKCS#11 only need two pieces of information:
- The location of the PKCS#11 library Dinamo;
- the password of the HSM user configured in PKCS#11.
The PKCS#11 library Dinamo is copied to the machine during the installation of the HSM. The file name is tacndp11.dll
.
In windows the PKCS#11 library will be in the subfolder <diretório de instalação>\HSM Dinamo\sdk\c
. If you have used the 64-bit version of the installer, the 32-bit version will also be available in the folder <diretório de instalação>\HSM Dinamo\sdk\32-bit
.
Examples:
-
C:\Program Files\Dinamo Networks\HSM Dinamo\sdk\c\tacndp11.dll
-
C:\Program Files\Dinamo Networks\HSM Dinamo\sdk\32-bit\tacndp11.dll
The PKCS#11 library Dinamo is copied to the machine during the installation of the HSM. The file name is libtacndp11.so
.
The PKCS#11 library will be in the system libraries folder.
Examples:
/usr/lib64/libtacndp11.so
/usr/lib/libtacndp11.so