Agentes de IA estão chamando sua API: 5 erros de autenticação que criam backdoors

Adicionar assinatura de solicitação HMAC

Além da autenticação baseada em token, assine cada carga de solicitação com HMAC-SHA256. Sua API verifica a assinatura antes processando a solicitação. Isso prova que a carga útil não foi adulterada em trânsito e vincula cada solicitação a um segredo do agente específico.

# 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"
  }
}

Seu servidor API recalcula o HMAC usando sua cópia armazenada do segredo do agente. Se os hashes corresponderem, o solicitação é autêntica. Se não o fizerem, rejeite-o.

Automatize a rotação secreta

A rotação manual não é dimensionada quando você executa dezenas de agentes. Construa um script de rotação que gere um novo secret, implanta-o, verifica a conectividade e depois revoga o antigo.

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();

Erro 4: ignorar o registro de solicitações para chamadas máquina a máquina

48,9% das organizações não percebem o tráfego máquina a máquina. Eles registram chamadas de API humanas, mas isentam comunicação serviço a serviço de sua pilha de observabilidade. Os agentes de IA caem nesse ponto cego.

Quando um agente se comporta mal, envia uma enxurrada de solicitações, acessa endpoints fora de seu escopo ou recebe comprometido, você precisa responder a três perguntas: qual agente, quando e o que ele tocou? Sem solicitação registrando, você não pode responder a nenhuma delas.

// 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();
});

Capture a identidade do agente, o endpoint, o método HTTP, o código de status e a duração de cada solicitação. Enviar estruturado registra em sua plataforma de observabilidade. Defina alertas para anomalias: picos repentinos no volume de solicitações, solicitações para endpoints fora do escopo do agente ou taxas de erro elevadas.

Erro 5: tratar a autenticação do agente da mesma forma que a autenticação humana

Apenas 18% dos líderes de segurança estão confiantes de que seus sistemas IAM podem gerenciar identidades de agentes. Os outros 82% do parafuso acesso do agente a fluxos de autenticação humana que não foram projetados para chamadores autônomos.

A autenticação humana pressupõe que uma pessoa lê uma tela de consentimento do OAuth, insere uma senha e responde a um prompt de MFA. Agentes não fazem nada disso. Eles precisam de um modelo de autenticação diferente com três propriedades.

1. Tokens com escopo definido e permissões explícitas

Cada token de agente declara quais endpoints ele pode chamar e quais ações pode executar. A API impõe aqueles escopos em cada solicitação. Sem escopo, sem acesso.

2. Limites de taxa por identidade

Um usuário humano envia algumas solicitações por minuto. Um agente envia centenas ou milhares. Limites de taxas por agente identidade evita que um agente deixe outros passarem fome e limita o raio de explosão se um agente se tornar desonesto.

3. Solicite atribuição em todas as camadas

Cada solicitação transporta a identidade do agente do proxy de borda através da camada de aplicação até o banco de dados registro de consulta. Quando algo dá errado, você traça todo o caminho desde o agente até a ação.

Audite um token de agente com o Botoi SDK

Combine os endpoints JWT e senha em uma única função de auditoria. Decodifique o token, verifique sua expiração, verifique a assinatura e sinalize escopos excessivamente amplos.

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);

Execute esta verificação como uma etapa de pré-implantação. Se o token expirou, tem um TTL superior a 24 horas, falha na assinatura verificação ou carrega escopos curinga, bloqueia a implantação.

Uma lista de verificação para autenticação de API do agente de IA

Os dados da pesquisa são claros: as equipes implantam agentes de IA mais rapidamente do que os protegem. 80,9% têm agentes em execução, mas menos de 1 em cada 5 dá a esses agentes a sua própria identidade. Cada erro nesta lista, chaves compartilhadas, escopos amplos, credenciais permanentes, tráfego silencioso, autenticação em forma humana, é uma porta dos fundos esperando pelo próximo deputado confuso incidente.

Escolha um erro desta lista. Corrija isso esta semana. Em seguida, passe para o próximo.