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 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.