Skip to navigation

Architecture

View as Markdown

Local SPIRE identities are hierarchical. The DPU identity comes first, the bare-metal host identity is attested through the DPU, and VM identity is served from the attested host path. The bundled dpu_hw server accepts the DPU serial as plaintext attestation data.

Data Hall identity shard static entries via SPIREcontroller-manager dpu_hw node attestation Kubernetes workload attestation host DSX JWT over IMDS dsx_imds node attestation Workload API parent same Workload API parent DSX JWT over IMDS DPU and LaunchLayer source CRs Identity Controller Deployment Shard-local SPIRE server External DPU SPIRE agent Paired DPU link-local interceptNICo IMDS passthroughDSX IMDS (metadata-service) Operator-owned bare-metal Kubernetes workerSPIRE agent Operator Kubernetes Poddsx-token-fetcher sidecar virt-launcher PodDSX IMDS (metadata-service) sidecar KubeVirt VM

Common Services owns the identity shard for Common Services and Data Hall control-plane resources. Each Data Hall owns the shard for its capacity resources. Both shards derive entries from their local DPU and LaunchLayer source CRs, and their Pods register beneath local dsx_imds agents.

Operator-owned Common Servicesbare-metal Kubernetes worker External Common Services DPU Operator-owned Data Hallcontrol-plane bare-metalKubernetes worker External Data Hall control-plane DPU Common Services cluster Operator-owned Data Hall capacity bare-metal hostKubeVirt worker External Data Hall capacity DPUpaired with an operator KubeVirt worker Standalone tenant-facing DataHall capacity bare-metal host External Data Hall capacity DPUpaired with a standalone tenant host Data Hall control-plane cluster IMDS host attestation JWT JWT-SVID / DSX JWT IMDS host attestation JWT JWT-SVID / DSX JWT JWT-SVID / DSX JWT JWT-SVID / DSX JWT JWT-SVID / DSX JWT JWT-SVID / DSX JWT JWT-SVID / DSX JWT IMDS host attestation JWT IMDS host attestation JWT IMDS VM JWT dsx-pod JWT-SVID Kubernetes WorkloadAttestorDPU IMDS selectors, dsx-imds dsx-pod JWT-SVID Kubernetes WorkloadAttestorDPU IMDS selectors, dsx-imds dsx-imds-vm JWT-SVIDLaunchLayer CR tenant Kubernetes WorkloadAttestorDPU IMDS selectors, dsx-imds Kubernetes WorkloadAttestorDPU IMDS selectors, dsx-imds Tenant-owned KubeVirt VM operator Kubernetes Poddsx-token-fetcher and application host SPIRE agentdsx_imds node attestationUnix and Kubernetes workload attestation paired DPU IMDSlink-local interceptNICo passthroughmetadata-service external DPU SPIRE agentdpu_hw node attestationKubernetes workload attestation operator Kubernetes Poddsx-token-fetcher and application host SPIRE agentdsx_imds node attestationUnix and Kubernetes workload attestation paired DPU IMDSlink-local interceptNICo passthroughmetadata-service external DPU SPIRE agentdpu_hw node attestationKubernetes workload attestation DPU and LaunchLayer source CRsCommon Services and Data Hall control plane NVIDIA Workload IdentityControllerleader elected ClusterStaticEntry CRs SPIRE controller-managerstatic entries and Pod registrations Common Services SPIRE serverdpu_hw and dsx_imds server plugins Common ServicesNVIDIA Workload IdentityKeys virt-launcher PodDSX IMDS (metadata-service) sidecar operator host SPIRE agentdsx_imds node attestationUnix and Kubernetes workload attestation paired DPU IMDSlink-local interceptNICo passthroughmetadata-service external DPU SPIRE agentdpu_hw node attestationKubernetes workload attestation host SPIRE agentLaunchLayer CR tenantdsx_imds node attestationUnix workload attestation paired DPU IMDSlink-local interceptNICo passthroughmetadata-service external DPU SPIRE agentdpu_hw node attestationKubernetes workload attestation DPU and LaunchLayer source CRsData Hall capacity NVIDIA Workload IdentityControllerleader elected ClusterStaticEntry CRs SPIRE controller-managerstatic entries and Pod registrations Data Hall SPIRE serverdpu_hw and dsx_imds server plugins Data HallNVIDIA Workload IdentityKeys NVIDIA Workload IdentityKeys Proxy CSInode plugin Pod

The parent association is an attested SPIRE agent, not a resource-ownership hierarchy. DPUs are Kubernetes workers in their Kamaji clusters, not in this management cluster. Every Kubernetes worker is an operator-owned bare-metal host, and every Pod uses the configured operator tenant and a /bm/<node-name>/pod/<pod-uid> subject. A tenant-facing bare-metal host is standalone and never becomes a Kubernetes node. A KubeVirt VM runs in an operator-owned virt-launcher Pod, so the Pod keeps its operator identity while its metadata sidecar selects the dynamically tenant-supplied VM SVID from the same operator host Workload API.

Registration parentage

The NVIDIA Workload Identity Controller owns DPU-derived, standalone host, and VM ClusterStaticEntry CRs. The SPIRE controller-manager registers those entries and registers Pods directly from the chart-owned ClusterSPIFFEID template.

Hexagons show inputs, stadiums show attested parent agent IDs, and rectangles show static CRs or Pod registration entries. {service} comes from global.dsx.defaultServiceName for static CRs and the spiffe.nvidia.com/service label for Pods.

The DPU resource supplies the worker-to-DPU relationship. Its IMDS registration allows DPU-hosted DSX IMDS to obtain the paired worker’s SPIRE JWT-SVID and exchange it for the DSX JWT returned through link-local IMDS. The worker uses that DSX JWT to attest its local SPIRE agent through dsx_imds.

For a tenant-assigned host, the BareMetalInstance supplies the host-to-DPU relationship. Its entry replaces the operator fallback derived from the DPU resource.

Local consumers exchange local SPIRE JWT-SVIDs with their shard’s NVIDIA Workload Identity Keys for DSX JWTs. NVIDIA Workload Identity Keys instances share only public signing keys across shards.

local SPIRE JWT-SVID DSX JWT token file or IMDS Public keys in NATS KV (optional) Public keys in NATS KV public JWKS dsx-token-fetcher and DSX IMDS NVIDIA Workload IdentityKeys Deployment DPU, host, Pod, and VM consumers External DSX Event Bus Peer shardNVIDIA Workload IdentityKeys instances External relying party

A SPIRE JWT-SVID is a cluster-local credential obtained from the local SPIRE Workload API. A DSX JWT is the credential returned by the local NVIDIA Workload Identity Keys. SPIRE JWT-SVIDs never establish trust between shards.

Install the identity chart once per shard. Each regular management cluster that owns DPU or LaunchLayer source CRs runs the Identity Controller for its shard. Every NVIDIA Workload Identity Keys instance validates only local SPIRE JWT-SVIDs through its node-local Workload API. It serves aggregate public keys received through the Event Bus when NATS is enabled, or only local public keys when NATS is disabled.

The Event Bus, OAuth2 provider, and relying parties are external to the identity chart.

DPF registers DPU Agent and DPUService workload identities through the external DPF identity configuration. The Identity Controller registers the paired host identity served by DPU IMDS.

Identity delivery

ConsumerSPIRE trust pathDSX JWT delivery
Kubernetes PodKubernetes WorkloadAttestor under the worker’s dsx_imds-attested host agent. The registration uses the operator tenant and worker host subjectThe dsx-token-fetcher sidecar selects dsx-pod, exchanges the local SPIRE JWT-SVID, and writes the DSX JWT to a Pod-private volume mounted read-only in application containers
DPU service PodDPF exposes the DPU SPIRE agent through csi.spiffe.ioNative admission injects the standard token-fetcher sidecar and token volume
DPU IMDSThe external DPU agent attests through the dpu_hw NodeAttestor agent and server. Its Kubernetes WorkloadAttestor binds the paired BM identity to the IMDS PodSPIFFE CSI exposes the DPU agent Workload API socket. DSX IMDS selects dsx-imds, exchanges the local SPIRE JWT-SVID, and serves the BM DSX JWT through IMDS
Bare-metal host processThe DPU agent is attested through dpu_hw. The host agent is attested through the repository dsx_imds NodeAttestor agent and server, then can serve local processes through the Unix WorkloadAttestorThe paired DPU intercept carries link-local IMDS to NICo IMDS, which passes identity requests to DSX IMDS. DPU-hosted DSX IMDS exchanges directly with its reachable shard-local NVIDIA Workload Identity Keys. The host agent uses the returned DSX JWT for node attestation. A host-process-specific token delivery contract is not currently defined
Kata Containers PodThe guest is a VM, so kata-uds-proxy forwards the host Workload API over vsockA guest sidecar independently serves the standard Workload API socket path
KubeVirt VMThe controller derives the VM subject from the dynamically supplied tenant ID and parents it to the operator-owned worker host’s dsx_imds agent. The Kubernetes WorkloadAttestor serves the operator-owned virt-launcher Pod, and SPIFFE CSI exposes that same agent’s Workload API socketThe DSX IMDS sidecar selects the VM SPIRE JWT-SVID by its exact dsx-imds-vm hint, exchanges it through NVIDIA Workload Identity Keys Proxy CSI, and serves the DSX JWT through IMDS