Introduction

The Java programming interface exports functionality using JNI (Java Native Interface).

Observation: HSM sessions have session-thread affinity. This means that the same session cannot be used by several threads at the same time.

Installation

Use the package client of HSM Dinamo in Maven Central Repository .

Supported platforms:

Linux x64
Windows x64

Observation: As of version 4.11.0 of the HSM client, the official distribution of the HSM client Dinamo for Java is now from the Maven repository. Migration is necessary. There are no changes to the APIs, only to the distribution method.

Manual installation

For manual installation, use the procedure below.

Download the JNI library from Maven Central Repository by clicking on versions and then browse. The file is named dinamo-hsm-x.y.z.jar where x.y.z is the version.
Copiar a biblioteca JNI java (dinamo-hsm-x.y.z.jar) para a pasta de extensions do Java (<JAVA_HOME>\jre\lib\ext) ou adicionar ao projeto.

For example, with JVM 1.4:
- on Windows: C:\j2sdk1.4.2_11\jre\lib\ext
- on Linux: /usr/java/j2sdk1.4.2_11/jre/lib/ext.

Other platforms

If your operating system is not natively supported, contact your HSM supplier to check availability. If so, the procedure is as follows:

Copy the platform libraries (e.g. tacndlib.dll and tacndjavalib.dll or libtacndlib.so and libtacndjavalib.so) to the system libraries folder (e.g. C:\WINDOWS\system32 or /usr/lib).

Environmental variables

Various aspects of the library's operation can be configured and controlled via environment variables. See the HSM documentation for the topic Environmental variables about the available options and details.

Notes

The programming interfaces in different languages available for the HSM:

Information such as features, initialization, management, integration and more can be found at HSM technical documentation .

For information on software versions, see Release Notes and the Downloads Dinamo Networks .