Zentitle2Core Library

The Java Licensing Client implements bindings to the Zentitle2Core C++ library's methods, allowing Java applications to leverage the functionality of the C++ Core library using the Java code.

Zentitle2Core Library Integration

1. Download the zip package with the Zentitle2Core binaries from the Zentitle2Core's Release Notes page.

2. Extract the content from the downloaded zip package. Place the platform-specific binaries from language_bindings/java folder into your project's working directory.

In the example below, the application is targeting MacOS. Thus, only the MacOS binary has been included in the project.

This solution works for all the operating systems, as Java runtime always loads the binary depending on the OS that the application is currently running (.dll on Windows, .so on Linux and .dylib on MacOS).

Using Zentitle2Core Methods

After the Zentitle2Core binaries have been integrated into the Java application, the following activation options can be used to leverage the functionality implemented in the Core library.

Device Fingerprint

A Device Fingerprint is a unique identifier of the device on which the application is being executed. Therefore, it is a good candidate for use as the activation's seat ID.

ActivationOptions activationOptions = new ActivationOptions(
    tenandId,
    productId,
    () -> DeviceFingerprint.generateForCurrentMachine(),
    storage,
    onlineActivationOptions,
    offlineActivationOptions,
    activationOperationLock);

Offline Activation

The Zentitle2Core library implements the logic responsible for encrypting and decrypting the tokens exchanged in the Offline License Activation process. Without the Zentitle2Core library, this functionality cannot be used.

OfflineActivationOptions offlineActivationOptions = new OfflineActivationOptions(tenantRsaKeyModulus);

ActivationOptions activationOptions = new ActivationOptions(
    tenandId,
    productId,
    () -> seatId,
    storage,
    onlineActivationOptions,
    offlineActivationOptions,
    activationOperationLock);

Secure Storage

It is not trivial to persist the activation's details into a license file that is hard to tamper and should not work on a different device (or even in a different folder within the same machine). The Zentitle2Core library implements this functionality using low-level code, making the license file encrypted and unusable when copied/moved elsewhere.

Secure storage also helps place the file into the correct system directory, depending on the OS that the application is currently running on. It provides predefined directories USER_DATA and PUBLIC_DATA. Depending on the application's licensing model, you can decide which one to use. The code below will create the ../{USER_DATA Dir}/YourAppName/.license file for your app.

Activation activation = new Activation(options ->
    options.useStorage(
        SecureActivationStorage
            .withAppDirectory(PredefinedSystemFolder.USER_DATA, "YourAppName")));