Skip to content

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

Open
juliamrch wants to merge 23 commits into
feat/principal-directory-referencefrom
iss5037
Open

feat(identity): authenticate principals with Basic Auth#5451
juliamrch wants to merge 23 commits into
feat/principal-directory-referencefrom
iss5037

Conversation

@juliamrch

@juliamrch juliamrch commented Jun 3, 2026

Copy link
Copy Markdown
Contributor

Description

closes #5037

This PR contains a new guide for Kong Identity, using Principals and Basic Auth. It should be merged after #5327

Preview Links

https://deploy-preview-5451--kongdeveloper.netlify.app/how-to/authenticate-principals-with-basic-authentication/

Test instructions

  • Use a control plane from .tech, and when deploying the data plane, at the bottom of the script, replace kong/kong-gateway:3.14 by kong/kong-gateway-dev:3.15.0.0-rc.5
  • Use this environment variable: export KONNECT_CONTROL_PLANE_URL=https://us.api.konghq.tech
  • Replace the API endpoints: instead of us.api.konghq.com, use us.api.konghq.tech

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).

@juliamrch juliamrch self-assigned this Jun 3, 2026
@netlify

netlify Bot commented Jun 3, 2026

Copy link
Copy Markdown

Deploy Preview for kongdeveloper ready!

Name Link
🔨 Latest commit b395792
🔍 Latest deploy log https://app.netlify.com/projects/kongdeveloper/deploys/6a22d6ceaa20120008a28cef
😎 Deploy Preview https://deploy-preview-5451--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.

@juliamrch juliamrch added this to the Kong Identity M0 and M1.1 milestone Jun 3, 2026
@juliamrch juliamrch changed the base branch from main to release/kong-identity-m0 June 3, 2026 18:18
cloudjumpercat and others added 6 commits June 3, 2026 20:24
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>
Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>
@juliamrch juliamrch marked this pull request as ready for review June 3, 2026 18:25
@juliamrch juliamrch requested a review from a team as a code owner June 3, 2026 18:25
Copilot AI review requested due to automatic review settings June 3, 2026 18:25

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

Adds new Kong Identity documentation covering the core concepts of Directories/Principals and a Gateway how-to showing how to authenticate Principals using the Basic Authentication plugin.

Changes:

  • Introduces a new Kong Identity reference page explaining Principals, Directories, identities, credentials, metadata, and limits.
  • Adds a new Gateway how-to that creates a Directory + Principal and configures the Basic Auth plugin to authenticate Principals.
  • Includes validation steps demonstrating unauthorized vs authorized requests.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 8 comments.

File Description
app/kong-identity/principals-and-directories.md New reference page defining Kong Identity Principals/Directories and how they map to Gateway concepts.
app/_how-tos/gateway/authenticate-principals-with-basic-authentication.md New how-to for configuring Basic Auth to authenticate Kong Identity Principals and validating requests.

Comment thread app/kong-identity/principals-and-directories.md Outdated
Comment thread app/_how-tos/gateway/authenticate-principals-with-basic-authentication.md Outdated
Comment thread app/_how-tos/gateway/authenticate-principals-with-basic-authentication.md Outdated
Comment thread app/_how-tos/gateway/authenticate-principals-with-basic-authentication.md Outdated
Comment thread app/_how-tos/gateway/authenticate-principals-with-basic-authentication.md Outdated
Comment thread app/_how-tos/gateway/authenticate-principals-with-basic-authentication.md Outdated
Comment thread app/_how-tos/gateway/authenticate-principals-with-basic-authentication.md Outdated
juliamrch and others added 6 commits June 3, 2026 20:37
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Comment thread app/kong-identity/principals-and-directories.md Outdated
@juliamrch juliamrch marked this pull request as draft June 11, 2026 10:57
@juliamrch juliamrch changed the base branch from release/kong-identity-m0 to feat/principal-directory-reference June 17, 2026 15:57
@juliamrch juliamrch marked this pull request as ready for review June 17, 2026 16:03
@juliamrch juliamrch marked this pull request as draft June 17, 2026 16:49
@juliamrch juliamrch marked this pull request as ready for review June 22, 2026 15:11
- konnect

min_version:
gateway: '3.4'

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.

Suggested change
gateway: '3.4'
gateway: '3.15'

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.

Kong Identity: Basic auth support

4 participants