Release Notes
Product Description
CipherTrust Application Data Protection for .NET Core provides APIs for performing cryptographic and key management operations using CipherTrust Manager.
Release Description
This release of CADP for .NET Core includes new features and enhancements.
Features and Enhancements
Added support for logging to Syslog Server. Follow the link for more information.
Added capability to set Transaction IDs in log entries.
Deprecated Support
.NET Core 3.1 is no longer supported.
The
Host
property is no longer required and will be deprecated in future release.The old log levels (LOW, MEDIUM, HIGH) are deprecated.
ProtectApp .NETCore 8.9 and earlier versions are now end of development.
Advisory Notes
It is recommended not to use the
Host
property; as this property will be deprecated in future release.Use the new log levels named NONE, ERROR, WARN (default), INFO, and DEBUG. If old log levels are used, they will be automatically set to WARN state.
Permissions
To run the CADP for .NET Core, it is important that users have the necessary read and write permissions for log files.
If users do not have appropriate permissions, the CADP for .NET Core will return an error.
.NET Standard
CADP for .NET Core version 8.13.0 is supported on .NET Standard 2.1.
Multi-threaded Application with Large Number of Threads and Sessions
When spawning a high number of threads with each thread opening a new session, and all threads getting spawned with a delay in milliseconds, the code takes few seconds to process SSL client certificates. On the other hand if the threads can share the session the delay in SSL Client Certificate processing can be avoided.
Known Issues
This section lists the issues known to exist in the product at the time of release.
Issue | Synopsis |
---|---|
CADP-11503 | Problem: The Special characters '&' and '<' are not supported in the Passphrase property.Workaround: Encrypt the Passphrase using PassphraseUtility and set the Passphrase Encrypted property to yes . |
PAN-3064 | Problem: The HMAC ComputeHash API throws an error when data is more than 4096 bytes in remote mode. Workaround: Use the GenerateMac API. |
Limitations
For SSL connection, if multiple NAE servers are specified in the properties file, the Common Name/SAN must be same for all the server certificates. The Host
property in the properties file only supports single value.
Compatibility Information
Key Manager
CipherTrust Manager 2.2 and higher versions.
Supported Platforms
CADP for .NET Core is tested on the following platforms:
Windows Server 2019 Datacenter
Red Hat Enterprise Linux 8.0 (Ootpa)
macOS 13.3
Ubuntu 20.04
Deliverables
This release includes the following components:
NuGet Package (CipherTrust.CADP.NETCore)
Product documentation is available on Thalesdocs
CADP for .NET Core samples are available on GitHub
We have attempted to make these documents complete, accurate, and useful, but we cannot guarantee them to be perfect. When we discover errors or omissions, or they are brought to our attention, we endeavor to correct them in succeeding releases of the product.