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

# JWT Auth plugin

> Reference for the JWT Auth plugin, which validates JSON Web Tokens from your identity provider.

The JWT Auth plugin identifies the caller from a signed JSON Web Token (JWT) that your identity provider issued. The instance names the provider. The provider supplies the signing keys, the issuer and audience checks, and the claim that names the consumer. The plugin also reads claims into an agent identity, which the agent plugins use.

> **Note**
>
> JWT Auth isn't available when Postman hosts your data plane. For more information, see [Choose a deployment model](/evaluate/deployment-models).

## Where it runs

|             |                                              |
| ----------- | -------------------------------------------- |
| Protocols   | HTTP, LLM, and MCP routes                    |
| Scope kinds | `global`, `service`, `route`                 |
| Phase       | Authentication, before other request plugins |

## Configuration

| Field                 | Type             | Default                                     | Description                                                                                                                                                                      |
| --------------------- | ---------------- | ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `provider`            | string           | None                                        | The identity provider that issues the tokens.                                                                                                                                    |
| `token_sources`       | array of objects | `Authorization` header with scheme `Bearer` | Where to read the token, in order. Each entry has `type` (`header` or `cookie`), `name`, and an optional `scheme`. A header other than `Authorization` has no scheme by default. |
| `subject_claim`       | string           | `sub`                                       | The claim for the subject.                                                                                                                                                       |
| `principal_claim`     | string           | `principalId`                               | The claim for the principal.                                                                                                                                                     |
| `kind_claim`          | string           | `user_type`                                 | The claim that marks the caller as an agent. The values `bot`, `agent`, and `service` mean an agent.                                                                             |
| `scopes_claim`        | string           | `scopes`                                    | The claim that holds the caller's scopes, as a space-separated string or a list.                                                                                                 |
| `tenant_claim`        | string           | `teamId`                                    | The claim for the caller's team.                                                                                                                                                 |
| `user_claim`          | string           | `userId`                                    | The claim for the user.                                                                                                                                                          |
| `session_claim`       | string           | `jti`                                       | The claim for the session.                                                                                                                                                       |
| `consumer_type_claim` | string           | `consumerType`                              | The claim for the consumer type. The value `autonomous_agent` also means an agent.                                                                                               |
| `installation_claim`  | string           | `installationUid`                           | The claim for the installation.                                                                                                                                                  |

The claim fields fill the agent identity. They don't change whether the gateway accepts the token. The gateway allows 60 seconds of clock skew by default.

## Example

```json
{
  "name": "jwt-auth-mcp",
  "plugin_id": "jwt-auth",
  "scope": { "kind": "route", "name": "linear-mcp" },
  "config": {
    "provider": "okta-workforce",
    "token_sources": [{ "type": "header", "name": "Authorization", "scheme": "Bearer" }]
  }
}
```

## Related guides

* [Authenticate requests with JWT Auth](/configure/authentication/jwt-auth)