You need to enable JavaScript to run this app. 是否存在FastAPI库可标记受保护端点并验证HTTP Only Cookie中的JWT令牌
优惠活动
大模型
产品
解决方案
定价
更多

是否存在FastAPI库可标记受保护端点并验证HTTP Only Cookie中的JWT令牌

方案实现说明

FastAPI 原生的**依赖注入(Dependency Injection)**特性就完全支持你的需求,不需要复杂的第三方集成,实现成本极低,核心思路是把身份校验逻辑封装成可复用的依赖,给需要保护的端点绑定该依赖即可自动完成校验。

步骤1:安装JWT验证依赖

首先安装JWT校验所需的库,用来验证Cognito返回的JWT令牌合法性:

pip install python-jose[cryptography]

你现有的/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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.22 04:45:03