Aduana Digital de Defensa Argentina
创建 ADDA 访问权限
← ADDA 手册

api-shield/1.0.0 · 更新于 2026年7月9日

API 保护

在不失去可见性的前提下管理速率限制、信誉和集成路由。

API Shield 保护集成路由、自动化和程序化调用，并采用不同于人工表单的评估方式。

重点不只是阻止异常 request：还要避免破坏有效集成，区分机构流量与 scraping，并在限制影响重要服务时保留 Evidence。

将 API Shield 与 Access、WAF 和 Secrets 交叉核验，有助于处理风险不在单个 request，而在凭证、隧道或来源安全态势中的情况。

检查清单

  • • 识别关键集成路由。
  • • 检查来源是否使用已知凭证、隧道或会话。
  • • 如果措施改变服务连续性，请用 Evidence 支撑决策。

快速开始

  1. 1. 从集成路由入手，而不只关注孤立的 request。
  2. 2. 检查 API 是否关联 Secrets、Access 或有效凭证。
  3. 3. 当调整需要其他团队协作时使用 tasks。

运维流程

建立上下文

研读路由、来源和预期的服务连续性。

避免盲目阻止具有下游依赖的 API。

关联信号

将信号与 Secrets、Access 或 keyring 交叉核验，以判断信任是否发生变化。

确认问题来自流量、身份还是凭证。

协商响应

当缓解措施涉及多个团队时，创建 task 或 incident。

维持对敏感变更的治理。

flowchart LR
  S1["建立上下文"]
  S2["关联信号"]
  S3["协商响应"]
  S1 --> S2
  S2 --> S3

验证器与检查

针对当前界面执行上下文分析，并返回以运维为重点的建议步骤。

验证 API 保护

为集成或自动化路由返回 checks 和文章。

示例

用于审查暴露 API 的 payload

{
  "moduleKey": "api-shield",
  "query": "token reuse scraping",
  "domain": "api.capacero.ar"
}

链接与参考

APIs

  • /api/adda/v1/shields/events
  • /api/adda/v1/secrets/status
  • /api/adda/v1/access/status

Docs 与支持路由

  • docs/ADDA_API.md
  • docs/ADDA_WAF.md

常见问题

  • • 将程序化流量当作人工浏览会扰乱响应。
  • • 调整防御而不检查 Secrets 或 Access，可能让风险根因继续存在。

建议操作

  • • 始终将信号与相关凭证、会话或隧道交叉核验。
  • • 如果 API 支撑关键流程，应先采用限制和可追溯性，再考虑突然阻止。

实用 Reason Codes

Score 字典

wafRiskScore

在所观察路由或表单上检测到的风险。

decision

已决定的操作：允许、验证、限制或阻止。

matchedRules

用于解释保护为何被触发的规则。

协议说明

  • • 服务连续性与遏制滥用同等重要。

文章历史

2026年7月9日

新增了聚焦连续性、凭证和协作的 API Shield 文章。