FastAPI: lưu session đăng nhập bằng SessionMiddleware trong 5 phút
SessionMiddleware của Starlette lưu trạng thái đăng nhập trong một cookie đã ký ở trình duyệt: sau khi đăng nhập, server chỉ cần đọc request.session là biết người dùng là ai — không cần database hay Redis. Gắn middleware một lần cho toàn bộ app, lấy secret_key từ biến môi trường, dùng cho app nhỏ, trang quản trị nội bộ hoặc prototype.
Vấn đề: biến global chỉ nhớ được một người
Nhiều app FastAPI mới lưu người dùng đã đăng nhập trong một biến global ở cấp module. Trên máy dev thì chạy được, nhưng chạy thật sẽ hỏng ngay: global chỉ nhớ một người — lần đăng nhập sau ghi đè lần trước; restart server là mất hết session; nhiều worker thì mỗi worker giữ một bản khác nhau, nên cùng một cookie lúc đăng nhập được, lúc bị đá ra.
from fastapi import FastAPI
from fastapi.responses import JSONResponse
app = FastAPI()
current_user = None # chỉ nhớ 1 người, restart là mất
USERS = {"linh": "mat-khau-123"}
@app.post("/login")
async def login(data: dict):
global current_user
if USERS.get(data.get("username")) == data["password"]:
current_user = data["username"]
return {"message": "Dang nhap thanh cong"}
return JSONResponse({"detail": "Sai tai khoan hoac mat khau"}, status_code=401)
@app.get("/me")
async def me():
if not current_user:
return JSONResponse({"detail": "Chua dang nhap"}, status_code=401)
return {"user": current_user}
Giải pháp: SessionMiddleware
SessionMiddleware đẩy trạng thái session xuống cookie của chính trình duyệt. Cookie được ký bằng secret_key nên client không sửa được nội dung — đổi một ký tự là chữ ký không khớp, server coi như chưa đăng nhập. Gắn middleware một lần, mọi endpoint sau đó đọc request.session như một dict bình thường.
import os
from fastapi import FastAPI, Request
from fastapi.responses import JSONResponse
from starlette.middleware.sessions import SessionMiddleware
app = FastAPI()
app.add_middleware(
SessionMiddleware,
secret_key=os.environ.get("SECRET_KEY", "dev-only-change-me"),
max_age=60 * 60 * 24, # 1 ngay
same_site="lax",
https_only=False, # production dat True
)
Ba endpoint đăng nhập, kiểm tra session và đăng xuất, mỗi cái chỉ vài dòng:
USERS = {"linh": "mat-khau-123"}
@app.post("/login")
async def login(data: dict, request: Request):
if USERS.get(data.get("username")) != data.get("password"):
return JSONResponse({"detail": "Sai tai khoan hoac mat khau"}, status_code=401)
request.session["user"] = data["username"]
return {"message": "Dang nhap thanh cong"}
@app.get("/me")
async def me(request: Request):
user = request.session.get("user")
if not user:
return JSONResponse({"detail": "Chua dang nhap"}, status_code=401)
return {"user": user}
@app.post("/logout")
async def logout(request: Request):
request.session.clear()
return {"message": "Da dang xuat"}
Điểm mấu chốt: request.session là một dict — gán request.session["user"] lúc đăng nhập, đọc request.session.get("user") ở endpoint cần bảo vệ, gọi request.session.clear() khi đăng xuất. max_age đặt thời gian sống của cookie; same_site="lax" chặn cookie bị gửi kèm từ site khác; https_only=True chỉ bật khi app đã chạy HTTPS — bật sớm trên máy dev sẽ làm session tự dưng "biến mất".
Lưu ý khi đưa lên production
Lấy SECRET_KEY từ biến môi trường và sinh bằng secrets.token_hex(32) — đừng hardcode chuỗi ngắn như trong ví dụ. Hai giới hạn cần nhớ: cookie chỉ chứa được khoảng 4KB, và không thể đăng xuất một người khỏi từng thiết bị riêng lẻ — muốn thu hồi từng session thì dùng session phía server (ví dụ Redis) và chỉ giữ session id trong cookie. Ngoài ra, cookie chỉ được ký chứ không mã hóa, nên đừng lưu mật khẩu hay token nhạy cảm trong đó — chỉ lưu user id hoặc username.
Bài đầy đủ (tiếng Anh): https://linhfish.dev/en/2026/11/21/fastapi-store-login-sessions-with-sessionmiddleware-in-5-minutes/
All rights reserved