> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# تسليم تدقيق SIEM

> تكوين تسليم التدقيق المحدد النطاق، والتحقق من webhooks، وفهم التغطية وإعادة المحاولات.

استخدم [واجهة برمجة تطبيقات الوجهة](https://docs.truthlocks.com/ar/api-reference/audit/siem/create.md) لحفظ التكوين المشفر لـ Splunk أو Datadog أو Elastic أو خطاف ويب HTTPS. أولاً [اسرد الوجهات](https://docs.truthlocks.com/ar/api-reference/audit/siem/list.md): يجب أن يكون `delivery_available` هو `true` قبل تمكين التسليم. سيعيد النشر بدون العامل `409 DELIVERY_UNAVAILABLE` عند طلب `enabled: true`.

## ما يتم تسليمه

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

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

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

استخدم اسم مضيف HTTPS عامًا على المنفذ 443، بدون بيانات اعتماد في عنوان URL أو معلمات الاستعلام أو الأجزاء. يتم رفض العناوين الخاصة وعمليات إعادة التوجيه ونقاط النهاية غير HTTPS. تدعم كل بيئة مساحة عمل ما يصل إلى 20 وجهة.

| المزود | نقطة النهاية | الاعتماد والتسليم |
| - | - | - |
| Webhook | عنوان URL الخاص بالاستيعاب عبر HTTPS | قم بتوفير `secret`. يستقبل غلاف JSON وتوقيع HMAC-SHA256 مختوم بالوقت. |
| Splunk | نقطة نهاية حدث HTTPS HEC، عادةً `/services/collector/event` | قم بتوفير HEC `token`. يستخدم `Authorization: Splunk …`؛ يجب أن يحتوي نجاح HTTP أيضًا على `code: 0`. استخدم المنفذ 443 أو وكيل عكسي HTTPS مناسب. |
| Datadog | نقطة نهاية HTTPS `/api/v2/logs` لموقعك | قم بتوفير مفتاح API لابتلاع السجل `token`. يستخدم `DD-API-KEY` ومصفوفة سجل JSON. حدد موقع Datadog الصحيح. |
| Elastic | نقطة نهاية HTTPS الخاصة بك التي تنتهي بـ `/INDEX/_doc` | قم بتوفير مفتاح API المشفر `token`. يستخدم `Authorization: ApiKey …` ومعرف مستند حتمي. |

عقود المزود: [Splunk HEC](https://help.splunk.com/splunk-enterprise/get-data-in/get-started-with-getting-data-in/9.1/get-data-with-http-event-collector/format-events-for-http-event-collector)، [سجلات Datadog](https://docs.datadoghq.com/api/latest/logs/)، [فهرسة Elasticsearch](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-index). لا يثبت دعم البروتوكول أن حساب المزود الخاص بك قد قبل حدثًا؛ اختبر الحساب المكون.

قدم `secret` لـ webhooks أو `token` للموفرين الآخرين، لا كلاهما أبدًا. يتم تشفير بيانات الاعتماد في وضع السكون ولا يتم إرجاعها أبدًا. يتطلب تغيير نقطة نهاية توفير بيانات الاعتماد الخاصة بها مرة أخرى. استخدم بيانات اعتماد مخصصة مع امتيازات الاستيعاب فقط حيثما كان ذلك مدعومًا.

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

يتضمن غلاف JSON `id` و`tenant_id` و`environment_id` و`occurred_at` و`event`. يكرر رأس `X-Truthlocks-Event-ID` معرف الحدث. تحقق من وحدات بايت نص HTTP الدقيقة قبل تحليلها أو معالجتها:

```python theme={null}
import hashlib
import hmac
import time


def verify_webhook(raw_body: bytes, headers, secret: bytes) -> bool:
    timestamp = headers.get("X-Truthlocks-Timestamp", "")
    try:
        if abs(time.time() - int(timestamp)) > 300:
            return False
        signed = timestamp.encode("ascii") + b"." + raw_body
    except (ValueError, TypeError, UnicodeEncodeError):
        return False
    expected = "v1=" + hmac.new(secret, signed, hashlib.sha256).hexdigest()
    return hmac.compare_digest(
        expected, headers.get("X-Truthlocks-Signature", "")
    )
```

اقبل فقط مساحة العمل/البيئة المتوقعة وسجل معرفات الأحداث بشكل دائم لرفض عمليات الإعادة. أعد استجابة 2xx فقط بعد قبول الحدث في التخزين الدائم. استخدم مقارنة التوقيع بوقت ثابت؛ لا تسجل السر المشترك أو رؤوس المصادقة.

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

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

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

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

استخدم [audit exports](https://docs.truthlocks.com/ar/api-reference/audit/export.md) لقطات التدقيق المسجلة و[risk-event exports](https://docs.truthlocks.com/ar/api-reference/risk/exports/create.md) لقطات إشارة المخاطر المدعومة. استمر في معالجة الموضع وإزالة تكرار هويات الأحداث عند استيراد اللقطات. وظائف التصدير وتسليم SIEM والتنبيهات النهائية هي عمليات منفصلة؛ إكمال إحداها لا يثبت نجاح الأخرى.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.