SuperAPI AI 工具集

litestar-security

安全与审计

查看项目

更新于 10-16 03:13

技能介绍

用途:当 Litestar 服务需要纵深防御式安全实现(不仅是认证接线)时使用本技能,把认证、授权、密钥处理、排除规则与失败行为一并审查。

主要能力:先划分公开、已认证、特权三类路由;在应用作用域一次性挂载所选认证机制;用守卫做授权与归属校验;用路由 opt 与 exclude_opt_key 精确控制端点包含与排除;用 NotAuthorizedException 表示身份失败、PermissionDeniedException 表示权限不足;用 SecretString/SecretBytes 存储密钥并在需要时以常量时间原语比较。

使用方式:保持认证与授权分离;用 litestar-requests 解析客户端输入,守卫内不手工重复解析头或 Cookie;仅在认证运行后从 request.user / request.auth 读取已认证上下文;优先使用内置安全后端而非自定义中间件;使守卫函数确定且无副作用;排除规则要窄、显式且被测试覆盖。

适用场景:需要统一审查 401 与 403 语义、守卫在 Litestar 各层叠加行为、公开路由排除审计、密钥不落入日志/错误响应的项目。

限制:资料未提供具体代码示例、安装命令、版本要求或性能数据;完整实现模式需查阅 references/security-patterns.md。相关主题可参考 Litestar 官方安全、安全后端、守卫、JWT 与密钥数据结构文档。