Important: This integration is a preview and subject to change. The certification process is underway.
إجمال
استخدم تكامل Google SecOps لتحليل بيانات الشبكة والأمان الخاصة بالكاتو جنبًا إلى جنب مع قياسات الأمان الأخرى في عمليات الأمان الخاصة بجوجل (Google SecOps، والمعروفة سابقًا بـ Chronicle). يدفع التكامل الأصلي البيانات مباشرة إلى تدفق تسجيل Google SecOps عبر ويب هوك HTTPS للمراقبة والتحقيق.
تقوم بتكوين التكامل في تطبيق إدارة الكاتو (CMA). ترسل كاتو JSON المحسوبة بواسطة سطر جديد، مع سجل واحد لكل سطر، وتوثق باستخدام مفتاح API الخاص بالكلاود Google والمفتاح السري لوك ويب هوك.
هذا التكامل منفصل عن تكامل Google Chronicle الذي يسترجع البيانات عبر واجهة برمجة التطبيقات الأحداث الخاصة بشبكات كاتو.
مصادر بيانات Google SecOps
يمكنك اختيار الأحداث، التدفقات، أو كلاهما:
الأحداث: سجلات نشاط الشبكة والأمان، مثل تطابق السياسات والتهديدات وتغييرات الاتصال ونشاط التدقيق.
التدفقات: سجلات تدفق الشبكة التي تضيف سياق التطبيق والمستخدم وتفاصيل الجلسات المجمعة، مثل البايتات والحزم والمدّة.
يتضمن كل سجل حقل data_source بالقيم events أو flows. يمكن لبيانات التدفق توليد حجم أكبر بكثير من بيانات الأحداث، بناءً على حركة المرور لديك.
المتطلبات السابقة
إذن المحرر لـ التكاملات في قسم الموارد في CMA. لمزيد من المعلومات، انظر إلى إدارة أدوار المسؤول باستخدام RBAC.
مثيل Google SecOps مرتبط بمشروع Google Cloud، مع تمكين API Chronicle.
الإذن لإنشاء تدفق تسجيل ويب هوك في Google SecOps ومفتاح API في مشروع Google Cloud المرتبط.
المتطلبات المسبقة كما هو موضح في البداية مع تكاملات الأحداث، بما في ذلك القوائم البيضاء لـ IP المطلوبة.
حالات استخدام
تفترض هذه الأمثلة أن مصادر البيانات ذات الصلة يتم استيعابها وتفسير الحقول المستخدمة في الارتباط بين السجلات بشكل مستمر.
أحداث
بعد التحقق من خرائط UDM، قوم بإعداد قاعدة YARA-L التي تربط تسجيل الدخول المشبوه بحدث تهديد كاتو للمستخدم نفسه في نافذة زمنية محددة.
التدفقات
استخدم عمليات البحث الإحصائية لتحديد التحويلات الصادرة الكبيرة بشكل غير عادي، ثم فحص أحداث كاتو المرتبطة لمعرفة سياق السياسة أو التهديد.
إنشاء تكامل Google SecOps
قم بإنشاء تدفق تسجيل ويب هوك ومفتاح API Google Cloud، واختبر النقطة النهائية بواسطة curl، ثم أدخل عنوان URL الخاص بالتدفق وبيانات الاعتماد في CMA.
الخطوة 1: إنشاء تدفق تسجيل ويب هوك HTTPS في Google SecOps
لإنشاء تدفق تسجيل ويب هوك:
تسجيل الدخول إلى Google SecOps والانتقال إلى الإعدادات > التدفقات.
اضغط إضافة جديد وأدخل اسم تدفق التغذية، مثل
Cato Networks.بالنسبة لـ نوع المصدر، اختر ويب هوك.
اختر نوع السجل لسجلات الكاتو.
انقر التالي.
ضبط محدد انقسام إلى
\nبحيث يلتقط Google SecOps كل سجل JSON مفصول في كل سطر كمدخل سجل منفصل.(اختياريًا) قم بتكوين مساحة أسماء الأصول وتسميات الاكتشاف.
انقر التالي، مراجعة تكوين الخلاصة، ثم انقر إرسال.
انقر توليد مفتاح سري. انسخ المفتاح واحفظه بأمان قبل مغادرة الشاشة. Google لا يعرضها مرة أخرى.
في علامة التبويب التفاصيل، انسخ عنوان URL لنقطة النهاية من معلومات النقطة النهائية. استخدم عنوان URL الكامل، بما في ذلك لاحقة
:importPushLogs.تأكد من تمكين الخلاصة.
توليد مفتاح سري آخر يلغي المفتاح السابق. إذا قمت بتدوير السر بعد تكوين Cato، حدّث مفتاح الوصول إلى Webhook في CMA فوراً لتجنب انقطاع التسليم.
الخطوة 2: إنشاء مفتاح API لسحابة Google
لإنشاء مفتاح API:
في وحدة التحكم لسحابة Google، اختر المشروع المرتبط بحساب Google SecOps الخاص بك.
اذهب إلى واجهات برمجة التطبيقات والخدمات > أوراق الاعتماد.
انقر إنشاء أوراق اعتماد > مفتاح API.
قيد المفتاح على واجهة برمجة التطبيقات لـ "كرونيكل" واحفظ القيد.
انسخ مفتاح API وخزنه بأمان.
يمكنك أيضًا استخدام مفتاح API موجود مقيد بواجهة برمجة التطبيقات لـ "كرونيكل" للمشروع المرتبط.
الخطوة 3: اختبار نقطة النهاية باستخدام curl
قبل تكوين الدمج في CMA، أرسل طلب اختبار مباشرةً إلى Google SecOps. يساعد ذلك في عزل مشاكل نقطة النهاية والاعتماد من تكامل Cato.
لاختبار نقطة النهاية:
استبدل
ENDPOINT_URLبعنوان URL الكامل لنقطة النهاية من الخطوة 1. عند الطلب، أدخل مفتاح API لسحابة Google من الخطوة 2 والمفتاح السري للخلاصة من الخطوة 1.تحديث الطوابع الزمنية النموذجية إلى الوقت الحالي بتوقيت UTC، ثم تشغيل الأمر التالي. احتفظ بكل كائن JSON في سطر منفصل؛ يرسل الأمر كلا السجلين في طلب واحد:
شغل المثال بالكامل في غلاف Bash تفاعلي (شغّل
bashأولاً إذا لزم الأمر). أدخل الأوراق الاعتمادية عند المطالبات المخفية؛ لا تقم بإدخالها في الأمر. يعطل المثال تتبع غلاف ويستخدم رؤوس اعتماد المرور من خلال الإدخال القياسي باستخدام--header @-، للحفاظ على السرية خارج تاريخ الغلاف وحجج سطر الأوامر curl. تُتلف متغيرات الاعتماد المؤقتة عند انتهاء المثال.( set +axv set -euo pipefail unset CATO_TEST_API_KEY CATO_TEST_WEBHOOK_SECRET IFS= read -r -s -p 'مفتاح API لسحابة Google: ' CATO_TEST_API_KEY builtin printf '\n' >&2 case "$CATO_TEST_API_KEY" in ''|*$'\r'*) builtin printf 'أدخل اعتماد غير فارغ بدون إعادة تشغيل\n' >&2; exit 1 ;; esac IFS= read -r -s -p 'مفتاح سري ل Webhook: ' CATO_TEST_WEBHOOK_SECRET builtin printf '\n' >&2 case "$CATO_TEST_WEBHOOK_SECRET" in ''|*$'\r'*) builtin printf 'أدخل اعتماد غير فارغ بدون إعادة تشغيل\n' >&2; exit 1 ;; esac builtin printf '%s\n' "X-goog-api-key: ${CATO_TEST_API_KEY}" "X-Webhook-Access-Key: ${CATO_TEST_WEBHOOK_SECRET}" | \ curl -q --fail --show-error --include --max-time 30 -X POST "ENDPOINT_URL" \ --header @- \ -H "Content-Type: application/json" \ --data-binary '{"message":"حدث اختبار من Cato 1","timestamp":"2026-07-14T12:00:00Z"} {"message":"حدث اختبار من Cato 2","timestamp":"2026-07-14T12:00:01Z"}' )تحقق من استجابة HTTP للخطأ. يرجع الطلب الناجح حالة HTTP 2xx.
في Google SecOps، ابحث في السجلات الأولية الأخيرة عن
test event from Cato 1وtest event from Cato 2. اسمح لبضع دقائق لعملية الإدخال، ثم تأكد من ظهورها كمدخلات سجلات منفصلة. إذا ظهرت السجلات معاً في مدخل سجل واحد، تحقق أن الفاصل Split delimiter مضبوط على\n. هذا النموذج يتحقق من الاتصال وتقسيم السجلات؛ لا يتم التحقق من جميع تعيينات المحلل لأحداث وتدفقات Cato.
هذا الاختبار يتحقق مما إذا كانت الوجهة تقبل طلب النموذج وتفصله إلى مدخلات سجل فردية. تحقق من بيانات Cato والتفسير بعد تكوين الدمج أدناه.
الخطوة 4: إنشاء التكامل في CMA
لإنشاء تكامل Google SecOps:
من قائمة التنقل في CMA، اذهب إلى الموارد > التكاملات.
افتح علامة تبويب التكاملات المكونة وانقر على جديد.
حدد Google SecOps والقدرة على تصدير البيانات.
أدخل اسم ووصف اختياري.
لعنوان URL خاص بـ Webhook، قم بلصق عنوان URL لنقطة النهاية الكاملة من الخطوة 1.
لمفتاح واجهة برمجة تطبيقات Google Cloud، قم بلصق المفتاح المقيد بواجهة برمجة التطبيقات لـ Chronicle.
لمفتاح الوصول إلى Webhook، قم بلصق المفتاح السري للبيانات.
تحت مصادر البيانات، اختر الأحداث، التدفقات، أو كلاهما.
(اختياري) قم بتكوين عوامل التصفية للأحداث والتدفقات للتحكم في السجلات المرسلة. راجع الفلاتر.
انقر حفظ.
تحتفظ Cato بمفاتيح البيانات مشفرة ولا تعرضها مجدداً. عند تحرير الدمج، اترك المفتاح دون تغيير للحفاظ على قيمته المخزنة، أو قم بإدخال استبدال.
تقوم Cato تلقائيًا بضبط رؤوس X-goog-api-key, X-Webhook-Access-Key, وContent-Type: application/json. لا تحتاج إلى تكوين الرؤوس.
الخطوة 5: تحقق من الإدخال والمقارنة
للتحقق من وصول بيانات Cato إلى Google SecOps:
في CMA، راجع حالة الدمج. قم بتحديث الصفحة إذا لزم الأمر وتحقق من الأخطاء في المصادقة أو الوجهة.
في Google SecOps، اذهب إلى الإعدادات > التغذيات، وافتح تغذية Cato، وراجع حالتها وآخر وقت إدخال.
قم بتوليد حدث Cato حديث أو حركة المرور الشبكية لكل مصدر بيانات محدد.
ابحث في السجلات الأولية الأخيرة باستخدام ملصق إدخال مُكوّن على التغذية أو قيمة سجل Cato مميزة. يمكنك أيضاً البحث عن حقل
data_sourceبالقيمeventsأوflows. اسمح لبضع دقائق للإدخال.تحقق من أن السجلات الفردية مُفصلة وأن الطوابع الزمنية والحقل المتطابق يتوافق مع نشاط Cato.
الفلاتر
استخدم عوامل التصفية للأحداث والتدفق للحد من البيانات الصادرة من كاتو والمصدرة إلى Google SecOps. يساعد هذا في التحكم في حجم التعقب والتركيز على الأنشطة ذات الصلة.
تستخدم شروط التصفية داخل المجموعة منطق AND. تستخدم المجموعات المنفصلة منطق OR.
تصفية الأحداث – انقر إضافة عامل تصفية لتحديد شرط أو إضافة مجموعة لإضافة مجموعة تصفية أخرى.
تصفية التدفقات – متاح عند اختيار تدفقات. يستخدم نفس منطق التصنيف مثل مرشح الأحداث.
يمكن لعوامل التصفية المقيِّدة جداً استبعاد جميع السجلات دون الإبلاغ عن خطأ. إذا لم تصل أي بيانات، تحقق من مصادر البيانات المختارة وشروط التصفية.
المعروف القيود
يدعم Google SecOps حجم طلب ويبهوك الأقصى من 4 ميجابايت و15,000 استعلام في الثانية لكل انطباع (QPS).
يعتمد كيفية تحويل سجلات كاتو إلى UDM على نوع سجل التغذية وتكوين المُفسّر.
إعادة توليد سر التغذية يلغي مفتاح السجل السابق. حدث المفتاح السري للوصول في الـ CMA عند تدوير السر.
لا يمكنك تخصيص تنسيق جسم طلب تكامل كاتو، نوع المحتوى، أو أسماء الرؤوس.
إصلاح المشاكل
المسألة | الحل |
|---|---|
فشل التحقق مع HTTP 401 أو 403 | تحقق من أن مفتاح Google Cloud API ينتمي إلى المشروع المرتبط ويتيح الوصول إلى Chronicle API. تأكد من أن سر التغذية لم يتم استبداله، وحدّث بيانات الاعتماد في CMA إذا لزم الأمر. |
الوجهة غير قابلة للوصول | انسخ عنوان URL الكامل لنقطة نهاية التغذية من تفاصيل > معلومات النقطة، بما في ذلك |
يظهر التكامل في حالة جيدة ولكن لا تصل أي بيانات | تحقق من اختيار مصدر البيانات وعوامل التصفية، توليد نشاط كاتو مطابق، ومراجعة حالة تغذية الإدخال وأخطاء المُفسّر. |
فقط الأحداث أو فقط التدفقات تصل | تأكد من أن المصادر المطلوبة قد تم اختيارها وأن عوامل تصفيتها تسمح بتتطابق السجلات. تحقق من أن كل مصدر يتم إرسالها إلى التغذية التي تم تكوينها لها. |
الوصول إلى السجلات الخام ولكن الحقول ليست مفهومة | راجع نوع السجل في التغذية وتكوين المُفسّر مقابل الإعداد في الخطوة 1. |
تُرفض الطلبات أو يتم تأخير الإدخال عند حجم عالٍ | راجع أخطاء الوجهة لحجم الطلب أو حدود الإدخال، واتصل بدعم كاتو مع نطاق الوقت المتأثر وتفاصيل الخطأ، باستثناء مفاتيح API وسرية webhook. |