website/docs: update create oauth provider page by dewi-tik · Pull Request #16617 · goauthentik/authentik

dewi-tik · 2025-09-04T15:03:19Z

Details

Updates the page to be more consistent with upcoming changes to the saml page

Checklist

If applicable

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

…aml page

netlify · 2025-09-04T15:03:24Z

✅ Deploy Preview for authentik-docs ready!

Name	Link
🔨 Latest commit	`37be18f`
🔍 Latest deploy log	https://app.netlify.com/projects/authentik-docs/deploys/68c8368cc6ab390008aca493
😎 Deploy Preview	https://deploy-preview-16617--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-04T15:03:24Z

✅ Deploy Preview for authentik-integrations ready!

Name	Link
🔨 Latest commit	`37be18f`
🔍 Latest deploy log	https://app.netlify.com/projects/authentik-integrations/deploys/68c8368c89fcae00081b0d6a
😎 Deploy Preview	https://deploy-preview-16617--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-04T15:03:34Z

✅ Deploy Preview for authentik-storybook ready!

Name	Link
🔨 Latest commit	`37be18f`
🔍 Latest deploy log	https://app.netlify.com/projects/authentik-storybook/deploys/68c8368c0025900008986fd0
😎 Deploy Preview	https://deploy-preview-16617--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.

codecov · 2025-09-04T15:09:25Z

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 92.77%. Comparing base (fa899e9) to head (37be18f).
⚠️ Report is 106 commits behind head on main.
✅ All tests successful. No failed tests found.

Additional details and impacted files

@@            Coverage Diff             @@
##             main   #16617      +/-   ##
==========================================
+ Coverage   92.42%   92.77%   +0.34%     
==========================================
  Files         838      838              
  Lines       45359    45374      +15     
==========================================
+ Hits        41924    42095     +171     
+ Misses       3435     3279     -156

Flag	Coverage Δ
e2e	`46.50% <ø> (+1.77%)`	⬆️
integration	`23.51% <ø> (+<0.01%)`	⬆️
unit	`90.91% <ø> (-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-04T15:35:41Z

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-37be18f3a10461653781740d39001fbfe9994e3f
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-37be18f3a10461653781740d39001fbfe9994e3f

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

tanberry · 2025-09-10T11:44:41Z

website/docs/add-secure-apps/providers/oauth2/create-oauth2-provider.md

-:::
+1. Log in to authentik as an administrator, and open the authentik Admin interface.
+2. Navigate to **Applications > Applications** and click **Create with provider** to create an application and provider pair.
+3. On the **New application** page, define the application settings, and then click **Next**.


The use of the word "box" was to indicate that it is a modal... I am fine with calling it a page, just like all the other pages, but that is a conscious decision to be less specific, imo.

Also, why do we want to remove line 17 with the info about offline_access?

"Box" seems a bit weird to me in this case. I know that box is used as a CSS term but to a non-frontend type person, box isn't as clear as page/window IMO.

I removed the offline access information because it's already mentioned on the OAuth provider page and seems to fit better there: https://version-2024-8.goauthentik.io/docs/providers/oauth2/#authorization_code

I agree about not using the term "box". I wish I had won the debate to use "modal". But sure, "page" is fine.

On the Note about offline access though I think we need to leave it here. This is the page about creating/configuring an Oauth provider, and this Note is about configuring the provider to use offline access scope, so this is where it most needs to be, so they see it as they are creating it. Thoughts?

Re-added the note with slight wording changes

tanberry

Thanks @dewi-tik !!

* Updated the page to be more consistent with upcoming changes to the saml page * Add note

authentik-automation · 2025-09-16T13:20:49Z

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

…16806) website/docs: update create oauth provider page (#16617) * Updated the page to be more consistent with upcoming changes to the saml page * Add note Co-authored-by: Dewi Roberts <dewi@goauthentik.io>

* main: (81 commits) translate: Updates for file web/xliff/en.xlf in de (#16808) stages: update friendly_name model from null to blank (#16672) sources/saml: add default error messages to exceptions (#15562) website/docs: 2025.8.3 release notes (#16809) core, web: update translations (#16783) stages/email_authenticator: Fix email mfa loop (#16579) website/docs: updated Frontend development environment contributor docs (#16731) webiste/integrations: update roundcube doc (#16753) website/docs: update create oauth provider page (#16617) website: bump @types/node from 24.4.0 to 24.5.0 in /website (#16789) web: bump the rollup group across 1 directory with 4 updates (#16792) core: bump github.com/getsentry/sentry-go from 0.35.2 to 0.35.3 (#16786) web: bump the storybook group across 1 directory with 5 updates (#16791) web: bump @types/node from 24.4.0 to 24.5.0 in /packages/esbuild-plugin-live-reload (#16794) web: bump @goauthentik/prettier-config from 1.0.5 to 3.1.0 in /web in the goauthentik group across 1 directory (#16793) web: bump @types/node from 24.4.0 to 24.5.0 in /packages/prettier-config (#16795) web: bump @types/node from 22.15.19 to 24.5.0 in /web (#16796) web: Use curated dictionary for e2e fixtures. (#16750) website/integrations: fix wekan redirect URL (#16801) website/docs: fix docker tabs not rendering properly (#16799) ...

Updated the page to be more consistent with upcoming changes to the s…

fdb3ca2

…aml page

dewi-tik requested a review from a team as a code owner September 4, 2025 15:03

tanberry reviewed Sep 10, 2025

View reviewed changes

Add note

37be18f

tanberry approved these changes Sep 15, 2025

View reviewed changes

dewi-tik added the backport/version-2025.8 Add this label to PRs to backport changes to version-2025.8 label Sep 16, 2025

dewi-tik merged commit 87b9276 into main Sep 16, 2025
155 of 158 checks passed

dewi-tik deleted the website/docs--update-oauth-provider branch September 16, 2025 13:20

authentik-automation bot pushed a commit that referenced this pull request Sep 16, 2025

website/docs: update create oauth provider page (#16617)

ea464e7

* Updated the page to be more consistent with upcoming changes to the saml page * Add note

authentik-automation bot mentioned this pull request Sep 16, 2025

website/docs: update create oauth provider page (cherry-pick #16617) #16806

Merged

Uh oh!

Conversation

dewi-tik commented Sep 4, 2025

Details

Checklist

Uh oh!

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

Uh oh!

✅ Deploy Preview for authentik-storybook ready!

Uh oh!

codecov bot commented Sep 4, 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 4, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

tanberry Sep 10, 2025

Choose a reason for hiding this comment

Uh oh!

tanberry Sep 10, 2025

Choose a reason for hiding this comment

Uh oh!

dewi-tik Sep 10, 2025

Choose a reason for hiding this comment

Uh oh!

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

Uh oh!

Choose a reason for hiding this comment

Uh oh!

dewi-tik Sep 15, 2025

Choose a reason for hiding this comment

Uh oh!

tanberry left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

authentik-automation bot commented Sep 16, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

netlify bot commented Sep 4, 2025 •

edited

Loading

netlify bot commented Sep 4, 2025 •

edited

Loading

netlify bot commented Sep 4, 2025 •

edited

Loading

codecov bot commented Sep 4, 2025 •

edited

Loading

github-actions bot commented Sep 4, 2025 •

edited

Loading

tanberry Sep 15, 2025 •

edited

Loading