feat(identity): landing page by juliamrch · Pull Request #5271 · Kong/developer.konghq.com

juliamrch · 2026-05-18T13:19:21Z

Description

Needs to be merged last, after #1895
Closes #4246

To do

Update links from fix(identity): M0 and M1 reference page updates from feedback #5747 once this branch is updated

Preview Links

https://deploy-preview-5271--kongdeveloper.netlify.app/identity/

Checklist

Tested how-to docs. If not, note why here.
All pages contain metadata.
Any new docs link to existing docs.
All autogenerated instructions render correctly (API, decK, Konnect, Kong Manager).
Style guide (capitalized gateway entities, placeholder URLs) implemented correctly.
Every page has a description entry in frontmatter.
Add new pages to the product documentation index (if applicable).

netlify · 2026-05-18T13:19:27Z

✅ Deploy Preview for kongdeveloper ready!

Name	Link
🔨 Latest commit	`3a3e011`
🔍 Latest deploy log	https://app.netlify.com/projects/kongdeveloper/deploys/6a4c4ae9afd9720008ccba8c
😎 Deploy Preview	https://deploy-preview-5271--kongdeveloper.netlify.app
📱 Preview on mobile	Toggle 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.

cloudjumpercat · 2026-05-20T14:51:24Z

@juliamrch Just a few small notes:

Possibly move the Plugins section after Features. I like the list of supported plugins, but it is a little Gateway-centric.
Change the slug of the landing page to /kong-identity and then the existing Kong Identity reference slug should be changed to /kong-identity/reference to match what we do for other products. You can update the redirects in the _redirects file.
Check with the Kong Identity team about adding a feature support table that could cover products, supported methods, etc.
For the image, I think I'd favor a diagram like what we have here or even a mermaid diagram. If you want to do a diagram like the first one, I'd reach out to the writers Slack channel because I think there was a channel you could go to to request a diagram like that but I don't know who made them.

cloudjumpercat · 2026-05-28T20:04:36Z

@juliamrch I've updated the release/kong-identity-m0 with main, so it now has the Kong Identity product changes. Could you update your feature branch? There will definitely be some conflicts that I'll try to list out here:

I made Kong Identity a variable, so {{site.indentity}} will be the new variable name to use in place of Kong Identity.
The landing page should use /identity as its slug and I think the existing Kong Identity reference page would become /identity/reference.
For products in the metadata, those will change to - identity for the product instead of - kong-identity.

Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>

Copilot

Pull request overview

Adds a new Kong Identity landing page and reshapes existing Kong Identity reference URLs to align around /identity/ (landing) plus /identity/auth-servers/ (auth server reference), updating a few cross-doc references accordingly.

Changes:

Added a new landing page at /identity/ with product-specific CTAs and plugin/how-to surfacing.
Moved the existing auth server reference off /identity/ to /identity/auth-servers/ and updated at least one related-resource link.
Updated internal Kong Identity how-to patterns to use the new /identity/ base breadcrumb and auth-server deep link.

Reviewed changes

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

File	Description
app/kong-identity/principals-and-directories.md	Updates related resource link(s) to point at the new auth servers location.
app/kong-identity/auth-servers.md	Changes permalink to `/identity/auth-servers/` (now separate from the landing page).
app/_landing_pages/identity.yaml	Introduces the new Kong Identity landing page content and CTAs.
.claude/skills/kong-identity-how-to/references/how-to-patterns.md	Updates internal how-to template references to use `/identity/` and new auth-server anchor URL.

Comments suppressed due to low confidence (1)

app/kong-identity/auth-servers.md:12

Changing the permalink to /identity/auth-servers/ breaks existing links that still point to sections on the old /identity/ URL (for example /identity/#dynamic-claim-templates in multiple how-tos and includes), so those references need to be updated (or redirected) in the same PR to avoid 404/anchor breakage.

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

ajessup · 2026-07-06T17:03:40Z

+
+                Use {{site.identity}} to:
+                * Issue and validate OAuth 2.0 and OIDC tokens from authorization servers
+                * Manage authenticating entities across {{site.base_gateway}}, {{site.event_gateway_short}}, and {{site.dev_portal}} in one place with principals


Ideally this should reference multiple API and event Gateways

Also worth referencing that the same Principal can support multiple authentication types (multiple OAuth servers, API Keys, Usernames and Passwords)

ajessup · 2026-07-06T17:03:57Z

+                * Issue and validate OAuth 2.0 and OIDC tokens from authorization servers
+                * Manage authenticating entities across {{site.base_gateway}}, {{site.event_gateway_short}}, and {{site.dev_portal}} in one place with principals
+                * Drive plugin and policy behavior with metadata attached to principals
+                * Set up an out-of-the-box authorization server


Act as an OAuth 2.0 compatible authorization server, to allow complete OAuth protection to API endpoints and MCP Servers

ajessup · 2026-07-06T17:04:24Z

+                {{site.identity}} centralizes authentication in {{site.konnect_short_name}}. It provides principals and directories as a shared identity layer to authenticate across Kong products.
+
+                Use {{site.identity}} to:
+                * Issue and validate OAuth 2.0 and OIDC tokens from authorization servers


This is covered below.

ajessup · 2026-07-06T17:05:23Z

+                Use {{site.identity}} to:
+                * Issue and validate OAuth 2.0 and OIDC tokens from authorization servers
+                * Manage authenticating entities across {{site.base_gateway}}, {{site.event_gateway_short}}, and {{site.dev_portal}} in one place with principals
+                * Drive plugin and policy behavior with metadata attached to principals


Maybe simply "Drive complex Gateway behavior with metadata attached to principals"

ajessup

Added some feedback

Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>

Co-authored-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>

cloudjumpercat

LGTM!

Co-authored-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>

feat(identity): first draft for landing page

d68f9bb

juliamrch self-assigned this May 18, 2026

juliamrch added the product:kong-identity label May 18, 2026

juliamrch changed the title ~~feat(identity): first draft for landing page~~ feat(identity): landing page May 18, 2026

juliamrch changed the base branch from main to release/kong-identity-m0 May 18, 2026 14:27

juliamrch added 3 commits May 18, 2026 16:49

fix(identity): replace identity tag with kong-identity

9377816

fix(identity): replace identity tag with kong-identity

7f03983

feat(identity): add kong-identity tags to index how-tos

efebac6

juliamrch added 6 commits May 21, 2026 13:30

Merge branch 'release/kong-identity-m0' into iss4246

857f353

Merge branch 'release/kong-identity-m0' into iss4246

3692965

feat(identity): update links

834e643

feat(identity): add usecases table

69cabd8

feat(identity): new template

6883690

Merge branch 'release/kong-identity-m0' into iss4246

f522ef9

juliamrch force-pushed the release/kong-identity-m0 branch from 9319a81 to 2c9b188 Compare June 22, 2026 15:27

cloudjumpercat force-pushed the release/kong-identity-m0 branch 2 times, most recently from 33ce795 to 7b2f80b Compare June 24, 2026 20:59

juliamrch and others added 3 commits June 30, 2026 15:37

Merge branch 'release/kong-identity-m0' into iss4246

e7ab50f

Revise landing page, fix accidental ruby version commit, file renames

c1cc0dc

Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>

feat(identity): add product to landing page to allow dev partial builds

8e0d6cb

cloudjumpercat added this to the Kong Identity M0 and M1.1 milestone Jul 1, 2026

juliamrch added 2 commits July 3, 2026 13:14

Merge branch 'release/kong-identity-m0' into iss4246

ed1f117

feat(identity): replace image and polish syntax

93cecae

juliamrch marked this pull request as ready for review July 3, 2026 12:32

juliamrch requested a review from a team as a code owner July 3, 2026 12:32

Copilot AI review requested due to automatic review settings July 3, 2026 12:32

Copilot started reviewing on behalf of juliamrch July 3, 2026 12:32 View session

juliamrch added the release-docs Docs for release label Jul 3, 2026

Copilot AI reviewed Jul 3, 2026

View reviewed changes

Comment thread app/_landing_pages/identity.yaml

Comment thread app/_landing_pages/identity.yaml

Comment thread app/_landing_pages/identity.yaml

Comment thread app/_landing_pages/identity.yaml

juliamrch and others added 2 commits July 3, 2026 16:25

Apply suggestions from code review

237b902

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

add api link

3f921e7

Guaris requested a review from cloudjumpercat July 6, 2026 12:33

juliamrch added 2 commits July 6, 2026 16:55

feat(identity): split intro in 2 columns

875f6e9

Merge branch 'release/kong-identity-m0' into iss4246

51f0ed6

ajessup reviewed Jul 6, 2026

View reviewed changes

Comment thread app/_landing_pages/identity.yaml

ajessup reviewed Jul 6, 2026

View reviewed changes

Comment thread app/assets/images/konnect/kong-identity-hero.png

ajessup reviewed Jul 6, 2026

View reviewed changes

cloudjumpercat added 2 commits July 6, 2026 14:58

apply feedback

b76b1ff

Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>

Merge branch 'release/kong-identity-m0' into iss4246

9f1dcb1

cloudjumpercat reviewed Jul 6, 2026

View reviewed changes

Comment thread app/_landing_pages/identity.yaml Outdated

cloudjumpercat added 2 commits July 6, 2026 17:25

removing app mapping links

c40fefc

Co-authored-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>

Merge branch 'release/kong-identity-m0' into iss4246

8c0eaed

cloudjumpercat approved these changes Jul 7, 2026

View reviewed changes

cloudjumpercat reviewed Jul 7, 2026

View reviewed changes

Comment thread app/_landing_pages/identity.yaml

fix column count

3a3e011

Co-authored-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>

cloudjumpercat merged commit 5f8fc8f into release/kong-identity-m0 Jul 7, 2026
13 checks passed

cloudjumpercat deleted the iss4246 branch July 7, 2026 01:01

Uh oh!

Conversation

juliamrch commented May 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

To do

Preview Links

Checklist

Uh oh!

netlify Bot commented May 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for kongdeveloper ready!

Uh oh!

cloudjumpercat commented May 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

cloudjumpercat commented May 28, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

ajessup Jul 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

ajessup Jul 6, 2026

Choose a reason for hiding this comment

Uh oh!

ajessup Jul 6, 2026

Choose a reason for hiding this comment

Uh oh!

ajessup Jul 6, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

ajessup left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

cloudjumpercat left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

juliamrch commented May 18, 2026 •

edited

Loading

netlify Bot commented May 18, 2026 •

edited

Loading

cloudjumpercat commented May 20, 2026 •

edited

Loading

ajessup Jul 6, 2026 •

edited

Loading