Los agentes de IA están llamando a su API: 5 errores de autenticación que crean puertas traseras

Agregar firma de solicitud HMAC

Más allá de la autenticación basada en token, firme cada carga útil de solicitud con HMAC-SHA256. Tu API verifica la firma antes procesando la solicitud. Esto demuestra que la carga útil no fue manipulada en tránsito y vincula cada solicitud a un secreto de 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"
  }
}

Su servidor API vuelve a calcular el HMAC utilizando su copia almacenada del secreto del agente. Si los hashes coinciden, el La solicitud es auténtica. Si no lo hacen, rechácelo.

Automatizar la rotación secreta

La rotación manual no escala cuando se ejecutan docenas de agentes. Cree un script de rotación que genere un nuevo secreto, lo implementa, verifica la conectividad y luego revoca el anterior.

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

Error 4: omitir el registro de solicitudes para llamadas de máquina a máquina

El 48,9% de las organizaciones no ven el tráfico de máquina a máquina. Registran llamadas API humanas pero eximen las internas comunicación de servicio a servicio desde su pila de observabilidad. Los agentes de IA caen en ese punto ciego.

Cuando un agente se porta mal, envía una avalancha de solicitudes, accede a puntos finales fuera de su alcance o obtiene comprometido, debe responder tres preguntas: ¿qué agente, cuándo y qué tocó? Sin petición iniciando sesión, no puedes responder a ninguna de ellas.

// 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 la identidad del agente, el punto final, el método HTTP, el código de estado y la duración de cada solicitud. Enviar estructurado registros en su plataforma de observabilidad. Establezca alertas para anomalías: picos repentinos en el volumen de solicitudes, solicitudes de puntos finales fuera del alcance del agente o tasas de error elevadas.

Error 5: tratar la autenticación del agente de la misma manera que la autenticación humana

Sólo el 18 % de los líderes de seguridad confían en que sus sistemas IAM puedan gestionar las identidades de los agentes. El otro 82% se escapa acceso de agente a flujos de autenticación humana que no fueron diseñados para llamadores autónomos.

La autenticación humana supone que una persona lee una pantalla de consentimiento de OAuth, ingresa una contraseña y responde a un mensaje de MFA. Los agentes no hacen nada de eso. Necesitan un modelo de autenticación diferente con tres propiedades.

1. Tokens con alcance y permisos explícitos

Cada token de agente declara qué puntos finales puede llamar y qué acciones puede realizar. La API hace cumplir esas alcances en cada solicitud. Sin alcance, sin acceso.

2. Límites de la tasa por identidad

Un usuario humano envía algunas solicitudes por minuto. Un agente envía cientos o miles. Límites de tarifas por agente La identidad evita que un agente mate de hambre a otros y limita el radio de explosión si un agente se vuelve rebelde.

3. Solicite atribución en cada capa

Cada solicitud transporta la identidad del agente desde el proxy perimetral a través de la capa de aplicación hasta la base de datos. registro de consultas. Cuando algo sale mal, se traza el camino completo desde el agente hasta la acción.

Auditar un token de agente con el SDK de Botoi

Combine los puntos finales JWT y de contraseña en una única función de auditoría. Decodifica el token, comprueba su caducidad, verificar la firma y marcar ámbitos demasiado amplios.

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

Ejecute esta comprobación como paso previo a la implementación. Si el token ha caducado, tiene un TTL de más de 24 horas, falla la firma verificación, o lleva alcances comodín, bloquea la implementación.

Una lista de verificación para la autenticación de API del agente de IA

Los datos de la encuesta son claros: los equipos implementan agentes de IA más rápido de lo que los protegen. El 80,9% tiene agentes en funcionamiento, pero menos de 1 de cada 5 dan a esos agentes su propia identidad. Cada error en esta lista, claves compartidas, alcances amplios, credenciales permanentes, tráfico silencioso, autenticación con forma humana, es una puerta trasera que espera al próximo diputado confundido incidente.

Elija un error de esta lista. Arreglalo esta semana. Luego pasa al siguiente.