Skip to navigation

DSX IMDS NodeAttestor Agent Plugin

View as Markdown

dsx-imds-node-attestor-agent is the agent half of SPIRE’s custom dsx_imds NodeAttestor. It requests a host DSX JWT through the paired DPU intercept and NICo IMDS passthrough, then sends that token as the SPIRE node-attestation payload.

The external DPU establishes the first local SPIRE identities through dpu_hw. DSX IMDS selects the host identity beneath that DPU agent and exchanges it for the DSX JWT used by this plugin. The bare-metal host agent must complete dsx_imds node attestation before it can serve host processes through the Unix WorkloadAttestor or provide identities to VMs.

Host identity trust path

The external dpu_hw NodeAttestor agent and server plugins attest the DPU agent. Its runtime WorkloadAttestor makes the registered host identity available to DSX IMDS. The repository-owned dsx_imds NodeAttestor agent and server plugins then attest the host agent, whose Unix WorkloadAttestor serves host processes.

dpu_hw node attestation host SPIRE JWT-SVID exchange for host DSX JWT host DSX JWT link-local IMDS identity passthrough dsx_imds node attestation Workload API DPU local SPIRE identitiesfrom shard-local SPIRE Host local SPIRE identitiesfrom shard-local SPIRE Shard-localNVIDIA Workload IdentityKeys DPU SPIRE agent processdpu_hw agent plugin Paired DPU link-local interceptNICo IMDS passthrough DSX IMDS(metadata-service) Bare-metal host SPIRE agent processdsx_imds agent plugin Bare-metal host process

Node attestation exchange

Request host SPIRE JWT-SVID by dsx-imds hint Local host SPIRE JWT-SVID NVIDIA Workload Identity Keys local SPIRE JWT-SVID Host DSX JWT Begin node attestation GET link-local identity with Metadata: true Pass through identity request Host DSX JWT Host DSX JWT Attestation payload Send attestation payload Verify host DSX JWT dsx_imds agent SPIFFE ID DSX IMDS process External DPU SPIRE agentruntime WorkloadAttestor Paired DPU intercept and NICo IMDS Shard-local NVIDIA Workload Identity Keys Pod dsx_imds NodeAttestor agent plugin Bare-metal host SPIRE agent Local SPIRE server Pod dsx_imds NodeAttestor server plugin

SPIRE starts the binary through the plugin SDK. The plugin has no application CLI flags. Configure it in the SPIRE agent HCL:

plugin_data {
endpoint = "http://169.254.169.254"
audience = "spiffe://k2.sjc-1.nvidia.com/spire/server"
}

endpoint defaults to http://169.254.169.254. audience is required. The HTTP client connects directly, ignores ambient proxy settings, and rejects redirects. Dockerfile.spire embeds the plugin in the DSX SPIRE agent image. The local E2E fixture selects that image through local-e2e-tests/dsx-imds-host-agent-values.yaml plus its shard override.