Skip to content

docs(auth): add scope and wildcard support for JWT routing overrides#31

Open
milan-berri wants to merge 1 commit intoBerriAI:mainfrom
milan-berri:litellm_jwt_override_scope_wildcard_docs
Open

docs(auth): add scope and wildcard support for JWT routing overrides#31
milan-berri wants to merge 1 commit intoBerriAI:mainfrom
milan-berri:litellm_jwt_override_scope_wildcard_docs

Conversation

@milan-berri
Copy link
Copy Markdown
Contributor

Summary

Backfills this docs site with the documentation that originally shipped under docs/my-website/ in BerriAI/litellm#25939 / #26325. After the docs source was migrated out of the litellm repo, those doc edits could no longer be carried in the code PR and were dropped on rebase — this PR brings them over.

Changes

  • docs/proxy/token_auth.md — expand the "Matching behavior" section under routing_overrides:
    • AND semantics across configured selectors
    • new optional scope selector
    • list/string selector forms
    • shell-style wildcards (*, ?), case-sensitive
    • scope-only space-split rule (iss, aud, client_id are never split on spaces)
    • new worked example combining scope with a wildcard client_id
  • docs/proxy/oauth2.md — short cross-reference to the new wildcard/scope behavior, pointing readers at token_auth.md.

No content changes outside these two files.

Related

Test plan

  • Render docs/proxy/token_auth.md locally and confirm the new "Matching behavior" bullets and the Example: scope and wildcard client_id YAML block are formatted correctly.
  • Render docs/proxy/oauth2.md locally and confirm the cross-reference link to token_auth.md#route-jwt-shaped-machine-tokens-to-oauth2 resolves.

Made with Cursor

@milan-berri milan-berri requested a review from a team April 28, 2026 08:51
@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 28, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
litellm Ready Ready Preview, Comment Apr 28, 2026 8:56am

Request Review

…ides

Backfills the `BerriAI/litellm-docs` site with the changes that originally
shipped under `docs/my-website/` in BerriAI/litellm#25939 / #26325. After
the docs source was migrated to this repo, those edits could no longer
be carried in the code PR and were dropped on rebase.

- proxy/token_auth.md: expand "Matching behavior" with AND semantics,
  the new optional `scope` selector, list/string forms, shell-style
  wildcards (`*`, `?`, case-sensitive), and the scope-only space-split
  rule (iss/aud/client_id are never split on spaces). Adds a worked
  example combining `scope` with a wildcard `client_id`.
- proxy/oauth2.md: cross-reference the new wildcard/scope behavior and
  point readers to token_auth.md for full details.

Code change is in BerriAI/litellm#26325 (litellm_internal_staging).
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