Introduction

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

Note

HSM sessions exhibit session-thread affinity, meaning a single session cannot be concurrently utilized by multiple threads.

Installation

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

Supported platforms:

• Linux x64
• Windows x64

Note

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.

1. 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.

2. 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:

1. 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).

Environment Variables

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

Notes

Programming interfaces in different languages available for the HSM:

1. C/C++
2. Java
3. .NET
4. JavaScript

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 .