如何用三层防护体系打造坚不可摧的 API 安全堡垒?

图片[1]-如何用三层防护体系打造坚不可摧的 API 安全堡垒?-牛翰网

扫描二维码
关注或者微信搜一搜:编程智域 前端至全栈交流与成长

发现1000+提升效率与开发的AI工具和实用程序:https://tools.cmdragon.cn/

FastAPI 安全与认证综合实战

通过三层防护体系实现API安全:

  1. 传输层:HTTPS + CORS配置
  2. 认证层:OAuth2 + JWT令牌
  3. 权限层:RBAC模型 + 操作日志审计

一、JWT 认证联调方案

sequenceDiagram participant 用户 participant FastAPI participant 数据库 用户->>FastAPI: 提交用户名密码 FastAPI->>数据库: 验证凭证 数据库–>>FastAPI: 返回用户数据 FastAPI->>FastAPI: 生成JWT令牌 FastAPI–>>用户: 返回access_token 用户->>FastAPI: 携带Bearer token FastAPI->>FastAPI: 解码验证token FastAPI->>数据库: 获取用户权限 FastAPI–>>用户: 返回受保护资源

实现步骤

# 安装依赖:pip install python-jose[cryptography]==3.3.0 passlib==1.7.4
from jose import JWTError, jwt
from datetime import datetime, timedelta

SECRET_KEY = "your-secret-key"
ALGORITHM = "HS256"
ACCESS_TOKEN_EXPIRE_MINUTES = 30


def create_access_token(data: dict):
    to_encode = data.copy()
    expire = datetime.utcnow() + timedelta(minutes=ACCESS_TOKEN_EXPIRE_MINUTES)
    to_encode.update({"exp": expire})
    return jwt.encode(to_encode, SECRET_KEY, algorithm=ALGORITHM)


async def get_current_user(token: str = Depends(oauth2_scheme)):
    credentials_exception = HTTPException(
        status_code=401,
        detail="无法验证凭证",
        headers={"WWW-Authenticate": "Bearer"},
    )
    try:
        payload = jwt.decode(token, SECRET_KEY, algorithms=[ALGORITHM])
        username: str = payload.get("sub")
        if username is None:
            raise credentials_exception
    except JWTError:
        raise credentials_exception
    return username

二、OAuth2 集成实现

graph TD A[用户] –>|登录| B(认证服务器) B –>|授权码| A A –>|提交授权码| C[客户端] C –>|换取令牌| B B –>|访问令牌| C C –>|访问资源| D[资源服务器]

第三方登录配置

# 配置示例:pip install authlib==1.0.1
from fastapi.security import OAuth2AuthorizationCodeBearer

oauth2_scheme = OAuth2AuthorizationCodeBearer(
    authorizationUrl='https://provider.com/auth',
    tokenUrl='https://provider.com/token',
    scopes={"read": "读取权限", "write": "写入权限"}
)


@app.get("/login/google")
async def login_google():
    return RedirectResponse(
        url=(
            "https://accounts.google.com/o/oauth2/auth"
            "?response_type=code"
            "&client_id=your-client-id"
            "&redirect_uri=http://localhost:8000/callback"
            "&scope=openid%20profile%20email"
        )
    )

三、渗透测试实战案例

flowchart TB A[信息收集] –> B[漏洞扫描] B –> C{存在漏洞?} C –>|是| D[渗透攻击] C –>|否| E[生成报告] D –> F[权限提升] F –> G[数据窃取] G –> E

  1. XSS测试:在输入字段注入 <script>alert(1)</script>
  2. SQL注入测试:’ OR 1=1 —
  3. 越权访问测试:修改用户ID参数
  4. SQL 注入防护方案
# 使用SQLAlchemy防止注入(pip install sqlalchemy==1.4.46)
from sqlalchemy import text


@app.get("/items/")
async def read_items(name: str):
    # 错误写法:f"SELECT * FROM items WHERE name = '{name}'"
    query = text("SELECT * FROM items WHERE name = :name")
    result = await database.execute(query, {"name": name})
    return result.fetchall()

课后 Quiz

  1. 问题:JWT 令牌应该存储在客户端的哪个位置最安全?

    • A) localStorage
    • B) sessionStorage
    • C) HTTPOnly Cookie
    • D) URL 参数

    答案:C。HTTPOnly Cookie 可以防止XSS攻击窃取令牌,配合Secure和SameSite属性使用更安全。

  2. 问题:当收到401 Unauthorized响应时,首先应该检查:

    • A) 路由配置
    • B) 令牌有效期
    • C) 数据库连接
    • D) 请求头格式

    答案:B。令牌过期是最常见的401错误原因,需检查令牌生成时间和有效期设置。

常见报错处理

错误现象:422 Validation Error

{
  "detail": [
    {
      "loc": [
        "body",
        "password"
      ],
      "msg": "field required",
      "type": "value_error.missing"
    }
  ]
}

解决方案

  1. 检查请求体是否包含所有必填字段
  2. 验证请求头 Content-Type 是否为 application/json
  3. 使用 Pydantic 模型进行数据验证:
class UserCreate(BaseModel):
    username: str = Field(min_length=3)
    password: str = Field(min_length=8, regex="^(?=.*[A-Za-z])(?=.*\d).{8,}$")

余下文章内容请点击跳转至 个人博客页面 或者 扫码关注或者微信搜一搜:编程智域 前端至全栈交流与成长
,阅读完整的文章:如何在FastAPI中玩转JWT认证与OAuth2集成,同时确保安全无虞?

往期文章归档:

  • FastAPI安全加固:密钥轮换、限流策略与安全头部如何实现三重防护? – cmdragon’s Blog
  • 如何在FastAPI中巧妙玩转数据脱敏,让敏感信息安全无忧? – cmdragon’s Blog
  • RBAC权限模型如何让API访问控制既安全又灵活? – cmdragon’s Blog
  • FastAPI中的敏感数据如何在不泄露的情况下翩翩起舞?
  • FastAPI安全认证的终极秘籍:OAuth2与JWT如何完美融合? – cmdragon’s Blog
  • 如何在FastAPI中打造坚不可摧的Web安全防线? – cmdragon’s Blog
  • 如何用 FastAPI 和 RBAC 打造坚不可摧的安全堡垒? – cmdragon’s Blog
  • FastAPI权限配置:你的系统真的安全吗? – cmdragon’s Blog
  • FastAPI权限缓存:你的性能瓶颈是否藏在这只“看不见的手”里? | cmdragon’s Blog
  • FastAPI日志审计:你的权限系统是否真的安全无虞? | cmdragon’s Blog
  • 如何在FastAPI中打造坚不可摧的安全防线? | cmdragon’s Blog
  • 如何在FastAPI中实现权限隔离并让用户乖乖听话? | cmdragon’s Blog
  • 如何在FastAPI中玩转权限控制与测试,让代码安全又优雅? | cmdragon’s Blog
  • 如何在FastAPI中打造一个既安全又灵活的权限管理系统? | cmdragon’s Blog
  • FastAPI访问令牌的权限声明与作用域管理:你的API安全真的无懈可击吗? | cmdragon’s Blog
  • 如何在FastAPI中构建一个既安全又灵活的多层级权限系统? | cmdragon’s Blog
  • FastAPI如何用角色权限让Web应用安全又灵活? | cmdragon’s Blog
  • FastAPI权限验证依赖项究竟藏着什么秘密? | cmdragon’s Blog
  • 如何用FastAPI和Tortoise-ORM打造一个既高效又灵活的角色管理系统? | cmdragon’s Blog
  • JWT令牌如何在FastAPI中实现安全又高效的生成与验证? | cmdragon’s Blog
  • 你的密码存储方式是否在向黑客招手? | cmdragon’s Blog
  • 如何在FastAPI中轻松实现OAuth2认证并保护你的API? | cmdragon’s Blog
  • FastAPI安全机制:从OAuth2到JWT的魔法通关秘籍 | cmdragon’s Blog
  • FastAPI认证系统:从零到令牌大师的奇幻之旅 | cmdragon’s Blog
  • FastAPI安全异常处理:从401到422的奇妙冒险 | cmdragon’s Blog
  • FastAPI权限迷宫:RBAC与多层级依赖的魔法通关秘籍 | cmdragon’s Blog
  • JWT令牌:从身份证到代码防伪的奇妙之旅 | cmdragon’s Blog
  • FastAPI安全认证:从密码到令牌的魔法之旅 | cmdragon’s Blog
  • 密码哈希:Bcrypt的魔法与盐值的秘密 | cmdragon’s Blog
  • 用户认证的魔法配方:从模型设计到密码安全的奇幻之旅 | cmdragon’s Blog
  • FastAPI安全门神:OAuth2PasswordBearer的奇妙冒险 | cmdragon’s Blog
  • OAuth2密码模式:信任的甜蜜陷阱与安全指南 | cmdragon’s Blog
  • API安全大揭秘:认证与授权的双面舞会 | cmdragon’s Blog
  • 异步日志监控:FastAPI与MongoDB的高效整合之道 | cmdragon’s Blog
  • FastAPI与MongoDB分片集群:异步数据路由与聚合优化 | cmdragon’s Blog
  • FastAPI与MongoDB Change Stream的实时数据交响曲 | cmdragon’s Blog

免费好用的热门在线工具

  • CMDragon 在线工具 – 高级AI工具箱与开发者套件 | 免费好用的在线工具
  • 应用商店 – 发现1000+提升效率与开发的AI工具和实用程序 | 免费好用的在线工具
  • CMDragon 更新日志 – 最新更新、功能与改进 | 免费好用的在线工具
  • 支持我们 – 成为赞助者 | 免费好用的在线工具
  • AI文本生成图像 – 应用商店 | 免费好用的在线工具
  • 临时邮箱 – 应用商店 | 免费好用的在线工具
  • 二维码解析器 – 应用商店 | 免费好用的在线工具
  • 文本转思维导图 – 应用商店 | 免费好用的在线工具
  • 正则表达式可视化工具 – 应用商店 | 免费好用的在线工具
  • 文件隐写工具 – 应用商店 | 免费好用的在线工具
  • IPTV 频道探索器 – 应用商店 | 免费好用的在线工具
  • 快传 – 应用商店 | 免费好用的在线工具
  • 随机抽奖工具 – 应用商店 | 免费好用的在线工具
  • 动漫场景查找器 – 应用商店 | 免费好用的在线工具
  • 时间工具箱 – 应用商店 | 免费好用的在线工具
  • 网速测试 – 应用商店 | 免费好用的在线工具
  • AI 智能抠图工具 – 应用商店 | 免费好用的在线工具
  • 背景替换工具 – 应用商店 | 免费好用的在线工具
  • 艺术二维码生成器 – 应用商店 | 免费好用的在线工具
  • Open Graph 元标签生成器 – 应用商店 | 免费好用的在线工具
  • 图像对比工具 – 应用商店 | 免费好用的在线工具
  • 图片压缩专业版 – 应用商店 | 免费好用的在线工具
  • 密码生成器 – 应用商店 | 免费好用的在线工具
  • SVG优化器 – 应用商店 | 免费好用的在线工具
  • 调色板生成器 – 应用商店 | 免费好用的在线工具
  • 在线节拍器 – 应用商店 | 免费好用的在线工具
  • IP归属地查询 – 应用商店 | 免费好用的在线工具
  • CSS网格布局生成器 – 应用商店 | 免费好用的在线工具
  • 邮箱验证工具 – 应用商店 | 免费好用的在线工具
  • 书法练习字帖 – 应用商店 | 免费好用的在线工具
  • 金融计算器套件 – 应用商店 | 免费好用的在线工具
  • 中国亲戚关系计算器 – 应用商店 | 免费好用的在线工具
  • Protocol Buffer 工具箱 – 应用商店 | 免费好用的在线工具
  • IP归属地查询 – 应用商店 | 免费好用的在线工具
  • 图片无损放大 – 应用商店 | 免费好用的在线工具
  • 文本比较工具 – 应用商店 | 免费好用的在线工具
  • IP批量查询工具 – 应用商店 | 免费好用的在线工具
  • 域名查询工具 – 应用商店 | 免费好用的在线工具
  • DNS工具箱 – 应用商店 | 免费好用的在线工具
  • 网站图标生成器 – 应用商店 | 免费好用的在线工具
  • XML Sitemap

来源链接:https://www.cnblogs.com/Amd794/p/18964762

© 版权声明
THE END
支持一下吧
点赞12 分享
评论 抢沙发
头像
请文明发言!
提交
头像

昵称

取消
昵称表情代码快捷回复

    暂无评论内容