Release notes

Introduction

These release notes apply to version v8.1.0 of the Time Stamp Option Pack™ (TSOP) Software Development Kit (SDK). They contain information specific to this release such as new features, defect fixes, and known issues.

This release supports the following operating systems:

  • Microsoft Windows Server 2019 x64

  • Microsoft Windows Server 2022 x64

  • Oracle Enterprise Linux 8 x64

  • Oracle Enterprise Linux 9 x64

  • Red Hat Enterprise Linux 8 x64

  • Red Hat Enterprise Linux 9 x64

  • SUSE Enterprise Linux 12 x64

  • SUSE Enterprise Linux 15 x64

The release notes may be updated with issues that have become known after this release has been made available. For the latest version, see https://nshieldsupport.entrust.com/hc/en-us/sections/360001115837-Release-Notes.

Access to the Support Portal is available to customers under maintenance. To request an account, contact nshield.support@entrust.com.

Purpose of this release

Time Stamp Option Pack™ Software Development Kit version v8.1.0 addresses a number of known issues and introduces a number of enhancements over the previous release, including:

  • Updated platform support.

  • Classpath changes.

  • ATV files and ncversions.

  • TSOP SDK User Guide.

Versions of these release notes

Revision Date Description

1.1

2024-10-18

Documentation tooling update: fixed the website navigation of TSOP SDK v8.1.0 docs. No content changes.

1.0

2024-09-26

TSOP SDK v8.1.0 GA release notes.

Changes in this release

The TSOP SDK v8.1.0 release introduces a number of enhancements. These are discussed in the following sections.

Updated platform support

The following operating systems are now supported:

  • Microsoft Windows Server 2022 x64

  • Oracle Enterprise Linux 9 x64

  • Red Hat Enterprise Linux 9 x64

Support for the following operating systems has been deprecated:

  • Microsoft Windows Server 2012 x64

  • Microsoft Windows Server 2016 x64

  • Oracle Enterprise Linux 7.1 x64

  • Oracle Enterprise Linux 7.6 x64

  • Red Hat Enterprise Linux Server 7 x64

See Introduction for the complete list of supported platforms.

Classpath changes

It is no longer necessary to specify asn1rt.jar on the classpath when using the TSOP SDK.

ATV files and ncversions

ATV files are now generated for both the C and Java components of the TSOP SDK and will be displayed in the version information returned by ncversions.

TSOP SDK User Guide

The TSOP SDK User Guide (previously, the TSOP SDK Reference Guide) is no longer included on the ISO and can be obtained via https://nshieldsupport.entrust.com/hc/en-us/categories/360000473317-Documents-Manuals.

Important information

Before deploying the TSOP SDK, the following should be considered:

  • This release only supports the operating systems detailed in Introduction.

  • It is required that all client applications built with pre-6.20.00 versions of the TSOP SDK (both the C and Java APIs) are rebuilt to use the updated libraries in this release.

  • On Linux, applications linking with libtti.a must also link with the pthread library.

  • When TTI_VERIFY_ESSCERTIDV2 is set to 0, the first SHA-2 hash in ESSCertIDv2 is checked - if no SHA-2 hashes are present - the first SHA-1 hash in ESSCertID is checked. If TTI_VERIFY_ESSCERTIDV2 is set to 1, or the environment variable is unset, only ESSCertIDv2 is verified.

  • The Java SDK requires a Java Development Kit (JDK) version 1.8 installation.

  • Both the Java and C versions of the TSOP SDK include example code (the Java examples are accompanied by Javadoc documentation).

  • On Windows, the Java and C versions of the TSOP SDK software are installed, respectively, in:

    • C:\Program Files\nCipher\nfast\java\dsesdk\

    • C:\Program Files\nCipher\nfast\c\dsesdk\

  • On Linux, the Java and C versions of the TSOP SDK software are installed, respectively, in:

    • /opt/nfast/java/dsesdk/

    • /opt/nfast/c/dsesdk/

See the TSOP SDK User Guide for additional information.