--- title: "دمج بيانات كاتو مع TrendAI" slug: "integrating-cato-data-with-trendai" updated: 2026-10-23T23:16:40Z published: 2026-10-23T23:16:40Z canonical: "knowledge.catonetworks.com/integrating-cato-data-with-trendai" --- > ## Documentation Index > Fetch the complete documentation index at: https://knowledge.catonetworks.com/llms.txt > Use this file to discover all available pages before exploring further. # دمج بيانات كاتو مع TrendAI > [!TIP] > **Important:** This integration is a preview and subject to change. The certification process is underway. ## إجمال استخدم تكامل TrendAI لتحليل بيانات الشبكة والأمان لـ Cato جنبًا إلى جنب مع بيانات الأمان الأخرى في TrendAI Vision One Agentic SIEM. يرسل التكامل الأصلي البيانات عبر HTTPS إلى مجمّع جمع أحداث TrendAI HTTP، بحيث يمكن لـ SOC إجراء بحث في سجلات كاتو واستخدامها في عمليات المراقبة والتحقيق. يمكنك إعداد التكامل في تطبيق إدارة كاتو (CMA). ترسل كاتو مصفوفات JSON مع `Content-Type: application/json` وتتم المصادقة باستخدام رمز المصرح به الذي تم إنشاؤه في TrendAI. ### مصادر بيانات TrendAI يمكنك اختيار **الأحداث**، **التدفقات**، أو كلاهما: - **الأحداث:** سجلات النشاط الشبكي والأمني، مثل تطابق السياسات، التهديدات، تغييرات الاتصال، ونشاط التدقيق. - **التدفقات:** سجلات تدفقات الشبكة التي تضيف سياق التطبيق والمستخدم وتفاصيل الجلسات المجمعة، مثل البايتات، الحزم، والمدة. تتضمن كل سجل حقل `data_source` مع القيمة `events` أو `flows`. يمكن أن تولد بيانات التدفق حجمًا أكبر بشكل ملحوظ من بيانات الأحداث، اعتمادًا على حركة المرور. ### المتطلبات السابقة - إذن المحرر لـ **التكاملات** في قسم **الموارد** من CMA. لمزيد من المعلومات، انظر إلى [إدارة أدوار المسؤول باستخدام RBAC](/v1/docs/managing-admin-roles-using-rbac). - مستأجر TrendAI Vision One مزود بـ Agentic SIEM وإذنًا لتكوين المستودعات وجامعي جمع أحداث HTTP. - الاعتمادات الكافية لـ Agentic SIEM لإدخال بيانات الجهات الخارجية والاحتفاظ المطلوب. - المتطلبات الأساسية الموصوفة في [البداية مع تكاملات الأحداث](/v1/docs/getting-started-with-event-integrations)، بما في ذلك أي قائمة تجاوز مطلوبة لعناوين IP. ## حالات استخدام تفترض هذه الأمثلة أن مصادر البيانات ذات الصلة تم إدخالها وأن الحقول المستخدمة لمقارنة السجلات تم تحليلها بشكل متسق. ### أحداث بدءًا من تنبيه نقطة نهاية TrendAI، ابحث عن أحداث كاتو في XDR Data Explorer للحصول على مضيف مطابق وعنوان IP ومعلومات الوقت لاستقصاء النشاط الشبكي ذي الصلة. ### التدفقات استعرض تدفقات كاتو حول تنبيه النقطة النهائية لتقييم الوجهات التي اتصل بها المضيف ومقدار البيانات التي تم نقلها. ## إنشاء تكامل TrendAI إنشاء مجمّع جمع أحداث HTTP في مستودع TrendAI، اختبر نقطة النهاية باستخدام curl، ثم استخدم عنوان URL للنقطة النهائية ورمز JWT لتكوين التكامل في CMA. ### الخطوة 1: إنشاء مجمع جمع أحداث HTTP في TrendAI **لتحضير وجهة TrendAI:** 1. قم بتسجيل الدخول إلى TrendAI Vision One وواصل إلى **Agentic SIEM & XDR > مصدر البيانات وإدارة السجلات > مستودعات السجلات الخاسمة**. 2. قم بإنشاء مستودع سجلات أو فتح واحد موجود. حدد إعدادات الاستيعاب والاحتفاظ التي تتطابق مع كيفية خطتك لاستخدام البيانات. لا يمكنك تغيير نوع استيعاب المستودع بعد إنشائه. يدعم الاستيعاب التحليلي التحليل، الارتباط، وصيد التهديدات؛ استيعاب الأرشفة مخصص للطلبات النادرة ومتطلبات الاحتفاظ. 3. في لوحة المستودع، افتح علامة التبويب **جامعي البيانات** واضغط على **إضافة جامع بيانات**. 4. اختر البائع والمنتج لبيانات Cato، واختر **JSON** كصيغة السجل، وحدد المنطقة الزمنية التي تستخدمها السجلات. 5. أدخل اسم الجامع والوصف. 6. حدد **جمع أحداث HTTP** كطريقة ونسخ عنوان URL لنقطة النهاية `/hec` المولدة للجامع. 7. انقر على **إضافة**. 8. على شاشة **توليد رمز JWT**، اختر فترة انتهاء الصلاحية واضغط على **توليد الرمز**. 9. انسخ الرمز، احفظه بأمان، واضغط على **إغلاق**. 10. في علامة التبويب **جامعي البيانات** الخاصة بالمستودع، تحقق من تفاصيل الجامع وعنوان URL لنقطة النهاية. ### الخطوة 2: الاختبار باستخدام curl قبل تكوين التكامل في CMA، أرسل طلب اختبار مباشرة إلى TrendAI. يساعد ذلك في عزل مشاكل نقطة النهاية والمصادقة من التكامل مع Cato. **لاختبار نقطة النهاية:** 1. استخدم عنوان URL لنقطة النهاية `/hec` المولدة بالكامل من الخطوة 1 مكان عنوان URL المثال. أدخل رمز JWT الخاص بالجامع في المطالبة الخفية. 2. قم بتحديث الطوابع الزمنية التجريبية إلى الوقت الحالي في UTC، ثم قم بتشغيل الأمر التالي: قم بتشغيل المثال بالكامل في واجهة **Bash** تفاعلية (قم بتشغيل `bash` أولاً إذا كان ذلك مطلوباً). أدخل أوراق الاعتماد في المطالبات الخفية؛ لا تقم بإدخالها في الأمر. يُعطل المثال تتبع الصدفة ويمرر رؤوس المصادقة عبر الإدخال القياسي باستخدام `--header @-`، مما يجعل أوراق الاعتماد خارج سجل الأوامر في الصدفة وخيارات سطر الأوامر في curl. يتم تجاهل المتغيرات المؤقتة للأوراق الاعتماد عند انتهاء المثال. ```bash (  ضبط +axv  ضبط -euo تجاوز الأنبوب  إلغاء ضبط CATO_TEST_TOKEN  IFS= اقرأ -r -s -p 'رمز JWT لـ TrendAI: ' CATO_TEST_TOKEN  builtin printf '\n' >&2  case "$CATO_TEST_TOKEN" in    ''|*$'\r'*) builtin printf 'أدخل اعتمادًا غير فارغ بدون عوائد انتقال.\n' >&2; exit 1 ;;  esac  builtin printf '%s\n' "Authorization: Bearer ${CATO_TEST_TOKEN}" | \    curl -q --fail --show-error --include --max-time 30 -X POST 'https:///ingest/api/v1/third_party_log/hec' \  --header @- \  -H "Content-Type: application/json" \  -d '[{"timestamp": "2026-04-07T10:00:03Z", "msg": "json log line 1"},{"timestamp": "2026-04-07T10:00:05Z", "msg": "json log line 2"}]' ) ``` 3. تحقق من رد HTTP لمعرفة إذا كان فيه خطأ. يعود الطلب الناجح بحالة HTTP 2xx. 4. في TrendAI، ابحث عن `سطر سجل json 1` و`سطر سجل json 2` في المستودع الهدف. أكد أن كلا السجلين يظهران بشكل منفصل. يقوم هذا الاختبار بالتحقق مما إذا كان الهدف يقبل الطلب التجريبي. تحقق من بيانات Cato والتحليل بعد تكوين التكامل أدناه. ### الخطوة 3: إنشاء التكامل في CMA **لإنشاء التكامل مع TrendAI:** 1. من قائمة التنقل CMA، اذهب إلى **الموارد > التكاملات**. 2. افتح علامة التبويب **التكاملات المكونة** واضغط على **جديد**. 3. حدد **TrendAI** و **قدرة تصدير البيانات**. 4. أدخل **اسم** و**وصف** اختياري. 5. بالنسبة ل**عنوان URL للاستيعاب**، قم بلصق عنوان URL الكامل لنقطة النهاية `/hec` التي تم إنشاؤها من جهاز تحصيل TrendAI. 6. بالنسبة ل**رمز الحامل**، قم بلصق رمز JWT الخاص بالمجمع. أدخل الرمز فقط؛ تقوم Cato بإضافة البادئة `Bearer`. 7. تحت **مصادر البيانات**، اختر **الأحداث**، **التدفقات**، أو كلاهما. 8. (اختياريًا) قم بتكوين عوامل تصفية الحدث والتدفق للتحكم في السجلات المرسلة. راجع [عوامل التصفية](/docs/ar/integrating-cato-data-with-trendai#filters). 9. انقر فوق **حفظ**. تقوم Cato بتخزين الرمز مشفرًا ولا تعرضه مرة أخرى. قم بتحديث التكامل عندما تقوم بتدوير رمز JWT. تقوم Cato بالمصادقة باستخدام رمز JWT باستخدام الترويسة `Authorization: Bearer <token>`. ### الخطوة 4: تحقق من الاستيعاب والتحليل **للتحقق من وصول بيانات Cato إلى TrendAI:** 1. في CMA، استعرض حالة التكامل. قم بتحديث الصفحة إذا لزم الأمر وتحقق من وجود أخطاء في المصادقة أو الوجهة. 2. في TrendAI، افتح المستودع واستعرض حالة المجمع ومعلومات الاستيعاب. 3. قم بتوليد حدث Cato حديث أو حركة مرور شبكية لكل مصدر بيانات محدد. 4. افتح **مستكشف بيانات XDR** وابحث عن سجلات Cato الحديثة باستخدام قيمة مميزة أو حقل `data_source`. اسمح لعدة دقائق للاستيعاب. 5. تحقق من ظهور السجلات بشكل فردي وأن طوابعها الزمنية والحقول المحللة تتطابق مع نشاط Cato. لكل مصدر محدد، أكد القيمة المقابلة لـ `events` أو `flows`. ## الفلاتر استخدم عوامل تصفية الأحداث والتدفق لتحديد بيانات Cato المصدرة إلى TrendAI. هذا يساعد في التحكم في حجم الاستيعاب وتركيز التحقيقات على النشاط ذو الصلة. تستخدم شروط التصفية داخل المجموعة منطق AND. تستخدم المجموعات المنفصلة منطق OR. - **مرشح الأحداث:** اضغط **إضافة مرشح** لتعريف شرط، أو **إضافة مجموعة** لإضافة مجموعة مرشحة أخرى. - **مرشح التدفقات:** متاح عند تحديد **التدفقات**. يستخدم نفس منطق التجميع مثل فلتر الحدث. يمكن للفلاتر التي تكون صارمة جدًا أن تستبعد كل السجلات دون الإبلاغ عن خطأ. إذا لم تصل البيانات، تحقق من مصادر البيانات المحددة وشروط التصفية. ## المعروف القيود - استخدام بيانات طرف ثالث للاستيعاب تستخدم أرصدة SIEM الوكيل. الاحتفاظ لما بعد الفترة الافتراضية يتطلب أرصدة إضافية. - لا يمكن تغيير نوع الاستيعاب للمستودع بعد الإنشاء. لاستخدام نوع استيعاب مختلف، قم بإنشاء مستودع آخر. - إذا انتهت صلاحية رمز JWT أو تم إلغاؤه، تتوقف الخدمة حتى تقوم بتحديث الرمز في CMA. - لا يمكنك تخصيص شكل جسم الطلب لتكامل Cato، نوع المحتوى أو ترويسة المصادقة. ## إصلاح المشاكل | المسألة | الحل | | --- | --- | | تفشل المصادقة مع HTTP 401 أو 403 | تأكد من أن رمز JSON المميز ينتمي إلى المجمع الوجهة ولم تنته صلاحيته أو يتم إلغاءه. إنشاء رمز بديل إذا لزم الأمر وتحديث **رمز Bearer** في CMA. | | الوجهة غير قابلة للوصول | انسخ عنوان URL الكامل لنقطة النهاية من تفاصيل جامع TrendAI، وتأكد من أن المجمع متاح في المستأجر الخاص بك. | | الوجهة تعيد HTTP 400 أو 415 | تأكد من أن نقطة النهاية هي عنوان URL `/hec` المُنتَج لهذا المجمع، والرمز المميز هو JWT صالح ولم تنتهِ صلاحيته، وجسم الطلب هو مصفوفة JSON. كاتو يرسل الجسم مع `نوع المحتوى: application/json`. | | يبدو أن التكامل صحي لكن لا يصل أي بيانات | راجع اختيار مصدر البيانات والفلاتر، وقم بإنشاء نشاط مطابقة كاتو، وتحقق من معلومات تجميع TrendAI وإعدادات المستودع. | | تصل الأحداث فقط أو التدفقات فقط | تأكد من أن المصادر اللازمة مختارة ومرشحاتها تسمح بتسجيلات المطابقة. تأكد من أن كل مصدر يتم إرساله إلى الوجهة المكونة له. | | تصل السجلات لكن الحقول لا تُفحص | استعرض البائع والمنتج واختيارات تنسيق السجل الخاصة بالجامع مقابل التكوين المستخدم في الخطوة 1. | ## الموارد الإضافية - [TrendAI: تجميع الحدث HTTP](https://docs.trendmicro.com/en-US/documentation/article/trend-vision-one-dslm-tlc-api) - [TrendAI: المستودعات](https://docs.trendmicro.com/en-US/documentation/article/trend-vision-one-log-repositories)