SCP Configuration For All Supported Platforms

This section provides information required for using the Thales-managed RMS Cloud License Manager (LM).

>Unzip the SCL Add-on package by using the password received from Thales in emails. Copy the package to the system where the RMS SDK is installed, and extract its contents to any folder (represented by <extractedfolder>). 

>The SCP installation and configuration prerequisites are given in the section Prerequisites for SCP Installation and Configuration.

Configure SCP

You can configure SCP:

>Using the SCP Configuration File

>Using the RMS Unified APIs

Using the SCP Configuration File

Open the SCP configuration file and modify the following elements:

Element

Description

TenantHostAddress

Specify the URL for Thales-managed services received in emails from Thales. For example:

https://demo-host.com/
RegistrationToken

A token required for authenticating a user/device for accessing the RMS licensing calls. The Registration token is a customer-specific token. It can be generated using the Sentinel EMS Customer Portal. Refer to the Sentinel EMS Customer Portal Guide for details.

(Optional) Configure Proxy Settings

For a proxy setup, modify the following elements in the SCP configuration file:

NOTE   By default, the system settings are used, but if defined, the configuration file settings take precedence.

Element

Description

ProxyMode

Proxy connection mode. The possible values are:

>1: Indicates that the proxy is disabled.

NOTE   The licensed application will not connect to the cloud if the client machine is in a proxy environment and proxy settings for SCP are not defined.

>2: Refers to the manual proxy mode. In this mode, you need to manually set the proxy settings.

>3: Refers to the auto proxy mode. In this mode, the proxy settings are automatically detected.

Manual Proxy Settings (ProxyMode value="2")

ProxyHost

Proxy host name or IP address.

ProxyPort

Port at which the proxy is running.

Proxy Credentials (when authentication is enabled in the proxy server)

ProxyUser

User name for the proxy authentication.

ProxyPassword

Proxy password for the proxy authentication.

Auto Proxy Settings (ProxyMode value="3")

In this mode, the proxy settings are automatically detected. There are two automatic proxy detection methods:

>WPAD (Web Proxy Autodiscovery Protocol): The proxy detection can be done using either DNS or DHCP discovery methods.

NOTE   DHCP has a higher priority than DNS. The WPAD-enabled client first uses DHCP to find a proxy server, and if the desired information is not obtained, DNS is used. If the wpad.dat file is not found or if a proxy is not detected while running wpad.dat, no error is returned. Instead, the client tries to connect in a manner similar to when the proxy is disabled (No Proxy).

>PAC (Proxy Auto-configuration): The location of the proxy script file is specified in the configuration file.

In the auto proxy mode, WPAD takes precedence over PAC.

ProxyPAC

Location of the auto-proxy configuration (.pac) file to be used for the proxy detection. Use this option for auto-proxy with the .pac file support. This option takes the URL or path of the .pac file as input.

(Optional) Setting Trace Logs and Trace Levels

The log settings defined in the SCP configuration file are not applicable for the standalone lease mode and RMS Cloud LM. Use the sntl_licensing_configure Sentinel RMS API to configure logging. The attributes of this API are:

Atrribute Possible Values

>SNTL_ATTR_CONFIG_TRACE_LEVEL

>SNTL_ATTR_CONFIG_TRACE_FUNCTION

> SNTL_ATTR_CONFIG_TRACE_ERROR

>SNTL_ATTR_CONFIG_TRACE_WRITER_FILE

Set the client trace writer filename.

For API details, refer to the Sentinel RMS API Reference Guide.

Using the RMS Unified API

You can choose to configure SCP through the RMS Unified APIs (via the SNTL_ATTR_CONFIG_SCP_USE_CONFIG_FILE attribute) available for the following programming languages:

Programming Language API
C sntl_licensing_configure
Java configure
.NET configure

NOTE   You can also use the sntl_cloud_demo sample, included with the SCL Add-on package, to understand the Unified API workflow and consumption of a license in the Connected (Cloud LM) deployment mode. This sample is available for C, Java, and .NET. Refer to the readme included with the sample to learn more about using this sample.