是否存在FastAPI库可标记受保护端点并验证HTTP Only Cookie中的JWT令牌
方案实现说明
FastAPI 原生的**依赖注入(Dependency Injection)**特性就完全支持你的需求,不需要复杂的第三方集成,实现成本极低,核心思路是把身份校验逻辑封装成可复用的依赖,给需要保护的端点绑定该依赖即可自动完成校验。
步骤1:安装JWT验证依赖
首先安装JWT校验所需的库,用来验证Cognito返回的JWT令牌合法性:
pip install python-jose[cryptography]
步骤2:修改重定向端点,写入HTTP Only Cookie
你现有的/aws_cognito_redirect端点拿到令牌后,需要把访问令牌、刷新令牌写入HTTP Only Cookie返回给客户端:
# 在你现有代码的read_code_challenge函数里,拿到tokens之后补充: token_data = tokens.json() response = RedirectResponse(url="/dashboard") # 登录成功跳转到你的业务页面 # 写入HTTP Only Cookie,生产环境记得加secure=True(仅HTTPS传输)、SameSite="Lax" response.set_cookie( key="access_token", value=token_data["access_token"], httponly=True, secure=True, # 本地开发如果用HTTP可以临时设为False samesite="Lax", max_age=token_data["expires_in"] ) response.set_cookie( key="id_token", value=token_data["id_token"], httponly=True, secure=True, samesite="Lax", max_age=token_data["expires_in"] ) return response
步骤3:封装认证校验依赖
写一个可复用的依赖函数,自动读取Cookie中的令牌并完成校验,校验不通过直接跳转登录页:
from jose import jwt, JWTError from fastapi import HTTPException, status # 预加载缓存Cognito用户池的公钥,不用每次请求都拉取 COGNITO_PUBLIC_KEYS = {} async def require_auth(request: Request, settings: config.Settings = Depends(get_settings)): access_token = request.cookies.get("access_token") if not access_token: # 未登录直接跳转到登录页 return RedirectResponse(url="/") # 验证JWT合法性 try: # 先拿JWT的kid匹配对应公钥 headers = jwt.get_unverified_headers(access_token) kid = headers["kid"] if kid not in COGNITO_PUBLIC_KEYS: # 公钥不存在时拉取Cognito的JWKS缓存到本地 async with httpx.AsyncClient() as client: jwks = await client.get(f"https://cognito-idp.{settings.region}.amazonaws.com/{settings.user_pool_id}/.well-known/jwks.json") for key in jwks.json()["keys"]: COGNITO_PUBLIC_KEYS[key["kid"]] = jwt.algorithms.RSAAlgorithm.from_jwk(key) public_key = COGNITO_PUBLIC_KEYS[kid] # 校验签名、过期时间、签发方、受众 payload = jwt.decode( access_token, public_key, algorithms=["RS256"], audience=settings.client_id, issuer=f"https://cognito-idp.{settings.region}.amazonaws.com/{settings.user_pool_id}" ) return payload # 校验通过返回用户信息,端点中可直接调用 except JWTError: # 令牌无效时清除Cookie跳转登录 response = RedirectResponse(url="/") response.delete_cookie("access_token") response.delete_cookie("id_token") return response
注意需要在你的config.Settings配置类中新增user_pool_id(Cognito用户池ID)配置项。
步骤4:给受保护端点绑定依赖
需要登录才能访问的端点,直接在参数里加user = Depends(require_auth)即可,框架会自动先执行校验逻辑:
# 示例:受保护的用户面板页 @app.get("/dashboard") async def dashboard(request: Request, user = Depends(require_auth)): # 校验通过的user就是当前登录用户信息,可以直接传给jinja2模板渲染 return templates.TemplateResponse("dashboard.html", {"request": request, "user": user})
补充:CSRF防护处理
因为你使用了Cookie认证,需要配套CSRF防护,可使用fastapi-csrf-protect库,给所有POST表单请求加上CSRF Token校验即可。
内容的提问来源于stack exchange,提问作者anon_dcs3spp
相关产品推荐
相关产品推荐

