Configuring the TLS versions for Phoenix

Know how to configure the TLS versions for Phoenix using Cloudera Manager. It is essential to configure these versions to enforce modern security standards, access advanced encryption, and streamline management.

Standardized TLS version configuration in Cloudera Manager unifies encryption parameters across database engines by using a dual-parameter model and a central feature flag. Cloudera Manager controls Transport Layer Security (TLS) versions through the TLS_ADVANCED_CONTROL feature flag. This feature flag manages whether database components utilize legacy configurations or adopt the standardized architecture introduced in Cloudera Manager 7.13.2 SP1. The dual-parameter model decouples tracking from properties emitted into configuration files, which allows two distinct configurations to resolve to the same property name.

The feature flag determines parameter behavior and user visibility based on its state:

  • When you disable the feature flag (OFF), components exhibit legacy behavior, maintaining pre-existing parameters and defaults to ensure zero impact on current deployments.
  • When you enable the feature flag (ON), components automatically transition to unified specifications, allow access to TLS v1.3 options, and ignore pre-existing values in favor of centralized defaults.

The framework automatically manages visibility and configuration file generation according to the state of the flag. The following table compares the legacy and unified parameter specifications for protocol control:

The unified approach sets Copy from Global as the default selection, enabling your database instances to inherit settings directly from the global Cloudera Manager configuration. To maintain a secure environment, all versions older than TLS v1.2 are deprecated and removed from the unified setup . If you use custom settings, you must explicitly plan your migration to ensure compatibility.

  1. Log in to the Cloudera Manager as an administrator.
  2. Select the Phoenix service.
  3. Click the Configuration tab.
  4. Search for tls.
  5. Configure the Supported SSL/TLS versions property as one of the following.
    • TLSv1.2: Enable TLS 1.2 exclusively.
    • TLSv1.3: Enable TLS 1.3 exclusively.
    • TLSv1.2, and TLSv1.3: Enable both the versions simultaneously.
    • Copy From Global Settings: Inherit cipher settings directly from Cloudera Manager's global TLS configuration.