feat(gateway): OIDC multi-idp reference and guide for extra_jwks_urls#5550
Open
lena-larionova wants to merge 3 commits into
Open
feat(gateway): OIDC multi-idp reference and guide for extra_jwks_urls#5550lena-larionova wants to merge 3 commits into
lena-larionova wants to merge 3 commits into
Conversation
✅ Deploy Preview for kongdeveloper ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
Contributor
There was a problem hiding this comment.
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_allowedapproach. - 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. |
a842861 to
7037c0c
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
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/