Skip to content

website/docs: ssf: update SSF documentation#20195

Merged
dewi-tik merged 6 commits intomainfrom
website/docs--update-ssf-provider-docs
Feb 11, 2026
Merged

website/docs: ssf: update SSF documentation#20195
dewi-tik merged 6 commits intomainfrom
website/docs--update-ssf-provider-docs

Conversation

@dewi-tik
Copy link
Contributor

Details

Updates the formatting and fixes some issues.


Checklist

If applicable

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

@dewi-tik dewi-tik requested a review from a team as a code owner February 11, 2026 12:45
@netlify
Copy link

netlify bot commented Feb 11, 2026

Deploy Preview for authentik-integrations ready!

Name Link
🔨 Latest commit b9d7f5e
🔍 Latest deploy log https://app.netlify.com/projects/authentik-integrations/deploys/698cd54e3ffe570008935f8a
😎 Deploy Preview https://deploy-preview-20195--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.

@netlify
Copy link

netlify bot commented Feb 11, 2026

Deploy Preview for authentik-docs ready!

Name Link
🔨 Latest commit b9d7f5e
🔍 Latest deploy log https://app.netlify.com/projects/authentik-docs/deploys/698cd54edc331900082c108b
😎 Deploy Preview https://deploy-preview-20195--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.

Co-authored-by: Dominic R <dominic@sdko.org>
Signed-off-by: Dewi Roberts <dewi@goauthentik.io>
@dewi-tik dewi-tik self-assigned this Feb 11, 2026
@dewi-tik dewi-tik added area:docs Features or issues related to Docusaurus backport/version-2025.12 Add this label to PRs to backport changes to version-2025.12 backport/version-2026.2 Add this label to PRs to backport changes to version-2026.2 labels Feb 11, 2026
@codecov
Copy link

codecov bot commented Feb 11, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 93.32%. Comparing base (26eb34e) to head (b9d7f5e).
⚠️ Report is 1 commits behind head on main.
✅ All tests successful. No failed tests found.

Additional details and impacted files
@@            Coverage Diff             @@
##             main   #20195      +/-   ##
==========================================
+ Coverage   93.29%   93.32%   +0.02%     
==========================================
  Files         978      978              
  Lines       54544    54544              
==========================================
+ Hits        50889    50901      +12     
+ Misses       3655     3643      -12     
Flag Coverage Δ
conformance 37.75% <ø> (+<0.01%) ⬆️
e2e 43.62% <ø> (-0.01%) ⬇️
integration 22.57% <ø> (+<0.01%) ⬆️
unit 91.51% <ø> (+<0.01%) ⬆️
unit-migrate 91.52% <ø> (+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
Copy link
Contributor

github-actions bot commented Feb 11, 2026

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-b9d7f5e5f53131d620d228daf7a99620c6af8e08
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-b9d7f5e5f53131d620d228daf7a99620c6af8e08

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

@dewi-tik dewi-tik requested a review from dominic-r February 11, 2026 16:54
@dewi-tik dewi-tik assigned tanberry and unassigned tanberry Feb 11, 2026
@dewi-tik dewi-tik requested a review from tanberry February 11, 2026 16:54
@dewi-tik dewi-tik moved this from Todo to Needs review in authentik Core Feb 11, 2026
@github-project-automation github-project-automation bot moved this from Needs review to In Progress in authentik Core Feb 11, 2026
Co-authored-by: Dominic R <dominic@sdko.org>
Signed-off-by: Dewi Roberts <dewi@goauthentik.io>
Another example use case is when an application uses SSF to subscribe to authorization events because the application needs to know if a user changed their password in authentik. If a user did change their password, then the application receives a POST request to write the fact that the password was changed.

## About using SSF in authentik
## Using the authentik SSF provider
Copy link
Contributor

Choose a reason for hiding this comment

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

For a while, we used the term "About" to indicate that this is a conceptual section, not procedural... however Jens doesn't like the word "about" so we can lose it, but using the gerund form of the verb runs the risk of making readers expect a procedural topic. a compromise would be "The authentik SSF Provider"... however, this is something we can discuss and come to an agreement on and add to Style Guide, later.

Copy link
Contributor

@tanberry tanberry left a comment

Choose a reason for hiding this comment

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

Nice improvements, thanks @dewi-tik .

Co-authored-by: Tana M Berry <tanamarieberry@yahoo.com>
Signed-off-by: Dewi Roberts <dewi@goauthentik.io>
@dewi-tik dewi-tik moved this from In Progress to In review in authentik Core Feb 11, 2026
@dewi-tik dewi-tik enabled auto-merge (squash) February 11, 2026 19:15
@dewi-tik dewi-tik merged commit 0329b6e into main Feb 11, 2026
102 checks passed
@dewi-tik dewi-tik deleted the website/docs--update-ssf-provider-docs branch February 11, 2026 19:44
@github-project-automation github-project-automation bot moved this from In review to Done in authentik Core Feb 11, 2026
authentik-automation bot pushed a commit that referenced this pull request Feb 11, 2026
* Update SSF documentation

* Fix tags

* Update website/docs/add-secure-apps/providers/ssf/create-ssf-provider.md

Co-authored-by: Dominic R <dominic@sdko.org>
Signed-off-by: Dewi Roberts <dewi@goauthentik.io>

* Update website/docs/add-secure-apps/providers/ssf/index.md

Co-authored-by: Dominic R <dominic@sdko.org>
Signed-off-by: Dewi Roberts <dewi@goauthentik.io>

* Apply suggestions from code review

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

---------

Signed-off-by: Dewi Roberts <dewi@goauthentik.io>
Co-authored-by: Dominic R <dominic@sdko.org>
Co-authored-by: Tana M Berry <tanamarieberry@yahoo.com>
@authentik-automation
Copy link
Contributor

🍒 Cherry-pick to version-2025.12 created: #20210

authentik-automation bot pushed a commit that referenced this pull request Feb 11, 2026
* Update SSF documentation

* Fix tags

* Update website/docs/add-secure-apps/providers/ssf/create-ssf-provider.md

Co-authored-by: Dominic R <dominic@sdko.org>
Signed-off-by: Dewi Roberts <dewi@goauthentik.io>

* Update website/docs/add-secure-apps/providers/ssf/index.md

Co-authored-by: Dominic R <dominic@sdko.org>
Signed-off-by: Dewi Roberts <dewi@goauthentik.io>

* Apply suggestions from code review

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

---------

Signed-off-by: Dewi Roberts <dewi@goauthentik.io>
Co-authored-by: Dominic R <dominic@sdko.org>
Co-authored-by: Tana M Berry <tanamarieberry@yahoo.com>
@authentik-automation
Copy link
Contributor

🍒 Cherry-pick to version-2026.2 created: #20211

dewi-tik added a commit that referenced this pull request Feb 11, 2026
…rsion-2026.2) (#20211)

website/docs: ssf: update SSF documentation (#20195)

* Update SSF documentation

* Fix tags

* Update website/docs/add-secure-apps/providers/ssf/create-ssf-provider.md




* Update website/docs/add-secure-apps/providers/ssf/index.md




* Apply suggestions from code review




---------

Signed-off-by: Dewi Roberts <dewi@goauthentik.io>
Co-authored-by: Dewi Roberts <dewi@goauthentik.io>
Co-authored-by: Dominic R <dominic@sdko.org>
Co-authored-by: Tana M Berry <tanamarieberry@yahoo.com>
dewi-tik added a commit that referenced this pull request Feb 12, 2026
…rsion-2025.12) (#20210)

website/docs: ssf: update SSF documentation (#20195)

* Update SSF documentation

* Fix tags

* Update website/docs/add-secure-apps/providers/ssf/create-ssf-provider.md




* Update website/docs/add-secure-apps/providers/ssf/index.md




* Apply suggestions from code review




---------

Signed-off-by: Dewi Roberts <dewi@goauthentik.io>
Co-authored-by: Dewi Roberts <dewi@goauthentik.io>
Co-authored-by: Dominic R <dominic@sdko.org>
Co-authored-by: Tana M Berry <tanamarieberry@yahoo.com>
kensternberg-authentik added a commit that referenced this pull request Feb 12, 2026
* main: (59 commits)
  website/docs: 2025.12.4 release notes (#20226)
  website/docs: 2025.10.4 release notes (#20242)
  security: CVE-2026-25748 (#20240)
  security: CVE-2026-25922 (#20241)
  security: CVE-2026-25227 (#20239)
  ci: fix release testing (#20207)
  core: Apply CSpell corrections. (#20191)
  core: bump goauthentik.io/api/v3 to 3.2026.5.0-rc1-1770842608 (#20213)
  core, web: update translations (#20215)
  core: bump library/node from 25.6.0-trixie to 25.6.1-trixie in /website (#20220)
  core: bump google-api-python-client from 2.189.0 to 2.190.0 (#20217)
  core: bump webauthn from 2.7.0 to 2.7.1 (#20218)
  ci: bump docker/build-push-action from 6.18.0 to 6.19.1 (#20221)
  website/integrations: Update Komga instructions to add "email_verified" attribute to "email" claim. (#20135)
  website: Apply CSpell corrections. (#20189)
  providers/saml: send logoutResponse on sp-init logout (#17691)
  website/docs: ssf: update SSF documentation (#20195)
  website/docs: draft of new WS-Fed provider docs  (#20091)
  website/docs: add email verification scope doc (#20141)
  website/docs: correct reference to overriden S3 variable (#20156)
  ...
kensternberg-authentik added a commit that referenced this pull request Feb 12, 2026
* main: (59 commits)
  website/docs: 2025.12.4 release notes (#20226)
  website/docs: 2025.10.4 release notes (#20242)
  security: CVE-2026-25748 (#20240)
  security: CVE-2026-25922 (#20241)
  security: CVE-2026-25227 (#20239)
  ci: fix release testing (#20207)
  core: Apply CSpell corrections. (#20191)
  core: bump goauthentik.io/api/v3 to 3.2026.5.0-rc1-1770842608 (#20213)
  core, web: update translations (#20215)
  core: bump library/node from 25.6.0-trixie to 25.6.1-trixie in /website (#20220)
  core: bump google-api-python-client from 2.189.0 to 2.190.0 (#20217)
  core: bump webauthn from 2.7.0 to 2.7.1 (#20218)
  ci: bump docker/build-push-action from 6.18.0 to 6.19.1 (#20221)
  website/integrations: Update Komga instructions to add "email_verified" attribute to "email" claim. (#20135)
  website: Apply CSpell corrections. (#20189)
  providers/saml: send logoutResponse on sp-init logout (#17691)
  website/docs: ssf: update SSF documentation (#20195)
  website/docs: draft of new WS-Fed provider docs  (#20091)
  website/docs: add email verification scope doc (#20141)
  website/docs: correct reference to overriden S3 variable (#20156)
  ...
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:docs Features or issues related to Docusaurus backport/version-2025.12 Add this label to PRs to backport changes to version-2025.12 backport/version-2026.2 Add this label to PRs to backport changes to version-2026.2

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

3 participants