SSO service documentation

[sirinoks]

Issue This PR Addresses

#3291 Only the sso part

Possibly,
Fixes #2955

However, for that specific issue I would want to describe SAML-2 part in a separate document, or add SAML-2 information to this doc later.

Type of Change

• Documentation Update: Change which improves documentation

Description

Describes the step by step process of auth. It is the first draft and is open to edits.

Steps to test the PR

• cd src/web/docusaurus
• pnpm start
• localhost:4631
• Click on Docs tab
• Click on API services, then Authentication and Authorization
• Read the content. Does it make sense? Can it be better?

Checklist

• Quality: This PR builds and passes our npm test and works locally
• Tests: This PR includes thorough tests or an explanation of why it does not
• Screenshots: This PR includes screenshots or GIFs of the changes made or an explanation of why it does not (if applicable)
• Documentation: This PR includes updated/added documentation to user exposed functionality or configuration variables are added/changed or an explanation of why it does not(if applicable)

No tests for just docs. Prettier was okay with this.
No need for screenshots for just text.

---

Might need to be updated with Supabase information and whatever is in #3030 . If this gets merged, please make sure to add an issue to describe #3030 in documentation somewhere.

[gitpod-io]

[sirinoks]

All related info:

• Issue How auth works doc
• Draft of the doc mentioned on wiki
• The recording where SSO process is described
• Issue that tracks all API documentation tasks
• Issue that wants general API documentation

Things that might need to be added later:

• Issue of some new SSO functionality that was not yet documented
• SAML-2 blog post

outdated

[tcvan0707]

Looks good to me!

updated

updated