AI 代理正在调用您的 API：创建后门的 5 个身份验证错误

添加 HMAC 请求签名

除了基于令牌的身份验证之外，还使用 ​​HMAC-SHA256 对每个请求负载进行签名。 您的 API 之前会验证签名 处理请求。 这证明有效负载在传输过程中没有被篡改，并将每个请求与 具体代理秘密。

# Sign a request payload so your API can verify the sender
PAYLOAD='{"agent_id":"agent-refund-processor","action":"refund","order_id":"ORD-7291"}'

curl -s -X POST https://api.botoi.com/v1/hash/hmac \\
  -H "Content-Type: application/json" \\
  -d "{
    \\"text\\": \\"$PAYLOAD\\",
    \\"key\\": \\"kX9mT2vR8nL4wQ6jY3bA5cF7hD1gP0sE9uI2oK4lM6nB8xZ3vC5tR7yW0qJ1aG\\",
    \\"algorithm\\": \\"sha256\\"
  }"

{
  "success": true,
  "data": {
    "hmac": "a3f8c2d1e5b7094f6d2c8a1e3b5f7d9e4c6a8b0d2f4e6c8a0b2d4f6e8c0a2b4",
    "algorithm": "sha256"
  }
}

您的 API 服务器使用其存储的代理机密副本重新计算 HMAC。 如果哈希值匹配，则 请求是真实的。 如果他们不这样做，请拒绝它。

自动秘密轮换

当您运行数十个代理时，手动轮换无法扩展。 构建一个生成新的轮换脚本 秘密，部署它，验证连接，然后撤销旧的。

import Botoi from "@botoi/sdk";

const botoi = new Botoi({ apiKey: process.env.BOTOI_API_KEY });

async function rotateAgentSecret() {
  // Generate a new 64-character secret
  const { data } = await botoi.password.generate({
    length: 64,
    uppercase: true,
    lowercase: true,
    numbers: true,
    symbols: false,
  });

  console.log("New secret generated. Deploy to agent, then revoke the old one.");

  // Hash the new secret for storage (never store plaintext)
  const hashed = await botoi.hash.sha256({ input: data.password });
  console.log("Hashed for DB:", hashed.data.hash);

  return { secret: data.password, hash: hashed.data.hash };
}

rotateAgentSecret();

错误 4：跳过机器对机器调用的请求日志记录

48.9% 的组织对机器到机器的流量视而不见。 他们记录人类 API 调用，但免除内部调用 来自其可观察性堆栈的服务到服务通信。 人工智能代理就陷入了这个盲点。

当代理行为不当、发送大量请求、访问其范围之外的端点或获取 受到损害后，您需要回答三个问题：哪个特工、何时、以及接触了什么？ 无要求 记录，您无法回答其中任何一个。

// Express middleware: log every agent request
app.use("/v1/*", (req, res, next) => {
  const agentId = req.headers["x-agent-id"] || "unknown";
  const start = Date.now();

  res.on("finish", () => {
    const log = {
      timestamp: new Date().toISOString(),
      agent_id: agentId,
      method: req.method,
      path: req.path,
      status: res.statusCode,
      duration_ms: Date.now() - start,
      ip: req.ip,
      user_agent: req.headers["user-agent"],
    };
    console.log(JSON.stringify(log));
  });

  next();
});

捕获每个请求的代理身份、端点、HTTP 方法、状态代码和持续时间。 发送结构化 记录到您的可观察平台。 设置异常警报：请求量突然激增、请求 端点超出代理范围，或者错误率升高。

错误5：将代理身份验证视为与人类身份验证相同

只有 18% 的安全领导者相信他们的 IAM 系统可以管理代理身份。 其余82%螺栓 代理访问并非为自主呼叫者设计的人工身份验证流程。

人工身份验证假设用户阅读 OAuth 同意屏幕、输入密码并响应 MFA 提示。 代理不会做这些事。 他们需要具有三个属性的不同身份验证模型。

1.具有明确权限的范围令牌

每个代理令牌声明它可以调用哪些端点以及它可以执行哪些操作。 API 强制执行这些 每个请求的范围。 没有范围，就没有访问权限。

2. 每个身份的速率限制

人类用户每分钟发送几个请求。 代理人发送数百或数千。 每个代理的速率限制 身份可以防止一名特工让其他特工挨饿，并在特工失控时限制爆炸半径。

3. 在每一层请求归属

每个请求都携带代理身份，从边缘代理通过应用层到达数据库 查询日志。 当出现问题时，您可以追踪从代理到行动的完整路径。

Audit an agent token with the Botoi SDK

将 JWT 和密码端点合并到单个审核功能中。 解码令牌，检查其过期时间， 验证签名，并标记过于广泛的范围。

import Botoi from "@botoi/sdk";

const botoi = new Botoi({ apiKey: process.env.BOTOI_API_KEY });

async function auditAgentToken(token: string, secret: string) {
  // Step 1: Decode to inspect claims
  const decoded = await botoi.jwt.decode({ token });
  const claims = decoded.data.payload;

  console.log("Agent:", claims.sub);
  console.log("Scopes:", claims.scopes);

  // Step 2: Check expiration
  const now = Math.floor(Date.now() / 1000);
  const hoursLeft = (claims.exp - now) / 3600;

  if (hoursLeft < 0) {
    console.error("Token expired", Math.abs(hoursLeft).toFixed(1), "hours ago");
    return { valid: false, reason: "expired" };
  }

  if (hoursLeft > 24) {
    console.warn("Token lives longer than 24 hours; rotate sooner");
  }

  // Step 3: Verify signature
  const verified = await botoi.jwt.verify({ token, secret, algorithms: ["HS256"] });

  if (!verified.data.valid) {
    console.error("Signature verification failed");
    return { valid: false, reason: "invalid_signature" };
  }

  // Step 4: Check scope breadth
  const dangerousScopes = claims.scopes.filter(
    (s: string) => s === "*" || s === "admin" || s.endsWith(":*")
  );

  if (dangerousScopes.length > 0) {
    console.warn("Overly broad scopes:", dangerousScopes);
  }

  return { valid: true, agent: claims.sub, scopes: claims.scopes, hoursLeft };
}

const result = await auditAgentToken(process.env.AGENT_TOKEN!, process.env.SIGNING_SECRET!);
console.log(result);

运行此检查作为预部署步骤。 如果令牌已过期、TTL 超过 24 小时，则签名失败 验证，或携带通配符范围，阻止部署。

AI 代理 API 身份验证清单

调查数据很明确：团队部署人工智能代理的速度比保护人工智能代理的速度快。 80.9% 有代理在运行，但是 不到五分之一的人向这些特工提供自己的身份。 这个列表中的每一个错误，共享密钥，广泛的范围， 永久凭证、静默流量、人形身份验证，是等待下一个困惑的副手的后门 事件。

从这个列表中选出一个错误。 这周修复一下吧 然后移动到下一个。