Authentication, Authorization & bảo mật ứng dụng Python
Đăng nhập đúng cách (session cookie vs JWT, refresh rotation, OAuth2/OIDC với Authlib, 2FA), băm mật khẩu, phân quyền RBAC/ABAC multi-tenant, và các lỗ hổng đặc thù Python: pickle, yaml.load, eval, SSTI Jinja2, path traversal, SSRF, subprocess shell=True.
FastAPI cung cấp công cụ (OAuth2PasswordBearer) nhưng để bạn tự lắp phần còn lại — đây là nơi nhiều dự án Python mắc lỗi:
JWT không thời hạn, secret cứng trong code, kiểm tra quyền thiếu ở một endpoint, pickle.loads dữ liệu từ Redis/người dùng.
Bảo mật là phần làm sai thì hậu quả lớn nhất, và câu "bạn lưu token ở đâu và vì sao" gần như luôn có ở vòng senior.
🎯 Mục tiêu học tập
- Chọn session cookie hay JWT; cài access/refresh token có rotation
- Tích hợp OAuth2/OIDC (Google, Microsoft) bằng Authlib; 2FA
- Băm mật khẩu bằng argon2; chống brute force
- Phân quyền RBAC/ABAC, cô lập multi-tenant, test IDOR tự động
- Phòng thủ OWASP Top 10 và lỗ hổng đặc thù Python
Session vs JWT, và refresh rotation
| Session cookie (Redis) | JWT | |
|---|---|---|
| Thu hồi | Ngay lập tức | Phải chờ hết hạn hoặc denylist |
| Hợp với | Web app cùng domain (SPA + API, Django) — mặc định nên chọn | Mobile, nhiều service cùng xác minh, API bên thứ ba |
# JWT ngắn hạn với PyJWT
def create_access_token(user_id: int) -> str:
now = datetime.now(UTC)
return jwt.encode({"sub": str(user_id), "iat": now, "exp": now + timedelta(minutes=15),
"iss": "taskflow", "aud": "taskflow-api"}, settings.jwt_private_key.get_secret_value(), algorithm="EdDSA")
def decode(token: str) -> dict:
return jwt.decode(token, settings.jwt_public_key, algorithms=["EdDSA"], audience="taskflow-api", issuer="taskflow")
# Cookie an toàn cho session/refresh token
response.set_cookie("refresh", value=raw, httponly=True, secure=True, samesite="lax", path="/auth/refresh", max_age=30*86400)
- Refresh token: lưu hash trong DB theo "family"; mỗi lần dùng cấp token mới, token cũ bị dùng lại → thu hồi cả family.
- Luôn chỉ định
algorithms=[...]khi decode (chống tấn công đổi thuật toán); không đặt dữ liệu nhạy cảm vào payload. - Không lưu token trong localStorage của SPA.
Mật khẩu, OAuth/OIDC, 2FA
from argon2 import PasswordHasher
ph = PasswordHasher() # argon2id, tham số an toàn mặc định
hashed = ph.hash(password)
ph.verify(hashed, attempt) # ném VerifyMismatchError nếu sai
if ph.check_needs_rehash(hashed): ... # nâng cấp tham số khi người dùng đăng nhập
- Rate limit đăng nhập theo email + IP; thông điệp lỗi chung; so sánh token bằng
hmac.compare_digest/secrets.compare_digest. - Token ngẫu nhiên:
secrets.token_urlsafe(32)— không bao giờ dùngrandomcho bảo mật. - Authlib cho OAuth2/OIDC (Authorization Code + PKCE, kiểm tra state, nonce, id_token qua JWKS); liên kết tài khoản theo
sub+ issuer, chỉ tự liên kết với email đã được xác minh. - 2FA TOTP bằng
pyotp+ mã khôi phục; passkey quawebauthn. Hoặc dùng dịch vụ (Auth0, Clerk, Keycloak, Zitadel) và hiểu cấu hình của nó. - Django: dùng auth có sẵn +
django-allauth; FastAPI:fastapi-userslà điểm khởi đầu tốt.
Phân quyền và multi-tenant
# Dependency phân quyền tái sử dụng
def require(permission: str):
async def checker(user: UserDep) -> User:
if permission not in user.permissions:
raise AppError(403, "FORBIDDEN", "Không đủ quyền")
return user
return checker
@router.delete("/{project_id}", dependencies=[Depends(require("project:delete"))])
async def delete_project(project_id: int, session: SessionDep, user: UserDep):
project = await repo.get(session, project_id, org_id=user.org_id) # lọc tenant trong MỌI truy vấn
if project is None:
raise AppError(404, "NOT_FOUND", "Không tìm thấy") # 404, không lộ sự tồn tại
...
- IDOR là lỗ hổng số 1: mọi truy vấn theo id phải kèm điều kiện tenant/quyền sở hữu.
- Lớp phòng thủ ở DB: PostgreSQL Row-Level Security (đặt
SET LOCAL app.org_idmỗi transaction). - Quy tắc phức tạp: thư viện policy (Casbin, Oso) hoặc dịch vụ ReBAC (OpenFGA, SpiceDB).
Lỗ hổng đặc thù Python
| Nguy hiểm | Vì sao | Dùng thay |
|---|---|---|
pickle.loads, shelve, joblib.load dữ liệu không tin cậy | Thực thi mã tuỳ ý khi giải tuần tự | JSON, msgpack; model ML chỉ tải từ nguồn tin cậy (safetensors) |
yaml.load | Tạo object tuỳ ý | yaml.safe_load |
eval, exec | Chạy code của người dùng | Parser riêng, ast.literal_eval cho literal |
subprocess(..., shell=True) với input | Command injection | Danh sách tham số, shell=False |
| f-string trong SQL | SQL injection | Tham số bind của SQLAlchemy/Django ORM; text() với :param |
Template(user_input).render() (Jinja2) | Server-side template injection | Template cố định, dữ liệu người dùng chỉ là biến; autoescape bật |
open(base / filename) | Path traversal (../../etc/passwd) | Tên file tự sinh; resolve() và kiểm tra nằm trong thư mục gốc |
httpx.get(user_url) | SSRF tới mạng nội bộ/metadata | Allowlist, chặn IP nội bộ, timeout |
Django DEBUG=True, SECRET_KEY trong repo | Lộ cấu hình, giả mạo session | Biến môi trường, manage.py check --deploy |
Công cụ: ruff rule S (bandit), pip-audit/uv audit trong CI, Dependabot; cẩn thận với package giả
mạo tên (typosquatting) trên PyPI.
🏋️ Bài tập thực hành
(1) Đăng ký/đăng nhập, xác minh email, quên mật khẩu bằng token một lần (argon2, secrets). (2) Access JWT 15 phút +
refresh trong cookie HttpOnly có rotation và phát hiện tái sử dụng. (3) Đăng nhập Google bằng Authlib (OIDC + PKCE). (4) RBAC
owner/admin/member, lọc tenant ở mọi repository, bật RLS cho một bảng. (5) Test bảo mật pytest: IDOR, mass assignment (field lạ → 422),
brute force (429), path traversal khi tải file. (6) Chạy ruff S, pip-audit và OWASP ZAP baseline, sửa mọi cảnh báo
từ Medium trở lên.
📚 Tài nguyên học tập
-
FastAPI — SecurityOAuth2, JWT trong FastAPIDocs
-
AuthlibOAuth2/OIDC client và serverDocs
-
OWASP Cheat Sheet SeriesSession, JWT, password storage, injectionGuide
-
BanditQuét lỗ hổng mã PythonDocs
-
Django — Deployment checklistCấu hình Django an toànDocs
✅ Tự đánh giá hoàn thành
- Trả lời được 'lưu token ở đâu và vì sao'
- Mật khẩu argon2, token bằng secrets, so sánh bằng compare_digest
- Mọi truy vấn lọc tenant, có test IDOR tự động
- Không còn pickle/yaml.load/eval/shell=True với dữ liệu không tin cậy