Your suggested change has been received. Thank you.

close

Suggest A Change

https://thales.na.market.dpondemand.io/docs/dpod/services/kmo….

Thales Logo

All

  • All
back

Release Notes

search

Please Note:

Release Notes

Product Description

CipherTrust Manager is the center of the CipherTrust Data Security Platform. It serves as the central point for managing configuration, policy and key material for data discovery, encryption, on-premise and cloud based use cases. It is the successor to both the Thales eSecurity (formerly Vormetric) DSM and the Gemalto (formerly SafeNet) KeySecure platforms.

Product Abbreviations

NameAbbreviation
CipherTrust Batch Data TransformationBDT
CipherTrust ManagerCM
CipherTrust Application Data ProtectionCADP
CipherTrust Application Key ManagementCAKM
CipherTrust Cloud Key ManagerCCKM
CipherTrust Data Protection GatewayDPG
CipherTrust RESTful Data ProtectionCRDP
CipherTrust Database Protection (formerly known as ProtectDB)CDP
CipherTrust Live Data TransformationLDT
CipherTrust Transparent EncryptionCTE
CipherTrust Transparent Encryption for KubernetesCTE-K8s
CipherTrust Transparent Encryption for RansomwareRWP
CipherTrust Transparent Encryption UserSpace (formerly known as ProtectFile FUSE)CTE UserSpace
CipherTrust Intelligent ProtectionCIP
CipherTrust Data Discovery and ClassificationDDC
CipherTrust Vaulted TokenizationCT-V
CipherTrust Vaultless TokenizationCT-VL
Data Protection on DemandDPoD

Release Description

This release is available on the Customer Support Portal in the following formats:

  • An upgrade file for physical k570, k470, and k160 CipherTrust Manager devices, and existing k170v Virtual CipherTrust Manager instances.

  • An OVA image file for deploying a new Virtual CipherTrust Manager on VMWare vSphere or Nutanix AHV.

  • A VHDX image file for deploying a new Virtual CipherTrust Manager on Microsoft Hyper-V.

  • A QCOW2 image file for deploying a new Virtual CipherTrust Manager on OpenStack.

In addition, 2.15.0 Virtual CipherTrust Manager will be available on the following public clouds, as the Community Edition:

  • Amazon Web Services: SafeNet Cloud Provisioning System

  • Google Cloud

    Note

    As 2.15.0 is not the default version, you must use the gcloud CLI to retrieve it.

  • Microsoft Azure: Available as a BYOL image in the Microsoft Azure Marketplace

  • Oracle Cloud

  • IBM Cloud

    • An OVA image file for deploying a new Virtual CipherTrust Manager on IBM Cloud VMWare.

    • A QCOW2 image file for deploying a new Virtual CipherTrust Manager IBM Cloud Virtual Private Cloud Gen2.

2.15.0 contains a number of new features and enhancements. Refer to Release 2.15.0 for details. For the list of known issues, refer to Known Issues.

Features and Enhancements

Release 2.15.0

Platform

  • Thales TCT k160 device: The external buttons may now be enabled to provide reset capabilities that will clear all objects off the CipherTrust Manager and power-off/shutdown the device. See the CipherTrust Manager k160 Quick Start Guide for details.

  • Added support for externally signed server certificate for Luna Network HSM root of trust.

  • Added a limited installation of the tcpdump utility to help troubleshoot network problems.

  • Added support for user password expiry reminders, configured through password policy. The expiry reminders are available as scheduled emails and as a UI banner display.

  • Changed the supported number of total log forwarder connections. CipherTrust Manager can now have a total of 64 log forwarder connections. Each Elasticsearch, Loki, and Syslog connection is counted towards the 64 connection total. In previous releases, there was no enforced limit, but log forwarder stability decreased after 25 connections were added.

  • Added support for SFTP to transfer the data to and from the CipherTrust Manager over SSH.

  • Added support for the cert_duration parameter in Client management profile.

  • Added capability to select individual keys during partial domain backups.

  • Added support to associate groups with the client during registration process.

  • If you change the auto-generated CA, the server certificate won't update to the new certificate on the next system restart. In this case, perform manual renewal to generate the new certificate from the modified auto-generated CA.

  • Client registration support is added for CADP for C clients.

  • Added capability to download the logs that are within specified start date and end date.

  • Support added for Key Checksum Value (KCV) for symmetric keys.

  • Extended quorum support for the following new operations:

    • ArchiveKey

    • RecoverKey

    • RevokeKey

    • ReActivateKey

    • CreateLink

    • UpdateLink

    • DeleteLink

    • UpdateAuthConnection (LDAP connection)

    • DownloadBackup

    • DownloadBackupDomain

  • Internal Luna HSM Clients updated in anticipation of Luna Cloud HSM end-of-support dates and to keep up to date with latest security patches, bug fixes, and performance improvements. Connections to Data Protection on Demand's Luna Cloud HSM service now use Luna HSM Client 10.5. Connections to other Luna HSMs use Luna HSM Client 10.6. This does not affect compatibility or configuration steps for HSM integrations.

Limitations

  • Policies created to manage authentication based on the Client IP parameter don't apply to the requests coming to the NAE and KMIP interfaces with "anonymous login" mode enabled. For details, refer to Client IP.

  • If a domain has more than 1000 cryptographic objects (keys and opaque objects), to fetch keys, it is recommended to use KeyNamesRequest instead of KeyQueryRequest. The response time of KeyQueryRequest is proportional to the number of keys on the CipherTrust Manager, therefore, it may lead to a timeout exception on the client side.

  • Currently, the log forwarders are not configured to use the system's proxy configuration. If proxy is configured, the log forwarders bypass the proxy servers.

  • The backup and restore of users and groups in a domain only works among the domains of different CipherTrust Managers. This feature does not support backup and restore among different domains of the same CipherTrust Manager.

  • During client renewal, if another client (which has Auth mode set to DN) already exists in the system with a matching subject DN, the client renewal may fail. This applies to external or local CA clients. For external CA certificates, delete the client to be renewed and register a new client with a new certificate and different subject DN.
    However, for local CAs, it is not required to delete the client to be renewed, rather set the do_not_modify_subject_dn field to false. Refer to Renewing Local CA Clients for details.

CipherTrust Secrets Management (CSM)

  • Added support to boot up Akeyless gateway when there is no internet connectivity after the first successful bootup.

  • Added a UI screen for Akeyless gateway when it is not reachable and displays 502 bad Gateway error.

  • Added Akeyless gateway metrics to the CipherTrust Manager Prometheus interface.

  • Added support to export Akeyless gateway logs to CipherTrust Manager via SSH and the logs API.

  • Added support for single-tenant Akeyless infrastructures in the Akeyless configuration.

  • Blocked the support for download and creation of customer fragments in Akeyless.

  • Changes in Akeyless configuration will be reflected on all nodes in a cluster resulting in a restart of the Akeyless service on all nodes.

  • The default key used for signing the tokens has been changed from HMAC to ECDSA with EC256 curve type for new installations of the CipherTrust Manager.

Limitation (s)

The "Forgot Password" feature for email is not supported through akeyless gateway on the CipherTrust Manager. Only "Forgot API Access Key" feature is supported. As a workaround, use the "Forgot Password" feature for email directly on the Akeyless website.

Application Data Protection

  • Added option to generate performance metrics for CRDP.

CCKM

  • Added support for asymmetric key types in AWS BYOK during key upload and rotation through API. Key sources now support the following key types:

    • CipherTrust Manager as a local or external key source supports AES (SYMMETRIC_DEFAULT), RSA, EC, and HMAC keys.

    • Luna HSM supports only AES and RSA keys.

    • DSM as a key source supports only AES keys.

  • Added support for Luna HSM as a key source for OCI EKMS (HYOK).

  • Enhanced the CCKM HYOK GUI to support changing the CipherTrust Manager's web interface port.

  • Ability to list all KMS containers added to CCKM through Discovery Schedule (GUI).

  • Added the column "Date Added to CCKM" to display the date when an AWS KMS account was added to the CCKM.

  • Ability to export and download the filtered key and KMS container metadata for AWS, Azure, Google, Oracle, and SAP clouds using the GUI.

    Also, removed limitation that allowed the export and download of only the metadata of 100 keys displayed on the first page of the search results for AWS, Google, and Azure clouds.

  • Ability to manage GCP key permissions (through Principals and Roles) using the GUI.

  • Added support for configuring the duration for which a Native or BYOK key can remain in the soft-deleted state before it is destroyed from CCKM (API).

  • Google Workspace CSE: Added support for migration of encryption keys from an old KACLS to a new KACLS.

  • Google Workspace CSE: Implemented changes to accommodate the new /certs API (per the latest Google spec 0.9.2).

CTE and CTE UserSpace

Information in this section applies to all types of CTE and CTE UserSpace Agents unless stated specifically.

CTE and CTE UserSpace

  • Added capability to fetch the latest capabilities from all the active clients present in the current CipherTrust Manager domain without requiring the Agent restart. This feature will be available from CTE 7.5.0 and CTE UserSpace 10.3.0.

  • Moved the Remove Agent Information button from the CipherTrust Manager administration GUI (Admin Settings > Properties) to the Transparent Encryption application (Transparent Encryption > Settings > Client Information and Capabilities).

  • CTE licenses are now enforced per domain on the CipherTrust Manager. The total number of clients registered on the CipherTrust Manager shouldn't exceed the total number of CTE licenses available on the CipherTrust Manager. Refer to License Enforcement for details.

CTE Specific

  • In the Profiles, changed the default Operation for Ransomware Protection from Monitor to Block.

  • In the GUI, changed the label of the GuardPoint type "Ransomware Protection" to "Ransomware Protection Only" to clarify that this type of GuardPoints can't perform encryption.

  • The header and footer of CTE reports downloaded as PDF now include the CipherTrust Manager username who generated the report and the timestamp when the report is generated. The CSV reports remain unaffected from this change.

Note

CTE resources of Container policies on the DSM cannot be migrated to the CipherTrust Manager using the backup/restore method. The Container policies are supported only on the DSM.

Notes on CTE UserSpace

CTE UserSpace is a kernel-independent file encryption product. The resources of CTE UserSpace clients running 10.0 and higher Agent versions are managed by the Transparent Encryption application on the CipherTrust Manager. These clients can't be managed by the ProtectFile & Transparent Encryption UserSpace application.

This release does not support the following features:

  • Kernel Compatibility Matrix

  • Agent and System locks

  • CBC and XTS keys

  • COS, IDT, and LDT policies and GuardPoints

Note

To manage the clients running the previous versions of the CTE UserSpace Agent, use the ProtectFile & Transparent Encryption UserSpace application only. Alternatively, upgrade those clients to CTE UserSpace 10.0 or a higher version.

DDC

  • Added support for the following new infotypes and classification profiles.

    • Keys: RSA Public, PGP Public, ECC Public, DH, DSA Public

    • Database Credentials: Oracle, MySQL, DB2, MongoDB, MSSQL, PostgreSQL, Redis

  • Added support for partial database scanning. To enable this, you need to configure the number of rows to be scanned. When you run a database scan, the scan results included data from the specified number of rows only.

  • Enhanced the GUI to display additional details (for example, owner and last modification date, etc.) retrieved as part of the scan execution.

Documentation

  • "Suggest An Edit" feature now enabled. Click the "Suggest An Edit" icon, which resembles a pen and paper (Suggest an Edit) in the top right of any page to send an email for suggested documentation content improvements.

Resolved Issues

IssueSynopsis
KY-78305During the cluster join operation, the joining node's cluster status is not displayed.
KY-78293If you run a cluster set up for about 30 days, the host-daemon service stops responding due to a file descriptor leak. This means that operations that access the CipherTrust Manager at the host system level fail. Some examples are restarting, retrieving system information, or kscfg commands. Error messages from host-daemon are visible in /var/log/hostd.log.
KY-77181Prometheus metrics with the node_ prefix are not exported. An error msg:fetching metrics for node_exporter:9100 failed with error: Get "http://node_exporter:9100/metrics is present in the debug logs.
KY-76510CCKM: [Intermittent] After migrating source keys from CCKM Enterprise in multiple domains on the CM, AWS key rotation might return resource not found error.
KY-74128, KY-74556If the LDAP connection property User's distinguished name (user_dn_field) is set to distinguishedName for LDAP Group Mapping, when the user or client authenticates, it loses all permissions in fewer than 5 minutes.
KY-73679Azure GUI: While importing an Azure certificate, if you select Yes for "Is Certificate File Password Protected?" and specify a password, later if you change to No without clearing the entered password, the password parameter is still picked up from the GUI.
KY-73123Salesforce: When MTLS is turned on, new certificates can't be uploaded to the Salesforce cloud.
KY-72549OCI HYOK: After a CipherTrust source key is deleted, it persists in the cache until the CipherTrust Manager services are restarted.
KY-72210AWS, Azure, and Luna HSM GUI: When adding a new container or changing the connection of a container, the GUI lists only 10 connections.
KY-72180Secure Start configuration changes on the CipherTrust Manager are not pushed to the CTE Agent.
KY-72032RSA signing is failing on the remote mode for CADP for JAVA when performing the EC encryption and RSA signing using the same connection.
KY-71691When a protection policy is created without selecting a character set, blank screen appears and an error is thrown on the console.
KY-71490If you create a key with six or more versions, and attempt to search for version 0 on the key's details page, there is no result.
KY-71226CCKM: Special character colon (:) is allowed in tag values for Azure certs, keys, and secrets, but returns error when creating/updating a key.
KY-71188Users in the Key Admins group are unable to create a new key version for a key owned by another user.
KY-71113The upgrade fails intermittently because the NAE service fails to start.
KY-71086When you upgrade from the CipherTrust Manager 2.10 or lower versions having auto-registered NAE clients, the NAE/KMIP service fails.
KY-70976The /v1/cluster/summary API response contains incorrect schema definition.
KY-70940Domain admin should not have permission to retrieve /v1/cluster/summary API.
KY-70904If you attempt to upgrade a Virtual CipherTrust Manager hosted on Microsoft Azure, the upgrade sometimes fails with the message Errors were encountered while processing:grub-pc present in the upgrade log.
KY-70603If you attempt to add an HSM-anchored domain through the CipherTrust Manager GUI, the operation times out with the error Failed to create domain kek in the debug logs.
KY-69666If you attempt to join a node to a cluster using the web console UI, the requests fails, and within a few minutes, add the node to the cluster allowlist, the join request sometimes re-runs successfully.
KY-69460The scan configuration parameter to control the volume of Data Objects configures the scan as if the user always selected the 'Maximum - No saved info' value.
KY-67373If two or more required user approvals are done within the interval of 1-2 seconds, and after the total required approvals the operation gets executed, the quorum still appears in the approved state instead of the executed state.
KY-66778Response schema for the get /v1/vault/keys2/ and Export v1/vault/keys2/{id}/export API doesn't match the actual response data.
KY-65962OCI test connection fails when an OCI user is part of an identity domain.
KY-65947If you attempt to add an alarm configuration from a specific record using the UI's Add Alarm Config from Record option, the conditions for boolean type fields are populated incorrectly. For example, the UI sets conditions such as input.success == "true,boolean" or input.success == "false,boolean" which are not in compliance with Open Policy Agent's Rego query language, and will not trigger alarms correctly.
KY-64767After upgrade, if a system was previously configured to send host syslog messages, USB syslog messages may not appear.
KY-63116If you restart all services, the Akeyless console and Akeyless gateway services return a 502 bad gateway error, and display the message "Oops! Something went wrong..." in the browser, instead of displaying in the "Following services are starting up:" message on the CM login page.
KY-62820Single hex-digit is allowed while creating a Character Set.
KY-62708The 'SSH Private Key' infotype does not show any matches for scans over its respective datasets, although the matches for 'SSH Private Key' are getting covered in another infotype called 'Private Key'. Because both of these infotypes are under a single classification profile 'Secrets', in effect there will not be any incorrect match difference for scans over the 'Secrets' classification profile.
KY-62563After auto-registering a client, the server audit record for creating a token has an incorrect value for client_id.
KY-62463The opaque objects corresponding to the connection are deletable, by default.
KY-59066Displayed Domain Level Usage for CTE Clients on Licensing page shows client usage for all domains instead of just the current domain.
KY-58714When OCR is enabled with low memory usage (e.g. 1GB RAM), the scan produces less sensitive matches. Therefore, you should manually select a minimum of 2GB RAM for scanning OCR datasets.
KY-55916Full DS scan on SAP HANA fails with an "Internal Error".
SAP HANA scans on specific target paths (the schema to which the user has privileges) are successful. The database can contain schemas to which the user does not have privileges. The scan on a full datastore will try to scan all schemas that are present in the database and as a result the scan will fail due to the lack of privileges on some schemas.
Note: For SAP HANA, the full data store scan is not supported. You need to specify at least one path.
KY-81007DatabaseID is not set in metadb ing_property.

Advisory Notes

This section highlights important issues you should be aware of before deploying the CipherTrust Manager. There is also a full list of known issues associated with the release.

Increased Disk Space and Cluster Node Downtime Required for Upgrade from CipherTrust Manager 2.13.x or lower

Due to a major internal database upgrade, CipherTrust Manager upgrade requires more free disk space and cluster node downtime when upgrading from CipherTrust Manager 2.13 or below.

  • You require 35 GB of free disk space to exercise the upgrade.

  • In-place online cluster upgrade requires additional downtime for cluster nodes. An individual cluster node might be unavailable for 10 minutes or more.

  • During upgrade, the message NOTICE: skipped replication for captured CCL command "LOCK TABLE in replication sets (kylo) is displayed multiple times. This is an expected part of backend database configuration and does not indicate a problem.

Required System Volume Disk Size for Virtual CipherTrust Manager

If you have deployed at a Virtual CipherTrust Manager with the previous evaluation disk size of 50 GB, you need to increase the system volume disk space to exercise the upgrade. We recommend at minimum 100 GB.

NextGen KeySecure and ProtectFile End-of-Support

NextGen KeySecure firmware and the ProtectFile connector reached End of Support in December 2023.

In most cases, you can upgrade from NextGen KeySecure to CipherTrust Manager directly. If you are running the legacy k450 or k460 hardware model, you must migrate data to the k470 or k570 model.

We strongly recommend migrating ProtectFile to CTE or CTE Userspace.

Quorum

Do not enable quorum on the ManagePolicyAttachment and DeletePolicy operations until all the CipherTrust Manager nodes in a cluster are upgraded to 2.10 or a higher version.

SMB Connection

The Host and Port fields must be specified together, or do not specify any of them. If Host and Portare not specified while creating an SMB connection, these fields cannot be added later.

Recommendation for Secure Initialization Vector in DESede CBC, AES CBC, and AES GCM Encryption Requests

When generating a new AES or DESede key CipherTrust Manager currently generates and stores a Default IV associated with the new key. This is mainly used to support specific legacy integrations and applications.

We strongly recommend future crypto applications use a secure, unique initialization vector (IV) for each AES CBC, AES GCM, and DESede CBC encryption request, rather than relying on a default IV provided by CipherTrust Manager for the security of your data. For example, unpredictable, unique IVs for AES CBC requests protect against oracle attack techniques such as ROBOT, DROWN, POODLE, and BEAST.

We recommend to use CipherTrust Manager's random number generation to produce secure IVs, or you can provide your own IV with each AES CBC, AES GCM or DESede CBC encryption request following the security guidelines for constructing secure IVs in NIST SP800-38A and NIST SP800-38D.

Caution

The IV value used for an encryption request is needed to decrypt the data later.

In the KMIP interface, always set the RandomIV object in the Cryptographic Parameters attribute to true or provide your own secure IV in the Request Payload as an IV/Counter/Nonce object.

In the REST and NAE interfaces, use CipherTrust Manager's random number generation to produce secure IVs for cryptographic requests, or provide your own secure IV.

Some Key States Change After Upgrade

After upgrade from 2.4 some key states are remapped as a result of harmonizing NAE-only key states. In most cases, the allowed operations for a key remain the same before and after upgrade, so key usage is not disrupted.

As you cannot upgrade directly from 2.4 to 2.15, these changes take effect when you first upgrade from 2.4 to an intermediate minor version, 2.5, 2.6, or 2.7.

  • When a key has an NAE state of Retired and the deactivation date is set in the future, the key is set to Deactivated immediately upon upgrade. No cryptographic operations are allowed.

  • When a key has an NAE state of Restricted and Protect Stop Date is set in future, the key is set to Active and the Protect Stop Date is set to the current time. Decryption, signature verification, unwrapping, and MAC verification are allowed.

  • When a key has an NAE state of Active and Activation Date is not set, the activation date is set to the current time. All cryptographic operations are allowed.

  • When a key has an NAE state of Active and Activation Date is set in the future, the key is set to a Pre-Active state and the Activation Date is retained. No cryptographic operations are allowed until the Activation Date is reached.

  • When a key has a state of Deactivated before upgrade, its state will be unchanged after upgrade. However, the allowed operations for the Deactivated state change for 2.5. The key loses its ability to decrypt, verify signatures, unwrap, and verify MACs. You can re-activate the key after upgrade and set the ProtectStop date to restore those operations.

System Upgrade and Downgrade Supported Releases

System upgrades on a single unclustered device have been tested from releases 2.12.x, 2.13.x, and 2.14.x.

Note

You cannot upgrade from 2.11.4 or higher 2.11.x version to 2.15.x, either directly or through an intermediary version, and then deploy 2.15.x in production. This is not supported as these patches will be released after 2.15 and contain bug fixes not present in 2.15. Upgrading from these patches to 2.15 can re-introduce bugs. If you are using one of these 2.11 patches, wait for future CipherTrust Manager releases to obtain the new features introduced in 2.15.

An unclustered CipherTrust Manager can be downgraded to the previous minor version. For release-specific upgrade/downgrade information, refer to the release notes for your release.

Warning

As we cannot guarantee stability, we strongly recommend using downgraded systems for test environments only. Do not use a downgraded CipherTrust Manager in a production environment.

Refer to the System Upgrade page for instructions to perform an upgrade or downgrade.

The cluster upgrade section provides instructions to perform an upgrade on a cluster of devices. Supported upgrade paths depend on the method used to upgrade the cluster.

  • Cluster remove/rebuild is supported from 2.12.x, 2.13.x, and 2.14.x.

  • In-place cluster upgrade is performed from one minor version at a time, so there is no limit on starting version.

Restoring a backup from release 2.12 or later is supported; however, restoring a newer backup to an older version is never supported.

Protect the ksadmin Private SSH Key

The private SSH key for the ksadmin account is critical to system security and must be carefully protected. Failure to do so could allow an attacker to compromise the system.

TLS/SSL Must be Enabled in a Production System

As it may be useful for troubleshooting, it is possible to disable TLS/SSL for the NAE interface. This will lead to an insecure system. Therefore, TLS/SSL should always be enabled for a production system.

Key Usage Mask Selection

If you want to perform any operation (for example, Wrap/Unwrap) from the NAE/KMIP connector, set the usage mask explicitly for that operation while creating keys through UI.

CipherTrust Secrets Management (CSM)

External Secrets Manager (ESM)

  • ESM has been renamed Universal Secrets Connector (USC). With gateway version 3.58.0 or greater, both 'usc' and 'esm' commands are supported.

  • With upcoming CipherTrust Manager 2.15.0 and older versions, users need to replace 'usc' with 'esm' to use external secrets. For example, akeyless esm list --esm-name <> to akeyless usc list --usc-name <>.

DDC

Upgrading DDC

After you upgrade to version 2.11 you will not be able to downgrade it to any of the previous versions.

Clusters

  • Only one CipherTrust Manager node in the cluster can have DDC activated. To access DDC, create a new DNS entry to point to the active CipherTrust Manager node.

  • DDC functionality cannot be accessed through the CipherTrust Manager FQDN. DDC requests sent to an inactive CipherTrust Manager node fail (and return the impression that DDC fails randomly).

Licensing

Overlapping licenses are not supported (except for the trial license).

EOS for Legacy Reports

The support for Legacy Reports has been dropped in DDC 2.11.

EOS for KCT Datastore

End of Support for KCT Datastore Format in DDC 2.11.

Upcoming End of Support for Platforms and Features

  • Linux 2.4 Node Agents

  • Email Targets - Microsoft Exchange (EWS)

  • Microsoft 365 - Exchange Online (EWS)

  • Web Browser - Internet Explorer

Compatibility

This section documents known compatibility topics to be considered before deploying the CipherTrust Manager.

TLS Compatibility

This table identifies the supported TLS versions for each of the CipherTrust Manager interfaces. The default minimum value reflects the default minimum_tls_version setting. This setting controls the lowest acceptable TLS version allowed for connections to the interface.

InterfaceMinimum TLS versionMaximum TLS versionDefault Minimum TLS version
Web UITLS 1.2TLS 1.3TLS 1.2
NAETLS 1.0TLS 1.3TLS 1.2
KMIPTLS 1.0TLS 1.3TLS 1.2

Caution

TLS 1.0 and TLS 1.1 support will be discontinued in a future release.

By default, CipherTrust Manager accepts the following ciphersuites for TLS 1.2+ connections:

  • TLS_AES_256_GCM_SHA384 (TLSv1.3)

  • TLS_CHACHA20_POLY1305_SHA256 (TLSv1.3)

  • TLS_AES_128_GCM_SHA256 (TLSv1.3)

  • TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384

  • TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384

  • TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256

  • TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256

TLS Deprecation Notices

  • Use of TLS 1.0 and 1.1 protocols is deprecated. This support will be discontinued in a future release. Upgrade all applications connecting to CipherTrust Manager interfaces to TLS 1.2 or higher as soon as feasible.

  • Use of the following CBC-based ciphersuites is deprecated, and support will be discontinued in a future release:

    • TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384

    • TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256

    • TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384

    • TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256

    • TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA

    • TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA

    • TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA

    • TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA

    • TLS_RSA_WITH_AES_256_CBC_SHA

    • TLS_RSA_WITH_AES_128_CBC_SHA

Client Platforms

The following client Platforms are supported by the CipherTrust Manager.

Caution

Older versions of most client platforms (versions earlier than the minimum versions listed below) may have incompatible TLS clients. We recommend testing older versions of client platforms in a non-production environment to ensure proper functionality.

For the purpose of transitioning from SafeNet KeySecure Classic, you can temporarily connect to CipherTrust Manager with TLS/SSL disabled on the CipherTrust Manager NAE interface; however, this is recommended only in a non-production environment.

CipherTrust Application Data Protection

  • CADP for .NET Core: minimum version 8.11.0

  • CADP for C: minimum version 8.14.0

  • CADP for Java: minimum version 8.13.1

CipherTrust Application Key Management

  • CAKM for Oracle TDE: minimum version 8.10.0

  • CAKM for Microsoft SQL Server EKM: minimum version 8.5.0

CipherTrust Cloud Key Manager

Minimum version 1.6.3.20532

CipherTrust Database Protection

  • CDP for Oracle: minimum version 8.12.0

  • CDP for MSSQL: minimum version 8.12.0

  • CDP for DB2: minimum version 8.12.0

  • CDP pdbctl: minimum version 1.5.1

  • CipherTrust Teradata Protection: minimum version 6.4.0.12

  • Transformation Utility: minimum version 8.4.3

CipherTrust Transparent Encryption

Minimum version 7.0.0

CipherTrust Transparent Encryption UserSpace

Minimum version 10.2.0.83

CipherTrust Transparent Encryption for Kubernetes

Minimum version 1.0.0

CipherTrust Vaulted Tokenization

Minimum version 8.7.1

CipherTrust Batch Data Transformation

Minimum version 2.2.0.2816

CipherTrust Vaultless Tokenization

Minimum version 2.5.2.19

ProtectFile

Minimum version:

  • ProtectFile Windows 8.12.3

  • ProtectFile Linux 8.12.3, 8.12.4p02 (for migration to CTE)

The latest three GA versions of ProtectFile are tested with CipherTrust Manager. Older versions are expected to work, but they are not tested explicitly.

Data Discovery and Classification Agents

Linux minimum kernel version is 2.6.

There are no changes in Agent requirements if you are upgrading from CM 2.4 to 2.5.1. If you are upgrading from a version older than 2.4 please refer to Upgrading Agents.

Note

ODBC driver for Microsoft SQL: To connect to Microsoft SQL, DDC Agent requires the ODBC drivers to be installed on the host. If DDC cannot find a suitable agent, make sure that these drivers are installed. If necessary, upgrade them to the latest available version. Thus, if your MSSQL Server is configured with TLS 1.2 only, install the ODBC Driver 17 for MSSQL Server.

TDP Version Compatibility

Data Discovery and Classification requires TDP 3.1.5.1 or newer.

Known Issues

This section lists the issues known to exist in the product at the time of release.

CipherTrust Manager

ReferenceSynopsis
KY-93937Problem: If you configure an LDAP connection for CipherTrust Manager user management, and set up group maps in a child domain, group permissions are not applied when users are logged into the child domain.
KY-92312Problem: If you attempt to configure an HSM root-of-trust on the CipherTrust Web UI, the UI sometimes displays a timeout error, but the HSM configuration succeeds.
Workaround: Wait two minutes and refresh the page to see if the HSM configuration succeeded. If the HSM configuration fails, retry with the ksctl hsm setup --timeout 120 CLI command.
KY-92080Problem: If the client certificate is renewed before its expiration date, on the original expiration date, the client goes into the expired state, which breaks communication between the client and the CipherTrust Manager.
Recommendation: Before the certificate expiration date, do either of the following:
• Re-register the client with the CipherTrust Manager using the new client certificate.
• Upgrade the CipherTrust Manager to 2.16.1 or higher.
Workaround: After the client moves to the expired state, renew the client certificate as a client administrator. Refer to Renewing client certificates for details on renewing client certificates. For CTE-specific instructions, refer to Client Certificate Renewal.
KY-91730Problem:If a network interface connection goes down on a node, the cluster status for that node displays as ready on other nodes, even though the node is unreachable.
KY-91454Problem: Before upgrading the CipherTrust Manager, if you change the setting (hide/show) of a column in a table, then after the upgrade, the order of the column is changed and the blank screen error may be displayed.
Workaround: Reset the columns setting, run the update user API, and set "user_metadata": {"persistedData": {}}.
KY-89062Problem If you attempt to create a partial domain-scoped backup in the CipherTrust Web UI, and toggle the number of results for Domain Backup Key in the Backup Properties screen, sometimes available domain backup keys no longer display. This occurs if you have more than ten domain backup keys.
Workaround: Retain ten or fewer domain backup keys.
KY-88925Problem: If you add connections to multiple Luna Network HSM V1 partitions in HA mode in connection manager, CCKM Luna key source and HSM-anchored domains are not usable.
Workaround: Use Luna Network HSM V0 partitions for HA groups formed through the connection manager. Delete existing connections to Luna Network HSM V1 partitions.
KY-84562Problem: Deactivating the CipherTrust Manager Full Trial license does not deactivate individual trial licenses.
Workaround: Reactivate the Full Trial license and re-attempt deactivation.
KY-80554, KY-81695Problem: If a client certificate contains both OCSP and CRL URLs, the certificate revocation check (for NAE and KMIP clients) only considers the OCSP and never falls back to check the CRL even if the OCSP URL is inaccessible.
KY-84081Problem: License count doesn't increase for KMIP auto-registered clients. However, the the clients are registered successfully.
KY-78303Problem: If you configure OIDC authentication for CipherTrust Manager users with an identity provider with a short id_token lifetime, users are logged out of their sessions frequently, every time the id_token expires. The error message Wrong username or password is displayed.
KY-73963Problem: Listing latest version of the keys throw an internal server error when a key policy exists on the CipherTrust Manager.
Workaround:
• Either delete the key policy present on the CipherTrust Manager.
OR
• Don't list the latest version of keys using Latest Version Only check box on the CipherTrust Manager UI.
• Don't list latest version of keys using the filter version as -1 in the API/CLI.
KY-80452Problem: If you create a log forwarder connection with an invalid hostname, and then add a log forwarder, logs stop forwarding from every configured log forwarder.
Workaround: Test all log forwarder connections before creating log forwarders. If you have already created a faulty log forwarder connection, edit the connection to use the IP address value instead of the hostname.
KY-80776Problem: When migrating KMIP keys from DSM, the migration utility migrates the key's application specific information incorrectly, therefore the key link page on the UI appears blank.
Workaround: Update the meta.kmip.app_specific_info of a key correctly as an array object. Please contact customer support for assistance.
KY-76147Problem: If you initiate an upgrade, and restart the CipherTrust Manager before being prompted, CipherTrust Manager services sometimes fail to restart.
Workaround: Contact customer support if your devices has hanging services in this scenario. While performing upgrades, confirm the upgrade has completed before restarting the CipherTrust Manager.
KY-68495Problem: When you change the port of the default interfaces (NAE, KMIP & WEB) and take a backup of the CipherTrust Manager, while restoring this backup on any CipherTrust Manager, the /v1/backupStatus API reports the incorrect status and also the success audit record for restore doesn't appear.
KY-52664Problem: [NAE] When sending data in bulk requests, encryption fails intermittently.
KY-77452Problem: Salesforce sandbox test connection fails when using domain_name field.
KY-75452Problem: The auto-registered clients don't get auto-renewed after expiration.
Workaround:
• For manually registered clients, renew the clients.
• For auto-registered clients, delete and re-register the clients.
KY-69549Problem: If you have configured an LDAP connection to manage CipherTrust Manager users and the LDAP server is not reachable, you cannot retrieve users with "return_groups=true" on GUI, API, or CLI.
Workaround: Resolve LDAP connectivity issue so that the CipherTrust Manager can retrieve user's group details.
KY-66205Problem:When custom interfaces are created in a cluster, with certificate auto-generation turned off, the node on which the interface is created accepts the client connections. However, on other nodes, the connection fails.
Workaround:Update the local trusted CA on the other nodes.
KY-65821Problem: The ls -l command fails in SSH sessions as ksadmin user, in the /home/ksadmin and /opt/keysecure directories.
Workaround: Use ls without the -l flag.
KY-64600Problem: If you create multiple automatic key rotation scheduled jobs, and they are scheduled to run at the same time, a key rotation intermittently fails with the message 'There is an ongoing key rotation job, cannot add another'.
Workaround: Schedule automatic key rotation jobs to run at different times from one another.
KY-64597Problem: Typing a % (percent character) into the embedded API Guide for GET operations leads to inconsistent results, and sometimes crashes the page.
Workaround: As a best practice, avoid naming resources with the % character. If you must retrieve a resource with a % in its name, use the UI or CLI to do so.
KY-64562Problem: Policy attachments can be detached (deleted) from system policies even though those policies are read-only.
Workaround: Restart CipherTrust Manager to populate the deleted system policy attachment.
KY-66351, KY-63083Problem: Clients registered in a deleted domain are not excluded from the License usage.
Workaround:
1. Log on to the root shell.
2. Delete the entries of the clients registered with the deleted domain from the database.
KY-61892Problem: The NAE and KMIP clients get auto-registered even if the system property, ALLOW_USER_IMPERSONATION_ACROSS_DOMAIN, is disabled and the user impersonated by the client certificate is not created in the root domain and the registration token is generated in the root domain.
However, the client wont be able to communicate using impersonated user for interface mode 'TLS, verify client cert, user name taken from client cert, auth request is optional'.
KY-61722Problem:Deleting a domain that contains an NAE (ProtectApp) client returns status code 500.
KY-61373Problem: The support for ProtectV is removed from the CipherTrust Manager, but the ProtectV license still shows up after the upgrade from version 2.10.0 to 2.12.0.
KY-61196, KY-64823Problem: In a CipherTrust Manager cluster, if two nodes are disconnected and you create the same user on both nodes and update them with same DN, on re-connect, duplicate users get created.
Workaround: Duplicate users cannot be authenticated as regular users, therefore, function as redundant users. It is recommended to delete these users to avoid any confusion. However, if you don't delete them, you will be allowed to log in with one user only.
KY-61054Problem: While migrating from KeySecure Classic to CipherTrust Manager, if the local CA is signed by an external CA, the migration will fail for the local CA even if the external CA is added to the known CA list.
Workaround: If an externally imported CA and its certificates are used on the NAE/KMIP interface of KeySecure Classic, the CA will be migrated as an external CA, but the certificates will not be migrated to the CipherTrust Manager.
Therefore, to use the same certificate for the NAE/KMIP interface on the CipherTrust Manager, select the migrated external CA and upload its certificate manually by editing the NAE interface on the CipherTrust Manager.
Similarly, if a local CA and its certificates are used on the NAE/KMIP interface of KeySecure Classic, use auto-generation or issue a new certificate and upload the certificate to the interface.
KY-60187, KY-60211Problem: Can't configure KMIP connection in domains when the username is specified in the KMIP auth tag request.
Workaround: Send KMIP requests without the auth tags and change the interface mode to TLS, verify client cert, user name taken from client cert, auth request is optional.
KY-56426Problem: Deleted groups still show up in the key details information on the CipherTrust Manager.
KY-56213Problem: If you attempt to create a Luna Network HSM STC partition in connection manager and upload a partition identity file, the upload fails with the error Code 14: NCERRInternalServerError: unexpected error. This is because CipherTrust Manager doesn't recognize the format of the partition identity file downloaded from Luna Network HSM.
Workaround: Use the Linux command base64 -wo on the partition identity file to convert it to base64 format, and then re-attempt the STC partition creation.
KY-55987Problem: If you have a scheduled job set to run on a particular cluster node, remove the node from cluster, and then rejoin it, the scheduled job runs on all cluster nodes instead.
Workaround: After making any changes to cluster membership, update the scheduled job run_on parameter to reflect the current cluster node ID.
KY-55416Problem: Alarms table does not support retention policy. Record based alarms will fill up the table.
Workaround: Contact customer support.
KY-54039, KY-55544Problem: Syslog message redirection from child domains to parent domains stops when 30 or more child domains enable this feature.
KY-53681Problem: You cannot delete the default backup key if it is uploaded from another domain.
Workaround: Contact customer support.
KY-53100Problem:Acknowledging/clearing alarms changes alarm's source and source_id to the cluster member node which updated the alarm.
KY-52137Problem: If you rotate the root of trust key for an HSM and then reboot the appliance, services fail to start up and the reboot does not complete. This can happen when the HSM contains two root of trust keys with the same name, and the wrong HSM key is loaded.
Workaround: If you are stuck in services startup, access the HSM with another client, and re-label one of the duplicate keys.
KY-51664Problem: When nShield Connect HSM is configured as root of trust, there are intermittent connectivity issues. The nShield HSM occasionally returns a ServerAccessDenied error, and CipherTrust Manager raises the HSM is offline system alarm.
Workaround: Wait for connectivity issues to resolve after a few automatic reconnection attempts.
KY-49376Problem: If a CipherTrust Manager is deployed at a version lower than 2.8, a CTE license is installed, and the CipherTrust Manager is upgraded to 2.8 or higher, the displayed CTE license usage count is incorrect.
Workaround: In a domain with pre-existing CTE clients, create or register a new CTE client, and then delete the new client.
KY-49126Problem: After the external CA is uploaded on the CipherTrust Manager, the GN and DC fields are not displayed as part of the record.
KY-48284Problem: Domain backups with local users cannot be restored into another domain in the same cluster.
Workaround: Restore the backup to a CipherTrust Manager in a new cluster, or to a different CipherTrust Manager instance which isn't clustered.
KY-47184Problem: After upgrade, services sometimes fail to restart with an error message starting with Forcing migration for retry.
Workaround: Contact customer support to recover from this state.
KY-39354Problem: Scheduled Partial Domain Backups and Domain Backups fail when there is an SCP connection. The backup file is created on CipherTrust Manager, but it is not forwarded through SCP, and the file is invalid.
Workaround: If scheduled backup through SCP is needed, create a System Backup.
KY-39235Problem: If a user fails to log in to a domain, an audit record is created in the root domain instead of the intended domain.
KY-27450Problem: Local Certificate Authorities (CAs) do not allow commas , in any of the fields.
Workaround: Configure an External CA instead. Use a backslash \ in the Distinguished Name (DN) while creating a user if you are using certificate based login. For example, C=IN,ST=UP,L=Noida,O=Thales\,INC,OU=ENC,CN=test is an accepted value.
All other printable characters are allowed, as per RFC 5280 definition of PrintableString. @ and & are also allowed, beyond the definitions of the RFC.
KY-25152Problem: You cannot pass in a custom SSH key via cloud init on Oracle Cloud instances for initial launch. You also cannot use cloud-init to auto-generate an initial password for the admin user on Oracle Cloud instances.
Workaround: Login to the GUI to enter the SSH public key on initial access. You can also change the password for the admin user on this login.
KY-17338Problem: KMIP: LDAP users cannot be set in the KMIP profile.
Workaround: To use LDAP authentication, use the KMIP auto registration.
KY-11517Problem: ProtectApp Application: The Invalid algorithm string error occurs when signing data with SHA384withRSA/PSSPadding.
KY-7289Problem: When migrating a KMIP application from KeySecure Classic to CipherTrust Manager, for encrypt/decrypt operations, the KMIP server always uses the ECB mode regardless of the provided mode.
Workaround: For migration use cases, if Cryptographic Usage Mask is specified with the CBC mode on KeySecure Classic:
  1. Decrypt the data using KeySecure Classic.
  2. Encrypt the data with keys stored on CipherTrust Manager.
KY-7288Problem: When migrating from KeySecure Classic to CipherTrust Manager, AES-GCM encrypt/decrypt operations, AuthenticatedEncryptionTag is returned appended to CipherText.
Workaround: For migration use cases, when using AES-GCM with KeySecure Classic:
  1. Decrypt the data using KeySecure Classic.
  2. Encrypt the data with keys stored on CipherTrust Manager.
After migration to CipherTrust Manager, the AAD tag is not appended to the data. It is sent as a separate tag.
KY-504Problem: Integration with CloudHSM Cluster: Fail-over is not supported between different ENI IPs within an AWS CloudHSM cluster.
NC-2063Problem: If a user is deleted (or LDAP connection name changes), they fail to display in the keys table.

CipherTrust Application Data Protection (CADP for C)

IssueSynopsis
KY-47385Problem: If you migrate a non-deletable VAE key from Data Security Manager to the CipherTrust Manager, the imported key is shown as "deletable".
Workaround: After migration, edit the key attributes on the CipherTrust Manager to make it non-deletable.

CipherTrust Cloud Key Manager

IssueSynopsis
KY-92814Problem: CCKM GUI: After applying a filter to a column, if you navigate away from the screen and return back, the filter may not persist.
Workaround: Apply the filter again.
KY-92752Problem: If the AWS XKS is connected and CCKM is disconnected, you cannot update the External Custom Key Store details of an AWS KMS Account.
Workaround: You can disconnect the AWS Console and CCKM, then update the External Custom Key Store details of an AWS KMS Account.
KY-87019Problem: GWS GUI: When creating a new endpoint, the Identity Provider list displays only 10 identity providers.
Workaround: Use the API to create a new endpoint using the required identity provider.
KY-86980Problem: Salesforce GUI: When adding a new Salesforce key using DSM to configure the source key, the DSM Domain field on the Configure DSM Key screen may not display all the available DSM domains.
Workaround: Use the API to add a new Salesforce key by uploading a DSM key created in a specific DSM domain.
KY-92234Problem: AWS GUI: AWS connection linked with an AWS KMS account can't be changed.
Workaround: Run the patch /v1/cckm/aws/kms/{id} API to change the AWS connection.
KY-91499Problem: AWS GUI: Key rotation schedule can't be updated.
Workaround: Update the key rotation schedule using the API.
KY-91459Problem: CCKM UI: Scheduler can't be linked to AWS HYOK keys.
Workaround: Link the scheduler using the API.
KY-89969Problem: Cloud key management APIs don't work behind a proxy for Google EKM, Google Workspace CSE, Microsoft DKE, OCI HYOK, SAP, DSM, and external CipherTrust Manager.
Workaround: Add the proxy URLs for your cloud to the proxy exception list and allow this URL in the firewall. Refer to URLs to Whitelist for Running CipherTrust Manager Behind Proxy.
KY-89038Problem: GCP GUI: Only 100 key rings are listed on the Add Key Rings screen even if more than 100 key rings exist.
Workaround: View all the existing key rings using the API.
KY-86632Problem: Azure GUI: When adding a new Azure key, the Vault drop-down doesn't display all available vaults.
Workaround: If a vault is not displayed on the GUI, use the API to create keys in the desired vault.
KY-84440Problem: AWS GUI: Alias specified when linking an unlinked AWS HYOK key is not attached to the key.
Workaround: Add the alias on the detail page of the key.
KY-82370Problem: In a configuration with multiple Luna Network HSMs in high availability mode configured in the connection manager, when the HSM in use becomes unavailable, CCKM occasionally doesn't failover to the remaining HSMs.
KY-81514Problem: SFDC: Refresh operations on CCKM don't remove certificates that are deleted from the SFDC console.
KY-80597Problem: CCKM Admin users can't create the add KMS container schedules.
Workaround: Create the add KMS container schedules using the CipherTrust Manager admin role.
KY-80439Problem: While editing a Cryptospace service account, the entry is removed from the list and added back to the Add Service field on the top. lf you keep clicking the Edit option on the next entry, it causes the previous entry to disappear.
KY-78298Problem: SAP GUI: The Algorithm filter on the SAP Keys page doesn't show the RSA 8192 algorithm.
KY-77916Problem: AWS GUI: The Accounts column filter on the AWS Keys page returns no results when the table is reset.
Workaround: To see the accounts list, either refresh the page or navigate away from the page and return to the Keys listing page.
KY-77825Problem: CCKM GUI: Account filtering doesn't work for the AWS keys and saved policies.
KY-76021Problem: SAP GUI: On the SAP Data Custodian Groups page, the Application column and filter show blank values for the Backup/Wrapping Keys (BWK) and SAP Analytics Cloud (SAC) applications.
Workaround: Search for the BWK and SAC applications by Group Name.
KY-76609Problem: The custom policy statement doesn't update when rotating an AWS key on which the encrypt permissions are disabled (the "Disable Encrypt Permissions on Current Key" check box is selected).
KY-76521Problem: CCKM: Intermediate keys in Luna HSM aren't cleaned up when the sync operation is performed.
KY-74887Problem: Google EKM: When an existing EKM endpoint (key URI hostname) is updated to include a port, the key URI is displayed without the protocol (https://).
Workaround: When using this endpoint on the Google console, manually add (https://) at the beginning of the endpoint.
KY-73919Problem: Synchronize Salesforce certificate operations don't display error messages in audit logs.
KY-72770Problem: OCI: The origin field of asymmetric HSM keys with External BYOK as Origin Type is set inconsistently for initial and subsequent versions. The origin of the initial version is correctly set to EXTERNAL. However, the origin of subsequent versions is incorrectly set to INTERNAL.
This issue is at the Oracle end.
KY-72067Problem: GUI: Salesforce mTLS connection doesn't work when the Salesforce connection to the CipherTrust Manager is configured using the Password authentication.
Workaround: Use the authentication type of Certificate or Client Credential (My Domain) when creating the Salesforce connection to the CipherTrust Manager.
KY-71243Problem: GUI: Intermittent: If the key source has a large number of keys (say, in thousands), fetching all the keys may take a significant amount of time or the request may time out.
Workaround: Use the API or CLI to fetch the keys.
KY-71194Problem: AWS GUI: Intermittent: If the CipherTrust Manager has a large number of keys (in thousands), while adding an external key store, request to fetch the health check keys times out. The Health Check Key drop-down list does not display the existing keys.
Workaround: Add the external key store using the API or CLI.
KY-65165Problem: SAP: A delete key job remains in the PENDING state for long time and fails intermittently. This issue is at the SAP end.
KY-56952Problem: GCP GUI: ACLs of Google Projects for cryptospaces and cryptospace endpoints can't be updated with the "CCKM Users" group.
Workaround: Use the API to update the ACLs with the "CCKM Users" group.
KY-42082Problem: SAP Data Custodian: SAP key activity report doesn't show any data. This issue is at the SAP end.
KY-31186Problem: If your proxy server does not support HTTP CONNECT, the CCKM Google cloud connection cannot use the CipherTrust Manager's proxy feature with a certificate.
Workaround: Add an exception (cloudkms.googleapis.com) with no_proxy or use the proxy with username and password, and restart the services.
KY-17213Problem: When a CipherTrust Manager key is created using an auto rotation schedule on AWS cloud native key, its owner is set to "Global".
Workaround: A CipherTrust Manager administrator can assign the ownership of the key to a desired user in the CCKM Users group.

CipherTrust Database Protection

IssueSynopsis
KY-82266Problem: CDP: A non-admin user of the ProtectDB Users group can't migrate tables on the CipherTrust Manager.
KY-72709Problem: Can't recognize domain user in user mapping.
Workaround: Use the pdbctl utility to add user mapping.
PDB-3293Problem: If datatype of a column changes from char family to blob after migration, the Return replacement value option for the Error Replacement feature does not work.

CipherTrust Data Discovery and Classification

IssueSynopsis
KY-80595Problem: After upgrading the CipherTrust Manager, editing an existing scan having "No Info" set for the Amount of Data Object Volume from Advanced Configuration results in Validation errors: matchDetail must be one of [minimum balanced maximum].
Workaround: Select "High - minimum info" for Amount of Data Object Volume from Advanced Configuration with other parameters when editing the scan.
Note: Subsequent edits to the scan don't require this workaround.
KY-75646Problem: Reports of scans on Teradata tables with unique primary index show the Key Source as "Integer Non Unique Column".
KY-75083Problem: Search for the Secrets infotypes returns less matches for the PDF data.
KY-74909Problem: Search for the Secrets infotypes returns less matches for the MongoDB data store.
KY-73411Problem: Probing an empty folder in an AWS S3 bucket returns the NotFound error.
KY-72978Problem: Search for the SSH private keys returns less matches when data for multiple infotypes is present in the same file.
KY-72411Problem: Scan on Office365 Sharepoint Online completes successfully for a non-existent file.
KY-72408Problem: Text data in Sharepoint Online Notebooks can't be matched.
KY-72397Problem: Images inserted in Sharepoint Online Notebooks can't be matched.
KY-9098Problem: DDC can't automatically assign an Agent for empty NFS shared folders. You cannot create an NFS type data store with an empty folder. When an empty folder is shared over NFS and scanned by DDC, the probe fails.
Workaround: Introduce any document in the empty folder and manually trigger the Agent selection. Click the "Find Agent" button to relaunch the Agent selection. The button is visible when you click the ellipsis (overflow) button next to the data store.
KY-9104Problem: Scan fails with “Error scanning. The target for Data Store XYZ cannot be accessed.” This happens when the Data Store is created and an Agent is selected for the Data Store but then the Agent is no longer available and there is no way to select a new Agent from the UI.
Workaround: Edit the Data Store and edit any configuration parameters so the DDC Server automatically searches for a new suitable Agent.
KY-9399Problem: The XVA file contains a data object that is was reported when it should not. The XVA file format is not correctly handled. After an XVA file is scanned and the report is generated, an additional data object in the Data Objects tab is displayed in the UI. You should ignore it.
KY-8990Problem: Scheduled scans and those launched manually via ‘run now’ only start after X hours. If an Agent and server have the wrong time set, DDC’s ability to schedule scans or to start them immediately when they are manually launched from the UI or API will be affected and the scan start may be delayed.
Workaround: Configure an NTP server for DDC and all Agent hosts.
Problem: None of the clustered nodes responds to requests to DDC.
DDC is only active in one of the CipherTrust Manager nodes. Requests sent to any other nodes will return this error. This will be improved in next releases.
Solution:
  • Run ksctl ddc active-node to identify the CipherTrust Manager node responsible for answering DDC requests and send the requests to the indicated IP. If this does not work, please restart the CipherTrust Manager node with that IP.
  • If the node identified by ksctl ddc active-node does not answer DDC requests correctly or is no longer active, contact Thales Customer Support.
KY-22666Problem: DDC may not scan big Data Objects for Data Stores other than local storage.
The threshold to consider is a file as big as half of the assigned scan RAM. When a DDC scan encounters a file exceeding this threshold, it may completely skip the file or scan just up to that threshold. The user has no way to identify the issue from DDC reports.
Possible Workarounds:
  • Download large files to a local storage, and run the scan on this local storage data store.
  • Increase the scan RAM as indicated in the Tuning Scan Settings section.
KY-19763Problem: OracleDB and IBM DB2: uppercase schema/table name issues.
User cannot launch Oracle/DB2 scan if schema OR table was created with lowercase and DDC is configured with lowercase.
Workaround: Set the target path in uppercase.
KY-21981Problem: Postgres tables without primary keys are not completely scanned
DDC can only scan Postgres tables if they have at least one primary key defined.
Workaround: Configure at least one primary key in the tables and run the scan again.
KY-34462Problem: In G-Drive DDC scans all the path to which the scan path is prefixed.
When scanning a specific G-Drive folder, the scan is extended onto all folder names that contain the name of the folder that you intended to scan.
KY-46340Problem: Office365: OneDrive for Business - Using wrong OneDrive domain while probing or scanning does not return an error.
Also a scan with the wrong domain and path does not return any error and it completes successfully.
KY-48874Problem: A scan with MySQL datastore (version 8.0.30) fails due to "failed status in the scanner service".
KY-49115Problem: Discrepancies in scan results of infotypes for the same file in DDC 2.10 and 2.9.
These infotypes show discrepancies:
- Australian Passport Number: 1070 (in version 2.9), 204 (in version 2.10)
- China Union Pay: 1000 (in 2.9), 921 (in 2.10)
- Discover: 1001 (in 2.9), 919 (in 2.10)
- Diners Club: 1001 (in 2.9), 1002 (in 2.10)
The above discrepancy is because of the new and improved data types, which are as follows:
- The Australian Passport Number data type has been enhanced for improved accuracy and coverage of the newer passport series, with additional updates made to enable the Australian Passport Number to be detected on the passport MRZ line.
- Discover Global Network cardholder data types including China Union Pay, Diners Club, Discover, and JCB have been updated to identify 14-19 digit primary account numbers (PANs) for all supported BIN ranges.
KY-51301Problem: For SMB Data Stores with remediation enabled, scans performed after remediation completes may not find matches in encrypted files.
Workaround: Automatic agent selection does not narrow the selection of DDC Agents to those installed on host with a CTE Agent in the Agent Group protecting the SMB GuardPoint. If DDC selects any of those agents, further scans on the SMB will read the encrypted content and therefore will be unable to find any match. In order to avoid this issue, please assign use labels to force DDC to select only the right agents as follows:
- Add one dedicated label to the DDC Agents installed on the hosts with valid CTE Agent,
- Associate that same label to the SMB Data Store, in order to guide automatic agent selection algorithm.
KY-51550Problem: Office365: OneDrive for Business - Scan progress reaches more than 100%.
KY-51586Problem: A scan of a LONGBLOB file in MySQL gets stuck while scanning.
DDC should be able to scan a 20 MB table, as LONGBLOB data type supports up to 4 GB of data, yet it fails.
KY-51623Problem: Partial Scan in BLOBs of size greater than 100 MB in MSSQL.
NOTE: If a file is partially scanned, it will be considered in the inaccessible location list.
KY-52297Problem: DDC scan fails with an empty GuardPoint path for a SMB data store.
Solution: A GuardPoint for a data store must always have a path configured in CTE.
KY-51695Problem: DDC is only able to scan the initial 4 KB of any text file stored as a large binary object in database tables.
KY-52494Problem: From this DDC version on (DDC-2.10), RHEL-compatible Agents can only be installed on environments running the matching and officially supported kernel version.
KY-52532Problem: Autopause feature not working as expected in Azure Table scans.
A scan of Azure Table with the "Autopause" feature enabled has the following issues:
  • it fails to resume after autopause end time after it enters the "Autopaused" state from the "Pending" state,
  • it fails to enter the "Autopaused" state from the "Running" state.
KY-42593, KY-42491Problem: Launching a second scan with any Data Stores in common with a running scan may restart the first scan progress on the shared Data Store, or even fail it if the first scan is manually paused.
Workaround: Minimize scan concurrency on any given Data Store and use automatic pause, as automatically paused scans normally do not fail.
KY-23163Problem: A scan goes into an interrupted state for CIFS after restarting the agent.
This only happens on Windows Server agents and for the Exchange Server and Windows Local Storage.
Solution: 1) Restart the Windows agent with the scan in the "Paused" state. Then resume the scan, and it will go into the "Scheduled" state.
2)Restart the Windows agent one more time and the scan comes back to normal.
KY-56387Problem: The count of data stores in the Agent List section does not change for the Exchange Server data store.
The number of data stores linked to an agent on the agents page is updated once the data store is ready, except for the Exchange Server data store.
KY-53620Problem: Targeted scans of a smaller dataset in a G-Drive data store take a long time, if the overall data that is stored in G-Drive is of a larger size (for example, over 500 GB).
KY-56390Problem: Scanning of any data from an Exchange Server data store works only if the agent is installed on the same machine as the Exchange Server.
KY-60493Problem: A scan is failing with an internal error when an entire SMB share is scanned.
A scan of a full SMB datastore takes a long time and and ends with an internal error. Scanning a sub folder only gives no problem and you can generate a report.
KY-66074Problem: Azure Table: The Issue related to Azure Table Data Store has been fixed as 'Cloudant Credentials', 'Basic Auth Secret' infotypes showing correct matches if relevant data resides inside the dataset.
Mongo DB: The IBM COS HMAC Credentials infotype is getting correct matches when quotes are not used while creating the dataset. But still it will get less matches with double quotes.
For example, if the dataset has more than one pair of double quotes like so:
"IBM COS HMAC TOKEN [-secret_accesskey]:: "687a726d2d905d575248759459871a2c4f92c54bdec6b78f""
In the above example, there are quotes around the '687a726d....' string. It will be considered an escape character, and MongoDB automatically appends '\' to ensure the string is preserved correctly. Due to this '\', the infotype will skip the match.
KY-66217Problem: The 'IBM COS HMAC Credentials' infotype from DDC shows fewer matches for EBCDIC formatted dataset. The conversion of the text dataset to EBCDIC format leads to this issue.
KY-66306Problem: When Google Drive is configured to use a language other than English (e.g. Portuguese), scans specifying both 'My Drive' or 'Meu Drive ' will result in a failed/incomplete scan.
Possible Workaround: Configure English as the default language for the Google Drive Data Stores that you scan.
KY-67484, KY-71568Problem: SharePoint Online Scan functionality is currently not available for a "Specific List" and "All List" as Target.

CipherTrust Secrets Management

IssueSynopsis
KY-81515Problem: The Forgot Password/Forgot Access Key feature doesn't work when the AKEYLESS_URL in the akeyless configuration is set to https://vault.akeyless.io.
Workaround: The field should be left blank.
KY-81517Problem: The new user registration doesn't work when the AKEYLESS_URL in the akeyless configuration is set to https://vault.akeyless.io.
Workaround: The field should be left blank.
KY-78214Problem: OIDC & SAML Auth login to Akeyless gateway doesn't work with CipherTrust Manager.
Workaround:
1. Log on to Akeyless console.
2. Navigate to Users & Auth Methods.
3. Go to already configured OIDC/SAML auth method.
4. Click the Generate OIDC Bookmark URL/Generate SAML Bookmark URL button to generate a bookmark URL.
5. Copy the corresponding bookmark URL and use the same for the subsequent logins.
KY-75947Problem: OpenID Connect (OIDC) fails to authenticate during callback to CipherTrust Manager from Akeyless.
KY-76477Problem: Reloading the external secrets manager (universal secrets connector) page leads to a "404 page not found" error.
Workaround: Go to Akeyless console webpage (https://CM-IP/akeyless-console/items) and open the universal secret connector again.
KY-75945Problem: Rotating Docker Hub target doesn't display the current password in the version list. Therefore, the user is unable to log in to the Docker Hub once the credentials are rotated on the Akeyless.
Workaround: Manually reset the Docker Hub password after the Docker Hub secret rotation.
KY-77535Problem: Decrypting the secret with DFC that no longer exists, abruptly logs the user out.
Workaround: Instead of SSO login (that uses JWT), try other authentication methods such as email, universal token, or API.
KY-72796Problem: The CipherTrust Manager constantly communicates with multiple IPs of the akeyless SAAS server (for example, "52.223.11.194", "35.71.185.167", "35.192.171.171") over port 9443, which leads to a lot of irrelevant log entries.
KY-70144Problem: During secret creating for Docker Hub target in Akeyless, the connection is refused.
Workaround: Add an explicit DNS Host entry to the CipherTrust Manager for Docker Hub.
KY-67413Problem: After creating a secret, akeyless provides a functionality to share the secrets to an external user through email. This functionality doesn't work on the akeyless console UI integrated with the CipherTrust Manager and throws an error.
Workaround: The user can share the secret through email using the akeyless account on console.akeyless.io.
KY-64835Problem: If you attempt to modify the protection key for an existing certificate-type secret in the Akeyless console, an exception stating Unexpected error is displayed.
Workaround: Delete and re-create the existing secret with the desired protection key.
KY-64751Problem: If you launch the Akeyless console from the Secrets Management tile, and the CipherTrust Manager session expires or is manually logged out, the Akeyless console session logs out as well.
Workaround: Refrain from logging out from the CipherTrust Manager UI unless you also want to log out from the Akeyless UI.
KY-63288Problem: Some internet browsers, such as Mozilla Firefox, Google Chrome, or Microsoft Edge launch the secrets management tile as a pop-up, and prompt to allow pop-ups.
Workaround: Allow pop-ups from the CM UI if prompted.
KY-61568Problem: The POST /v1/connectionmgmt/services/akeyless/connections operation in the API playground to create a new Akeyless connection introduces unnecessary parameters "meta", "products", and "category".
Workaround: Ignore these parameters. They do not affect the functioning of the Akeyless connection.

CipherTrust Transparent Encryption

IssueSynopsis
KY-91010Problem: If an LDT policy contains multiple security rules, the first security rule displayed on the second page of the Security Rules tab doesn't display the check box.
KY-75999, KY-84128Problem: The CTE licenses are not updated, when the domain gets deleted from the CipherTrust Manager or the clients of a domain are migrated from DSM to CipherTrust Manager.
Workaround: If the clients of a domain are migrated from DSM to CipherTrust Manager and the license count is incorrect for that domain, create a CTE client (for example, ABC) in the same domain and then delete it. This will correct the license count for that domain.
KY-78994Problem: On an RWP-capable CTE client, when an RWP and any other type of GuardPoints are applied to the same path, the RWP GuardPoint can be disabled but not enabled.
Workaround:
1. Disable other GuardPoints.
2. Enable the RWP GuardPoint.
You can now enable other GuardPoints again.
KY-72096Problem: CTE UserSpace: After upgrade to CipherTrust Manager 2.15.0, CTE UserSpace 10.1.0 clients don't show the Healthy status on GUI.
This issue is resolved in the CTE-U 10.2.0 release.
Workaround: Upgrade the clients to 10.2.0 or manually restart the CTE-U services (secfs-fuse restart) to restore the client communication to the Healthy state for older CTE-U client versions.
KY-72095Problem: After upgrade to CipherTrust Manager 2.15.0, CTE clients can take up to 25 minutes to show the Healthy status on GUI. This issue has no impact on the functioning of GuardPoints.
This issue is resolved in the CTE 7.5.0 release.
Workaround: Upgrade the clients to 7.5.0 or manually restart the VMD service (secfs restart) to restore the client communication to the Healthy state for older CTE client versions.
KY-60249Problem: The get /v1/transparent-encryption/policies API does not return the complete list of policies added to the CipherTrust Manager.
Workaround: Run the get /v1/transparent-encryption/policies API with limit as -1.
KY-59893Problem: Signature rules are not copied to a clone policy.
Workaround: On the policy details page, manually add the missing signature rules.
KY-55739Problem: When a CipherTrust Manager user having only CTE Admins group permissions initiates a Quorum-dependent operation, a corresponding Quorum is created. After the required Quorum approvals, the operation does not auto-trigger in the background.
Workaround: Retry the operation after the required Quorum approvals.
KY-55511, KY-55527, KY-55275, KY-55528Problem: Simultaneous composite operations (for example, update and delete) are not supported for quorums.
KY-55273Problem: If quorum is activated for client group deletion, then bulk client group deletion generates multiple quorums in pre-active state.
Workaround: Delete client groups individually.
KY-55064, KY-54442Problem: In case of bulk client or client GuardPoint deletion, the quorum details may not be available. However, quorum operations (such as approval, rejection) can be performed.
This issue has no impact on functionality.
KY-51759, KY-51754Problem: When quorum is enabled, if you perform an operation to delete clients or GuardPoints in bulk, the quorum is created in pre-active state.
Workaround: Activate the quorum using the /v1/quorum-mgmt/quorums/{id}/activate API.
KY-51135Problem: Group members cannot be imported from ldap for user sets.
KY-34329Problem: Browsing VxVM raw devices that have slash in the path names shows non-existing directory in the GuardPaths.
Workaround: Create GuardPoints by manually entering the raw device paths.

Batch Data Transformation (BDT)

IssueSynopsis
KY-72695Problem: 500 Status code occurs when fetching BDT policies.

ProtectApp

IssueSynopsis
KSCH-16415Problem: The Host Name field on the Client Registration screen does not have validation for host availability.
Workaround: Add clients using the API.

ProtectFile

IssueSynopsis
KSCH-573Problem: Encryption rules cannot be modified to reset values for include and exclude extension parameters.
KSCH-568Problem: Encryption rules do not prevent specifying both include and exclude extension parameters simultaneously.
KSCH-567Problem: Modifying a file level encryption rule to set the “isRecursive” flag does not return error.
KSCH-564Problem: Non-encryptor clients cannot be removed from a Linux cluster while a cryptographic operation on an encryption rule is in progress.

CipherTrust Intelligent Protection

IssueSynopsis
KY-56816Problem: Unencrypted report is generated for few files if user reboot the machine during remediation.

Workaround: User need to run scan with reclassify option or full scan again to generate correct report.
KY-55480Problem: Cross domain client registration is not working with CIP.
AGT-43391Problem: All files are not encrypted on performing bulk rename during remediation on Linux Local Storage with STD/LDT policy.

Workaround: All remaining files will get encrypted after a periodic CIP scan which runs after 8 hours (default).
KY-36741Problem: File becomes plain with MOVE operation of a tagged file with ACL and STD policy on Linux.
KY-65540Problem: PQS configurations are not visible on GUI after saving remediationconfig via API using the ID/UUID for the knox_connection_identifier name.

Workaround:

• Solution 1: Use GUI to configure PQS.

• Solution 2: Use the knox_connection_identifier name instead of ID/UUID via API.

On this page