Skip to content

website/docs: add oidc issuer information - #22556

Merged
dewi-tik merged 18 commits into
mainfrom
oidc-global-issuer
Jun 2, 2026
Merged

website/docs: add oidc issuer information#22556
dewi-tik merged 18 commits into
mainfrom
oidc-global-issuer

Conversation

@PeshekDotDev

Copy link
Copy Markdown
Contributor

Details

Currently this feature is fully undocumented, so i added some basic introductory information for the docs


Checklist

  • Local tests pass (ak test authentik/)
  • The code has been formatted (make lint-fix)

If an API change has been made

  • The API schema and clients have been updated (make gen)

If changes to the frontend have been made

  • The code has been formatted (make web)

If applicable

  • The documentation has been updated
  • The documentation has been formatted (make docs)

@PeshekDotDev PeshekDotDev self-assigned this May 22, 2026
@PeshekDotDev
PeshekDotDev requested a review from a team as a code owner May 22, 2026 02:53
@netlify

netlify Bot commented May 22, 2026

Copy link
Copy Markdown

Deploy Preview for authentik-integrations ready!

Name Link
🔨 Latest commit 2a85c91
🔍 Latest deploy log https://app.netlify.com/projects/authentik-integrations/deploys/6a1ee91bcfc24300090ae88d
😎 Deploy Preview https://deploy-preview-22556--authentik-integrations.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

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

Comment thread website/docs/add-secure-apps/providers/oauth2/index.mdx Outdated
Comment thread website/docs/add-secure-apps/providers/oauth2/index.mdx Outdated

Setting the issuer mode to _Same identifier is used for all providers_ (referred to internally as **global** mode) makes every OAuth2 provider on the authentik instance share the same issuer: the root URL of the instance (`https://authentik.company/`).

:::warning

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

i'd make this an :::info + adding a title

@netlify

netlify Bot commented May 22, 2026

Copy link
Copy Markdown

Deploy Preview for authentik-docs ready!

Name Link
🔨 Latest commit 2a85c91
🔍 Latest deploy log https://app.netlify.com/projects/authentik-docs/deploys/6a1ee91bb0c4e6000846e03b
😎 Deploy Preview https://deploy-preview-22556--authentik-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

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

Comment thread website/docs/add-secure-apps/providers/oauth2/index.mdx Outdated

@dominic-r dominic-r left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

once applied

@github-project-automation github-project-automation Bot moved this from Todo to In Progress in authentik Core May 22, 2026
PeshekDotDev and others added 3 commits May 21, 2026 21:58
Co-authored-by: Dominic R <dominic@goauthentik.io>
Signed-off-by: Connor Peshek <connor@connorpeshek.me>
Co-authored-by: Dominic R <dominic@goauthentik.io>
Signed-off-by: Connor Peshek <connor@connorpeshek.me>
Co-authored-by: Dominic R <dominic@goauthentik.io>
Signed-off-by: Connor Peshek <connor@connorpeshek.me>
@codecov

codecov Bot commented May 22, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 93.29%. Comparing base (f47fc31) to head (a38247a).
⚠️ Report is 4 commits behind head on main.
✅ All tests successful. No failed tests found.

Additional details and impacted files
@@           Coverage Diff           @@
##             main   #22556   +/-   ##
=======================================
  Coverage   93.29%   93.29%           
=======================================
  Files        1033     1033           
  Lines       60150    60150           
  Branches      400      400           
=======================================
+ Hits        56116    56117    +1     
+ Misses       4034     4033    -1     
Flag Coverage Δ
conformance 36.55% <ø> (ø)
e2e 41.81% <ø> (+<0.01%) ⬆️
integration 33.00% <ø> (+<0.01%) ⬆️
rust 0.00% <ø> (ø)
unit 92.23% <ø> (+<0.01%) ⬆️
unit-migrate 92.27% <ø> (+0.01%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

Comment thread website/docs/add-secure-apps/providers/oauth2/index.mdx Outdated
dominic-r and others added 2 commits May 21, 2026 23:03
Signed-off-by: Dominic R <dominic@goauthentik.io>
@PeshekDotDev

Copy link
Copy Markdown
Contributor Author

All good calls @dominic-r , added. Will wait for review from back-end team before continuing

Signed-off-by: Dewi Roberts <dewi@goauthentik.io>

@dewi-tik dewi-tik 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.

LGTM. Pushed some changes to the rest of the doc where I noticed some issues.

@netlify

netlify Bot commented May 26, 2026

Copy link
Copy Markdown

Deploy Preview for authentik-storybook ready!

Name Link
🔨 Latest commit a38247a
🔍 Latest deploy log https://app.netlify.com/projects/authentik-storybook/deploys/6a1f14971066ad000833877d
😎 Deploy Preview https://deploy-preview-22556--authentik-storybook.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

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

Signed-off-by: Connor Peshek <connor@connorpeshek.me>
@BeryJu BeryJu added the backport/version-2026.5 Add this label to PRs to backport changes to version-2026.5 label May 26, 2026
@dewi-tik
dewi-tik enabled auto-merge (squash) May 27, 2026 11:17
@dewi-tik
dewi-tik merged commit 6cdae9a into main Jun 2, 2026
112 checks passed
@dewi-tik
dewi-tik deleted the oidc-global-issuer branch June 2, 2026 18:08
@github-project-automation github-project-automation Bot moved this from In Progress to Done in authentik Core Jun 2, 2026
@github-actions

github-actions Bot commented Jun 2, 2026

Copy link
Copy Markdown
Contributor

authentik PR Installation instructions

Instructions for docker-compose

Add the following block to your .env file:

AUTHENTIK_IMAGE=ghcr.io/goauthentik/dev-server
AUTHENTIK_TAG=gh-a38247aabd9bb8700b8e85d1bbf42f36f83c4c28
AUTHENTIK_OUTPOSTS__CONTAINER_IMAGE_BASE=ghcr.io/goauthentik/dev-%(type)s:gh-%(build_hash)s

Afterwards, run the upgrade commands from the latest release notes.

Instructions for Kubernetes

Add the following block to your values.yml file:

authentik:
    outposts:
        container_image_base: ghcr.io/goauthentik/dev-%(type)s:gh-%(build_hash)s
global:
    image:
        repository: ghcr.io/goauthentik/dev-server
        tag: gh-a38247aabd9bb8700b8e85d1bbf42f36f83c4c28

Afterwards, run the upgrade commands from the latest release notes.

@authentik-automation

Copy link
Copy Markdown
Contributor

⚠️ Cherry-pick to version-2026.5 has conflicts: #22800

dominic-r added a commit that referenced this pull request Jun 4, 2026
* website/docs: add oidc issuer information

* Update website/docs/add-secure-apps/providers/oauth2/index.mdx

Co-authored-by: Dominic R <dominic@goauthentik.io>
Signed-off-by: Connor Peshek <connor@connorpeshek.me>

* Update website/docs/add-secure-apps/providers/oauth2/index.mdx

Co-authored-by: Dominic R <dominic@goauthentik.io>
Signed-off-by: Connor Peshek <connor@connorpeshek.me>

* Update website/docs/add-secure-apps/providers/oauth2/index.mdx

Co-authored-by: Dominic R <dominic@goauthentik.io>
Signed-off-by: Connor Peshek <connor@connorpeshek.me>

* Apply suggestion from @dominic-r

Signed-off-by: Dominic R <dominic@goauthentik.io>

* update warning to info

* Update language throughout the doc, fix punctuation and spelling

Signed-off-by: Dewi Roberts <dewi@goauthentik.io>

* update typos

* fix wording

* lint

---------

Signed-off-by: Connor Peshek <connor@connorpeshek.me>
Signed-off-by: Dominic R <dominic@goauthentik.io>
Signed-off-by: Dewi Roberts <dewi@goauthentik.io>
Co-authored-by: Dominic R <dominic@goauthentik.io>
Co-authored-by: Dewi Roberts <dewi@goauthentik.io>
dominic-r added a commit that referenced this pull request Jun 4, 2026
…ion-2026.5) (#22800)

* Cherry-pick #22556 to version-2026.5 (with conflicts)

This cherry-pick has conflicts that need manual resolution.

Original PR: #22556
Original commit: 6cdae9a

* website/docs: resolve OAuth2 docs conflict

Agent-thread: https://sdko.org/internal/threads/019e9455-de8d-7451-a51e-3f7b0924a20a

A7k-product: product

A7k-product-repo: 2

Co-authored-by: Agent <agent@svc.sdko.net>

---------

Co-authored-by: Connor Peshek <connor@connorpeshek.me>
Co-authored-by: Dominic R <dominic@goauthentik.io>
Co-authored-by: Agent <agent@svc.sdko.net>
kensternberg-authentik added a commit that referenced this pull request Jun 30, 2026
* main: (175 commits)
  web: fix British spellings flagged by cspell (#22820)
  web: Flesh out frontend, E2E, agent instructions. (#22388)
  root: update gen-changelog to filter unnecessary commits (#22550)
  root: gitignore release generation artifacts (#22549)
  sources/oauth: Fallback to `id` field when `sub` is missing in OIDC callback (#22672)
  translate: Updates for project authentik and language fr_FR (#22687)
  ci: replace deprecated app-id with client-id for actions/create-github-app-token (#22799)
  web: bump @playwright/test from 1.59.1 to 1.60.0 in /web (#22476)
  web: bump the storybook group across 1 directory with 5 updates (#22653)
  website/docs: add oidc issuer information (#22556)
  ci: bump snok/container-retention-policy from 3.0.1 to 3.1.0 (#22778)
  website: bump the build group across 1 directory with 9 updates (#22669)
  web: bump knip from 6.12.0 to 6.14.1 in /web (#22657)
  ci: update ubuntu version of ARM runners (#22798)
  core: bump openapitools/openapi-generator-cli from v7.20.0 to v7.22.0 in /packages/client-go (#22573)
  core: bump axllent/mailpit from v1.30.0 to v1.30.1 in /tests/e2e (#22747)
  core: bump goauthentik/fips-python from `33d1ed9` to `7a06339` in /lifecycle/container (#22676)
  ci: explicitly exit Node lint scripts to fix CI hang (#22794)
  core: bump openapitools/openapi-generator-cli from v7.21.0 to v7.22.0 in /packages/client-ts (#22575)
  core: bump django-stubs[compatible-mypy] from 6.0.4 to 6.0.5 (#22748)
  ...
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

backport/version-2026.5 Add this label to PRs to backport changes to version-2026.5

Projects

Archived in project

Development

Successfully merging this pull request may close these issues.

4 participants