يقوم وكلاء الذكاء الاصطناعي باستدعاء واجهة برمجة التطبيقات الخاصة بك: 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 باستخدام نسخته المخزنة من سر الوكيل. إذا تطابقت التجزئة، فإن الطلب حقيقي. إذا لم يفعلوا ذلك، رفض ذلك.

أتمتة التناوب السري

لا يتم تغيير حجم التدوير اليدوي عند تشغيل العشرات من الوكلاء. قم ببناء برنامج نصي للتناوب يقوم بإنشاء ملف جديد Secret، وينشره، ويتحقق من الاتصال، ثم يلغي القديم.

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

الخطأ الرابع: تخطي تسجيل الطلبات للمكالمات من جهاز إلى جهاز

48.9% من المؤسسات لا تستطيع رؤية حركة المرور من آلة إلى آلة. يقومون بتسجيل مكالمات واجهة برمجة التطبيقات البشرية ولكنهم يعفونها داخليًا الاتصالات من خدمة إلى خدمة من مكدس إمكانية المراقبة الخاصة بهم. يقع عملاء الذكاء الاصطناعي في تلك النقطة العمياء.

عندما يسيء وكيل التصرف، أو يرسل سيلًا من الطلبات، أو يصل إلى نقاط النهاية خارج نطاقه، أو يحصل على معلومات إذا تعرضت للخطر، فأنت بحاجة إلى الإجابة على ثلاثة أسئلة: أي وكيل، ومتى، وما الذي لمسه؟ بدون طلب التسجيل، لا يمكنك الإجابة على أي منهم.

// 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 ورمز الحالة والمدة في كل طلب. إرسال منظم سجلات إلى منصة المراقبة الخاصة بك. ضبط التنبيهات الخاصة بالحالات الشاذة: الارتفاع المفاجئ في حجم الطلب، والطلبات نقاط النهاية خارج نطاق الوكيل، أو ارتفاع معدلات الخطأ.

الخطأ الخامس: معاملة مصادقة الوكيل مثل المصادقة البشرية

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 يمنح هؤلاء العملاء هويتهم الخاصة. كل خطأ في هذه القائمة، المفاتيح المشتركة، النطاقات الواسعة، أوراق الاعتماد الدائمة، حركة المرور الصامتة، المصادقة على شكل الإنسان، هي باب خلفي في انتظار النائب المرتبك التالي حادثة.

اختر خطأ واحدا من هذه القائمة. إصلاحه هذا الأسبوع. ثم انتقل إلى التالي.