Clarify SSO setup with OAuth 2.0 in the documentation

[podlomar]

Describe the Request

The section on Single-Sign-On only has an example for OpenID with Google. If you want to setup pure OAuth client with, say, GitHub that does not support OpenID, you still need to read through the Google OpenID setup to get importent information like how to setup the OAuth redirect URL.

Also, it is not clear from the docs that the redirect param of the directus SSO link is not for OAuth redirects but for Directus redirecting back to your frontend after authentication success.

It took me whole day of debugging and even going through the Directus source code to understand this.

I already have the fix ready as a PR, but every PR needs an issue as I understand from the contribution guide.

Maintainence Strategy

Rarely, as the OAuth protocol is pretty standard and does not change. Would require update if GitHub actually implements OpenID.

[M-GRV]

Hey!

Did you see the rest of the examples? There are def some auth2.0 ones available.

https://docs.directus.io/self-hosted/sso-examples.html#oauth-2-0

I do agree the main SSO Docs could use a little love as it can def be confusing with it all feeling a little jumbled together on the one page. Would love to see the PR

[phazonoverload]

I do agree the main SSO Docs could use a little love

So do I! In an upcoming sprint this quarter we are focusing on self-hosted docs and this will be part of it. 😄

[linear[bot]]

EDU-356 Clarify SSO setup with OAuth 2.0 in the documentation