Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Neoteroi/GuardPost
Classes to handle authentication and authorization for async Python application.
https://github.com/Neoteroi/GuardPost
asyncio authentication authorization strategy synchronous
Last synced: 11 days ago
JSON representation
Classes to handle authentication and authorization for async Python application.
- Host: GitHub
- URL: https://github.com/Neoteroi/GuardPost
- Owner: Neoteroi
- License: mit
- Created: 2019-06-05T14:49:02.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2024-09-03T21:42:34.000Z (5 months ago)
- Last Synced: 2025-01-10T09:56:17.773Z (about 1 month ago)
- Topics: asyncio, authentication, authorization, strategy, synchronous
- Language: Python
- Homepage:
- Size: 95.7 KB
- Stars: 38
- Watchers: 3
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/Neoteroi/guardpost/actions?query=workflow%3ABuild)
[](https://pypi.org/project/guardpost/)
[](https://github.com/Neoteroi/guardpost)
[](https://github.com/Neoteroi/guardpost/blob/main/LICENSE)
[](https://codecov.io/gh/Neoteroi/guardpost)
# Authentication and authorization framework for Python apps
Basic framework to handle authentication and authorization in asynchronous
Python applications.
**Features:**
- strategy to implement authentication (who or what is using a service?)
- strategy to implement authorization (is the acting identity authorized to do a certain action?)
- support for dependency injection for classes handling authentication and
authorization requirements
- built-in support for JSON Web Tokens (JWTs) authentication
This library is freely inspired by [authorization in ASP.NET
Core](https://docs.microsoft.com/en-us/aspnet/core/security/authorization/policies?view=aspnetcore-2.2);
although its implementation is extremely different.
## Installation
```bash
pip install guardpost
```
To install with support for `JSON Web Tokens (JWTs)` validation:
```
pip install guardpost[jwt]
```
### Examples
For examples, refer to the [examples folder](./examples).
## Functions to validate JWTs
GuardPost includes functions to validate JSON Web Tokens (JWTs) and handle
JSON Web Keys Sets (JWKS).
The built-in validator class can retrieve automatically JWKS from identity providers
and handle automatically caching and keys rotation. Caching is useful to not incur in
useless performance fees (e.g. downloading JWKS at each web request), and keys rotation
is important because identity providers can periodically change the keys they use to
sign JWTs.
To use these features, install to include additional dependencies:
```bash
pip install guardpost[jwt]
```
The following example shows how to use guardpost to validate tokens:
```python
import asyncio
from guardpost.jwts import JWTValidator
async def main():
validator = JWTValidator(
authority="YOUR_AUTHORITY",
valid_issuers=["YOUR_ISSUER_VALUE"],
valid_audiences=["YOUR_AUDIENCE"],
)
# keys are fetched when necessary
data = await validator.validate_jwt("YOUR_TOKEN")
print(data)
asyncio.run(main())
```
An example value for `authority`, to validate access tokens issued by
Azure Active Directory could be: `https://sts.windows.net/YOUR_TENANT_ID/`.
GuardPost is used in BlackSheep and has been tested with:
- Auth0
- Azure Active Directory
- Azure Active Directory B2C
- Okta
## If you have doubts about authentication vs authorization...
`Authentication` answers the question: _Who is the user who is initiating the
action?_, or more in general: _Who is the user, or what is the service, that is
initiating the action?_.
`Authorization` answers the question: _Is the user, or service, authorized to
do something?_.
Usually, to implement authorization, is necessary to have the context of the
entity that is executing the action.
## Usage in BlackSheep
`guardpost` is used in the [BlackSheep](https://www.neoteroi.dev/blacksheep/)
web framework, to implement [authentication and authorization
strategies](https://www.neoteroi.dev/blacksheep/authentication/) for request
handlers.
To see how `guardpost` is used in `blacksheep` web framework, read:
* [Authentication](https://www.neoteroi.dev/blacksheep/authentication/)
* [Authorization](https://www.neoteroi.dev/blacksheep/authorization/)
# Documentation
Under construction. 🚧