Skip to content

feat(gateway): OIDC multi-idp reference and guide for extra_jwks_urls#5550

Open
lena-larionova wants to merge 3 commits into
mainfrom
feat/multi-idp
Open

feat(gateway): OIDC multi-idp reference and guide for extra_jwks_urls#5550
lena-larionova wants to merge 3 commits into
mainfrom
feat/multi-idp

Conversation

@lena-larionova

@lena-larionova lena-larionova commented Jun 11, 2026

Copy link
Copy Markdown
Contributor

Description

  • Reference for multi-idp support in OIDC
  • how-to guide for extra_jwks_urls approach

Note: this is logged as a 3.15 feature ticket but is already available in 3.14; work was originally planned in the product but we already have support and just need to make docs more clear + complete. You can test with the regular quickstart.

Fixes #5465
Fixes #5419

Preview Links

https://deploy-preview-5550--kongdeveloper.netlify.app/plugins/openid-connect/#multi-idp-support
https://deploy-preview-5550--kongdeveloper.netlify.app/plugins/openid-connect/multi-idp/
https://deploy-preview-5550--kongdeveloper.netlify.app/how-to/configure-oidc-with-multi-idp/

Copilot AI review requested due to automatic review settings June 11, 2026 18:17
@lena-larionova lena-larionova requested a review from a team as a code owner June 11, 2026 18:17
@netlify

netlify Bot commented Jun 11, 2026

Copy link
Copy Markdown

Deploy Preview for kongdeveloper ready!

Name Link
🔨 Latest commit a842861
🔍 Latest deploy log https://app.netlify.com/projects/kongdeveloper/deploys/6a2b1cc9949f5f0008a665ed
😎 Deploy Preview https://deploy-preview-5550--kongdeveloper.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR adds new documentation to clarify how to validate JWT access tokens from multiple identity providers (IdPs) with the OpenID Connect (OIDC) plugin, including a new reference page, a dedicated how-to, supporting prerequisites, and diagrams, plus a new “Multi-IdP support” section in the plugin overview.

Changes:

  • Added a new reference page comparing “trusted issuers registry” vs token exchange for multi-IdP scenarios.
  • Added a new Gateway how-to showing a Keycloak two-realm setup for the extra_jwks_uris / issuers_allowed approach.
  • Updated the OIDC plugin overview page to introduce multi-IdP support and link to the new reference.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 9 comments.

Show a summary per file
File Description
app/gateway/plugins/oidc/multi-idp.md New reference page describing multi-IdP approaches, config, and troubleshooting.
app/_kong_plugins/openid-connect/index.md Adds a multi-IdP overview section and links to the new reference.
app/_includes/prereqs/auth/oidc/keycloak-multi-idp.md New prerequisite include to set up Keycloak with two realms for the how-to.
app/_includes/plugins/oidc/diagrams/multi-idp-trusted-issuers.md New Mermaid sequence diagram for the trusted issuers registry flow.
app/_how-tos/gateway/configure-oidc-with-multi-idp.md New how-to for configuring trusted issuers registry multi-IdP validation using Keycloak realms.

Comment thread app/_kong_plugins/openid-connect/index.md Outdated
Comment thread app/_kong_plugins/openid-connect/index.md Outdated
Comment thread app/_kong_plugins/openid-connect/index.md Outdated
Comment thread app/_kong_plugins/openid-connect/index.md Outdated
Comment thread app/gateway/plugins/oidc/multi-idp.md
Comment thread app/gateway/plugins/oidc/multi-idp.md
Comment thread app/_includes/plugins/oidc/diagrams/multi-idp-trusted-issuers.md Outdated
Comment thread app/_how-tos/gateway/configure-oidc-with-multi-idp.md
Comment thread app/_how-tos/gateway/configure-oidc-with-multi-idp.md Outdated
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Include multi-idp docs [KGW 3.15] Multi-IdP support

2 participants