Sentinel LDK Run-time Environment Installer for Windows: Readme

# Sentinel® LDK and Sentinel HASP® Run-time Environment Installer GUI for Windows: Readme

## Version 7.80

### April 2018

This document provides information regarding the Run-time Environment Installer GUI for Sentinel LDK and Sentinel HASP, including supported operating systems, enhancements, known compatibility issue, and issues resolved. ("Sentinel LDK" is the next generation of Sentinel HASP.)

The following topics are discussed:

- Operating Systems Supported
- Virtual Environments Supported
- Upgrading the Run-time Environment
- Installing the Run-time Environment
- Allowing Incoming Connections From Public Networks Using Port 1947
- Issues Related to Device Guard and Code Integrity Policies
- Enhancements and Issues Resolved in This Release
- Security Updates in This Release
- Revision History
- Known Issues - Run-time Environment

## Operating Systems Supported

- Windows 7 SP1
- Windows 7 SP1 Embedded standard (x86)
- Windows 8.1 SP1
- Windows Server 2008 R2 SP1
- Windows Server 2012 R2
- Windows Server 2016
- Windows 10 Version 1709
  Note: Windows 10 Insider Preview builds are not supported.

The operating system versions listed in this section were tested by Gemalto and verified to be fully compatible with Sentinel LDK. Older operating system versions are likely to be fully compatible as well, but are not guaranteed. For reasons of compatibility and security, Gemalto recommends that you always keep your operating system up to date with the latest fixes and service packs.

The installer detects the version of the operating system at run-time, before installing the relevant drivers.

## Virtual Environments Supported

For a list of the virtual environments supported, see "Supported Platforms for End Users" in the Sentinel LDK Release Notes.

The latest Release Notes can be seen at: http://sentinelldk.safenet-inc.com/LDKdocs/RN

Back to Topics

## Upgrading the Run-time Environment

When using the Installer GUI to upgrade the Run-time Environment, ensure that:

- No other Run-time Environment Installer is active.
- No other Run-time Environment components are active. Although the installation program terminates applications that are accessing the Run-time, it does not terminate running services. For example, if the Sentinel License Manager is running as a service, you must stop the service before upgrading the Run-time Environment.

Back to Topics

## Installing the Run-time Environment

- The Installer GUI detects the version of the operating system during Run-time Environment installation, before installing the relevant drivers.
- By default, Windows Vista (and later) operating systems display a User Account Control message during driver installation. The user must click Continue to continue the installation. Alternatively, the user can change the default setting from the Control Panel of their operating system.
- A log file of the installation process is written to aksdrvsetup.log in the Windows directory.

For additional information, see “2.17 - Upgrading Sentinel LDK Run-Time Environment (RTE) Installer” in the Sentinel EMS Configuration Guide.

Back to Topics

## Allowing Incoming Connections From Public Networks Using Port 1947

The Run-time Environment Installer adds a firewall rule named “Sentinel License Manager” that allowed incoming connections from private networks using port 1947.

You can manually allow access from public networks using this port, but Gemalto highly recommends against this.

If you do plan to allow incoming connections from public networks using port 1947, create a rule with a different name in order to prevent future RTE upgrades from removing this access.

Back to Topics

## Issues Related to Device Guard and Code Integrity Policies

The traditional method until now to protect against malicious application under Windows has been to trust the applications unless they were blocked by an antivirus or other security solution. Device Guard, available in Windows 10 Enterprise, implements a mode of operation in which the operating system trusts only applications that are authorized by your enterprise. You designate these trusted applications by creating code integrity policies.

You can maintain a whitelist of software that is allowed to run (a configurable code integrity policy), rather than trying to stay ahead of attackers by maintaining a constantly-updated list of "signatures" of software that should be blocked. This approach uses the trust-nothing model well known in mobile device operating systems.
Only code that is verified by Code Integrity, usually through the digital signature that you have identified as being from a trusted signer, is allowed to run. This allows full control over allowed code in both kernel and user mode.

Code integrity contains two primary components:

- kernel mode code integrity (KMCI)
- user mode code integrity (UMCI)

This section describes issues that arise and the workarounds when machines at the end user site are enabled with Device Guard, and the code integrity policy set to “enforce” mode.

Note: The procedures described in this document should be performed by an IT professional who is familiar with Device Guard and code integrity policies.

### Issue 1: Windows blocks the installation of the Run-time Environment

During installation of the Run-time Environment on your computer, Windows displays a message similar to this: "Your organization used Device Guard to block this app. Contact your support person for more info."

Solution:

To install the Run-time Environment on a machine where Device Guard is enabled in enforce mode (which make use of PcaCertificate level code signing check), ensure that DigiCert is listed/added in the Signers list of the policy file.

Import the Digicert Intermediate certificate to the trusted list of Intermediate Certification Authorities(ICA) store on the golden computer before creating code integrity policy.

A Digicert Intermediate certificate is available from https://aboutssl.org/digicert-trusted-root-authority-certificates/#intermediates. Under Intermediate Certificates, locate and download the DigiCert EV Code Signing CA (SHA2) certificate. You can also fetch this intermediate certificate from your trusted source.

To add the DigiCert Root Certificate:

1. Download the certificate on the golden computer and double-click the certificate file. The Certificate dialog box is displayed.
2. Click Install Certificate. Follow the Certificate Install Wizard to complete the import of this certificate to the ICA store.
3. Run the steps to create a new or updated policy. This will allow Sentinel software to be installed without any issues on a machine where Device Guard is enabled.

Repeat the installation of the Run-time Environment.

### Issue 2: Protected application does not operate at the customer site

(LDK-17267) ) When you distribute applications that are protected with SL keys, the customized vendor library (haspvlib_vendorID.*) that are required for these applications are not signed. As a result, Device Guard does not allow the software to operate at the customer site.

Workaround A:

This workaround must be performed at the customer site.

Do the following to add an exception for the customized vendor library file in the code integrity policy:

1. Use Windows PowerShell in elevated mode to create a policy for the exception.
2. Use the Group Policy editor to deploy the policy file.

Each of these procedures is described below. For additional details, go to: https://technet.microsoft.com/en-us/itpro/windows/keep-secure/deploy-code-integrity-policies-steps?f=255&MSPPError=-2147217396

To create the policy for the exception:

1. Open PowerShell in elevated mode.
2. Run the command to create a policy (referred to below as P1) in audit mode.
3. Deploy this policy.
4. Operate the protected application as you would normally.
5. Create another policy (referred to as P2) that captures audit information from the events log.
   Note: Before proceeding with the next step, review policy P2 carefully. This policy contains information about all the binaries that were used in your system while you operated the protected application. Any unwanted application that was executed during this time is logged in the policy. If not removed, any such application will be treated as a trusted binary.
6. Merge policies P1 and P2.
7. Disable audit mode.
8. Deploy the merged policy.

To deploy the policy file:

1. Open the Group Policy editor by running GPEdit.msc.
2. Navigate to: Computer Configuration\Administrative Templates\System\Device Guard
3. Select Deploy Code Integrity Policy. Enable this setting by using the path to the relevant policy file created above.

Workaround B (not recommended):

This workaround must be performed at the customer site.

Before deploying the code integrity policy, disable UMCI (user mode code integrity) mode.

To accomplish this, run the following command in Windows PowerShell in elevated mode:
`Set-RuleOption -FilePath <Policy path> -Option 0 -Delete`

### Issue 3: Vendor Tools fail to load

(SM-907) Sentinel LDK Vendor Tools fail to load. An error message is displayed, stating that a DLL, LIB, COM, or EXE file is not designed to run on Windows or that the DLL contains an error.

For example:

Workaround A:

Do the following to add a policy for the Sentinel LDK Vendor Tools in the code integrity policy file:

1. Use Windows PowerShell in elevated mode to create a policy for the Vendor Tools.
2. Use the Group Policy editor to deploy the policy file.

Each of these procedures is described below. For additional details, go to: https://technet.microsoft.com/en-us/itpro/windows/keep-secure/deploy-code-integrity-policies-steps?f=255&MSPPError=-2147217396

To create the policy for the Vendor Tools:

1. Open PowerShell in elevated mode.
2. Run the command to create a policy (referred to below as P1) in audit mode.
3. Deploy this policy.
4. Execute all of the Vendor Tools that you will require at your site and perform all of the functions in these tools that you will require. If you miss any required Vendor Tools or Vendor Tool functions, the required entries will not be added in the new code integrity policy, and these tools or functions will generate an error message when they are eventually used.
5. Create another policy (referred to as P2) that captures audit information from the events log.
   Note: Before proceeding with the next step, review policy P2 carefully. This policy contains information about all the binaries that were used in your system while you operated the Vendor Tools. Any unwanted application that was executed during this time is logged in the policy. If not removed, any such application will be treated as a trusted binary.
6. Merge policies P1 and P2.
7. Disable audit mode.
8. Deploy the merged policy.

To deploy the policy file:

1. Open the Group Policy editor by running GPEdit.msc.
2. Navigate to: Computer Configuration\Administrative Templates\System\Device Guard
3. Select Deploy Code Integrity Policy. Enable this setting by using the path to the relevant policy file created above.

Workaround B (not recommended):

Perform this workaround at your development site.

Before deploying the code integrity policy, disable UMCI (user mode code integrity) mode.

To accomplish this, run the following command in Windows PowerShell in elevated mode:
`Set-RuleOption -FilePath <Policy path> -Option 0 -Delete`

No further actions are required.

### Issue 4: Digital signature removed from the RTE Installer

(SM-18780) When a user creates a Run-time Environment Installer using Sentinel EMS, the digital signature is removed from the Installer. As a result, Device Guard blocks the RTE Installer from executing.

If the vendor downloads the installer as an EXE file and signs it, Device Guard allows the installer to run, but the installation fails due to an unsigned DLL file called by haspdinst.exe.

Workaround:

Perform the procedure that follows.

1. Download the Run-time Environment Installer from the following URL in the Gemalto web site:

> https://sentinelcustomer.gemalto.com/sentineldownloads/

2. Use the downloaded Installer to install the Run-time Environment.
3. Place a copy of the Vendor library (haspvlib_vendorID.*) in %CommonProgramFiles(x86)%\Aladdin Shared\HASP\ (on a 32-bit machine, place the Vendor library in %CommonProgramFiles%\Aladdin Shared\HASP\).

To work with Sentinel EMS, continue with the following additional steps:

4. In a Web browser, enter the following to start Admin Control Center: http://localhost:1947
5. On the Configuring Network Settings page, in the EMS URL field, enter the URL to access the Sentinel EMS Service.
6. Click Submit.
7. Proceed to work with Sentinel EMS as required.

As an alternative, you can use one of the workarounds provided above for issues 2 and 3.

Back to Topics

## Enhancements and Issues Resolved in This Release

### Issues Resolved

Reference | Description
--- | ---
SM-12155 | If a customer applies a V2C update from a remote machine that has the Vendor library but no license from the same vendor, the error returned was HASP_UPDATE_TOO_NEW, which was confusing. Now the error returned is HASP_KEYID_NOT_FOUND.
SM-18502 | Defining an excessive number of User Restrictions in Admin Control Center would cause the License Manager Service to fail.
SM-19981 | hasp_update would return an internal error for an HL Key when the license definition contains empty content in the default memory section.

SM-23609

The RTE installer adds a firewall rule (named “Sentinel License Manager”) that, in the past, allowed incoming connections from any network, including public networks, using port 1947. Starting with RTE version 7.80, the firewall rule added by the RTE Installer does not allow incoming connections from public networks. If you are upgrading from an earlier version of RTE, the installer replaces the existing rule (that allows connections from public networks) with a rule that blocks such connections.

You can manually allow access using this port from public networks, but Gemalto highly recommends against this.

If you do plan to allow access from public networks using port 1947, create a rule with a different name in order to prevent future RTE upgrades from removing this access.

SM-25600 | The Run-Time Environment would require an excessive amount of time to install.
SM-26543 | Under certain circumstances, Sentinel License Manager would crash on the REST interface with long packets.
SM-9841 | HASP4 keys would stop working after the Run-time Environment was upgraded to v.7.54.

Back to Topics

## Security Updates in This Release

This section describes security issues that may affect Sentinel products and that have been resolved in Sentinel Run-time Environment v.7.80.

For the latest information regarding these issues or any older or newly-discovered issues, see this Web page:

https://sentinel.gemalto.com/technical-support/security-updates-sm/

### Reporting a Security Vulnerability

If you think you have found a security vulnerability, please send it to Gemalto using the links provided on the Web page provided above.

### Sentinel LDK Vulnerabilities

The vulnerabilities listed below affect the License Manager service of HASP SRM, Sentinel HASP and Sentinel LDK products. These vulnerabilities are resolved in Sentinel Run-time Environment version 7.80.

- (SM-26010) A cross-site scripting (XSS) vulnerability in the Admin Control Center logs has been resolved.

Back to Topics

## Revision History

This section describes enhancements implemented and issues resolved in the last three major releases of Sentinel Run-time Environment.

### Issues Resolved in Version 7.65

Reference | Description
--- | ---
SM-21408 | The Admin Control Center help system was missing information regarding the new “Idle Timeout of Session” configuration parameter.
SM-23320 | A possible security issue related to License Manager failure due to stack overflow on deep XML data (reported by Kaspersky) has been resolved.
SM-23402 | A possible security issue related to buffer overflow (reported by Kaspersky) has been resolved.
SM-23813 | A possible security issue that was reported by Kaspersky has been resolved.

### Enhancements in Version 7.63

Reference | Description
--- | ---
SM-13443 | When a Sentinel HL (HASP configuration) key or HASP HL key is attached to a Windows machine, the Run-time Environment is no longer installed automatically by Windows Update. It is now the software vendor’s responsibility to ensure that the Run-time Environment is installed when required.

SM-13505

In the past, the timeout for an idle License Manager session was fixed at 12 hours. You can now set the timeout to any value between 10 minutes and 720 minutes (12 hours). The timeout value can be set as follows:

- In Admin Control Center, on the Basic Configuration page. Use the Idle Timeout of Session parameter.
- In the hasplm.ini file. Assign the timeout value to idle_session_timeout_mins.

SM-14894 | Admin Control Center now adds the update counter in C2V files in clear text - for example: <update_counter>5</update_counter> It is no longer necessary to decode the C2V file in order to view this information.
SM-19483 | Admin Control Center now recognizes the new V2CP format to update protection keys. This supports planned enhancements in Sentinel LDK v.7.8.

### Issues Resolved in Version 7.63

Reference | Description
--- | ---
SM-15922 | Admin Control Center no longer requires the <?xml header in a V2C file.
SM-17175 | After system reboot/service restart, an SL AdminMode detached license would disappear from a recipient machine that had no other licenses.
SM-18015 | On some machines, the License Manager service would start before the Secure Storage driver is loaded. This would cause the Secure Storage to become corrupted. Now, the License Manager service waits for the Secure Storage driver to start.
SM-18302 | Cancelling a detached SL AdminMode license from the recipient VM machine would fail with the HASP_VM_DETECTED error.
SM-18502 | In Admin Control Center, defining too many users in the User Restrictions field would cause the License Manager to fail.

### Enhancements in Version 7.61

Reference | Description
--- | ---
SM-5318 | The Run-time Environment now supports the use of the VMType3 clone protection scheme.

### Enhancements in Version 7.60

Reference | Description
--- | ---
SM-1286 | You can now enter the URL to access Sentinel EMS in your Web browser without changing the EMS URL to lowercase.
SM-901 | Admin Control Center (under Windows) can now display and apply updates to local SL UserMode keys. (Session information and certificate information for SL UserMode keys is not displayed.)
SM-4237 | To display SL UserMode keys in Admin Control Station, License Manager runs an additional process (hasplmv) on the machine. If you are willing to accept that SL UserMode keys will not be displayed, you have the option to prevent hasplmv from executing by clearing the relevant check box on the Configuration page in Admin Control Center.

SM-6525

In the past, Admin Control Center and Admin API provided a configuration parameter that determined whether a remote user could access and perform actions in Admin Control Center. However, this parameter did not control remote access to Admin API.
Now, the parameter Allow Remote Access to ACC and Admin API (in Admin Control Center) and the tag <accremote> (in Admin API) control remote access to both Admin Control Center and Admin API.

### Issues Resolved in Version 7.60

Reference | Description
--- | ---
LDK-12145 | When a data file is protected with Version 2 data protection mode for Android platforms: If, for any reason (for example, no license was found), the protected application was not able to decrypt the protected data file, no error message was generated to explain why the file cannot be opened.
SM-513 | Under Windows 10, a physical machine would be detected as a virtual machine when only Hyper-V Hypervisor is enabled.
SM-515 | It was possible to rehost a cloned license to another machine.
SM-518 | The Diagnostics report in Admin Control Center (Diagnostics > Generate Report) displays information on "Recent Clients" and "Recent Users". Each entry contained a time stamp but not a date stamp. The report has been corrected to display both a time stamp and a date stamp for each entry.

SM-6102

When building a Run-Time Environment installer using Wix, an error message similar to the following was generated:
Invalid product version '7.53.1.66350' in package HASP_Setup.msi'. When included in a bundle, all product version fields in an MSI package must be less than 65536.
This error no longer occurs.

SM-942 | Under certain circumstances, Sentinel LDK License Manager Service would crash. The exception code would map to STATUS_STACK_OVERFLOW in __chkstk API.

### Enhancements in Version 7.55

Reference | Description
--- | ---

SM-4748

Sentinel Admin Control Center can now be used to configure the License Manager for the following additional considerations:

- Allow specific named users to access specific Batch Codes, protection keys (haspID), or Product IDs.
- Use the "*" wildcard character for IP and hostname.
- Use subnet mask notation (for example: 172.18.8.0/21) for IP addresses

For more information, see "Configuring User Settings" in the Admin Control Center online help.

### Issues Resolved in Version 7.55

Reference | Description
--- | ---
SM-4942 | Various crash conditions in the License Manager that could be used for denial-of-service attacks or privilege-escalation attacks have been resolved.

SM-7748

When a user issues a "detach license" request from a remote Admin Control Center, the user name cannot be included in request. As a result, User Restrictions (defined in ACC on the license server machine) that are based on the user name are handled as follows:

- “allow” user restrictions that are based on a specific user name are not applied because the user name is not available to the License Manager on the license server. If a different restriction such as `deny=all@all` is also specified, the detach request will be denied.

- If any “deny” user restriction that is applicable for the request in all respects other than username exists, that restriction is applied even if the user name specified in the restriction does not match. For example: If the detach request was sent from a machine with the hostname host123, and a user restriction has been specified `deny=skr@host123` on the license server machine, the detach request is denied even the user requesting the detach has a different username.

Sentinel Admin Control Center online help has been updated to describe these limitations.

### Enhancements in Version 7.54

Reference | Description
--- | ---
SM-889 | Run-time Environment is supported under Windows Server 2016.

### Issues Resolved in Version 7.54

Reference | Description
--- | ---

SM-2090

Installation of a rebranded RTE would fail when the account name contains multi-byte characters (such as Japanese). The install log would contain an error similar to the following:

`could not open C:\Users\userName\AppData\Local\Temp\EMSUrl.properties ../hhlinst.c,4659
OPEN file C:\Users\userName\AppData\Local\Temp\EMSUrl.properties processing error. ../hhlinst.c,4660,`

SM-2957 | The decrypt function in the HASP4 API would give incorrect results after RTE 7.52 or 7.53 was installed.
SM-3767 | After installation of RTE 7.53, hasplms was unreachable to remote clients. The RTE installer did not add the firewall rule to allow Sentinel License Manager Service.

### Issues Resolved in Version 7.53

Reference | Description
--- | ---

SM-1201

Given the following scenario:

1. Obtain a C2V file for an SL Legacy key.
2. Prepare an update to upgrade the SL Legacy key to an SL AdminMode key in Sentinel License Generation API, but do not apply the update.
3. Prepare a second update using the first update as the current state for the key.
4. Apply the second update to the key.

The update would return a status of OK even though the update fails.

SM-1549

Given the following scenario:

1. Connect a Sentinel HL (HASP configuration) key to a machine and generate a C2V file for the key.
2. Create an update in Sentinel License Generation API to upgrade the key to a Sentinel HL (Driverless configuration) key, but do not apply the update.
3. Prepare a second update to the key using the first update as the current state for the key.
4. Apply the second update to the key.

The update would return a status of OK even though the update fails.

### Enhancements in Version 7.52

Reference | Description
--- | ---
LDK-15786 | The Features page in Admin Control Center now displays the peak number of consumed seats per Feature. The peak number is based on the current License Manager session. For each Feature, the peak number value is displayed as a tool tip for the seats value under the Logins column. This information enables end users and organizations to determine if the number of seats purchased is suitable for their needs.
SM-815 | The Run-time Environment can now be installed under Windows 10 when Device Guard is enabled.

Back to Topics

### Issues Resolved in Version 7.52

Reference | Description
--- | ---

SM-498

A Sentinel HL (HASP configuration) key would not be accessible by the protected application under the following circumstances:

The following conditions exist:

- Windows 10 version 1607 is present on the machine.
- The network is disabled.
- The Run-time Environment is not present on the machine.

The following actions are performed:

1. The HL key is connected to the machine and then disconnected.
2. The Run-time Environment is installed on the machine.
3. The HL key is connected again to the machine.

The HL key would not be accessible.

SM-504 | When using RTE 7.51, a Stop error (BSoD) would occur when the protected application attempted to retrieve the serial number of the disk drive that uses Intel RAID drivers.
SM-528 | Under certain circumstances, the uninstall of the Run-time Environment on a Windows 8 machine would fail.
SM-537 | The uninstall of the Run-time Environment would not provide proper notification if it failed to remove all necessary files. The uninstall process now provides a detailed list of any files that it fails to remove and advises the user to remove the files manually.
SM-824 | During the installation of a rebranded Run-time Environment using the -v flag (`haspdinst.exe -i -v`), an internal error would be displayed (message: "An error occurred when the RTE installer attempted to unpack the file sm.cab"). Note that the -v flag is not a documented option, and that the installation would succeed despite the error message.

SM-830

Given the following circumstances.

1. A machine is not connected to the network
2. Run-time Environment v.7.50 is installed on the machine.
3. The Run-time Environment is removed with a purge command.
4. You connect a Sentinel HL (HASP configuration) key to the machine.

The Run-time Environment would be automatically reinstalled.

Now, the Run-time Environment is not installed under these circumstances.

Back to Topics

### Issues Resolved in Version 7.51

Reference | Description
--- | ---
LDK-13933 | When installing Sentinel LDK Run-time Environment v7.41 or later under Windows 10 (x86), the file hlvdd.dll was not installed. As a result, the protected application would fail.
LDK-16215 | Each time the end user would connect a Sentinel HL (Driverless configuration) key to a different USB port on a Windows machine, the Driver Software Installation message box would indicate that a restart was required.

LDK-16443

Given the following circumstances:

- A V2C file was applied to a new SL AdminMode license on a given machine.
- The same V2C was applied a second time to the license.

Instead of generating an error message and rejecting the update, the License Manager would generate the error message and then remove the original SL AdminMode license from the machine. (The license would be restored when the License Manager was restarted.)

### Issues Resolved in Version 7.50

Reference | Description
--- | ---

LDK-12479

Given the following circumstances:

- A file type is registered as “protected” using Version 1 data file protection.
- A file of the protected type is saved from the protected application using “Save as”.

Under certain circumstances, the saved file was not encrypted.

LDK-12860 | When a fully-qualified domain name (FQDN) was provided in the login scope using a character set outside the Windows code page, the login would fail with error code 50 (Scope Result Empty).
LDK-13136 | Sentinel Licensing API would identify a Max Micro key as a Max key under certain circumstances.

LDK-13455

Given the following circumstances:

- A license server machine and the recipient machine are in different time zones
- A detachable license is transferred online from the server to the recipient machine.

The detached license would expire earlier than expected.

LDK-13926 | The branded RTE Installer that is generated by Sentinel EMS did not copy the haspvlib correctly to /var/hasplm/. As a result, when hasp_update attempted to apply a V2C file, error 48 was generated.

LDK-14274

Given the following circumstances:

- An SL AdminMode or SL Legacy license is located on a physical machine.
- From a remote VM, hasp_get_info() is called to fetch values of the "disabled" and "usable" tags for the SL license.

The incorrect values disabled=true and usable= false were returned.

LDK-14280 | HASP HL keys are not recognized correctly by the License Manager when keys from two or more vendors are connected to a given machine.
LDK-14805 | The Run-time Environment did not support RAID controllers that create symbolic links as \Device\RaidPort.
LDK-15306 | On the Diagnostics page of Admin Control Center, the Requests counter would count a request to local licenses as a remote request.

LDK-15307

Given the following circumstances:

1. SL Legacy licenses from two different vendors were present on a machine.
2. The license from one of the vendors is removed.
3. The License Manager service is restarted.

The remaining SL Legacy license was no longer visible in Admin Control Center.

LDK-15857

Given the following circumstances:

1. RTE version 6.60 or earlier is installed on a machine with no licenses.
2. Retrieve the fingerprint of the machine.
3. Upgrade the RTE to version 7.41
4. Use the retrieved fingerprint to generate an SL AdminMode license.
5. Apply the license with the upgraded RTE.

The license would be marked as “cloned”.

LDK-16113 | When a V2C file to clear the “cloned” status of an SL Legacy license was applied, The “clear clone” operation was not applied correctly until the user restarted the machine.
LDK-16215 | Driver software was reinstalled and the end user was prompted to restart the machine each time an HL (Driverless configuration) key was connected to a differed USB port on the machine.

### Issues Resolved in Version 7.41

Reference | Description
--- | ---
LDK-12845 | Installation of Sentinel Run-time Environment version 7.40 on a machine with an obsolete version (11.5.x) of Intel RAID drivers would cause a Stop error (BSoD).

### Enhancements in Revision 7.40

Reference | Description
--- | ---
LDK-6938 | The Run-time Environment now supports Sentinel HL Drive microSD keys.
LDK-8350 | The diagnostic report in Admin Control Center now provides additional information for Driverless keys and updated driver versions
LDK-10079 | The diagnostic panel in Admin Control Center now displays the version number for the Run-time Environment.
LDK-10107 | The Admin Control Center log file now indicates the version number for the Licensing API.
LDK-10279 | The button in Admin Control Center for generating C2V files is now blocked for HASP HL keys and Sentinel HL (HASP configuration) keys.
LDK-11034 | The Sentinel Keys page in Admin Control Center now displays the capacity of attached Sentinel Drive microSD keys.
LDK-11335 | Admin Control Center now displays the module name (in addition to the Feature ID) for Sentinel Master keys and Sentinel Developer keys.

### Issues Resolved in Version 7.40

Reference | Description
--- | ---
LDK-7237 | Under certain circumstances, Admin Control Center would continue to show active sessions for an HL key after all sessions had logged out of the key.
LDK-8866 | Under certain circumstances, if SL license information became corrupted, Sentinel LDK License Manager Service would crash instead of issuing an error message. As a result, it was not possible for the vendor to correct the situation by sending a license update.
LDK-9797 | The Run-time Environment did not provide a meaningful error message when a given License Manager ID was found on multiple machines in the same network. This situation is typically caused by cloning a VM. As a result, it was difficult to identify the source of the problem when the licenses on these machine were inaccessible. Now an appropriate error message is generated.
LDK-9948 | Rehosting of an SL Legacy key to a different machine would fail with the return code HASP_CLONE_DETECTED.
LDK-10273 | Admin Control Center would allow a license to be detached even though the termination date for the detach was invalid.
LDK-10564 | The Vendor ID for a Master key was not the same in Admin Control Center pages and in the Diagnostics Reports.
LDK-10857 | When an iSCSI disk was connected to a Windows physical machine, the License Manager would regard the machine as a virtual machine.
LDK-11478 | After Run-time Environment v.7.32 was installed, running an application that was protected with Sentinel HASP Envelope (prior to Sentinel LDK 6.3) would cause a Stop error (BSoD).
LDK-11787 | Under certain circumstances, the Licensing API function hasp_get_info would always return a value of 0 as the value for <updateCounter> for an SL license. Now the function returns the correct value for <updateCounter>.
LDK-11825 | Admin Control Center was not able to display an invalid HL key. Now such a key is visible in Admin Control Center with an indication that the key is not valid.
LDK-12196 | When an SL key is installed on a machine with Run-time Environment 7.32 or 7.3, the Run-time Environment would continually open additional handles.

Back to Topics

## Known Issues - Run-time Environment

Reference | Description
--- | ---
12506 | Sentinel LDK communicates via TCP and UDP on port 1947. This port is IANA-registered exclusively for this purpose. At the end user site, the firewall must be configured so that communication via this port is not blocked.
180256 | When a computer names contains UTF-16 characters, Admin Control Center displays the short name for the computer (similar to Windows Explorer). Similarly, the sntl_admin_get function in Admin API returns the short name.
182646 | After Windows 7 is upgraded to Windows 8, the user is not able to use existing SL licenses or to install new SL licenses. Workaround: After you upgrade from Windows 7 to Windows 8, reinstall the Run-time Environment.

LDK-2471

Sentinel Licensing API: On a computer with the Nvidia chip set GeForce 7025/nForce 630a, and where the CPU is AMD Athlon 64 X2, the hasp_read and hasp_encrypt functions may fail with error 39, HASP_BROKEN_SESSION. This problem only exists with HASP HL keys with Firmware version 3.25.

Workaround 1: On the computer described above, when error 39 is returned, call the hasp_read or hasp_encrypt function again. It is not necessary to call hasp_login again.

Workaround 2: Use Sentinel HL keys with Firmware version 4.2x.

LDK-8480

With some new USB chipsets, it is possible that the API hasp_update() call, used to update the firmware of Sentinel HL keys to version 3.25, will generate the HASP_BROKEN_SESSION return code, even if the firmware is correctly updated. (This issue does not occur with Sentinel HL Driverless keys with firmware version 4.x.)

Workaround: Install the latest Run-time Environment. The automatic firmware update feature of the License Manager will automatically update the firmware of the key the first time that the key is connected, without the need to call hasp_update().

LDK-11418

For a Java 7 or Java 8 application that is protected with Envelope, the end user must use the following flag when launching the protected application:

- For Java 7: Specify -usesplitverifier
- For Java 8: Specify -noverify

If the appropriate flag is not specified, the application may throw java.verifyerror when launched.

LDK-17267 | The License Manager fails to load vlibs under Windows 10 when Device Guide is enabled and the Code Integrity policy is set to “enforce”. For more information, see Issues Related to Device Guard and Code Integrity Policies.
SM-907 | Sentinel LDK Vendor Tools fail to load under Windows 10 when Device Guide is enabled and the Code Integrity policy is set to "enforce". An error message is displayed regarding a certain DLL, stating that the DLL is not designed to run on Windows or that the DLL contains an error. For more information, see Issues Related to Device Guard and Code Integrity Policies.

LDK-17302
LDK-13953
LDK-14971

Given the following circumstances at a customer site:

1. One machine has Run-time Environment version 7.51.
2. A second machine has a version of Run-time Environment that is earlier than 7.51.
3. The customer performs rehost of a license repeatedly between the two machines.
4. An update is applied to the license on either of these machines.

A rehost operation sometimes fails with the message HASP_REHOST_ALREADY_APPLIED.

Workaround: Obtain a new SL license from the software vendor for the protected application on the target machine. Before attempting any additional rehost procedure, install the latest Run-time Environment on both machines.

Back to Topics

© Gemalto 2018. All rights reserved. Gemalto, the Gemalto logo, are trademarks and service marks of Gemalto and are registered in certain countries.

DocID 118 Revision 1803-6