website/docs: add a single page about our user interface, document Consent stage by tanberry · Pull Request #20533 · goauthentik/authentik

tanberry · 2026-02-24T21:31:23Z

This PR adds a single page about the User interface, and what tasks an end user can accomplish there.

It also adds a new page, about the Consent stage.

TODOs:

research "LDAP limitation with 2FA"
finish MFA section
on Consent stage page, step 4, explain how to select the Order value for the policy

If applicable

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

netlify · 2026-02-24T21:31:54Z

✅ Deploy Preview for authentik-integrations ready!

Name	Link
🔨 Latest commit	`24fc66e`
🔍 Latest deploy log	https://app.netlify.com/projects/authentik-integrations/deploys/69c3f4f300b6c700081a926e
😎 Deploy Preview	https://deploy-preview-20533--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 · 2026-02-24T21:33:10Z

✅ Deploy Preview for authentik-docs ready!

Name	Link
🔨 Latest commit	`24fc66e`
🔍 Latest deploy log	https://app.netlify.com/projects/authentik-docs/deploys/69c3f4f352f8b80008379c19
😎 Deploy Preview	https://deploy-preview-20533--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.

github-actions · 2026-02-24T22:12:58Z

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-0ff60c67223c95b397b235173b7acdc228c98467
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-0ff60c67223c95b397b235173b7acdc228c98467

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

codecov · 2026-02-24T22:51:04Z

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 92.81%. Comparing base (237423d) to head (0ff60c6).
⚠️ Report is 3 commits behind head on main.
✅ All tests successful. No failed tests found.

Additional details and impacted files

@@           Coverage Diff           @@
##             main   #20533   +/-   ##
=======================================
  Coverage   92.81%   92.81%           
=======================================
  Files        1000     1000           
  Lines       56604    56604           
  Branches      425      425           
=======================================
+ Hits        52536    52539    +3     
+ Misses       4068     4065    -3

Flag	Coverage Δ
conformance	`37.38% <ø> (+<0.01%)`	⬆️
e2e	`42.89% <ø> (+0.04%)`	⬆️
integration	`22.22% <ø> (+<0.01%)`	⬆️
rust	`0.23% <ø> (ø)`
unit	`91.71% <ø> (+2.96%)`	⬆️
unit-migrate	`89.45% <ø> (-2.36%)`	⬇️

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.

dewi-tik

I know it's a draft. Just did a quick once over.

website/docs/users-sources/user/user-interface.mdx

tanberry · 2026-03-02T14:59:41Z

I know it's a draft. Just did a quick once over.

Thanks @dewi-tik yeah for sure still a draft.. I just copy/pasted rough notes in there without looking at typos... this habit of putting in very rough drafts comes from my fear of losing content/ideas... if I push it to GH then it is "safe." (Just to explain why it is so very messy.)

netlify · 2026-03-04T22:28:43Z

✅ Deploy Preview for authentik-storybook ready!

Name	Link
🔨 Latest commit	`0ff60c6`
🔍 Latest deploy log	https://app.netlify.com/projects/authentik-storybook/deploys/69c404779c42f300075305eb
😎 Deploy Preview	https://deploy-preview-20533--authentik-storybook.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.

Signed-off-by: Tana M Berry <tanamarieberry@yahoo.com>

website/docs/users-sources/user/user-interface.mdx

cspell.config.jsonc

Signed-off-by: Jens L. <jens@beryju.org>

BeryJu · 2026-03-24T18:50:58Z

website/docs/add-secure-apps/bindings-overview/index.md

+A _policy binding_ connects a specific policy (a policy object) to a flow or stage binding. With the policy binding, the flow (or specifically the stage within the flow) will now have additional content (i.e. the rules of the policy).

-With policy bindings, you can also bind groups and users to another component (an application, a source, a flow, etc.). For example you can bind a group to an application, and then only that group (or other groups also bound to it), can access the application.
+With policy bindings, you can also bind groups and users to another component (an application, a source, a flow, etc.). For example you can bind a specific group to an application, and then only that group (or other groups also bound to it), can access the application.


Depending on policy engine mode on the application this might be and instead of or, however or is default so /shrug

website/docs/add-secure-apps/bindings-overview/index.md

website/docs/add-secure-apps/flows-stages/stages/consent/index.md

website/docs/users-sources/user/user-interface.mdx

tanberry · 2026-03-24T20:59:19Z

@BeryJu got all the edits in, just one outstanding question.. On the MFA section of the User Interface, are there any options that are displayed by default, and the others can be added by adding stages? Or, are there none by default, and each one must be added?

* main: (42 commits) endpoints/connectors: fix enabled flag not respected (#21144) web: bump vite from 7.3.1 to 8.0.2 in /web (#21109) website/docs: add a single page about our user interface, document Consent stage (#20533) website: bump the build group across 1 directory with 9 updates (#21127) web: bump knip from 5.88.1 to 6.0.5 in /web (#21129) core: bump drf-spectacular from 0.28.0 to 0.29.0 (#19420) packages/client-go: init (#21139) providers/proxy: Add a default maxResponseBodySize to Traefik Middleware (#21111) core: bump library/nginx from `dec7a90` to `7150b3a` in /website (#21137) core: bump gunicorn from 25.1.0 to 25.2.0 (#21134) core: bump github.com/getsentry/sentry-go from 0.43.0 to 0.44.1 (#21122) core: bump astral-sh/uv from 0.11.0 to 0.11.1 in /lifecycle/container (#21135) ci: bump taiki-e/install-action from 2.69.8 to 2.69.9 in /.github/actions/setup (#21136) web/a11y: Modals, Command Palette (Merge branch) (#17812) website/docs: document file picker values (#20994) packages/client-rust: init (#21117) core: bump sentry-sdk from 2.55.0 to 2.56.0 (#21124) events: add helper to log deprecation configuration_warning message (#21115) core: bump djangorestframework from 3.17.0 to 3.17.1 (#21126) core: bump twilio from 9.10.3 to 9.10.4 (#21123) ...

* main: (26 commits) endpoints/connectors: fix enabled flag not respected (#21144) web: bump vite from 7.3.1 to 8.0.2 in /web (#21109) website/docs: add a single page about our user interface, document Consent stage (#20533) website: bump the build group across 1 directory with 9 updates (#21127) web: bump knip from 5.88.1 to 6.0.5 in /web (#21129) core: bump drf-spectacular from 0.28.0 to 0.29.0 (#19420) packages/client-go: init (#21139) providers/proxy: Add a default maxResponseBodySize to Traefik Middleware (#21111) core: bump library/nginx from `dec7a90` to `7150b3a` in /website (#21137) core: bump gunicorn from 25.1.0 to 25.2.0 (#21134) core: bump github.com/getsentry/sentry-go from 0.43.0 to 0.44.1 (#21122) core: bump astral-sh/uv from 0.11.0 to 0.11.1 in /lifecycle/container (#21135) ci: bump taiki-e/install-action from 2.69.8 to 2.69.9 in /.github/actions/setup (#21136) web/a11y: Modals, Command Palette (Merge branch) (#17812) website/docs: document file picker values (#20994) packages/client-rust: init (#21117) core: bump sentry-sdk from 2.55.0 to 2.56.0 (#21124) events: add helper to log deprecation configuration_warning message (#21115) core: bump djangorestframework from 3.17.0 to 3.17.1 (#21126) core: bump twilio from 9.10.3 to 9.10.4 (#21123) ...

tanberry added 2 commits February 24, 2026 11:57

rough draft

b2e0679

more content, still drafty

234c639

tanberry requested a review from a team as a code owner February 24, 2026 21:31

tanberry marked this pull request as draft February 24, 2026 21:31

dewi-tik reviewed Feb 25, 2026

View reviewed changes

tanberry and others added 2 commits March 2, 2026 09:59

Merge branch 'main' into docs-user-interface

d2e71fd

wow the Consent stage is interesting

10cbf6f

tanberry and others added 7 commits March 4, 2026 16:48

figured out consent policy binding

ab98c0c

more content

858afdc

tweak

fb952f3

add steps to create Consent stage

88fd2dd

add to sidebar, more procedural content

4540b22

Merge branch 'main' into docs-user-interface

d5c0313

Merge branch 'main' into docs-user-interface

64f5ef4

tanberry marked this pull request as ready for review March 16, 2026 20:17

tanberry added 3 commits March 16, 2026 21:29

tested steps, more polish

ec59bd4

fixed mangled section

5c79c0a

work on user interface doc

a500ca3

tanberry marked this pull request as draft March 16, 2026 20:31

tanberry and others added 5 commits March 17, 2026 07:34

Merge branch 'main' into docs-user-interface

437ad8d

Merge branch 'main' into docs-user-interface

6a58742

Merge branch 'main' into docs-user-interface

f944a6c

tweak to App paassword section

4faa86d

Merge branch 'main' into docs-user-interface

a83a977

tanberry and others added 4 commits March 23, 2026 10:46

Merge branch 'main' into docs-user-interface

5a09799

Signed-off-by: Tana M Berry <tanamarieberry@yahoo.com>

tweaks

ce156bb

tweak to a preposition

2edfda9

Merge branch 'main' into docs-user-interface

2783768

BeryJu reviewed Mar 23, 2026

View reviewed changes

website/docs/users-sources/user/user-interface.mdx Outdated Show resolved Hide resolved

BeryJu reviewed Mar 23, 2026

View reviewed changes

website/docs/users-sources/user/user-interface.mdx Outdated Show resolved Hide resolved

jens edits

c3a0e2c

tanberry requested review from BeryJu, dewi-tik and dominic-r March 23, 2026 15:58

tanberry and others added 2 commits March 23, 2026 17:13

removed unrelated change to cspell file

31b0535

Merge branch 'main' into docs-user-interface

c4d8622

dominic-r approved these changes Mar 24, 2026

View reviewed changes

Merge branch 'main' into docs-user-interface

f188739

BeryJu reviewed Mar 24, 2026

View reviewed changes

cspell.config.jsonc Outdated Show resolved Hide resolved

Apply suggestion from @BeryJu

ad6a989

Signed-off-by: Jens L. <jens@beryju.org>

BeryJu requested changes Mar 24, 2026

View reviewed changes

tanberry requested a review from BeryJu March 25, 2026 13:07

tanberry added 2 commits March 25, 2026 14:51

Jens edits

9b28424

two missed edits

903744b

BeryJu approved these changes Mar 25, 2026

View reviewed changes

Merge branch 'main' into docs-user-interface

24fc66e

tanberry enabled auto-merge (squash) March 25, 2026 14:47

Merge branch 'main' into docs-user-interface

0ff60c6

tanberry merged commit a6c5540 into main Mar 25, 2026
107 checks passed

tanberry deleted the docs-user-interface branch March 25, 2026 16:25

Uh oh!

Conversation

tanberry commented Feb 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

netlify bot commented Feb 24, 2026 • 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 Feb 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for authentik-docs ready!

Uh oh!

github-actions bot commented Feb 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

codecov bot commented Feb 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

dewi-tik left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

tanberry commented Mar 2, 2026

Uh oh!

netlify bot commented Mar 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for authentik-storybook ready!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

BeryJu Mar 24, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

tanberry commented Mar 24, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

tanberry commented Feb 24, 2026 •

edited

Loading

netlify bot commented Feb 24, 2026 •

edited

Loading

netlify bot commented Feb 24, 2026 •

edited

Loading

github-actions bot commented Feb 24, 2026 •

edited

Loading

codecov bot commented Feb 24, 2026 •

edited

Loading

netlify bot commented Mar 4, 2026 •

edited

Loading