60e0ffc959
Upgrade checks / Notify on failure (push) Has been cancelled
Upgrade checks / Close issue on success (push) Has been cancelled
Schema Crash Test / Real-world schema crash test (232K schemas) (push) Has been cancelled
Run static analysis / static_analysis (push) Has been cancelled
Tests / Tests: Python 3.10 on ubuntu-latest (push) Has been cancelled
Tests / Tests: Python 3.13 on ubuntu-latest (push) Has been cancelled
Tests / Tests: Python 3.10 on windows-latest (push) Has been cancelled
Tests / Tests with lowest-direct dependencies (push) Has been cancelled
Tests / MCP conformance tests (push) Has been cancelled
Tests / Integration tests (push) Has been cancelled
Tests / Package install smoke (push) Has been cancelled
Upgrade checks / Static analysis (push) Has been cancelled
Upgrade checks / Tests: Python 3.10 on ubuntu-latest (push) Has been cancelled
Upgrade checks / Tests: Python 3.13 on ubuntu-latest (push) Has been cancelled
Upgrade checks / Tests: Python 3.10 on windows-latest (push) Has been cancelled
Upgrade checks / Integration tests (push) Has been cancelled
Update MCPServerConfig Schema / update-config-schema (push) Has been cancelled
Update SDK Documentation / update-sdk-docs (push) Has been cancelled
68 lines
1.7 KiB
Plaintext
68 lines
1.7 KiB
Plaintext
---
|
|
title: auth
|
|
sidebarTitle: auth
|
|
---
|
|
|
|
# `fastmcp.utilities.auth`
|
|
|
|
|
|
Authentication utility helpers.
|
|
|
|
## Functions
|
|
|
|
### `decode_jwt_header` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/utilities/auth.py#L32" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
|
|
|
|
```python
|
|
decode_jwt_header(token: str) -> dict[str, Any]
|
|
```
|
|
|
|
|
|
Decode JWT header without signature verification.
|
|
|
|
Useful for extracting the key ID (kid) for JWKS lookup.
|
|
|
|
**Args:**
|
|
- `token`: JWT token string (header.payload.signature)
|
|
|
|
**Returns:**
|
|
- Decoded header as a dictionary
|
|
|
|
**Raises:**
|
|
- `ValueError`: If token is not a valid JWT format
|
|
|
|
|
|
### `decode_jwt_payload` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/utilities/auth.py#L49" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
|
|
|
|
```python
|
|
decode_jwt_payload(token: str) -> dict[str, Any]
|
|
```
|
|
|
|
|
|
Decode JWT payload without signature verification.
|
|
|
|
Use only for tokens received directly from trusted sources (e.g., IdP token endpoints).
|
|
|
|
**Args:**
|
|
- `token`: JWT token string (header.payload.signature)
|
|
|
|
**Returns:**
|
|
- Decoded payload as a dictionary
|
|
|
|
**Raises:**
|
|
- `ValueError`: If token is not a valid JWT format
|
|
|
|
|
|
### `parse_scopes` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/utilities/auth.py#L66" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
|
|
|
|
```python
|
|
parse_scopes(value: Any) -> list[str] | None
|
|
```
|
|
|
|
|
|
Parse scopes from environment variables or settings values.
|
|
|
|
Accepts either a JSON array string, a comma- or space-separated string,
|
|
a list of strings, or ``None``. Returns a list of scopes or ``None`` if
|
|
no value is provided.
|
|
|