Fingerprint Generation and License Activation

Container Engine Deployment

Prerequisites

Installed Java 17+

The Fingerprint Generator tool requires Java 17 or higher. For installation instructions, please refer to the Java installation articles of vendor.

Dedicated User

For license validation, fingerprints must be generated using a dedicated user account. This is important because different users may have varying access levels to machine hardware information, resulting in different fingerprints. It is not necessary to create a new user; however, the license activation process should be conducted using a single user account.

SSH Server

If you have deployed a server using a container image that requires a license based on a fingerprint, SSH connectivity to the host environment is necessary. This acts as a safeguard against fraudulent implementations of the fingerprint generator. .

Fingerprint generation

Obtain the Tool

Download the {fingerprint-tool.jar} from the feature branch, available at download.newired.com.  Tool's help could be evoked by command 

java -jar fingerprint-tool.jar

Execute the Tool

Ensure that the file is accessible to the dedicated user account on the server.

1. Log in or switch to the dedicated user account if you haven't done so already.
2. Run the following command 

   java -jar fingerprint-tool.jar -g

   You will be prompted for the Domain . For example, if your domain is https://my.domain.org/newired, the output will look like this:

   Collecting device information Creating device fingerprint Available network interfaces. 1  (recommended)               | eth4   | Ethernet            | 9c:2d:cd:11:a2:79    | Reatek PCIe GbE Family Contro... 2  (partially recommended) | wlan1 | Wi-Fi 2              | f8:9e:94:69:9d:5d    | Intel(R) Wi-Fi 6E AX211 160MHz 3  (not recommended)        | wlan0 |                           | f8:9e:94:69:9d:5e    | Microsoft Wi-Fi Direct Virtual... Choose one network interface by number: 1 Enter configuration data Domain: https://my.domain.org/newired Fingerprint '15:35981912,1698320430,327069095,1845835809;1:aHR0cHM6Ly9teS5kb21haW4ub3JnL25ld2lyZWQ=' written to C:\Users\<user>\Downloads\newired-fingerprints.txt.

   Network interfaces can change frequently in dynamic environments, especially when using virtual adapters created by tools like Docker Engine. Therefore, fingerprints are taken from only one interface, which must be chosen carefully. The fingerprinting tool categorizes interfaces by type and name to help users select a reliable option.

   
   

    The generated fingerprint is saved to the file newired-fingerprints.txt. This file should be sent to your license manager, who will generate the license file. Alternatively, you may send just the content of the file, which is the fingerprint itself. For example, it would be 15:35981912,1698320430,327069095,1845835809;1:aHR0cHM6Ly9teS5kb21haW4ub3JnL25ld2lyZWQ=

   
   

   
   

Obtain License

Send the generated file (newired-fingerprints.txt) containing the fingerprint, or its content, to your Newired contact or Newired customer care to generate the license file. Here is an example of a license file:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<newired:license xmlns:newired="http://www.newired.com/products"
                 newired:version="1.0"
                 newired:product="NEWIRED">
    <newired:customer name="Example Customer" />
    <newired:features_tips value="yes" />
    <newired:features_journeys value="yes" />
    <newired:expirationdate day="22" month="11" year="2025" />
    <newired:hl value="<your-environment-fingerprint>"/>
    <newired:signature value="<signature>" />
</newired:license>

Activate License

Follow the instructions provided in the README file included in the Newired-Docker-<version>.zip package.

Troubleshooting

Validation

To validate a fingerprint, use the following command:

java -jar fingerprint-tool.jar -v "<your fingerprint>" -m "Domain:<your domain>"