Auth Backend Module

Reusable FastAPI authentication backend module with JWT tokens and OAuth support.

Features

• ✅ Email/password registration and login
• ✅ Google OAuth integration
• ✅ JWT access and refresh tokens
• ✅ Token refresh with rotation
• ✅ Secure password hashing (bcrypt)
• ✅ PostgreSQL database with SQLAlchemy
• ✅ Token revocation on logout

Installation

# Using Poetry
poetry add path/to/auth-backend

# Using pip
pip install -e path/to/auth-backend

Usage

from fastapi import FastAPI
from auth_backend import auth_router, init_db

app = FastAPI()

# Initialize database
init_db("postgresql://user:password@localhost/dbname")

# Include auth routes
app.include_router(auth_router, prefix="/auth", tags=["auth"])

API Endpoints

• POST /auth/register - Register new user
• POST /auth/login - Login with email/password
• POST /auth/google - Login with Google OAuth
• POST /auth/refresh - Refresh access token
• POST /auth/logout - Logout (revoke refresh token)
• GET /auth/me - Get current user info

Environment Variables

DATABASE_URL=postgresql://user:password@localhost/dbname
SECRET_KEY=your-secret-key-here

Database Models

• User - User accounts
• RefreshToken - JWT refresh tokens
• OAuthAccount - OAuth provider accounts

Security Notes

⚠️ Important: Change the SECRET_KEY in security.py for production use!