> This page is for Workload Identity, version Latest · v1.16.0-rc.7 (default).
> 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.

# NVIDIA Workload Identity user guide

- Kubernetes and DPUService Pods use the
  [token-fetcher sidecar](/workload-identity/user-guide/token-fetcher-example).
- Paired bare-metal hosts and [KubeVirt](https://kubevirt.io/user-guide/) VMs use DSX IMDS.
- Relying parties validate DSX JWT-SVIDs with the NVIDIA Workload Identity Keys [JWKS](https://www.rfc-editor.org/rfc/rfc7517#section-5) endpoint.

## Acquire a token from DSX IMDS

| Consumer | Endpoint |
| --- | --- |
| Paired bare-metal host | `http://169.254.169.254/latest/meta-data/identity` |
| KubeVirt VM over IPv4 | `http://169.254.169.254/latest/meta-data/identity` |
| KubeVirt VM over IPv6 | `http://[fd00:76b9::254]/latest/meta-data/identity` |

Paired bare-metal hosts reach DPU-hosted DSX IMDS through NICo. The host
`dsx_imds` NodeAttestor uses the returned host token to attest its [SPIRE](https://spiffe.io/docs/latest/spire-about/) agent.
KubeVirt VMs reach a DSX IMDS sidecar in the virt-launcher Pod and receive their
VM identity. The VM network setup sidecar enables IPv4, IPv6, or both from the
primary [OVN](https://github.com/ovn-kubernetes/ovn-kubernetes) allocation. See
[VM network requirements](/workload-identity/components/imds-network-setup#vm-bindings).

Request a token over IPv4:

```bash
curl --fail-with-body --silent --show-error --noproxy '*' --get \
  --header 'Metadata: true' \
  --header 'Accept: application/json' \
  --data-urlencode 'aud=spiffe://ds9.dsx.nvid.id/openbao' \
  http://169.254.169.254/latest/meta-data/identity
```

For a VM with IPv6, use the same request with the IPv6 endpoint:

```bash
curl --fail-with-body --silent --show-error --noproxy '*' --globoff --get \
  --header 'Metadata: true' \
  --header 'Accept: application/json' \
  --data-urlencode 'aud=spiffe://ds9.dsx.nvid.id/openbao' \
  'http://[fd00:76b9::254]/latest/meta-data/identity'
```

Example response:

```json
{
  "token": "<dsx-jwt-svid>",
  "expires_in": 300,
  "spiffe_id": "spiffe://tenant-2.ds9.dsx.nvid.id/vm/example-vm"
}
```

Plain-text request:

```bash
curl --fail-with-body --silent --show-error --noproxy '*' --get \
  --header 'Metadata: true' \
  --header 'Accept: text/plain' \
  --data-urlencode 'aud=spiffe://ds9.dsx.nvid.id/openbao' \
  http://169.254.169.254/latest/meta-data/identity
```

Plain-text response:

```text
<dsx-jwt-svid>
```

The bare-metal host path is a node-attestation contract, not a generic
host-process identity contract. See the [DSX IMDS
API](/workload-identity/components/imds#http-api) for the versioned endpoint and
plain-text response option.

## Consume a DSX JWT-SVID

Use the returned `token` value as the relying party bearer credential:

```bash
curl --fail-with-body \
  --header 'Authorization: Bearer <dsx-jwt-svid>' \
  https://relying-party.example/v1/resource
```

Do not log or persist the token.

## Validate a DSX JWT-SVID

Example request:

```bash
curl --fail-with-body \
  https://identity-keys.shard.example.com/.well-known/jwks.json
```

Example response:

```json
{
  "keys": [
    {
      "use": "sig",
      "kty": "EC",
      "kid": "<key-id>",
      "crv": "P-256",
      "alg": "ES256",
      "x": "<x-coordinate>",
      "y": "<y-coordinate>"
    }
  ]
}
```

Example verifier settings:

```yaml
issuer: https://ds9.dsx.nvid.id
audience: spiffe://ds9.dsx.nvid.id/openbao
jwks_url: https://identity-keys.shard.example.com/.well-known/jwks.json
```

With [NATS](https://docs.nats.io/nats-concepts/jetstream/key-value-store) enabled, every shard serves the aggregate JWKS. With NATS disabled,
use the issuing shard's endpoint.