SuperAPI AI 工具集

superior-api-security

安全与审计

查看项目

更新于 10-23 18:16

技能介绍

用途

Superior API Security 是 kodekateam/superior-skills 下的一个安全技能,定位为服务端信任边界上的防御性安全工作:实现、加固或评审 REST API 的安全控制,同时保持 API 已文档化的契约不变。它明确反对按清单堆叠安全中间件,要求控制措施建立在真实的参与者、资源、业务影响、部署拓扑与既有安全架构之上。

主要能力

建立安全契约

在改动代码之前,技能要求先识别:暴露的操作、版本与消费方;公开、已认证、特权、内部、Webhook 与机器对机器等各类调用者;敏感资源、属性、操作与业务流;身份在何处建立、授权在何处执行;代理、网关、缓存、队列、第三方服务与出站网络访问;预期流量、突发行为、载荷大小、操作成本与容错能力;以及哪些安全控制已由基础设施承担。同时要求追踪实际生效的请求路径,不能仅凭网关、框架默认值或客户端检查就假定需求已被执行。

按风险选择控制

技能指向参考文档 references/api-security-controls.md,覆盖认证、对象/功能/属性授权、输入与输出边界、资源消耗、敏感业务流、SSRF、面向浏览器的控制、错误、密钥、清单与第三方 API 消费。优先级聚焦于阻止调用者:冒充其他身份或越权行事、读写他人对象、设置或接收无权访问的属性、调用特权操作或绕过工作流不变量、耗尽计算存储带宽付费集成或稀缺库存、使服务器访问非预期目的地、通过响应日志时序或元数据泄露内部信息。技能要求保留成熟的身份、密码学、模式校验与密钥管理库,不得自行发明令牌格式、签名方案、密码存储或加密协议。涉及会话、Bearer 令牌、刷新或重置凭据、API 密钥、签名 Webhook、密钥轮换、吊销与重放抵抗时,参考 references/session-token-and-webhook-security.md。

速率与滥用控制

当涉及限流、节流、配额、并发限制、凭据攻击、抓取、垃圾信息、枚举、高成本操作或敏感业务流自动化时,参考 references/rate-limiting-and-abuse-controls.md。一个有意义的限制需定义:被控制的操作与危害、用于计账的身份维度、持续额度、突发额度、并发与成本权重、计数器存放位置及分布式实例如何协调、限流器或计数存储故障时的行为、拒绝契约、可观测性、豁免与恢复路径,以及同时证明强制执行与合法突发容忍度的测试。技能指出,仅按 IP 计数对已认证或分布式滥用往往不足,请求速率也无法约束载荷大小、查询复杂度、批大小、执行时间、下游成本或并发工作。

响应与遥测安全

使用既定的 HTTP 语义与项目错误模式;应用层限流拒绝返回 429 Too Many Requests,并在已知有意义的重试时间时包含 Retry-After 头。向客户端提供稳定、可操作的错误标识,但不暴露堆栈、密钥、查询、内部主机名、令牌内容或授权策略细节。以请求或追踪关联、允许范围内的行为者与租户标识、控制决策与脱敏原因码记录安全相关结果;不得记录凭据、会话令牌、API 密钥、原始授权头、密码重置产物或不必要的敏感载荷。客户端可见细节与诊断细节需分离,并遵循仓库的隐私与留存规则。

验证与协作

参考 references/security-verification.md 获取威胁驱动的测试矩阵,包括负向授权、令牌校验、模式变更、资源限制、限流器行为、并发、SSRF、错误泄露与代理边界检查。安全完成需在实际执行点提供证据:运行最窄但有意义的自动化测试,加上覆盖部署路径的配置或集成检查;纯设计工作应标注为拟议验证计划而非保护证据。报告需说明在别处执行的控制、未验证的假设、发布风险与发布后监控需求。技能还规定了与其他技能的窄范围组合,例如整体代码评审用 superior-code-review、业务不变量变更用 superior-logic、租户模式相关用 superior-database;明确不得将安全评审扩大为未授权的渗透测试、基础设施变更或生产流量实验。

使用方式

该技能以技能文档形式提供,通过 https://www.skills.sh/kodekateam/superior-skills/superior-api-security 访问,正文中包含多份按主题拆分的参考文件路径,需结合具体任务按需查阅。具体调用或安装方式暂未提供。

适用场景

适用于 REST API 的认证与授权边界设计、输入输出校验、限流与滥用防护、SSRF 防护、错误与日志脱敏、会话令牌与 Webhook 安全等防御性安全工作,也适用于安全评审与验证计划制定。

限制

不用于未授权的渗透测试、基础设施改动或生产流量实验;不替代已有维护中的身份、密码学、模式校验与密钥管理库;未提供具体收费、平台支持范围与安装命令等信息。