Skip to content

Conversation

@nicedevil007
Copy link
Contributor

Details

Couldn’t resist keeping the docs train rolling—here’s another guide hot off the press! We just wired up ChatGPT’s custom OIDC flow against authentik in our environment and figured the playbook deserved a home in the integrations docs.

This PR introduces a ChatGPT integration guide that covers the authentik OIDC provider setup (scopes, signing key, redirect URI), walks through the six-step ChatGPT SSO wizard, and finishes with a verification checklist so teams can prove SSO is redirecting through authentik end-to-end.


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)

@netlify
Copy link

netlify bot commented Nov 1, 2025

Deploy Preview for authentik-docs ready!

Name Link
🔨 Latest commit a3875cd
🔍 Latest deploy log https://app.netlify.com/projects/authentik-docs/deploys/6907a8c54f73da0008f1282b
😎 Deploy Preview https://deploy-preview-17893--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.

@netlify
Copy link

netlify bot commented Nov 1, 2025

Deploy Preview for authentik-storybook canceled.

Name Link
🔨 Latest commit a3875cd
🔍 Latest deploy log https://app.netlify.com/projects/authentik-storybook/deploys/6907a8c51e9a7600083adf17

@dominic-r
Copy link
Member

ooo fancy

@dominic-r dominic-r self-requested a review November 1, 2025 21:07
@netlify
Copy link

netlify bot commented Nov 1, 2025

Deploy Preview for authentik-integrations ready!

Name Link
🔨 Latest commit a3875cd
🔍 Latest deploy log https://app.netlify.com/projects/authentik-integrations/deploys/6907a8c5e132e20008b45ecb
😎 Deploy Preview https://deploy-preview-17893--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.

@nicedevil007
Copy link
Contributor Author

btw: it is also possible to do this with SAML, but I wasn't able to test it. I'm more familiar with OIDC and I already kept logging out my collegues from ChatGPT while doing this integration, don't want to do it again :/ Maybe someone else can add this part later?

@codecov
Copy link

codecov bot commented Nov 1, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 92.88%. Comparing base (754425a) to head (a3875cd).

Additional details and impacted files
@@           Coverage Diff           @@
##             main   #17893   +/-   ##
=======================================
  Coverage   92.88%   92.88%           
=======================================
  Files         869      869           
  Lines       47960    47960           
=======================================
  Hits        44547    44547           
  Misses       3413     3413           
Flag Coverage Δ
e2e 45.21% <ø> (+0.07%) ⬆️
integration 23.13% <ø> (-0.06%) ⬇️
unit 91.08% <ø> (+<0.01%) ⬆️
unit-migrate 91.13% <ø> (+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.

@nicedevil007 nicedevil007 changed the title New Integration Guide: ChatGPT website/integrations: ChatGPT Nov 1, 2025
@dominic-r
Copy link
Member

btw: it is also possible to do this with SAML, but I wasn't able to test it. I'm more familiar with OIDC and I already kept logging out my collegues from ChatGPT while doing this integration, don't want to do it again :/ Maybe someone else can add this part later?

I think OIDC is a good start. If someone needs it added and wants to document it, they can

@dominic-r
Copy link
Member

Hey there 👋 I was wondering if you could send over some screenshots of what the UI flows look like as I can't find anything on my side for OIDC. Also, I'll write up the guide for SAML. Thanks

@nicedevil007
Copy link
Contributor Author

Hey there 👋 I was wondering if you could send over some screenshots of what the UI flows look like as I can't find anything on my side for OIDC. Also, I'll write up the guide for SAML. Thanks

If have to reset OIDC completly to be able to create screenshots for you and then my collegues will be logged of again.

is this enough for now? I can do it with the reset but my collegues will try to kill me at some point hahahahaha

image

here is the bad button for resetting it :/
image

@dominic-r
Copy link
Member

Thanks, I'll try to do with that. In the meantime, I've pushed up a draft of what the integration will look like. Feel free to push up any commits if you notice an obvious mistake based on your setting-it-up experience.

@nicedevil007
Copy link
Contributor Author

Thanks, I'll try to do with that. In the meantime, I've pushed up a draft of what the integration will look like. Feel free to push up any commits if you notice an obvious mistake based on your setting-it-up experience.

mhhh maybe you can't see anything without the teams license model of openai?

@dominic-r
Copy link
Member

Visiting the URL in the doc redirects me back to the main website and authentik doesn't have a ChatGPT subscription. However, let's not worry about this for now. I suggest we come back to it after the other docs. I'm working on the Microsoft365 one right now.

@nicedevil007
Copy link
Contributor Author

nicedevil007 commented Nov 2, 2025

ok... before monday reaches us... I did it for you ;)

image

here you can see the 2 buttons at the bottom, Custom SAML and Custom OIDC.

SAML Try

image image

with metadata:
image

alternate manual config:
image

attributes:
image

application link:
image

test page:
image

I wasn't able to get it up and running with that. Authentik always tells me "Not Found", maybe you are more lucky than me.

image

OIDC Part

Step 1: Provide an Identity Provider Name
image

Step 2: Create an Application
image

Step 3: Add Claims
image

Step 4: Provide your OIDC Configuration
image

Step 5: Configure Application Link
image

Step 6: Test Single Sign-On
image

Verification
image

and here some options you can set for teams license.

image

@nicedevil007
Copy link
Contributor Author

Visiting the URL in the doc redirects me back to the main website and authentik doesn't have a ChatGPT subscription. However, let's not worry about this for now. I suggest we come back to it after the other docs. I'm working on the Microsoft365 one right now.

which one do you mean?

this here is the default page I see when I log in to chatgpt.com

image

here I enter my email address that is on the verified domain (this is mandatory before doing the SSO stuff in my opinion):
image

Now I get redirected to authentik and after successful login I get redirected to chatgpt.

@dominic-r
Copy link
Member

which one do you mean?

this here is the default page I see when I log in to chatgpt.com

when I was already logged in. Anyways, thanks so much for those screenshots. I'll finish up the docs

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

Status: Todo

Development

Successfully merging this pull request may close these issues.

2 participants