إجمال
يغطي دليلك هذا النطاق الكامل لقضايا أمان الذكاء الاصطناعي للتطبيقات في CMA، بما في ذلك عدم قيام الحراس بفحص أو اتخاذ إجراءات على حركة مرور الوكيل / LLM، وعدم قيام تكاملات بوابة الذكاء الاصطناعي بإرسال الأحداث، وفشل اتصالات الوكيل المُدار في الاتصال أو المزامنة، وعدم عمل قواعد سياسة الحراس كما هو متوقع.
تمتد المكونات المتأثرة لحراس أمان الذكاء الاصطناعي (الوكيل، API، و بوابة الذكاء الاصطناعي)، قواعد سياسة الحراس وملفات التعريف الخاصة بمحركها، تكاملات بوابة الذكاء الاصطناعي، تكاملات الوكيل المُدار والترخيص الأساسي لأمان الذكاء الاصطناعي للتطبيقات. عندما يفشل أي من هذه، يخسر العملاء القدرة على رؤية حركة مرور الوكيل / LLM ونشاط الوكيل المُدار، لا يمكن تنفيذ السياسة، ولا تتحقق أهداف الحوكمة والامتثال.
الأعراض
- يظهر الحارس صفر استدعاءات في CMA حتى عندما يكون التطبيق المتصل يرسل حركة المرور بنشاط
- تم تكوين قاعدة سياسة الحراس لكنها لا تتطابق أبداً أو تتطابق بشكل غير متسق عبر الطلبات المتشابهة
- تم مطابقة قاعدة حظر أو تعميم وحظر، ولكن يتم مراقبة الطلب فقط، أو لا يتم تطبيق أي إجراء بشكل مرئي
- تم تكوين تكامل بوابة الذكاء الصناعي (بورتكي، لايت LLM، أو كونغ) ولكن حركة المرور التي تمر عبر البوابة لا تظهر كأنها تمت فحصها في CMA
- يظهر تكامل الوكيل المدار على أنه مفصول، يفشل في اختبار اتصال، أو يفشل أثناء تثبيت نص الإعداد الخاص به/تكديس CloudFormation
- يظهر تكامل الوكيل المدار نشطًا ولكن لا تظهر أي تكوينات وكلاء أو جلسات وكلاء في CMA
الأسباب المحتملة
- انتهت صلاحية ترخيص الأمان لتطبيقات الذكاء الصناعي أو لم يتم تمكينه
- تم تعطيل تبديل تمكين سياسة الغارد العالمية في CMA
- تم إنشاء الغارد ولكن لا يتلقى حركة مرور بالفعل. لا يشير التطبيق، أو البوابة إلى نقطة نهاية الغارد (وضع بروكسي/API) أو لم يتم تضمين حاجز الحماية بوابة الذكاء الصناعي في تكوين البوابة.
- تم تعطيل قاعدة سياسة تفاعل الحراس، غير منشورة، أو تمت مراجعتها لنموذج محرك خاطئ، اتجاه خاطئ (مستخدم، مساعد، إدخال أداة، إخراج أداة) أو فعل خاطئ
- لم يتم تمكين إعداد خاص بمنصة مطلوب للرؤية للوكيل المدار
- لم يمر بعد زمن التأخير المتوقع لتحديث البيانات.
- لم يتم دعم نوع مزود LLM المتأثر، منصة الوكيل أو نوع البوابة من قبل تكامل الحاراس أو الوكيل المدار المعني
التقييم الأولي
اكمل هذه الفحوصات قبل مواجهة المزيد من صعوبات الاستكشاف معظم المشاكل تتعود إلى أحد هذه المتطلبات الأساسية
تحقق من ترخيص الأمان للذكاء الصناعي
تحقق من أن ترخيص الأمان للمستخدمين النهائيين للذكاء الصناعي (يشتمل على أمان الذكاء الصناعي للوكلاء) مُفعل ولم تنتهِ صلاحيته. انتقل إلى CMA > حساب > تراخيص > الأمان المتميز وتأكد من أن الترخيص موجود، نشط، وضمن فترة صلاحيته.
{height="" width=""}
إذا كان الترخيص غائبًا، معطلًا، أو انتهت صلاحيته، فإن ميزات الأمان للذكاء الصناعي لتطبيقات، بما في ذلك إنشاء الغارد، تنفيذ سياسة تفاعل الغارد، تكامل بوابة الذكاء الصناعي، وتكاملات الوكيل المُدار، لن تعمل بغض النظر عن التكوين. حل أي مشاكل ترخيص قبل متابعة الخطوات في هذا المستند
تحقق من تمكين سياسة الحراس
انتقل إلى CMA > أمان الذكاء الصناعي > سياسة الغارد وتأكد من أن تبديل تمكين سياسة الغارد مفعل. هذه خطوة بسيطة يمكن التغاضي عنها بسهولة، ولن يسري أي قاعدة ما دامت معطلة.
.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A01%3A31Z&se=2026-11-22T13%3A21%3A31Z&sr=b&sp=r&sig=ujhTy1oXL21GsZlN3D%2BglRmz1DBzg5nHlg7JDhEMD3Y%3D)
تحقق من نشر الحراس وتوجيه حركة المرور
الغارد يفحص فقط حركة المرور التي يتلقاها بالفعل. قبل الافتراض بوجود مشكلة سياسة أو كشف، تحقق من أن الغارد موجود بصورة صحيحة في مسار حركة المرور.
- انتقل إلى أمان الذكاء الصناعي > الحراس وتأكد من وجود الحارس المتأثر وتكوينه بالنوع الصحيح Proxy، API، أو بوابة الذكاء الصناعي للنشر المعني.
- قم بإنشاء حث للاستخدام من الوكيل المزروع. يجب أن يزداد عدد الاستدعاءات الموضح في "CMA" مع كل موجه. إذا لم تزداد الاستدعاءات، فهذا يشير إلى احتمال حدوث خطأ في إعدادات التطبيق.
.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A01%3A31Z&se=2026-11-22T13%3A21%3A31Z&sr=b&sp=r&sig=VWP7%2BcknIaN%2FPamnBSaTuY4o%2BLcmHSB7JlS6L%2BG5XBI%3D)
- افتح الحارس المتأثر وانتقل إلى علامة التبويب النشر. حسب نوع الحارس، يجب أن تكون القيم المحددة من هذه الفئة موجودة في إعدادات التطبيق:
- لكل أنواع الحراس، تأكد من أن مفتاح API المكون في التطبيق يتوافق مع مفتاح نشط غير ملغى يظهر في CMA. يمكنك تجديد مفتاح API في CMA إذا لزم الأمر، هذا يؤدي إلى إبطال المفتاح السابق لذا يجب تحديث التطبيق مباشرة بعد التجديد.
.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A01%3A31Z&se=2026-11-22T13%3A21%3A31Z&sr=b&sp=r&sig=n%2Fw76ld5nEsW0vyipGDBj0bbrWCm%2BDh4N2k0ajwz%2BQw%3D)
- للحراس الذين يستخدمون البروكسي و API، تأكد من أن التطبيق يشير إلى عنوان URL لنقطة النهاية الخاصة بالحارس عبر تحرير ملف إعدادات التطبيق (مثل، config.py) وإضافة GUARD_API_KEY و BASE_URL و MODEL_ID وعندما يكون الحارس نوع بروكسي ولم يتم توفير مفتاح LLM في CMA، LLM_PROVIDER_API_KEY.
- تأكد من أن جميع رؤوس الطلبات المطلوبة، خاصة التي عليها علامة النجمة (*) متضمنة في كود العميل الخاص بالتطبيق (مثل، client.py). لمزيد من المعلومات حول نشر الحراس، انظر مثال لتطبيق الحراس لتشات بوت{target=
_blank}. - للحارس AI Gateway، تأكد من إعداد التكامل المرتبط (Portkey، LiteLLM، أو Kong) لتوجيه حركة المرور عبر Cato. يجب إضافة مفتاح API الصادر من Cato والضمان إلى إعدادات بوابة الحراسة الخاصة بها (على سبيل المثال، config.yaml لـ LiteLLM).
- لكل أنواع الحراس، تأكد من أن مفتاح API المكون في التطبيق يتوافق مع مفتاح نشط غير ملغى يظهر في CMA. يمكنك تجديد مفتاح API في CMA إذا لزم الأمر، هذا يؤدي إلى إبطال المفتاح السابق لذا يجب تحديث التطبيق مباشرة بعد التجديد.
تحقق من اتصال التكامل مع الوكيل المدارة
تكاملات الوكيل المدارة هي اتصالات للقراءة فقط مع منصات وكيل الطرف الثالث وتستخدم نموذجًا مختلفًا عن الحراس. لا يوجد فحص لحركة المرور، فقط جرد واستقصاء الجلسات.
- انتقل إلى AI Security > Integrations > Managed Agent Platform وتأكد من أن التكامل المعني (Amazon Bedrock، Amazon Quick، Microsoft Foundry، Copilot Studio، أو Gemini Enterprise Agent Platform) يظهر حالة نشطة وكان التكامل مكتملًا بالكامل.
- لـ Amazon Bedrock أو Amazon Quick، تأكد من أن كومة CloudFormation قد تمت بنجاح في حساب AWS الصحيح (أو في حالة النشر المتعدد للحسابات، في حساب إدارة AWS Organizations) وأن جميع المتطلبات المسبقة لـ AWS الموثقة متوفرة.
- بالنسبة لـ Microsoft Foundry أو Copilot Studio، تأكد من إتمام كل خطوة إعداد بواسطة حامل الدور الصحيح وأن المتطلبات المسبقة الموثقة مستوفاة:
- قام مسؤول Entra ID (مسؤول التطبيق، المسؤول عن تطبيق السحاب، أو المسؤول العام) بمنح موافقة واسعة النطاق عبر الرابط المخصص لتكامل أمان الذكاء الاصطناعي لشبكات Cato.
- بالنسبة لـ Foundry، قام مالك الاشتراك أو مسؤول الوصول للمستخدم بتعيين دور مستخدم خدمات الإدراك لتطبيق Cato على كل اشتراك يحتوي على موارد Foundry.
- بالنسبة لـ Copilot Studio، قام مسؤول منصة الطاقة (أو المسؤول العام) بتسجيل تطبيق Cato كـ تطبيق إدارة باستخدام سكربت التسجيل في PowerShell في Azure Cloud Shell، وتمكين جلسات الوكيل لكل بيئة ذات صلة وغير مخصصة للمطورين.
- أدخل مسؤول Cato معرف مستأجر Microsoft Entra ID الصحيح في CMA ونقر بنجاح على اختبار الاتصال قبل الحفظ. معرف المستأجر غير المتطابق هو سبب شائع لأخفاقات اختبار الاتصال.
- بالنسبة إلى منصة Gemini Enterprise Agent، تأكد من تنفيذ سكربت إعداد Google Cloud في المشروع الصحيح لـ Google Cloud (قم بتشغيل
gcloud config set project PROJECT_IDإذا لزم الأمر)، وأن الهوية التي تقوم بتشغيل السكربت تمتلك صلاحية تمكين الـ API وإنشاء موارد الاتحاد هوية العمل IAM/Workload، وأن رمز التعريف لم ينتهي قبل تشغيل السكربت. إذا لم يكن من الممكن التحقق من الاتصال مباشرة بعد تشغيل السكربت بنجاح، فانتظر بضع دقائق لتطبيق تغييرات Google Cloud IAM قبل المحاولة مرة أخرى. - أكد توقيت تحديث البيانات المتوقع قبل الختام أن التكامل معطل:
- يتم جلب البيانات بواسطة Foundry وCopilot Studio عند الاتصال ثم يتم تحديثها كل ساعة
- تعتمد نشاط Bedrock AgentCore على تسليم AWS لتتبع CloudWatch، مما قد يستغرق وقتًا بعد الاستدعاء الأول للعميل.
استكشاف المشكلة وحلها
الخطوات لاستكشاف الأعطال التي قد يواجهها المسؤولون أو المستخدمون مذكورة أدناه. تهدف هذه الخطوات لتحديد الأسباب المحتملة للمشكلات التي تم مواجهتها.
استكشاف أخطاء الحارس الذي يظهر عدم وجود استدعاءات
هذا ينطبق عندما تُظهر صفحة الحراس (AI Security > Guards) عدم وجود استدعاءات في CMA.
- تأكد من صلاحية ترخيص AI Security للتطبيقات، وأنه تم توليد مطالبات المستخدم من التطبيق المتأثر.
- بالنسبة للحراس الوكلاء، تأكد من أن مزود الذكاء الاصطناعي مدعوم من Cato كما هو موثق في العمل مع حراس الأمن الذكاء الاصطناعي{target=
_blank}. - انتقل إلى Home > Events، وقم بتصفية نوع الحدث = AI Security وتأكد مما إذا كان يُولد أي أحداث ذات صلة بالحارس. إذا لم يصل أي منها، تأكد من أن الحارس يتم نشره إلى إعدادات التطبيق كما هو موضح في التحقق من نشر الحارس وتوجيه المرور.
.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A01%3A31Z&se=2026-11-22T13%3A21%3A31Z&sr=b&sp=r&sig=KV0iPzRHKobzVjFIX%2F1v83cw6jX8rLk8KvGTOacEEmk%3D)
- تحقق من إمكانية الوصول إلى API أمن الذكاء الاصطناعي عن طريق تشغيل curl -v https://api.aisec.catonetworks.com عبر CLI. ينبغي أن يُظهر المخرجات حل FQDN، ومصافحة TLS ناجحة، واستجابة HTTP (عادةً HTTP 404).
- لتأكيد أن حارس معين يمكن الوصول إليه ويستجيب، يمكنك تشغيل أمر curl باستخدام مثال الطلب (تضمين مفتاح حارس صالح) من AI Security > Guards > Deployment. ينبغي أن يتضمن الرد الناجح قاعدة سياسة الحارس المطابقة والإجراء الذي سيتم تطبيقه.
.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A01%3A31Z&se=2026-11-22T13%3A21%3A31Z&sr=b&sp=r&sig=qED8QmajxiOsZsbRQzlvn9S3UIQSC9Yrb2sBum7vx7E%3D)
- إذا تم تكوين الحارس بشكل صحيح على التطبيق، يمكن الوصول إلى الحارس عبر curl ولم يتم إنشاء أحداث CMA، فقم بالتصعيد إلى دعم Cato مع نوع الحارس/إعداداته (الوكيل، API، أو بوابة الذكاء الاصطناعي)، تفاصيل التطبيق وملفات التكوين (قم بحجب مفاتيح API)
استكشاف أخطاء عدم تأثير قواعد سياسة الحارس
هذا ينطبق عندما تُظهر صفحة الحراس استدعاءات، لكن قواعد سياسة الحراس لا تتخذ الإجراء المُكون.
- انتقل إلى AI Security > Guards Policy، وتأكد من أن Policy Enabled مفعل، وتم نشر القاعدة المتأثرة.
- تأكد من أن ملف المحرك المرفق بالقاعدة يشمل الكاشف المتوقع للقبض على المحتوى المعني. يمكنك استخدام ملعب المحرك{target=
_blank} للتحقق من أن محتوى المطالبة يُطلق الكاشف ضمن ملف المحرك قبل المزيد من استكشاف الأخطاء. - تأكد من أن الاتجاه الخاص بالقاعدة يتطابق مع المكان الذي يظهر فيه المحتوى بالفعل. لن يُقيم الكاشف الموجه نحو مخرجات الأداة مطالبة الاتجاه المستخدم، والعكس صحيح.
- تأكد من أن الإجراء المُكوّن على القاعدة هو الإجراء الذي يتم توقعه. سيتم تطبيق قاعدة مضبوطة على إخفاء & حظر أو إخفاء ومراقبة لإجراء بناءً على نوع المحتوى المُكتشف ضمن المطالبة، كما هو موضح في الإجراء غير المتوقع المطبق بواسطة السياسة{target=
_blank} . - إذا كانت قواعد متعددة يمكن أن تنطبق على نفس الحدث، تحقق من القاعدة التي تم تفعيلها فعليًا عن طريق مراجعة تفاصيل الحدث. تقييم القواعد يتم بشكل مستقل ولا يعتمد على الترتيب. عندما تتوافق أكثر من قاعدة، يتم تطبيق الإجراء الأكثر تشددًا. الإجراء الذي يتم على الحدث بشكل أقل تشددًا من المتوقع يعني عادةً أن نطاق القاعدة الأكثر تشددًا أو الملف الشخصي للمحرك أو الاتجاه لم يتوافق فعليًا مع ذلك الحدث.
- إذا كانت القاعدة قيد التشغيل ومُحددة النطاق بشكل صحيح وكان المحتوى يجب أن يتوافق، لكن الإجراء المتوقع لا يزال غير مطبق، صعد الأمر إلى دعم Cato مع معرف الحدث، لقطة شاشة للقاعدة (ملف تعريف المحرك، الاتجاه، الإجراء) والحارس أو الدمج الذي تم استلام الحركة من خلاله.
حل مشاكل تكوين الوكيل المفقود أو الجلسات
يتم تطبيق هذا عندما تكون تكوينات الوكيل المُدار المتوقعة أو جلسات الوكيل مفقودة أو غير مكتملة في CMA.
- تأكد من أن الدمج ذاته يظهر كأنه نشط، راجع التحقق من اتصال الدمج مع الوكيل المدار قبل معالجة فقدان البيانات داخله.
- اسمح بتكرار التحديث المعتادة للمنصة: دورة واحدة على الأقل كل ساعة لـ Microsoft Foundry وCopilot Studio، وحتى الوقت اللازم لـ AWS لتوليد وتوصيل آثار CloudWatch لـ Bedrock AgentCore.
- تحقق من أن Cato يدعم رؤية جلسات الوكلاء في CMA للتطبيق المُدار المتأثر، كما هو موثق في العمل مع الوكلاء المدارة{target=
_blank} . - بالنسبة لـ Amazon Bedrock AgentCore، تأكد من تمكين البحث في تعاملات CloudWatch (وحدة تحكم AWS > إشارات التطبيقات (APM) > البحث في المعاملات، مع ابتلاع الانتشار كملفات منظمة). بدون هذا، يمكن أن تعرض Cato وكلاء AgentCore في المخزون ولكنه لا يُظهر نشاطهم أبدًا.
- بالنسبة لـ Copilot Studio، تأكد من تمكين جلسات الوكلاء للبيئة المحددة التي ينتمي إليها الوكيل المفقود (مركز إدارة منصة الطاقة > إدارة > البيئات > [البيئة] > الإعدادات > المنتج > الميزات > الوكلاء في Copilot Studio)، وتأكد من أن البيئة ليست بيئة مطور غير مدعومة لهذا الإعداد.
- بالنسبة لـ Microsoft Foundry، تحقق من أن الاشتراك المحدد الذي يحتوي على المورد المفقود في Foundry لديه دور مستخدم خدمات الإدراك مُعَين إلى تطبيق Cato. لا يتم تطبيق تعيين الأدوار على مستوى المستأجر ويجب تكراره لكل اشتراك.
- بالنسبة لمنصة Gemini Enterprise Agent، تحقق من التوقعات: يتم عرض جلسات الوكلاء و أحداث الجلسة فقط؛ لا يتم جمع أداة الاستخدام والدمج والخدمات الخارجية داخل جلسة حسب التصميم.
- إذا انقضت فترة التحديث المحددة وتم تأكيد إعدادات التتبع / الأدوار / الجلسة الخاصة بالمنصة وكانت جميعها صحيحة، صعد الأمر إلى دعم Cato مع نوع الدمج والاشتراك المحدد / البيئة / المشروع المتأثر، والبيانات المتوقع مقابل البيانات الفعلية المُلاحظة.
تصعيد الحالات إلى دعم كاتو
قبل رفع قضية مع دعم Cato، تأكد من إتمام جميع خطوات استكشاف المشاكل ذات الصلة المدرجة في هذا الدليل. إذا ظلت المشكلة دون حل، قم بتصعيدها إلى دعم Cato مع المعلومات التالية:
- وصف المشكلة — وصف واضح وموجز للعرض الملحوظ والسلوك المتوقع
- المكون المتأثر — اسم الحارس والنوع (Proxy، API، أو بوابة AI) الدمج بوابة AI (Portkey، LiteLLM، أو Kong) أو الدمج الوكيل المُدار (Amazon Bedrock، Amazon Quick، Microsoft Foundry، Copilot Studio، أو منصة وكيل المشاريع Gemini)
- تفاصيل البيئة — للحراس: تفاصيل التطبيق وملفات التكوين (حذف مفاتيح API). لدمج الوكلاء المدارة: تأكد من تصميم الشروط المسبقة وتقديم أي أخطاء في التكوين مُلاحظة.
- تفاصيل الاتصال/السياسة — أسماء قوانين سياسة الحراس، ملف تعريف المحرك، الاتجاه والإجراء أو خطوة إعداد الدمج الأخيرة المُنجزة ونتيجتها.
- خطوات استكشاف الأخطاء التي تم إكمالها — ملخص للخطوات المتخذة بالفعل من هذا الدليل ونتائج كل منها
- الأدلة الداعمة — روابط لأحداث أمنية الذكاء الاصطناعي، لقطات شاشة لقواعد التكوين أو تكامل الإعدادات، حالة كومة CloudFormation أو رسائل خطأ اختبار الاتصال، والطوابع الزمنية الدقيقة (حسب توقيت UTC والمنطقة الزمنية للعميل).
كلما زادت المعلومات والسياق المقدم مسبقًا، كان دعم Cato قادرًا على التحقيق وحل المشكلة بسرعة أكبر.