-
-
Notifications
You must be signed in to change notification settings - Fork 305
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
[17.0][MIG] fastapi_auth_jwt: update version to 17.0
- Loading branch information
1 parent
9d24e36
commit 1e9cf0c
Showing
14 changed files
with
199 additions
and
160 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -17,19 +17,20 @@ FastAPI Auth JWT support | |
:target: http://www.gnu.org/licenses/lgpl-3.0-standalone.html | ||
:alt: License: LGPL-3 | ||
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Frest--framework-lightgray.png?logo=github | ||
:target: https://github.com/OCA/rest-framework/tree/16.0/fastapi_auth_jwt | ||
:target: https://github.com/OCA/rest-framework/tree/17.0/fastapi_auth_jwt | ||
:alt: OCA/rest-framework | ||
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png | ||
:target: https://translation.odoo-community.org/projects/rest-framework-16-0/rest-framework-16-0-fastapi_auth_jwt | ||
:target: https://translation.odoo-community.org/projects/rest-framework-17-0/rest-framework-17-0-fastapi_auth_jwt | ||
:alt: Translate me on Weblate | ||
.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png | ||
:target: https://runboat.odoo-community.org/builds?repo=OCA/rest-framework&target_branch=16.0 | ||
:target: https://runboat.odoo-community.org/builds?repo=OCA/rest-framework&target_branch=17.0 | ||
:alt: Try me on Runboat | ||
|
||
|badge1| |badge2| |badge3| |badge4| |badge5| | ||
|
||
This module provides ``FastAPI`` ``Depends`` to allow authentication with `auth_jwt | ||
<https://github.com/OCA/server-auth/tree/16.0/auth_jwt>`_. | ||
This module provides ``FastAPI`` ``Depends`` to allow authentication | ||
with | ||
`auth_jwt <https://github.com/OCA/server-auth/tree/16.0/auth_jwt>`__. | ||
|
||
**Table of contents** | ||
|
||
|
@@ -39,83 +40,95 @@ This module provides ``FastAPI`` ``Depends`` to allow authentication with `auth_ | |
Usage | ||
===== | ||
|
||
The following FastAPI dependencies are provided and importable from | ||
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. | ||
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. | ||
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. | ||
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``. | ||
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. | ||
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. | ||
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. | ||
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``. | ||
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. | ||
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. | ||
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). | ||
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 <https://github.com/OCA/rest-framework/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 <https://github.com/OCA/rest-framework/issues/new?body=module:%20fastapi_auth_jwt%0Aversion:%2016.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_. | ||
`feedback <https://github.com/OCA/rest-framework/issues/new?body=module:%20fastapi_auth_jwt%0Aversion:%2017.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_. | ||
|
||
Do not contact contributors directly about support or help with technical issues. | ||
|
||
Credits | ||
======= | ||
|
||
Authors | ||
~~~~~~~ | ||
------- | ||
|
||
* ACSONE SA/NV | ||
|
||
Contributors | ||
------------ | ||
|
||
Mohamed Alkobrosli <[email protected]> | ||
|
||
Maintainers | ||
~~~~~~~~~~~ | ||
----------- | ||
|
||
This module is maintained by the OCA. | ||
|
||
|
@@ -135,6 +148,6 @@ Current `maintainer <https://odoo-community.org/page/maintainer-role>`__: | |
|
||
|maintainer-sbidoul| | ||
|
||
This module is part of the `OCA/rest-framework <https://github.com/OCA/rest-framework/tree/16.0/fastapi_auth_jwt>`_ project on GitHub. | ||
This module is part of the `OCA/rest-framework <https://github.com/OCA/rest-framework/tree/17.0/fastapi_auth_jwt>`_ project on GitHub. | ||
|
||
You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1 @@ | ||
from . import models |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Empty file.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,3 @@ | ||
[build-system] | ||
requires = ["whool"] | ||
build-backend = "whool.buildapi" |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1 @@ | ||
Mohamed Alkobrosli \<<[email protected]>\> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,2 @@ | ||
This module provides `FastAPI` `Depends` to allow authentication with | ||
[auth_jwt](https://github.com/OCA/server-auth/tree/16.0/auth_jwt). |
This file was deleted.
Oops, something went wrong.
Oops, something went wrong.