Skip to main content
AuthFort

authfort

PyPI Coverage Python License: MIT Docs

Complete authentication and authorization library for Python.

Install

pip install authfort[fastapi]
# or with SQLite: pip install authfort[sqlite,fastapi]

Quick Start

from authfort import AuthFort, CookieConfig
from fastapi import FastAPI, Depends

auth = AuthFort(
    database_url="postgresql+asyncpg://user:pass@localhost/mydb",
    cookie=CookieConfig(),
)

app = FastAPI()
app.include_router(auth.fastapi_router(), prefix="/auth")
app.include_router(auth.jwks_router())

@app.get("/profile")
async def profile(user=Depends(auth.current_user)):
    return {"email": user.email, "roles": user.roles}

Endpoints

Method Path Description
POST /auth/signup Create account
POST /auth/login Sign in
POST /auth/refresh Refresh access token
POST /auth/logout Sign out
GET /auth/me Get current user
POST /auth/magic-link Request magic link
POST /auth/magic-link/verify Verify magic link
POST /auth/otp Request email OTP
POST /auth/otp/verify Verify email OTP
POST /auth/verify-email Verify email address
GET /auth/oauth/{provider}/authorize Start OAuth flow
GET /auth/oauth/{provider}/callback OAuth callback
POST /auth/introspect Token introspection
GET /.well-known/jwks.json Public signing keys

Features

  • Email/password auth with argon2 hashing
  • JWT RS256 with automatic key management
  • Refresh token rotation with theft detection
  • OAuth 2.1 with PKCE (Google, GitHub, or any provider via GenericOAuthProvider/GenericOIDCProvider)
  • Email verification, magic links, email OTP (passwordless)
  • Role-based access control
  • Password reset (programmatic — you control delivery)
  • Change password (with old password verification)
  • Session management (list, revoke, revoke all except current)
  • Ban/unban users
  • Rate limiting — per-endpoint IP + email based, in-memory sliding window, pluggable storage
  • Admin user management — list, search, get, delete users programmatically
  • Event hooks (24 event types)
  • JWKS + key rotation
  • Cookie and bearer token modes
  • Multi-database: PostgreSQL (default), SQLite, MySQL via SQLAlchemy

OAuth

from authfort import AuthFort, GoogleProvider, GitHubProvider, GenericOIDCProvider

auth = AuthFort(
    database_url="...",
    providers=[
        GoogleProvider(client_id="...", client_secret="..."),
        GitHubProvider(client_id="...", client_secret="..."),
        GenericOIDCProvider(
            "keycloak",
            client_id="...",
            client_secret="...",
            discovery_url="https://keycloak.example.com/realms/myrealm/.well-known/openid-configuration",
        ),
    ],
)

Programmatic API

# Create users without the HTTP endpoint
result = await auth.create_user("admin@example.com", "password", name="Admin")

# Roles
await auth.add_role(user_id, "admin")
await auth.remove_role(user_id, "editor")

# Password reset (you handle delivery — email, SMS, etc.)
token = await auth.create_password_reset_token("user@example.com")
if token:
    send_email(email, f"https://myapp.com/reset?token={token}")
await auth.reset_password(token, "new_password")

# Change password (authenticated)
await auth.change_password(user_id, "old_password", "new_password")

# Sessions
sessions = await auth.get_sessions(user_id, active_only=True)
await auth.revoke_session(session_id)
await auth.revoke_all_sessions(user_id, exclude=user.session_id)  # keep current

# Ban/unban
await auth.ban_user(user_id)
await auth.unban_user(user_id)

# Admin user management
users = await auth.list_users(query="john", role="admin", limit=20)
user = await auth.get_user(user_id)
await auth.delete_user(user_id)
count = await auth.get_user_count(banned=True)

License

MIT

Metadata

Release files for authfort 0.0.32

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for authfort 0.0.32
File Size Uploaded Provenance Actions
authfort-0.0.32.tar.gz 134.5 kB Without provenance Details for authfort-0.0.32.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for authfort 0.0.32
File Interpreter ABI Platform Actions
authfort-0.0.32-py3-none-any.whl Python 3 none any Details for authfort-0.0.32-py3-none-any.whl

Total release size: 234.3 kB

Release files / authfort-0.0.32.tar.gz

Download URL authfort-0.0.32.tar.gz
Size 134.5 kB
Tags Source
SHA-256 checksum
How to use checksums
d45cc7d84a04d515fad073f044607216d8d2b2fee394907b659f285c7438a0a3
BLAKE2b-256 checksum
How to use checksums
56c1875f4a61d033df461187ddfa98081da8968b41dcffee13ad442b0a279e03
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / authfort-0.0.32-py3-none-any.whl

Download URL authfort-0.0.32-py3-none-any.whl
Size 99.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6da0c2d0f7a14d9d7f74cec7e219fa76dbff4c3e3949a9e272106fa4bad322e3
BLAKE2b-256 checksum
How to use checksums
1e0f772bb4878c5bf5b6dabab95665379d3b1b6c015bc3942afa4f1e63d5c172
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for authfort 0.0.32

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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.0.32 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page