Skip to content

website/integrations: add OIDC and update SAML instructions for Zammad#20421

Merged
dewi-tik merged 7 commits intogoauthentik:mainfrom
abrain:feature/zammad-docs-oidc
Feb 20, 2026
Merged

website/integrations: add OIDC and update SAML instructions for Zammad#20421
dewi-tik merged 7 commits intogoauthentik:mainfrom
abrain:feature/zammad-docs-oidc

Conversation

@abrain
Copy link
Contributor

@abrain abrain commented Feb 19, 2026

Details

This Pull Request adds instructions how to configure authentik and Zammad for authentication via OpenID Connect. The current guide only shows the configuration for SAML.


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 has been updated (make gen-build)

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)

@abrain abrain requested a review from a team as a code owner February 19, 2026 14:55
@netlify
Copy link

netlify bot commented Feb 19, 2026

Deploy Preview for authentik-integrations ready!

Name Link
🔨 Latest commit e2ae57c
🔍 Latest deploy log https://app.netlify.com/projects/authentik-integrations/deploys/6998225f13e5f900088e831b
😎 Deploy Preview https://deploy-preview-20421--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 19, 2026

Deploy Preview for authentik-storybook ready!

Name Link
🔨 Latest commit 3b79010
🔍 Latest deploy log https://app.netlify.com/projects/authentik-storybook/deploys/699750b173423c0008504cf9
😎 Deploy Preview https://deploy-preview-20421--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.

@netlify
Copy link

netlify bot commented Feb 19, 2026

Deploy Preview for authentik-docs ready!

Name Link
🔨 Latest commit e2ae57c
🔍 Latest deploy log https://app.netlify.com/projects/authentik-docs/deploys/6998225fb0083f0008b1c3d9
😎 Deploy Preview https://deploy-preview-20421--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.

@dewi-tik dewi-tik added the area:docs Features or issues related to Docusaurus label Feb 19, 2026
@dewi-tik
Copy link
Contributor

Thank you very much for the contribution @abrain! We really appreciate it.

I've made some minor changes. Could you help with completing the "Configuration Verification" section that I've added. You can find an example of one here: http://localhost:3000/infrastructure/keycloak/#configuration-verification

@abrain
Copy link
Contributor Author

abrain commented Feb 19, 2026

Done :) In order to verify how the SAML login works, I tried to set it up with our test instance. In the process, I had to deviate from the instructions to make it work.

I would put those changes into a different PR or should I even open a bug report first?

Copy link
Contributor

@dewi-tik dewi-tik left a comment

Choose a reason for hiding this comment

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

Thank you very much @abrain.

Looks good to go from my POV. We'll merge once another colleague approves.

@dewi-tik
Copy link
Contributor

Done :) In order to verify how the SAML login works, I tried to set it up with our test instance. In the process, I had to deviate from the instructions to make it work.

I would put those changes into a different PR or should I even open a bug report first?

Apologies, responded before seeing your message. You can add those changes to this PR. Thanks

@dewi-tik dewi-tik self-requested a review February 19, 2026 16:31
@dewi-tik dewi-tik changed the title website/integrations: add OIDC method for Zammad website/integrations: add OIDC and update SAML instructions for Zammad Feb 19, 2026
@codecov
Copy link

codecov bot commented Feb 19, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 93.24%. Comparing base (05ad1f0) to head (e2ae57c).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff             @@
##             main   #20421      +/-   ##
==========================================
- Coverage   93.29%   93.24%   -0.05%     
==========================================
  Files         981      981              
  Lines       55161    55161              
==========================================
- Hits        51461    51437      -24     
- Misses       3700     3724      +24     
Flag Coverage Δ
conformance 37.45% <ø> (+<0.01%) ⬆️
e2e 43.27% <ø> (+<0.01%) ⬆️
integration 22.38% <ø> (-0.05%) ⬇️
unit 91.49% <ø> (+0.44%) ⬆️
unit-migrate 91.51% <ø> (-0.03%) ⬇️

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.

@dominic-r dominic-r force-pushed the feature/zammad-docs-oidc branch from 3b79010 to 73d521e Compare February 19, 2026 21:57
@dominic-r dominic-r enabled auto-merge (squash) February 19, 2026 21:59
@dewi-tik dewi-tik disabled auto-merge February 20, 2026 08:59
@dewi-tik dewi-tik enabled auto-merge (squash) February 20, 2026 08:59
@dewi-tik dewi-tik merged commit a52ecd3 into goauthentik:main Feb 20, 2026
101 checks passed
kensternberg-authentik added a commit that referenced this pull request Feb 20, 2026
* main:
  website/docs: change permission name from 'Can view Admin interface' to 'Can access…' (#20412)
  website/integrations: add OIDC and update SAML instructions for Zammad (#20421)
kensternberg-authentik added a commit that referenced this pull request Feb 20, 2026
…ionship

* main:
  core: bump msgraph-sdk from 1.54.0 to 1.55.0 (#20432)
  core: bump aws-cdk-lib from 2.238.0 to 2.239.0 (#20434)
  core: bump constructs from 10.5.0 to 10.5.1 (#20433)
  core: bump goauthentik/fips-python from `c272691` to `d973c46` in /lifecycle/container (#20437)
  core: bump goauthentik/fips-debian from `b0917af` to `4419749` in /lifecycle/container (#20438)
  web/admin/bugfix: Edit Stage not working. Invoking IdentificationStageForm not working (#20429)
  core: bump ruff from 0.15.1 to 0.15.2 (#20435)
  enterprise/providers/microsoft_entra: only check upn when set (#20441)
  core: bump selenium from 4.40.0 to 4.41.0 (#20436)
  website/docs: change permission name from 'Can view Admin interface' to 'Can access…' (#20412)
  website/integrations: add OIDC and update SAML instructions for Zammad (#20421)
  website/integrations: update wazuh acs url (#20401)
  web: Center footer links. (#20345)
kensternberg-authentik added a commit that referenced this pull request Feb 21, 2026
* main: (29 commits)
  web/flow: refactor flow executor so component selection is in an easy-to-maintain table (#19999)
  website/integrations: gatus: fix config block  (#20446)
  core: bump msgraph-sdk from 1.54.0 to 1.55.0 (#20432)
  core: bump aws-cdk-lib from 2.238.0 to 2.239.0 (#20434)
  core: bump constructs from 10.5.0 to 10.5.1 (#20433)
  core: bump goauthentik/fips-python from `c272691` to `d973c46` in /lifecycle/container (#20437)
  core: bump goauthentik/fips-debian from `b0917af` to `4419749` in /lifecycle/container (#20438)
  web/admin/bugfix: Edit Stage not working. Invoking IdentificationStageForm not working (#20429)
  core: bump ruff from 0.15.1 to 0.15.2 (#20435)
  enterprise/providers/microsoft_entra: only check upn when set (#20441)
  core: bump selenium from 4.40.0 to 4.41.0 (#20436)
  website/docs: change permission name from 'Can view Admin interface' to 'Can access…' (#20412)
  website/integrations: add OIDC and update SAML instructions for Zammad (#20421)
  website/integrations: update wazuh acs url (#20401)
  web: Center footer links. (#20345)
  core: bump goauthentik.io/api/v3 to 3.2026.5.0-rc1-1771349690 (#20367)
  ci: bump tj-actions/changed-files from 47.0.3 to 47.0.4 (#20374)
  ci: bump helm/kind-action from 1.13.0 to 1.14.0 (#20375)
  core: bump library/golang from 1.25.5-trixie to 1.26.0-trixie in /lifecycle/container (#20381)
  core: bump goauthentik/fips-debian from `10dadf1` to `b0917af` in /lifecycle/container (#20382)
  ...
kensternberg-authentik added a commit that referenced this pull request Feb 23, 2026
* main: (30 commits)
  web/flow: generate a single API object for network transactions and use it for the lifetime of the FlowExecutor (#20030)
  web/flow: refactor flow executor so component selection is in an easy-to-maintain table (#19999)
  website/integrations: gatus: fix config block  (#20446)
  core: bump msgraph-sdk from 1.54.0 to 1.55.0 (#20432)
  core: bump aws-cdk-lib from 2.238.0 to 2.239.0 (#20434)
  core: bump constructs from 10.5.0 to 10.5.1 (#20433)
  core: bump goauthentik/fips-python from `c272691` to `d973c46` in /lifecycle/container (#20437)
  core: bump goauthentik/fips-debian from `b0917af` to `4419749` in /lifecycle/container (#20438)
  web/admin/bugfix: Edit Stage not working. Invoking IdentificationStageForm not working (#20429)
  core: bump ruff from 0.15.1 to 0.15.2 (#20435)
  enterprise/providers/microsoft_entra: only check upn when set (#20441)
  core: bump selenium from 4.40.0 to 4.41.0 (#20436)
  website/docs: change permission name from 'Can view Admin interface' to 'Can access…' (#20412)
  website/integrations: add OIDC and update SAML instructions for Zammad (#20421)
  website/integrations: update wazuh acs url (#20401)
  web: Center footer links. (#20345)
  core: bump goauthentik.io/api/v3 to 3.2026.5.0-rc1-1771349690 (#20367)
  ci: bump tj-actions/changed-files from 47.0.3 to 47.0.4 (#20374)
  ci: bump helm/kind-action from 1.13.0 to 1.14.0 (#20375)
  core: bump library/golang from 1.25.5-trixie to 1.26.0-trixie in /lifecycle/container (#20381)
  ...
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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants