JWT bearer token authentication for FastAPI.
Project description
This module provides FastAPI Depends to allow authentication with auth_jwt.
Table of contents
Usage
The following FastAPI dependencies are provided and importable from odoo.addons.fastapi_auth_jwt.dependencies:
def auth_jwt_authenticated_payload() -> Payload
Return the authenticated JWT payload. Raise a 401 (unauthorized) if absent or invalid.
def auth_jwt_optionally_authenticated_payload() -> Payload | None
Return the authenticated JWT payload, or None if the Authorization header and cookie are absent. Raise a 401 (unauthorized) if present and invalid.
def auth_jwt_authenticated_partner() -> Partner
Obtain the authenticated partner corresponding to the provided JWT token, according to the partner strategy defined on the auth_jwt validator. Raise a 401 (unauthorized) if the partner could not be determined for any reason.
This is function suitable and intended to override odoo.addons.fastapi.dependencies.authenticated_partner_impl.
The partner record returned by this function is bound to an environment that uses the Odoo user obtained from the user strategy defined on the auth_jwt validator. When used authenticated_partner_impl this in turn ensures that odoo.addons.fastapi.dependencies.authenticated_partner_env is also bound to the correct Odoo user.
def auth_jwt_optionally_authenticated_partner() -> Partner
Same as auth_jwt_partner except it returns an empty recordset bound to the public user if the Authorization header and cookie are absent, or if the JWT validator could not find the partner and declares that the partner is not required.
def auth_jwt_authenticated_odoo_env() -> Environment
Return an Odoo environment using the the Odoo user obtained from the user strategy defined on the auth_jwt validator, if the request could be authenticated using a JWT validator. Raise a 401 (unauthorized) otherwise.
This is function suitable and intended to override odoo.addons.fastapi.dependencies.authenticated_odoo_env_impl.
def auth_jwt_default_validator_name() -> str | None
Return the name of the default JWT validator to use.
The default implementation returns None meaning only one active JWT validator is allowed. This dependency is meant to be overridden.
def auth_jwt_http_header_authorization() -> str | None
By default, return the credentials part of the Authorization header, or None if absent. This dependency is meant to be overridden, in particular with fastapi.security.OAuth2AuthorizationCodeBearer to let swagger handle OAuth2 authorization (such override is only necessary for comfort when using the swagger interface).
Bug Tracker
Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us to smash it by providing a detailed and welcomed feedback.
Do not contact contributors directly about support or help with technical issues.
Credits
Maintainers
This module is maintained by the OCA.
OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.
Current maintainer:
This module is part of the OCA/rest-framework project on GitHub.
You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Hashes for odoo_addon_fastapi_auth_jwt-16.0.1.0.4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2805947e55981c8f55f6ed3392f855760336b9137698b30ebbe64717183362c3 |
|
MD5 | 96e750421ad7a51ed00e45f113b7e250 |
|
BLAKE2b-256 | cc8f3450b064403871a024409ea5eb7007b81b01347acccde4e361292c478925 |