Dependency Injection Xác thực Token qua HTTP Header (Header Token Auth Dependency)

Mục tiêu kiến thức

• Sử dụng cơ chế Dependency Injection của FastAPI (Depends()).
• Đọc HTTP Header (Header(...)) và trả về mã lỗi 401 Unauthorized khi token không hợp lệ.

Mô tả bài toán

Viết hàm create_auth_guarded_app(valid_tokens: dict[str, str]) -> FastAPI:

• valid_tokens là dictionary ánh xạ {api_token: username} (ví dụ: {"secret-token-123": "alice", "admin-key-999": "superadmin"}).
• Xây dựng dependency function:

verify_api_token(x_api_key: str = Header(..., alias="X-API-Key")) -> str:

• Nếu x_api_key có trong valid_tokens: trả về username tương ứng.
• Nếu không có hoặc sai: raise HTTPException(status_code=401, detail="Invalid API Key").
• Tạo endpoint được bảo vệ:

GET /protected/dashboard:

• Yêu cầu dependency user: str = Depends(verify_api_token).
• Trả về: {"status": "success", "authenticated_user": user, "data": "Confidential Academy Metrics"}.
• Tạo endpoint công khai:

GET /public/health:

• Không yêu cầu token, trả về {"status": "healthy"}.

Ràng buộc

• Thời gian chạy tối đa: 1000ms.
• Giới hạn bộ nhớ: 256MB.
• Dữ liệu đầu vào tuân thủ đúng kiểu dữ liệu và miền giá trị được mô tả.