Агенты ИИ вызывают ваш 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. Запрашивайте атрибуцию на каждом уровне

Каждый запрос передает идентификатор агента от пограничного прокси-сервера через уровень приложения в базу данных. журнал запросов. Когда что-то идет не так, вы прослеживаете полный путь от агента к действию.

Аудит токена агента с помощью 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);

Запустите эту проверку как шаг перед развертыванием. Если срок действия токена истек, срок жизни токена превышает 24 часа, подпись не удалась. проверки или содержит области с подстановочными знаками, заблокируйте развертывание.

Контрольный список для аутентификации API агента AI

Данные опроса однозначны: команды развертывают агенты ИИ быстрее, чем обеспечивают их безопасность. У 80,9% агенты работают, но менее 1 из 5 присваивают этим агентам свою индивидуальность. Каждая ошибка в этом списке, общие ключи, широкие возможности, постоянные учетные данные, тихий трафик, аутентификация в форме человека, это бэкдор, ожидающий следующего сбитого с толку депутата инцидент.

Выберите одну ошибку из этого списка. Исправьте это на этой неделе. Затем переходите к следующему.