Skip to main content
Migration Notice
We're migrating documentation from the old portal into this one. Some things may look a little different or out of place in the meantime — we know, and we're working to get it right. If something's unclear or doesn't look right, let us know.

Clusters

The Clusters tab (Settings > Clusters) is where you register the Kubernetes clusters that the product watches. For each cluster you supply the connection details the console uses to scan pods, PVCs, and nodes. You can also connect a RunAI workload scheduler and the Dell CSI storage credentials.

This is the first tab to configure on a new install. The K8 Data Security, AI Risk Pipeline, and Data Auditing pages have no data until at least one cluster is registered and scanned.

Overview​

Each cluster you add becomes one collapsible card. The console connects to the cluster's Kubernetes API on a schedule to build the topology and risk picture, and it never writes to the cluster.

Storage devices (PowerScale and ObjectScale / ECS) are configured on the Storage tab and act only as audit event sources. This tab covers the Kubernetes side and the per-cluster integrations.

  • Click Add Cluster to create a card, complete its sections, then click Save Settings at the bottom of the tab. When there are unsaved edits, the button turns orange and reads Save Changes.
  • Remove a cluster with the trash icon in its header.

Adding a cluster requires a license. Add Cluster is disabled, with a note above the list, until an active subscription is installed under Settings > Licensing. See Licensing.

  • Clusters you already have keep working, and you can still edit or remove them, after a subscription expires.
  • If the license ends while the page is open, Save Settings still saves your other changes. The new cluster stays on the page, unsaved, with a message, and saves once a license is installed.
  • Without a license, removing a saved cluster asks you to confirm first, because you cannot add it back until a license is installed.

Secret fields (Bearer Token, RunAI client secret) are never returned to the browser in plaintext. Each secret field has a masked row with an eye icon to view the stored value, and a separate write-only input. Leave the write-only input blank to keep the existing secret, and type in it only to replace the stored value.

Cluster connection​

This section is required for every cluster.

  • Display Name — a friendly label for the cluster. It appears in the cluster selectors on the K8 Data Security and Data Auditing pages.

  • K8s API Endpoint — the HTTPS URL of the Kubernetes API server. It must be reachable from the host that runs the console.

    • Rancher-managed clusters: use the Rancher proxy URL, for example https://rancher.host/k8s/clusters/c-m-xxxx.
    • Direct clusters: use the kube-apiserver address, for example https://192.0.2.10:6443.
  • Bearer Token — the token of the read-only aisec-reader service account. The manifest also gives it list on namespaces and get / list on secrets in the Dell CSI namespace, which the Dell storage helpers need. Leave the input blank to keep the existing token. Create the account with the manifest in Kubernetes read-only service account, then read the token:

    kubectl -n aisec-reader get secret aisec-reader-token -o jsonpath='{.data.token}' | base64 -d; echo
  • Ignore SSL Certificates (Bypass Validation) — disables TLS certificate validation for the API endpoint. Selected by default; clear it when the API server presents a trusted certificate, because bypassing validation removes protection against man-in-the-middle attacks.

  • Test Connection — validates the endpoint and token immediately. A green check confirms that the console can reach the API. A red message shows the error so you can fix the URL, token, or TLS setting before saving.

Workload scheduler​

This section is optional. It integrates RunAI so the topology can attribute GPU workloads to RunAI users and the RunAI scheduler filter on the Data Security page has data. Leave it blank if you do not run RunAI.

  • Base URL — the RunAI control-plane URL, for example https://runai.yourdomain.com.
  • Client ID / Client Secret — the RunAI API application credentials. Leave the secret blank to keep the existing one.
  • Ignore SSL Certificates — applied to the RunAI endpoint. Selected by default; clear it when the RunAI endpoint presents a trusted certificate.
  • Test Connection — verifies that the console can authenticate to RunAI.

Dell storage integration​

These fields identify the Kubernetes Secret that holds the Dell CSI driver credentials. The console uses it to map a PVC to its backend PowerScale export when it builds the topology.

  • CSI Namespace — the namespace where the Dell CSI driver runs. Prefilled with the default dell-storage. Click Load from Cluster to fill a dropdown with the cluster's namespaces, or type the name directly.
  • CSI Secret — the Secret that holds the CSI credentials. Prefilled with the default csi-isilon-creds. Click Load secrets to list the Secrets in the chosen namespace, or type the name. View Contents decodes and displays the Secret's values so you can confirm that you selected the right one.

Load from Cluster, Load secrets, and View Contents read from the first saved cluster. For other clusters, type the namespace and secret.

Scan schedule​

There is no per-cluster scan schedule on this tab. Scan cadence for all clusters is configured on the System Jobs page, Schedules tab. After you register a cluster, set or confirm its scan schedule there, or run a one-off scan with Run Now on the K8 Cluster Scan row of the Schedules tab.

Workflows​

Register a cluster​

  1. Open Settings > Clusters and click Add Cluster.
  2. Enter a Display Name and the K8s API Endpoint.
  3. Paste a service-account Bearer Token. Ignore SSL Certificates is selected by default; clear it if the API server presents a trusted certificate.
  4. Click Test Connection in the Cluster connection section and confirm that it returns a green check.
  5. Click Save Settings.
  6. Open System Jobs > Schedules and click Run Now on the K8 Cluster Scan row to run the first K8 scan, or set its schedule there. When the scan completes, the cluster appears on the K8 Data Security page.

Troubleshooting​

  • Test Connection fails on the API endpoint — the most common causes are an unreachable URL, an expired or under-scoped Bearer Token, or a TLS error that requires Ignore SSL Certificates.
  • A cluster does not appear on the K8 Data Security and Data Auditing pages — a cluster appears only after it has been scanned at least once.
  • A secret was overwritten with an empty value — leave the write-only input blank when you save unrelated changes. Use the eye icon to reveal a stored value.