website/docs: add docs for source switch expression policy by tanberry · Pull Request #16878 · goauthentik/authentik

tanberry · 2025-09-18T07:40:28Z

This PR adds a new topic about switching the source based on a user's email address/domain. Also cleans up some other areas in our policy docs.

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

netlify · 2025-09-18T07:40:32Z

✅ Deploy Preview for authentik-docs ready!

Name	Link
🔨 Latest commit	`4aa7225`
🔍 Latest deploy log	https://app.netlify.com/projects/authentik-docs/deploys/68d2d54ba38d140007098bd4
😎 Deploy Preview	https://deploy-preview-16878--authentik-docs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

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

netlify · 2025-09-18T07:40:33Z

✅ Deploy Preview for authentik-integrations ready!

Name	Link
🔨 Latest commit	`4aa7225`
🔍 Latest deploy log	https://app.netlify.com/projects/authentik-integrations/deploys/68d2d54b6c5e3700084504bd
😎 Deploy Preview	https://deploy-preview-16878--authentik-integrations.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

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

netlify · 2025-09-18T07:41:03Z

✅ Deploy Preview for authentik-storybook canceled.

Name	Link
🔨 Latest commit	`4aa7225`
🔍 Latest deploy log	https://app.netlify.com/projects/authentik-storybook/deploys/68d2d54bd828f500089f4c53

codecov · 2025-09-18T07:49:06Z

Codecov Report

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

Additional details and impacted files

@@            Coverage Diff             @@
##             main   #16878      +/-   ##
==========================================
+ Coverage   92.58%   92.78%   +0.20%     
==========================================
  Files         838      844       +6     
  Lines       45386    45593     +207     
==========================================
+ Hits        42021    42304     +283     
+ Misses       3365     3289      -76

Flag	Coverage Δ
e2e	`46.39% <ø> (+0.47%)`	⬆️
integration	`23.42% <ø> (-0.08%)`	⬇️
unit	`90.93% <ø> (+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.

github-actions · 2025-09-18T08:08:32Z

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-4aa7225dc4fa86ebfc1fd212f72d43bf501f64ce
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-4aa7225dc4fa86ebfc1fd212f72d43bf501f64ce

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

dewi-tik

Just a few suggestions. Great addition to the docs

Co-authored-by: Dewi Roberts <dewi@goauthentik.io> Signed-off-by: Tana M Berry <tanamarieberry@yahoo.com>

dewi-tik

Few more minor edits

Co-authored-by: Dewi Roberts <dewi@goauthentik.io> Signed-off-by: Tana M Berry <tanamarieberry@yahoo.com>

Co-authored-by: Jens L. <jens@goauthentik.io> Signed-off-by: Tana M Berry <tanamarieberry@yahoo.com>

BeryJu · 2025-09-23T17:27:52Z

@@ -0,0 +1,45 @@
+---
+title: Switch which source is used based on email address


Suggested change

title: Switch which source is used based on email address

title: Dynamic email-domain based federation

* draft for source switch docs * add python * add sidebar entry * Update website/docs/customize/policies/expression/source_switch.md Co-authored-by: Dewi Roberts <dewi@goauthentik.io> Signed-off-by: Tana M Berry <tanamarieberry@yahoo.com> * Update website/docs/customize/policies/index.md Co-authored-by: Dewi Roberts <dewi@goauthentik.io> Signed-off-by: Tana M Berry <tanamarieberry@yahoo.com> * Update website/docs/customize/policies/working_with_policies.md Co-authored-by: Dewi Roberts <dewi@goauthentik.io> Signed-off-by: Tana M Berry <tanamarieberry@yahoo.com> * Update website/docs/customize/policies/working_with_policies.md Co-authored-by: Dewi Roberts <dewi@goauthentik.io> Signed-off-by: Tana M Berry <tanamarieberry@yahoo.com> * add sectin about binding the policy * tweak * Update website/docs/customize/policies/index.md Co-authored-by: Dewi Roberts <dewi@goauthentik.io> Signed-off-by: Tana M Berry <tanamarieberry@yahoo.com> * Update website/docs/customize/policies/working_with_policies.md Co-authored-by: Dewi Roberts <dewi@goauthentik.io> Signed-off-by: Tana M Berry <tanamarieberry@yahoo.com> * Update website/docs/customize/policies/working_with_policies.md Co-authored-by: Dewi Roberts <dewi@goauthentik.io> Signed-off-by: Tana M Berry <tanamarieberry@yahoo.com> * Update website/docs/customize/policies/working_with_policies.md Co-authored-by: Dewi Roberts <dewi@goauthentik.io> Signed-off-by: Tana M Berry <tanamarieberry@yahoo.com> * Update website/docs/customize/policies/working_with_policies.md Co-authored-by: Dewi Roberts <dewi@goauthentik.io> Signed-off-by: Tana M Berry <tanamarieberry@yahoo.com> * Update website/docs/customize/policies/expression.mdx Co-authored-by: Jens L. <jens@goauthentik.io> Signed-off-by: Tana M Berry <tanamarieberry@yahoo.com> --------- Signed-off-by: Tana M Berry <tanamarieberry@yahoo.com> Co-authored-by: Tana M Berry <tana@goauthentik.io> Co-authored-by: Dewi Roberts <dewi@goauthentik.io> Co-authored-by: Jens L. <jens@goauthentik.io>

This cherry-pick has conflicts that need manual resolution. Original PR: #16878 Original commit: dbf85d0

authentik-automation · 2025-09-24T11:38:28Z

🍒 Cherry-pick to version-2025.8 created: #16972

authentik-automation · 2025-09-24T11:38:30Z

⚠️ Cherry-pick to version-2025.4 has conflicts: #16973

This cherry-pick has conflicts that need manual resolution. Original PR: #16878 Original commit: dbf85d0

authentik-automation · 2025-09-24T11:38:34Z

⚠️ Cherry-pick to version-2025.6 has conflicts: #16974

#16878) (#16972) website/docs: add docs for source switch expression policy (#16878) * draft for source switch docs * add python * add sidebar entry * Update website/docs/customize/policies/expression/source_switch.md * Update website/docs/customize/policies/index.md * Update website/docs/customize/policies/working_with_policies.md * Update website/docs/customize/policies/working_with_policies.md * add sectin about binding the policy * tweak * Update website/docs/customize/policies/index.md * Update website/docs/customize/policies/working_with_policies.md * Update website/docs/customize/policies/working_with_policies.md * Update website/docs/customize/policies/working_with_policies.md * Update website/docs/customize/policies/working_with_policies.md * Update website/docs/customize/policies/expression.mdx --------- Signed-off-by: Tana M Berry <tanamarieberry@yahoo.com> Co-authored-by: Tana M Berry <tanamarieberry@yahoo.com> Co-authored-by: Tana M Berry <tana@goauthentik.io> Co-authored-by: Dewi Roberts <dewi@goauthentik.io> Co-authored-by: Jens L. <jens@goauthentik.io>

tanberry added 2 commits September 18, 2025 09:35

draft for source switch docs

23cbf9b

add python

e0f6d6d

tanberry requested a review from a team as a code owner September 18, 2025 07:40

tanberry marked this pull request as draft September 18, 2025 07:40

add sidebar entry

6bb5e44

dewi-tik reviewed Sep 19, 2025

View reviewed changes

tanberry and others added 6 commits September 22, 2025 09:01

Update website/docs/customize/policies/expression/source_switch.md

a8185b0

Co-authored-by: Dewi Roberts <dewi@goauthentik.io> Signed-off-by: Tana M Berry <tanamarieberry@yahoo.com>

Update website/docs/customize/policies/index.md

685f7aa

Co-authored-by: Dewi Roberts <dewi@goauthentik.io> Signed-off-by: Tana M Berry <tanamarieberry@yahoo.com>

Update website/docs/customize/policies/working_with_policies.md

b9ddfcd

Co-authored-by: Dewi Roberts <dewi@goauthentik.io> Signed-off-by: Tana M Berry <tanamarieberry@yahoo.com>

Update website/docs/customize/policies/working_with_policies.md

c35ed88

Co-authored-by: Dewi Roberts <dewi@goauthentik.io> Signed-off-by: Tana M Berry <tanamarieberry@yahoo.com>

add sectin about binding the policy

070207d

tweak

667ca35

dewi-tik reviewed Sep 23, 2025

View reviewed changes

tanberry marked this pull request as ready for review September 23, 2025 12:51

tanberry requested a review from BeryJu September 23, 2025 12:52

tanberry and others added 6 commits September 23, 2025 11:37

Update website/docs/customize/policies/index.md

2fcb1dd

Co-authored-by: Dewi Roberts <dewi@goauthentik.io> Signed-off-by: Tana M Berry <tanamarieberry@yahoo.com>

Update website/docs/customize/policies/working_with_policies.md

83a22a5

Co-authored-by: Dewi Roberts <dewi@goauthentik.io> Signed-off-by: Tana M Berry <tanamarieberry@yahoo.com>

Update website/docs/customize/policies/working_with_policies.md

15562e2

Co-authored-by: Dewi Roberts <dewi@goauthentik.io> Signed-off-by: Tana M Berry <tanamarieberry@yahoo.com>

Update website/docs/customize/policies/working_with_policies.md

a961cfb

Co-authored-by: Dewi Roberts <dewi@goauthentik.io> Signed-off-by: Tana M Berry <tanamarieberry@yahoo.com>

Update website/docs/customize/policies/working_with_policies.md

044822e

Co-authored-by: Dewi Roberts <dewi@goauthentik.io> Signed-off-by: Tana M Berry <tanamarieberry@yahoo.com>

Update website/docs/customize/policies/expression.mdx

4aa7225

Co-authored-by: Jens L. <jens@goauthentik.io> Signed-off-by: Tana M Berry <tanamarieberry@yahoo.com>

BeryJu reviewed Sep 23, 2025

View reviewed changes

BeryJu approved these changes Sep 23, 2025

View reviewed changes

tanberry merged commit dbf85d0 into main Sep 23, 2025
109 checks passed

tanberry deleted the docs-source-switch branch September 23, 2025 18:57

tanberry added backport/version-2025.8 labels Sep 24, 2025

authentik-automation Bot pushed a commit that referenced this pull request Sep 24, 2025

Cherry-pick #16878 to version-2025.4 (with conflicts)

2ef351d

This cherry-pick has conflicts that need manual resolution. Original PR: #16878 Original commit: dbf85d0

This was referenced Sep 24, 2025

website/docs: add docs for source switch expression policy (cherry-pick #16878) #16972

Merged

website/docs: add docs for source switch expression policy (backport of #16878) #16973

Closed

authentik-automation Bot pushed a commit that referenced this pull request Sep 24, 2025

Cherry-pick #16878 to version-2025.6 (with conflicts)

e5c0673

This cherry-pick has conflicts that need manual resolution. Original PR: #16878 Original commit: dbf85d0

authentik-automation Bot mentioned this pull request Sep 24, 2025

website/docs: add docs for source switch expression policy (backport of #16878) #16974

Closed

tanberry mentioned this pull request Sep 24, 2025

Cherry pick pr 16878 #16981

Closed

2 tasks

		@@ -0,0 +1,45 @@
		---
		title: Switch which source is used based on email address

	title: Switch which source is used based on email address
	title: Dynamic email-domain based federation

Conversation

tanberry commented Sep 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

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

Uh oh!

✅ Deploy Preview for authentik-docs ready!

Uh oh!

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

Uh oh!

✅ Deploy Preview for authentik-integrations ready!

Uh oh!

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

Uh oh!

✅ Deploy Preview for authentik-storybook canceled.

Uh oh!

codecov Bot commented Sep 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

github-actions Bot commented Sep 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

dewi-tik left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

dewi-tik left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

BeryJu Sep 23, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

authentik-automation Bot commented Sep 24, 2025

Uh oh!

authentik-automation Bot commented Sep 24, 2025

Uh oh!

authentik-automation Bot commented Sep 24, 2025

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

tanberry commented Sep 18, 2025 •

edited

Loading

netlify Bot commented Sep 18, 2025 •

edited

Loading

netlify Bot commented Sep 18, 2025 •

edited

Loading

netlify Bot commented Sep 18, 2025 •

edited

Loading

codecov Bot commented Sep 18, 2025 •

edited

Loading

github-actions Bot commented Sep 18, 2025 •

edited

Loading