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

Managing Kubernetes Storage Groups and Clients

Managing Kubernetes Clients

search

Please Note:

Managing Kubernetes Clients

Register and view Kubernetes (K8s) clients on the K8s Clients page of the CipherTrust Manager GUI.

Every node of a Kubernetes cluster consumes one CTE CSI license. The license applies to worker nodes where CSI is attached to the application pod. Refer to CTE Licensing Model for details.

Registering Kubernetes Clients

Registration is the process of configuring a Kubernetes (K8s) client with a CipherTrust Manager. This process creates SSL certificates for further communication between the CipherTrust Manager and the K8s client. Refer to Registering Clients for details.

After registration, the K8s client can communicate with the CipherTrust Manager. All the GuardPolicies applied to the K8s storage group are automatically added to the K8s client. The client configuration is then built for K8s client (exactly like a CTE client) and sent to the client.

After successful registration, the K8s client appears on the K8s Clients page of the CipherTrust Manager GUI. The client status becomes Healthy.

Note

All the K8s clients that you want to attach to a storage group must have the same K8s Namespace and K8s StorageClass.

Viewing Details of Kubernetes Clients

The K8s Clients page shows the total number of K8s clients, clients with errors, clients with warnings, and healthy clients. The Status Bar contains the following tabs:

  • Total Clients: Shows the total number of registered clients with all types of health status.

  • Errors: Shows the number of clients with errors.

  • Warnings: Shows the number of clients with warnings.

  • Healthy: Shows the number of healthy clients.

Refer to Client States for details.

Click each tab to filter the K8s clients. The clients list displays names of clients in the CipherTrust Manager database and details about their configuration.

To view the details of a K8s client:

  1. Open the Transparent Encryption application.

  2. In the left pane, click Clients > K8s Clients. The list of K8s clients registered with the CipherTrust Manager is displayed. The following details are displayed:

    ColumnDescription
    StatusHealth status of the K8s client.
    Client NameName of the K8s client registered with the CipherTrust Manager. The name is a combination of:
    • The node on which the K8s client is running
    • The linked StorageClass
    • The namespace where the K8s client pod runs
    • A random string
    Agent VersionVersion of the CTE CSI Agent installed on the K8s client.
    DescriptionDescription of the K8s client.

Reregistration and Reenrollment

Unlike a CTE client, when a K8s client crashes or stops, it does not persist any information about its previous interaction with the CipherTrust Manager.

If you try to reregister the K8s client with same name (<node-name>_<csi-storage-class>_<csi-namespace>), the client is registered as a new client (with a new random string _<random-string> appended to its name).

After registration:

  1. K8s client sends the enrollment request to the CipherTrust Manager.

  2. CipherTrust Manager checks the request for the node name, namespace, and StorageClass.

  3. CipherTrust Manager removes the existing registration entry of the client (with the old random string).

Viewing GuardPolicies Applied to Kubernetes Clients

To view the GuardPolicies applied to a K8s client:

  1. Open the Transparent Encryption application.

  2. In the left pane, click Clients > K8s Clients. The list of K8s clients registered with the CipherTrust Manager is displayed.

  3. Under Client Name, click the desired client link. The detail view of the K8s client is displayed. The GuardPolicies tab shows the list GuardPolicies applied to the K8s client.

  4. Under Policy, click the expand icon (Expand Icon) to the left of the desired policy. The following policy details are displayed:

    ColumnDescription
    PodName of the K8s pod.
    CTE PVC NameName of the CTE PVC.
    K8s PVC NameName of the K8s PVC.
    K8s PVC PhaseName of the K8s PVC phase.
    StorageClassName of the K8s StorageClass.
    CTE Guard NameName of the CTE GuardPolicy.

Deleting Kubernetes Clients with Error Status

The Kubernetes clients with the Error status can be deleted from the CipherTrust Manager GUI. Kubernetes clients with other status cannot be deleted.

To delete such a Kubernetes client:

  1. Open the Transparent Encryption application.

  2. In the left pane, click Clients > K8s Clients. The list of K8s clients registered with the CipherTrust Manager is displayed.

  3. Click the Delete button corresponding to the erroneous Kubernetes client (with the status "Error") that you want to delete. A dialog box appears prompting to confirm the action.

    Deleting a client is permanent and cannot be undone.

  4. Click Delete.

A request to delete the client is submitted successfully to the CTE Agent. After the CipherTrust Manager receives confirmation from the CTE Agent, the Kubernetes client is deleted and its entry is removed from the K8s Clients page.

On this page