Skip to content

docs: add unified authentication guide #28

Description

@rhuss

Summary

Add a single docs/src/authentication.md guide page covering all authentication methods, OIDC grant types, and the full token lifecycle. Currently authentication information is scattered across four API reference pages with no unified entry point.

Key Requirements

  • Decision tree for auth method selection
  • All four auth modes (none, plaintext, cloudflare_jwt, oidc) with code snippets
  • OIDC grant types (browser, keyboard, device code, client credentials)
  • Full token lifecycle (login, persistence, refresh, expiry)
  • Cross-links to existing API reference pages
  • SUMMARY.md entry under "Guides"

Context

Brainstorm document: brainstorm/022-auth-guide.md

Assisted-By: 🤖 Claude Code

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions