الانتقال إلى المحتوى الرئيسي
استخدم واجهة برمجة تطبيقات الوجهة لحفظ التكوين المشفر لـ Splunk أو Datadog أو Elastic أو خطاف ويب HTTPS. أولاً اسرد الوجهات: يجب أن يكون delivery_available هو true قبل تمكين التسليم. سيعيد النشر بدون العامل 409 DELIVERY_UNAVAILABLE عند طلب enabled: true.

ما يتم تسليمه

تستقبل الوجهة الممكنة أحداث تدقيق جديدة تم التحقق من مساحة عملها وبيئتها عند التسجيل. لا تستقبل وجهة الإنتاج أبدًا أحداث وضع الحماية. لا يتم تعيين بيئة تخمينية أو بث للأحداث التاريخية والأحداث التي لا تحتوي على إسناد بيئي موثوق. هذا لا يعد بأن كل منتج قديم يسجل كل إجراء منصة؛ استخدم أدلة التدقيق/التصدير المسجلة لتحديد فجوات التغطية. التكوين ليس دليلاً على الاستيعاب. status: enabled يعني أن الوجهة ممكّنة. يتضمن رد القائمة delivery_counts على مستوى البيئة لسجلات pending وdelivered وfailed وcancelled. تلقى السجل الذي تم تسليمه إقرار HTTP من المزود؛ يجب أيضًا التحقق من الفهرسة والتنبيهات والاحتفاظ في نظام SIEM الخاص بك.

تكوين جهاز الاستقبال

استخدم اسم مضيف HTTPS عامًا على المنفذ 443، بدون بيانات اعتماد في عنوان URL أو معلمات الاستعلام أو الأجزاء. يتم رفض العناوين الخاصة وعمليات إعادة التوجيه ونقاط النهاية غير HTTPS. تدعم كل بيئة مساحة عمل ما يصل إلى 20 وجهة. عقود المزود: Splunk HEC، سجلات Datadog، فهرسة Elasticsearch. لا يثبت دعم البروتوكول أن حساب المزود الخاص بك قد قبل حدثًا؛ اختبر الحساب المكون. قدم secret لـ webhooks أو token للموفرين الآخرين، لا كلاهما أبدًا. يتم تشفير بيانات الاعتماد في وضع السكون ولا يتم إرجاعها أبدًا. يتطلب تغيير نقطة نهاية توفير بيانات الاعتماد الخاصة بها مرة أخرى. استخدم بيانات اعتماد مخصصة مع امتيازات الاستيعاب فقط حيثما كان ذلك مدعومًا.

التحقق من توقيعات خطاف الويب (webhook)

يتضمن غلاف JSON id وtenant_id وenvironment_id وoccurred_at وevent. يكرر رأس X-Truthlocks-Event-ID معرف الحدث. تحقق من وحدات بايت نص HTTP الدقيقة قبل تحليلها أو معالجتها:
اقبل فقط مساحة العمل/البيئة المتوقعة وسجل معرفات الأحداث بشكل دائم لرفض عمليات الإعادة. أعد استجابة 2xx فقط بعد قبول الحدث في التخزين الدائم. استخدم مقارنة التوقيع بوقت ثابت؛ لا تسجل السر المشترك أو رؤوس المصادقة.

إعادة المحاولات وتغييرات التكوين

التسليم مرة واحدة على الأقل. يتم الالتزام بقائمة الانتظار في نفس معاملة قاعدة البيانات كحدث التدقيق المنسوب، لذلك لا يمكن أن يؤدي التراجع عن التدقيق إلى ترك تسليم خلفه. يمكن أن يتسبب تعطل العامل بعد قبول المستلم في تكرار؛ قم بإزالة التكرار باستخدام معرف الحدث الثابت. يتم إعادة محاولة فشل النقل والاستجابات غير 2xx مع تراجع أسي يبدأ من دقيقة واحدة، بحد أقصى ساعة واحدة، حتى 20 محاولة. تبقى السجلات المستنفدة failed؛ لا توجد إعادة محاولة تلقائية غير محدودة أو وقت إنجاز موعود. يؤدي تعطيل أو تغيير وجهة إلى إلغاء عمليات التسليم المعلقة لتجنب إعادة توجيه قائمة انتظار قديمة إلى مستلم متغير. يؤدي الحذف إلى إزالة التكوين وبيانات الاعتماد المحفوظة وسجلات قائمة انتظار التسليم الخاصة بها. احتفظ بأدلة التسليم المطلوبة قبل الحذف. لا يوجد إعادة تشغيل تاريخية تلقائية.

تصدير اللقطات

استخدم audit exports لقطات التدقيق المسجلة وrisk-event exports لقطات إشارة المخاطر المدعومة. استمر في معالجة الموضع وإزالة تكرار هويات الأحداث عند استيراد اللقطات. وظائف التصدير وتسليم SIEM والتنبيهات النهائية هي عمليات منفصلة؛ إكمال إحداها لا يثبت نجاح الأخرى.