Introduction

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

--- title: Arquitetura API Java --- flowchart TD A(Applicação Java) B(Biblioteca
Dinamo Java) C(Biblioteca
Dinamo JNI) D(tacndlib.dll /
libtacndlib.so) A <--> B <--> C <--> D

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 HSM client package Dinamo in the Maven Central Repository.

Supported platforms:

Linux x64
Windows x64

Observation: From version 4.11.0 from the HSM client, the official distribution of client from HSM Dinamo to 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 Repositoryby clicking on versions and then browse. The file is named dinamo-hsm-x.y.z.jar where x.y.z is the version.
Copy the JNI java library (dinamo-hsm-x.y.z.jar) to the Java extensions folder (<JAVA_HOME>\jre\lib\ext) or add to the project.

For example, with JVM 1.4:
- in 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 e tacndjavalib.dll or libtacndlib.so e libtacndjavalib.so) to the system libraries folder (e.g: C:\WINDOWS\system32 or /usr/lib).

The programming interfaces in different languages available for the HSM:

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