KI-Agenten rufen Ihre API auf: 5 Authentifizierungsfehler, die Hintertüren schaffen

HMAC-Anfragesignierung hinzufügen

Signieren Sie über die tokenbasierte Authentifizierung hinaus jede Anforderungsnutzlast mit HMAC-SHA256. Ihre API überprüft zuvor die Signatur Bearbeitung der Anfrage. Dies beweist, dass die Nutzlast während des Transports nicht manipuliert wurde und verknüpft jede Anfrage mit einem spezifisches Agentengeheimnis.

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

Ihr API-Server berechnet den HMAC anhand seiner gespeicherten Kopie des Geheimnisses des Agenten neu. Wenn die Hashes übereinstimmen, wird der Anfrage ist authentisch. Wenn nicht, lehnen Sie es ab.

Automatisieren Sie die Secret-Rotation

Die manuelle Rotation lässt sich nicht skalieren, wenn Sie Dutzende Agenten ausführen. Erstellen Sie ein Rotationsskript, das ein neues generiert Secret, stellt es bereit, überprüft die Konnektivität und widerruft dann das alte.

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

Fehler 4: Überspringen der Anforderungsprotokollierung für Maschine-zu-Maschine-Aufrufe

48,9 % der Unternehmen sind blind für den Maschine-zu-Maschine-Verkehr. Sie protokollieren menschliche API-Aufrufe, nehmen jedoch interne Aufrufe aus Service-zu-Service-Kommunikation aus ihrem Observability-Stack. KI-Agenten geraten in diesen blinden Fleck.

Wenn sich ein Agent schlecht verhält, sendet er eine Flut von Anfragen, greift auf Endpunkte außerhalb seines Geltungsbereichs zu oder greift auf Endpunkte zu kompromittiert, müssen Sie drei Fragen beantworten: Welcher Agent hat wann und was berührt? Ohne Anfrage Protokollierung, Sie können keine davon beantworten.

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

Erfassen Sie bei jeder Anfrage die Identität des Agenten, den Endpunkt, die HTTP-Methode, den Statuscode und die Dauer. Strukturiert versenden Protokolle auf Ihrer Observability-Plattform. Legen Sie Benachrichtigungen für Anomalien fest: plötzliche Spitzen im Anfragevolumen, Anfragen an Endpunkte außerhalb des Agentenbereichs oder erhöhte Fehlerraten.

Fehler 5: Agenten-Authentifizierung genauso behandeln wie menschliche Authentifizierung

Nur 18 % der Sicherheitsverantwortlichen sind zuversichtlich, dass ihre IAM-Systeme Agentenidentitäten verwalten können. Die anderen 82 % Bolzen Agentenzugriff auf menschliche Authentifizierungsflüsse, die nicht für autonome Anrufer konzipiert sind.

Bei der menschlichen Authentifizierung wird davon ausgegangen, dass eine Person einen OAuth-Zustimmungsbildschirm liest, ein Passwort eingibt und auf eine MFA-Eingabeaufforderung antwortet. Agenten tun nichts davon. Sie benötigen ein anderes Authentifizierungsmodell mit drei Eigenschaften.

1. Bereichsbezogene Token mit expliziten Berechtigungen

Jeder Agent-Token gibt an, welche Endpunkte er aufrufen und welche Aktionen er ausführen kann. Die API erzwingt diese Umfänge auf jede Anfrage. Kein Geltungsbereich, kein Zugriff.

2. Ratenbegrenzungen pro Identität

Ein menschlicher Benutzer sendet einige Anfragen pro Minute. Ein Agent sendet Hunderte oder Tausende. Tariflimits pro Agent Identität verhindern, dass ein Agent andere aushungert, und begrenzen den Explosionsradius, wenn ein Agent abtrünnig wird.

3. Fordern Sie auf jeder Ebene eine Namensnennung an

Jede Anfrage überträgt die Agentenidentität vom Edge-Proxy über die Anwendungsschicht zur Datenbank Abfrageprotokoll. Wenn etwas schief geht, können Sie den gesamten Weg vom Agenten bis zur Aktion verfolgen.

Prüfen Sie ein Agent-Token mit dem Botoi SDK

Kombinieren Sie die JWT- und Passwort-Endpunkte in einer einzigen Prüffunktion. Entschlüsseln Sie den Token, überprüfen Sie seinen Ablauf, Überprüfen Sie die Signatur und kennzeichnen Sie zu breite Bereiche.

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

Führen Sie diese Prüfung als Schritt vor der Bereitstellung aus. Wenn das Token abgelaufen ist, eine TTL von mehr als 24 Stunden hat, schlägt die Signatur fehl Wenn eine Überprüfung erfolgt oder Platzhalterbereiche vorhanden sind, wird die Bereitstellung blockiert.

Eine Checkliste für die AI-Agent-API-Authentifizierung

Die Umfragedaten sind eindeutig: Teams setzen KI-Agenten schneller ein, als sie sie sichern. 80,9 % haben Agenten im Einsatz, aber Weniger als jeder Fünfte gibt diesen Agenten eine eigene Identität. Jeder Fehler auf dieser Liste, gemeinsame Schlüssel, weite Bereiche, Permanente Anmeldeinformationen, stiller Datenverkehr, Authentifizierung in menschlicher Form – das ist eine Hintertür, die auf den nächsten verwirrten Stellvertreter wartet Vorfall.

Wählen Sie einen Fehler aus dieser Liste aus. Repariere es diese Woche. Fahren Sie dann mit dem nächsten fort.