Skip to content

docs: explain advanced OIDC provider controls#3100

Open
atharva-appwrite wants to merge 1 commit into
mainfrom
docs/oidc-provider-controls
Open

docs: explain advanced OIDC provider controls#3100
atharva-appwrite wants to merge 1 commit into
mainfrom
docs/oidc-provider-controls

Conversation

@atharva-appwrite

Copy link
Copy Markdown

What does this PR do?

Documents the OpenID Connect provider prompt and maximum authentication age controls in the OAuth 2 login guide. Clarifies where to configure them, when to use each option, and that they affect the provider authorization request rather than client callback handling.

This is intentionally scoped away from OAuth server / Sign in with your product documentation and the OAuth consent flow updates in #3090.

Test plan

  • bun run check
  • git diff --check

@appwrite

appwrite Bot commented Jul 15, 2026

Copy link
Copy Markdown

Appwrite Website

Project ID: 69d7efb00023389e8d27

Sites (1)
Site Status Logs Preview QR
 website
69d7f2670014e24571ca
Ready Ready View Logs Preview URL QR Code

Website (appwrite/website)

Project ID: 684969cb000a2f6c0a02

Sites (1)
Site Status Logs Preview QR
 website
68496a17000f03d62013
Processing Processing View Logs Preview URL QR Code


Tip

Silent mode disables those chatty PR comments if you prefer peace and quiet

@greptile-apps

greptile-apps Bot commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

Greptile Summary

This PR adds a new "Configure OpenID Connect authorization" subsection to the OAuth 2 login guide, documenting the prompt and max_age (max authentication age) parameters that Appwrite forwards to an OIDC provider's authorization request. It also fixes a missing trailing newline at end of file.

  • The new subsection correctly describes all four standard OIDC prompt values (none, login, consent, select_account) and accurately notes that none must be used in isolation.
  • The max_age description is technically correct per the OIDC Core spec and gives useful guidance on when to apply it.

Confidence Score: 5/5

Pure documentation addition with no code changes; content is technically accurate per the OIDC Core specification.

The change introduces only new prose in a Markdoc file. The OIDC prompt values and max_age description align with the OIDC Core spec, the heading hierarchy is correct, and the trailing-newline fix is harmless. Nothing in this diff touches runtime logic.

No files require special attention.

Important Files Changed

Filename Overview
src/routes/docs/products/auth/oauth2/+page.markdoc Adds a new subsection documenting OIDC prompt and max_age controls; also fixes missing trailing newline at EOF.

Reviews (1): Last reviewed commit: "docs: explain advanced OIDC provider con..." | Re-trigger Greptile

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant