Starlette Authlib Middleware
Introduction
A drop-in replacement for Starlette session middleware, using authlib's jwt.
Rationale
It is sometimes necessary to integrate a Starlette-based application into more complex scenarios where other actors need to make decisions based on session data. This middleware makes this possible by using a standard JWT token instead of the Starlette-encrypted one, thus simplifying interaction with third-party components.
Requirements
- Python 3.10+
- Starlette 0.9+
Installation
pip install starlette-authlib
Usage
A complete example where we drop-in replace standard session middleware:
from starlette.applications import Starlette
from starlette_authlib.middleware import AuthlibMiddleware as SessionMiddleware
app = Starlette()
app.add_middleware(SessionMiddleware, secret_key='secret')
Other things you can configure either via environment variables or .env file:
DOMAIN- declare cookie domain. App must be under this domain. If empty, the cookie is restricted to the subdomain of the app (this is useful when you write eg. SSO portals)JWT_ALG- one of authlib JWT supported algorithmsJWT_SECRET- jwt secret. Only useful for HS* algorithms, see thesample_appfolder for middleware usage w/ crypto keys.
See it in action: sample application
A sample application is included, and you can run it with either Starlette-based session middleware or this one, just by setting a variable:
# run with vanilla Starlette-based session middleware
VANILLA=1 uvicorn sample_app.app:app
# run with this drop-in replacement
uvicorn sample_app.app:app
As you can notice in code here, the only difference is an
import name, based on this VANILLA env var.
Contributing
This project is absolutely open to contributions so if you have a nice idea, create an issue to let the community discuss it.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file starlette_authlib-0.3.21.tar.gz.
File metadata
- Download URL: starlette_authlib-0.3.21.tar.gz
- Upload date:
- Size: 4.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
poetry/2.4.3 CPython/3.10.21 Linux/6.17.0-1022-azure
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ed4fe8e967afc1f7b46fecd996baf722349cb37ed02c8d4fc43411af22260c0e
|
|
| MD5 |
a7605698895905b4142a51b88965403b
|
|
| BLAKE2b-256 |
f90f5e5329cd21873319af4900cd8d0e6df571258a0ed36a9021cf273bf99558
|
File details
Details for the file starlette_authlib-0.3.21-py3-none-any.whl.
File metadata
- Download URL: starlette_authlib-0.3.21-py3-none-any.whl
- Upload date:
- Size: 5.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
poetry/2.4.3 CPython/3.10.21 Linux/6.17.0-1022-azure
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ff0b274a13e015be99b8549e1c43e9ae172b24d19ff93248879b7280e8a25462
|
|
| MD5 |
09a4455c17c23f74084c7bf59a0f4200
|
|
| BLAKE2b-256 |
4ab99b0b745e35e1b7f2239830877f63d109495537b4bb16ee5d711cc189ff1c
|
