Skip to content

Conversation

dewi-tik
Copy link
Contributor

@dewi-tik dewi-tik commented Sep 4, 2025

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)

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

netlify bot commented Sep 4, 2025

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

QR Code

Use your smartphone camera to open QR code link.

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

Copy link

netlify bot commented Sep 4, 2025

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

QR Code

Use your smartphone camera to open QR code link.

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

Copy link

netlify bot commented Sep 4, 2025

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

QR Code

Use your smartphone camera to open QR code link.

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

Copy link

codecov bot commented Sep 4, 2025

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.

Copy link
Contributor

github-actions bot commented Sep 4, 2025

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.

:::
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**.
Copy link
Contributor

Choose a reason for hiding this comment

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

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.

Copy link
Contributor

Choose a reason for hiding this comment

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

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

Copy link
Contributor Author

Choose a reason for hiding this comment

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

"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

Copy link
Contributor

@tanberry tanberry Sep 15, 2025

Choose a reason for hiding this comment

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

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?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Re-added the note with slight wording changes

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.

Thanks @dewi-tik !!

@dewi-tik dewi-tik added the backport/version-2025.8 Add this label to PRs to backport changes to 2025.8 label Sep 16, 2025
@dewi-tik dewi-tik merged commit 87b9276 into main Sep 16, 2025
155 of 158 checks passed
@dewi-tik 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
* Updated the page to be more consistent with upcoming changes to the saml page

* Add note
@authentik-automation
Copy link
Contributor

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

dewi-tik added a commit that referenced this pull request Sep 16, 2025
…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 <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
backport/version-2025.8 Add this label to PRs to backport changes to 2025.8
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants