Answer: You set up OIDC authentication for the Claude apps gateway by configuring the `oidc` block in gateway.yaml, which connects the gateway to your identity provider and decides who can sign in. It requires an `issuer` and `client_id`, plus a `client_secret` unless `token_endpoint_auth_method` is `private_key_jwt`. Status: Confirmed Entry: tool/claude-code/admin-and-enterprise/gateway-oidc-setup Revision: 3 Digest: sha256:afa2e23b59409b04 (changes whenever the content changes) Timeline: Created: 2026-11-13T03:03:26Z Last changed: 2026-11-17T12:23:05Z (client_secret: — → Unless `token_endpoint_auth_method` is `private_key_jwt`) Last verified: 2026-11-20T12:18:34Z Next check: 2026-11-21T12:18:34Z Check interval: Daily Expected change: No fixed schedule Data: Field | Value | Source | As of config block | oidc | [1] | 2026-11-20 issuer | Yes | [1] | 2026-11-20 client_id | Yes | [1] | 2026-11-20 client_secret | Unless `token_endpoint_auth_method` is `private_key_jwt` | [1] | 2026-11-20 default scopes | [openid, profile, email, offline_access] | [1] | 2026-11-20 default email_claim | email | [1] | 2026-11-20 default groups_claim | groups | [1] | 2026-11-20 default use_pkce | true | [1] | 2026-11-20 Sources: [1] Anthropic. "Claude apps gateway configuration". https://code.claude.com/docs/en/claude-apps-gateway-config.md Role: primary. Accessed: 2026-11-20T12:18:34Z Quote: "The `oidc` block connects the gateway to your identity provider and decides who can sign in." (Supports: config block) Quote: "| `issuer` | Yes | OIDC discovery base." (Supports: issuer) Quote: "| `client_id` | Yes | From your OAuth client registration |" (Supports: client_id) Quote: "| `client_secret` | Unless `token_endpoint_auth_method` is `private_key_jwt` | From your OAuth client registration." (Supports: client_secret) Quote: "Default `[openid, profile, email, offline_access]`." (Supports: default scopes) Quote: "| `email_claim` | No | Which id\_token claim carries the user's email. Default `email`." (Supports: default email_claim) Quote: "| `groups_claim` | No | Which id\_token claim carries group membership. Default `groups`." (Supports: default groups_claim) Quote: "| `use_pkce` | No | Send a PKCE (S256) challenge on the authorization request. Default `true`." (Supports: default use_pkce) Published: 2026-11-20T10:36:07Z Snapshot SHA-256: c110ccb1294b9d24e010a27fafad5aebb5627347fedd99744031249eb8098d9d (captured 2026-11-17T12:23:05Z) Verification: Method: Automated extraction from [1] with deepseek-flash (JSON output, thinking disabled). Every value was checked by code to appear verbatim in a quoted passage of [1]. On this check the text of [1] was unchanged since 2026-11-17T12:23:05Z, so the values verified then were kept. Cross-check: not-available at 2026-11-20T12:18:34Z. No independent second source is configured for this entry Last successful check: 2026-11-20T12:18:34Z Last attempt: 2026-11-20T12:18:34Z Notes and limitations: Extracted automatically from a single official source (section "`oidc`"). Related: https://latestn.com/tool/claude-code/admin-and-enterprise/gateway-requirements What are the requirements a gateway must meet before rolling it out for Claude Code in an organization? https://latestn.com/tool/claude-code/admin-and-enterprise/gateway-telemetry-export How do I configure telemetry export in the Claude apps gateway? https://latestn.com/tool/claude-code/admin-and-enterprise/gcp-gateway-prerequisites What do I need to set up before deploying Claude apps gateway on Google Cloud? https://latestn.com/tool/claude-code/admin-and-enterprise/foundry-rbac-permissions What Azure RBAC permissions are required to use Claude Code with Microsoft Foundry? https://latestn.com/tool/claude-code/admin-and-enterprise/gateway-availability-limitations What are the availability and limitations of the Claude apps gateway for Claude Code? https://latestn.com/tool/claude-code/admin-and-enterprise/gateway-multiple-upstreams How do I configure multiple upstreams in the Claude apps gateway.yaml file? https://latestn.com/tool/ All entries in AI tools Change log: Time | Event | Change | Source 2026-11-17T12:23:05Z | changed | client_secret: — → Unless `token_endpoint_auth_method` is `private_key_jwt` | [1] 2026-11-17T12:23:05Z | changed | config block: — → oidc | [1] 2026-11-17T12:23:05Z | changed | default id_token_signed_response_alg: RS256 → — | [1] 2026-11-17T12:23:05Z | changed | client_secret requirement: Unless `token_endpoint_auth_method` is `private_key_jwt` → — | [1] 2026-11-17T12:23:05Z | changed | client_id: From your OAuth client registration → Yes | [1] 2026-11-17T12:23:05Z | changed | issuer: OIDC discovery base. Must serve discovery at `/.well-known/openid-configuration`. → Yes | [1] 2026-11-15T12:18:15Z | changed | client_secret requirement: — → Unless `token_endpoint_auth_method` is `private_key_jwt` | [1] 2026-11-15T12:18:15Z | changed | client_secret: Unless `token_endpoint_auth_method` is `private_key_jwt` → — | [1] 2026-11-15T12:18:15Z | changed | client_id: Yes → From your OAuth client registration | [1] 2026-11-15T12:18:15Z | changed | issuer: Yes → OIDC discovery base. Must serve discovery at `/.well-known/openid-configuration`. | [1] 2026-11-13T03:03:26Z | added | Entry created | — Changes for this entry as a feed: https://latestn.com/tool/claude-code/admin-and-enterprise/gateway-oidc-setup/latest Challenge this entry: Open challenges: None How: If a value here is wrong or out of date, send what is wrong and a link to evidence. Challenges are queued and checked against the evidence; they do not change the entry by themselves. If the entry changes as a result, the change log says so. Form: https://latestn.com/dispute/tool/claude-code/admin-and-enterprise/gateway-oidc-setup POST: https://latestn.com/dispute/tool/claude-code/admin-and-enterprise/gateway-oidc-setup with claim, evidence_url, and optionally field and contact (form-encoded or JSON) GET: https://latestn.com/dispute/tool/claude-code/admin-and-enterprise/gateway-oidc-setup?claim={what is wrong}&evidence_url={link} How to cite: LatestN. (2026). How do I set up OIDC authentication for the Claude apps gateway? Revision 3, last verified 2026-11-20T12:18:34Z. https://latestn.com/tool/claude-code/admin-and-enterprise/gateway-oidc-setup (accessed 2026-11-21T09:56:58Z). @misc{LatestN_tool_claude_code_admin_and_enterprise_gateway_oidc_setup_r3, title = {How do I set up OIDC authentication for the Claude apps gateway?}, author = {{LatestN}}, year = {2026}, howpublished = {\url{https://latestn.com/tool/claude-code/admin-and-enterprise/gateway-oidc-setup}}, note = {Revision 3; digest sha256:afa2e23b59409b04; last verified 2026-11-20T12:18:34Z; accessed 2026-11-21T09:56:58Z} } Reuse: License: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/) Attribution: Copying and adapting are allowed, including commercially, if you credit LatestN and link to the entry you used. Each entry ends with a ready-made citation. URL: https://latestn.com/tool/claude-code/admin-and-enterprise/gateway-oidc-setup