Trust an external token issuer
set_trusted_issuerConfigures a domain's JWT/API key endpoints to accept an identity provider's tokens by setting its issuer and required audience; can also replace an existing issuer.
Instructions
Makes the domain's jwt / apiKeyOrJwt endpoints accept tokens from an identity provider, or replaces the issuer of that name. issuer must be the exact iss the provider puts in tokens (Auth0's ends with "/", Entra's does not). audience is REQUIRED — the provider signs every app's tokens with the same keys. kind "jwks" (default) verifies RS/PS/ES against published keys; kind "hs256" verifies HS256 against a shared secret (Supabase's JWT secret, aud "authenticated") passed as secret — write-only, omit it to keep the stored one. The block then sees request.auth.issuer (the name) and request.auth.subject. Check it with check_trusted_issuer. Requires confirm=true.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"domainId": "<domainId>",
"name": "<name>",
"issuer": "<issuer>",
"audience": "<audience>"
},
"name": "set_trusted_issuer"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | "jwks" (published public keys, default) or "hs256" (a shared secret). Omit to keep an existing issuer's kind. | |
| name | Yes | The issuer's name on this domain, e.g. "auth0" — lowercase letters, digits, hyphens. | |
| issuer | Yes | The issuer URL, exactly as the token's iss, e.g. "https://tenant.eu.auth0.com/". | |
| secret | No | hs256 only: the shared secret tokens are signed with, at least 32 bytes. Never returned. Omit to keep the stored one. | |
| confirm | No | Must be true to act. Omit/false returns a preview only. | |
| enabled | No | false keeps the configuration but refuses its tokens. | |
| jwksUri | No | Omit to find the keys through the issuer's discovery document. | |
| audience | Yes | The value the provider puts in aud for this API. | |
| domainId | Yes | The domain's id — from list_domains. | |
| scopeClaim | No | Where the provider puts permissions: scope (default), scp (Entra, Okta), permissions (Auth0 RBAC), roles. |