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
Metadata
1 maintainer
Release files for starlette-authlib 0.3.25
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| starlette_authlib-0.3.25.tar.gz | 3.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| starlette_authlib-0.3.25-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 8.2 kB
Release files / starlette_authlib-0.3.25.tar.gz
| Download URL | starlette_authlib-0.3.25.tar.gz |
|---|---|
| Size | 3.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7d1039efb62cdaa7fe58b34203fbe433d6909411cbd4e143a0e258d7cc9c58e9
|
|
BLAKE2b-256 checksum How to use checksums |
39e434d4ab906c817df6236219abe91a9c78185025290bd6ff5862c331c98da7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 27, 2026.
Transparency logRelease files / starlette_authlib-0.3.25-py3-none-any.whl
| Download URL | starlette_authlib-0.3.25-py3-none-any.whl |
|---|---|
| Size | 4.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c429d1388027bb88bca67d7e40892ce0b77e123e941bef8f5111d4c8c71f8af8
|
|
BLAKE2b-256 checksum How to use checksums |
83135ef196b801b60d56eeaa2bf913f7bb27e17d90142b7e5cccae84aac27fe4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 27, 2026.
Transparency log
