> This page is for Workload Identity, version v1.16.0-rc.5.
> For other versions, use one of these documentation indexes:
> - Latest · v1.16.0-rc.7 (default): https://docs.nvidia.com/workload-identity/v1.16.0-rc.7/llms.txt
> - v1.16.0-rc.5: https://docs.nvidia.com/workload-identity/v1.16.0-rc.5/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/workload-identity/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/workload-identity/_mcp/server.

# DSX IMDS NodeAttestor Server Plugin

`dsx-imds-node-attestor-server` is the server half of SPIRE's custom
`dsx_imds` NodeAttestor. It verifies the host DSX JWT received from the agent
plugin and returns the DSX subject as a reattestable SPIRE agent ID.

```mermaid
sequenceDiagram
    participant DI as DSX IMDS process
    participant DA as External DPU SPIRE agent<br/>runtime WorkloadAttestor
    participant NI as Paired DPU intercept and NICo IMDS
    participant EX as Shard-local NVIDIA Workload Identity Keys Pod
    participant AP as dsx_imds NodeAttestor agent plugin
    participant HA as Bare-metal host SPIRE agent
    participant SS as Local SPIRE server Pod
    participant SP as dsx_imds NodeAttestor server plugin
    participant JWKS as Reachable NVIDIA Workload Identity Keys aggregate JWKS endpoint
    DI->>DA: Request host SPIRE JWT-SVID by dsx-imds hint
    DA-->>DI: Local host SPIRE JWT-SVID
    DI->>EX: NVIDIA Workload Identity Keys local SPIRE JWT-SVID
    EX-->>DI: Host DSX JWT
    HA->>AP: Begin node attestation
    AP->>NI: GET link-local identity with Metadata: true
    NI->>DI: Pass through identity request
    DI-->>NI: Host DSX JWT
    NI-->>AP: Host DSX JWT
    AP-->>HA: Host DSX JWT attestation payload
    HA->>SS: Send attestation payload
    SS->>SP: Verify host DSX JWT
    SP->>JWKS: Load flat aggregate public keys
    SP->>SP: Verify signature, audience, issuer, and subject
    SP-->>SS: dsx_imds agent SPIFFE ID
```

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

```hcl
plugin_data {
  jwks_url = "https://identity-keys.shard.example.com/.well-known/jwks.json"
  issuer = "https://ds9.dsx.nvid.id"
  audience = "spiffe://k2.sjc-1.nvidia.com/spire/server"
}
```

All three fields are required. SPIRE supplies the trust domain through its core
configuration. `issuer` sets the expected `iss` claim because `jwks_url` does
not. The standard OIDC remote key set caches and refreshes keys.
`Dockerfile.spire` embeds the plugin in the DSX SPIRE server image.