Activate a license

An internet connection is required to activate a license. The activation process binds the license to your device’s Hardware-Bound Licenses.

Note

Unless you are using an Online License, the internet connection is only required for the initial activation.

Activation Credentials

To activate your license, you will need one of the following credentials. The Activation Key is the preferred and most flexible method.

  • Activation Key (Recommended) An activation key is a unique identifier linked to your account that looks like XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX. It is the preferred method for activation because it is flexible, allowing multiple activations on different devices as needed for your project.

  • Serial Number A serial number is a key in the format XXXX-XXXX-XXXX-XXXX. It is less flexible as it only allows for a single activation. Once used, it cannot be used again.

  • Credentials This method uses your customer login, password, and a product reference number to activate.

Note

Regardless of the activation method used, the final generated license file will always have a unique serial number associated with it. This serial number is important for identifying a specific license, for instance, when requesting technical support or a license repositioning.

Activation Methods

You can activate your license using one of the following methods.

1. License Manager GUI (Windows Only) The graphical id3 License Manager application helps you manage your license files on Windows. Before you can use id3 Software Development Kits (SDKs), you must have the correct license installed. Please refer to the License Manager user’s guide for more details.

Prerequisites: - Microsoft Windows 7, 8 or 10 - An active Internet connection

2. Command-Line Tool A command-line activation tool is available in the activation/cli-tool directory for all supported platforms.

For example on Linux x64:

cd activation/cli-tool/linux/x64
chmod +x id3LicenseActivationCLI
./id3LicenseActivationCLI --help

Several options are possible to activate a license.

Activation with a serial number:

id3LicenseActivationCLI.exe --activate .\data\id3Face.lic --serialkey="XXXX-XXXX-XXXX-XXXX"

Activation with an activation key:

id3LicenseActivationCLI.exe --activate .\data\id3Face.lic --activationkey="email-XXXXXXXX-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"

Activation with credentials:

id3LicenseActivationCLI.exe --activate .\data\id3Face.lic --login="[email protected]" --password="myPassword" --reference="XXXXXXXX"

3. Programmatic Activation It is generally preferred to activate the license programmatically within your application. This is the recommended approach for most applications.

Important

Programmatic activation is the only way to activate a license on mobile devices (Android, iOS).

See Activating a license in your app (Android/iOS) in the section for details and code examples.