Agen AI memanggil API Anda: 5 kesalahan autentikasi yang menyebabkan pintu belakang

Tambahkan penandatanganan permintaan HMAC

Selain autentikasi berbasis token, tandatangani setiap payload permintaan dengan HMAC-SHA256. API Anda memverifikasi tanda tangan sebelumnya memproses permintaan tersebut. Hal ini membuktikan bahwa muatan tidak dirusak dalam perjalanan dan menghubungkan setiap permintaan ke a rahasia agen tertentu.

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

Server API Anda menghitung ulang HMAC menggunakan salinan rahasia agen yang tersimpan. Jika hashnya cocok, maka permintaan itu asli. Jika tidak, tolak saja.

Otomatiskan rotasi rahasia

Rotasi manual tidak berskala ketika Anda menjalankan lusinan agen. Buat skrip rotasi yang menghasilkan skrip rotasi baru rahasia, menyebarkannya, memverifikasi konektivitas, lalu mencabut yang lama.

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

Kesalahan 4: melewatkan pencatatan permintaan untuk panggilan mesin-ke-mesin

48,9% organisasi tidak mengetahui lalu lintas mesin-ke-mesin. Mereka mencatat panggilan API manusia tetapi mengecualikan panggilan internal komunikasi layanan-ke-layanan dari tumpukan observabilitasnya. Agen AI termasuk dalam titik buta tersebut.

Ketika agen berperilaku buruk, mengirimkan banyak permintaan, mengakses titik akhir di luar cakupannya, atau mendapatkan dikompromikan, Anda perlu menjawab tiga pertanyaan: agen mana, kapan, dan apa yang disentuhnya? Tanpa permintaan logging, Anda tidak dapat menjawab satupun dari mereka.

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

Tangkap identitas agen, titik akhir, metode HTTP, kode status, dan durasi pada setiap permintaan. Kirim terstruktur log ke platform observasi Anda. Tetapkan peringatan untuk anomali: lonjakan tiba-tiba dalam volume permintaan, permintaan untuk titik akhir di luar cakupan agen, atau tingkat kesalahan yang meningkat.

Kesalahan 5: memperlakukan autentikasi agen sama dengan autentikasi manusia

Hanya 18% pemimpin keamanan yang yakin sistem IAM mereka dapat mengelola identitas agen. Baut 82% lainnya akses agen ke alur autentikasi manusia yang tidak dirancang untuk penelepon otonom.

Autentikasi manusia mengasumsikan seseorang membaca layar persetujuan OAuth, memasukkan kata sandi, dan merespons permintaan MFA. Agen tidak melakukan semua itu. Mereka memerlukan model autentikasi berbeda dengan tiga properti.

1. Token tercakup dengan izin eksplisit

Setiap token agen menyatakan titik akhir mana yang dapat dipanggil dan tindakan apa yang dapat dilakukan. API menerapkan hal tersebut cakupan pada setiap permintaan. Tidak ada ruang lingkup, tidak ada akses.

2. Batasan tarif per identitas

Pengguna manusia mengirimkan beberapa permintaan per menit. Seorang agen mengirim ratusan atau ribuan. Batas tarif per agen identitas mencegah satu agen membuat agen lain kelaparan dan membatasi radius ledakan jika agen menjadi nakal.

3. Minta atribusi pada setiap lapisan

Setiap permintaan membawa identitas agen dari edge proxy melalui lapisan aplikasi ke database log kueri. Ketika terjadi kesalahan, Anda menelusuri seluruh jalur dari agen ke tindakan.

Audit token agen dengan Botoi SDK

Gabungkan titik akhir JWT dan kata sandi ke dalam satu fungsi audit. Dekode token, periksa masa berlakunya, verifikasi tanda tangan, dan tandai cakupan yang terlalu luas.

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

Jalankan pemeriksaan ini sebagai langkah pra-penerapan. Jika token kedaluwarsa, memiliki TTL lebih dari 24 jam, gagal ditandatangani verifikasi, atau membawa cakupan wildcard, memblokir penerapan.

Daftar periksa untuk autentikasi API agen AI

Data surveinya jelas: tim menyebarkan agen AI lebih cepat daripada mengamankannya. 80,9% memiliki agen yang berjalan, namun kurang dari 1 dari 5 memberikan identitas mereka sendiri kepada agen tersebut. Setiap kesalahan dalam daftar ini, kunci bersama, cakupan luas, kredensial permanen, lalu lintas senyap, autentikasi berbentuk manusia, adalah pintu belakang yang menunggu deputi berikutnya yang kebingungan kejadian.

Pilih satu kesalahan dari daftar ini. Perbaiki minggu ini. Kemudian lanjutkan ke yang berikutnya.