feat(identity): Principal directory reference by cloudjumpercat · Pull Request #5327 · Kong/developer.konghq.com

cloudjumpercat · 2026-05-21T21:06:14Z

Description

Fixes #5033

Preview Links

https://deploy-preview-5327--kongdeveloper.netlify.app/identity/principals/

TODO:

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-21T21:06:21Z

✅ Deploy Preview for kongdeveloper ready!

Name	Link
🔨 Latest commit	`3059d54`
🔍 Latest deploy log	https://app.netlify.com/projects/kongdeveloper/deploys/6a32d723bae803000863a6a5
😎 Deploy Preview	https://deploy-preview-5327--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.

* feat(event-gw): SASL PLAIN fetch Kong Identity principal * move directory to prereq and make a bit more generic Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> * add how to to index, fix validate wording Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> * Add identity product to how to Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> --------- Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> Co-authored-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>

* feat(event-gw): SASL OAUTH fetch Kong Identity principal * copilot review * fix conflict Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> * Add directory prereq, add network container step, some small wording adjustments Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> --------- Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> Co-authored-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>

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

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

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

Copilot

Pull request overview

Adds initial reference documentation for Kong Identity Principals and Directories and surfaces it from the main Kong Identity reference page, establishing shared introductory content via a reusable include.

Changes:

Adds a new /identity/principals/ reference page describing principals/directories, caching/TTL behavior, mappings, and API/UI configuration.
Introduces a shared include (sections/principals-and-directories.md) and embeds it in both the main Identity page and the new reference page.
Updates the main Kong Identity reference page to mention principals/directories and link to the new reference.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 6 comments.

File	Description
app/konnect-platform/kong-identity.md	Adds principals/directories to the conceptual overview and links to the new principals reference section.
app/kong-identity/principals-and-directories.md	New reference page for principals/directories, including API/UI steps, mappings, caching notes, and limitations.
app/_includes/sections/principals-and-directories.md	Shared introductory section content reused across Kong Identity pages.

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

juliamrch

Reviewed and added some suggestions to increase clarity. Not sure about the Example configuration section: shouldn't it be included in the API tab, in the Configure a principal section?

juliamrch · 2026-06-17T11:38:53Z

+
+### Identities
+
+Identities are references to how a principal is known in other systems. 


Avoiding passive voice for a smoother reading:

Suggested change

Identities are references to how a principal is known in other systems.

Identities are references to how other systems identify a principal.

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

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

cloudjumpercat added the release-docs Docs for release label May 21, 2026

cloudjumpercat force-pushed the feat/principal-directory-reference branch from 3994272 to 52cb7b3 Compare May 28, 2026 20:05

cloudjumpercat commented May 28, 2026

View reviewed changes

Comment thread app/kong-identity/principals-and-directories.md Outdated

cloudjumpercat commented May 28, 2026

View reviewed changes

Comment thread app/kong-identity/principals-and-directories.md Outdated

ajessup reviewed Jun 2, 2026

View reviewed changes

juliamrch mentioned this pull request Jun 3, 2026

Kong Identity: Basic auth support #5037

Open

jdemartini81 reviewed Jun 4, 2026

View reviewed changes

Comment thread app/kong-identity/principals-and-directories.md

juliamrch mentioned this pull request Jun 5, 2026

feat(identity): authenticate principals with Basic Auth #5451

Open

7 tasks

ajessup reviewed Jun 11, 2026

View reviewed changes

jakubdyszkiewicz and others added 14 commits June 12, 2026 09:40

First draft of principals reference, it's rough

313ef59

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

revise

a8d0b82

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

fix the failing build

006d266

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

Fixes from spec, other wording and formatting, add API request examples

d79328e

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

Kong Identity variable

37cf200

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

Apply PM feedback, new KEG section, new examples section

864eda3

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

UI steps draft

1add431

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

fix broken links

f1254f2

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

Add note about creating a directory in the UI

3a66386

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

Add lookup caching note

49cda2e

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

Apply PM feedback

af3bd94

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

Fix the name of the conditional expression

d86cd35

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

cloudjumpercat force-pushed the feat/principal-directory-reference branch from 0d94340 to d86cd35 Compare June 16, 2026 19:39

Connective content to the identity reference

0432302

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

cloudjumpercat marked this pull request as ready for review June 16, 2026 20:18

cloudjumpercat requested a review from a team as a code owner June 16, 2026 20:18

Copilot AI review requested due to automatic review settings June 16, 2026 20:18

Copilot started reviewing on behalf of cloudjumpercat June 16, 2026 20:19 View session

Copilot AI reviewed Jun 16, 2026

View reviewed changes

Apply suggestions from copilot

a7d4d14

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

juliamrch reviewed Jun 17, 2026

View reviewed changes

cloudjumpercat and others added 2 commits June 17, 2026 08:33

Apply suggestions from code review

69d0fc8

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

Change sections to fix tab weirdness

3059d54

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

cloudjumpercat force-pushed the release/kong-identity-m0 branch from a40068b to abd5b60 Compare June 17, 2026 18:56

juliamrch added the product:kong-identity label Jun 22, 2026

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


		### Identities

		Identities are references to how a principal is known in other systems.

	Identities are references to how a principal is known in other systems.
	Identities are references to how other systems identify a principal.

Conversation

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

Uh oh!

Description

Preview Links

Checklist

Uh oh!

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

Uh oh!

✅ Deploy Preview for kongdeveloper ready!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

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!

Uh oh!

juliamrch left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

juliamrch Jun 17, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

cloudjumpercat commented May 21, 2026 •

edited

Loading

netlify Bot commented May 21, 2026 •

edited

Loading