docs: Authentication section #2234
2026-09-26
docs(auth): with --> to
All checks were successful
Documentation / Build and Deploy Documentation (pull_request) Has been skipped
Checks / Changelog / Check changelog is added (pull_request_target) Successful in 8s
Checks / Prek / Check changed files (pull_request) Successful in 7s
Checks / Prek / Clippy and Cargo Tests (pull_request) Has been skipped
Update flake hashes / update-flake-hashes (pull_request) Successful in 1m19s
Checks / Prek / Pre-commit & Formatting (pull_request) Successful in 2m46s
docs(internal auth): Redo rego methods (see commit notes)
* Tokens + recaptcha combinations have been removed since they don't work. Docstring in config tomlto be removed later * Method 3 expanded to include both static and admin issued tokens * Methods 1-3 are the "trusted token flow" and 4-6 are the "untrusted captcha flow"
docs(deploying): Fix OIDC links
The deploying stub page will be rewritten sooon and the "What's next" steps should migrate there. In the meantime this helps npm not break when building the docs
docs(auth): Fix wordings and add links to admin commands
* Add confirmed email + reCAPTCHA registration method as well
docs(auth): Rename rego page to "internal auth" & add pwd reset details
* Moved around a few paragraphs to fit new title as well
docs(auth): Move legacy auth page to rego page (see desc)
The commit moves legacy.mdx to registration.mdx and significantly shortens it. Instead of explaining every registration option now a table is provided. Renaming the page because besides registration there is not much else to explain about legacy auth. If anything, those should be elaborated on the main authentication.mdx page (i.e. difference between OAuth and UIAA) The email section has also been updated with (some) relevant info.