الانتقال إلى المحتوى الرئيسي
PUT
تحديث وجهة SIEM
تحقق من delivery_available في استجابة القائمة قبل تمكين وجهة. يغطي التسليم أحداث التدقيق الجديدة مع إسناد بيئة تم التحقق منها. لا يتم بث الأحداث التاريخية وغير المنسوبة. وجهة enabled ليست دليلًا على الاستيعاب الناجح؛ افحص delivery_counts وجهاز الاستقبال الخاص بك.
استخدم مفتاح واجهة برمجة التطبيقات لبيئة الاختبار أو الإنتاج المقصودة. يتطلب الإدراج audit:read؛ تتطلب التغييرات audit:write. يجب أن تنتمي جلسة المتصفح إلى مسؤول مساحة عمل. لا يمكن تحديث أو حذف وجهة من مستأجر أو بيئة أخرى. يتم تشفير بيانات الاعتماد في وضع السكون ولا تظهر أبدًا في الردود. بالنسبة لخطافات الويب، قم بتوفير secret؛ بالنسبة لـ Splunk أو Datadog أو Elastic، قم بتوفير token. يتطلب تغيير نقطة نهاية توفير بيانات الاعتماد الخاصة بها مرة أخرى. لا يتم دعم تكوين CloudWatch. يمكن أن تحتوي البيئة على ما يصل إلى 20 وجهة. يؤدي حذف وجهة إلى إزالة بيانات الاعتماد المحفوظة وسجلات التسليم في قائمة الانتظار. يؤدي تعطيل أو تغيير وجهة إلى إلغاء عمليات التسليم المعلقة؛ احفظ أي دليل تسليم تحتاجه أولاً. راجع دليل تسليم SIEM لإعادة المحاولات، وإعدادات المزود، والتحقق من الويب هوك. لاستيعاب اللقطات، استخدم صادرات التدقيق أو صادرات أحداث المخاطر. لا تمكن هذه الصادرات التدفق المستمر.

التفويضات

X-API-Key
string
header
مطلوب

مفتاح API للمصادقة من جهاز إلى جهاز

معلمات المسار

id
string<uuid>
مطلوب

معرف وجهة SIEM.

الجسم

application/json
endpoint
string<uri>

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

Maximum string length: 2048
token
string
write-only

رمز لتهيئة Splunk أو Datadog أو Elastic. مطلوب عند الإنشاء لهؤلاء المزودين. لا تقدم سرًا أيضًا.

Required string length: 16 - 8192
secret
string
write-only

سر مشترك لتكوين webhook. مطلوب عند الإنشاء لـ webhook. لا توفر الرمز المميز أيضًا.

Required string length: 16 - 8192
enabled
boolean
افتراضي:false

تمكين تسليم أحداث التدقيق المنسوبة إلى البيئة المسجلة حديثًا. يتطلب delivery_available=true؛ وإلا فإن true يُرجع 409. الافتراضي هو false عند إنشاء وجهة.

الاستجابة

وجهة SIEM محدثة.

id
string<uuid>
environment_id
string<uuid>
provider
enum<string>
الخيارات المتاحة:
splunk,
datadog,
elastic,
webhook
endpoint
string<uri>
enabled
boolean
status
enum<string>
الخيارات المتاحة:
configured_delivery_unavailable,
disabled,
enabled
credential_configured
boolean
created_at
string<date-time>
updated_at
string<date-time>