تخط وانتقل إلى المحتوى الرئيسي

Webhook سجل النشاط

نظرة عامة

يُتيح Webhook سجل النشاط إمكانية إرسال سجلات نشاط المستخدمين تلقائيًا من لوسيديا إلى نقطة النهاية التي تحددها، وذلك في شبه وقت فعلي. بدلًا من سحب السجلات يدويًا، تقوم لوسيديا بدفعها مباشرةً إلى نظام SIEM الخاص بك (مثل Splunk) لأغراض المراقبة الأمنية والامتثال.

المميزات الرئيسية

  • تسليم السجلات في شبه وقت فعلي

  • مصادقة آمنة لـ Webhook

  • سجلات منظّمة بتنسيق JSON

  • تغطية شاملة لنشاط المستخدمين وبيانات التدقيق

المتطلبات الأساسية

قبل ضبط إعدادات Webhook، تأكد من توفّر ما يلي:

  • رابط URL صالح لنقطة النهاية من نظام SIEM الخاص بك

  • طريقة مصادقة جاهزة (Header أو Body أو كليهما)

  • صلاحية دور المدير ضمن الإعدادات العامة (General Settings) في لوسيديا

كيفية ضبط إعدادات Webhook

الخطوة الأولى — الانتقال إلى سجل النشاط

انتقل إلى الإعدادات (Settings) ← المستخدمون (Users) ← سجل النشاط (Activity Log)، ثم اضغط على أيقونة ضبط إعدادات Webhook.

الخطوة الثانية — تعبئة تفاصيل Webhook

1. الطريقة (Method) اختر طريقة HTTP المناسبة لنقطة النهاية:

  • HTTP POST (موصى به)

  • HTTP GET

2. الرابط (URL) أدخل رابط URL لنقطة نهاية نظام SIEM الخاص بك. يجب أن يكون الرابط صالحًا ويمكن الوصول إليه.

3. اسم متغير المصادقة (Authentication Variable Name) أدخل اسمًا لمتغير المصادقة، مع مراعاة الشروط التالية:

  • أن يبدأ بحرف

  • أن يحتوي على أحرف وأرقام فقط

  • ألا يحتوي على مسافات

مثال: authorization

4. موقع المصادقة (Authentication Location) اختر الموقع الذي سيُرسَل فيه رمز المصادقة:

  • Header

  • Body

  • أو كليهما

5. رمز المصادقة (Authentication Token) أدخل الرمز الآمن الخاص بك. لا يدعم الحقل الأحرف العربية ولا الرموز الخاصة.

6. تفعيل Webhook فعّل Webhook عبر زر التبديل لبدء تسليم السجلات.

هيكل بيانات السجل

تُرسَل جميع السجلات بتنسيق JSON. فيما يلي نموذج لمحتوى الإرسال ووصف لكل حقل.

نموذج محتوى الإرسال

json

{

"timestamp": "2026-03-16T11:10:54Z",

"activity_log": "User A updated permissions for User B",

"user_action": "Update",

"feature": "User Management",

"user_email": "[email protected]",

"user_ip_address": "192.168.1.1",

"user_agent": "Mozilla/5.0"

}

مرجع الحقول

الحقل

الوصف

timestamp

وقت تنفيذ الإجراء بتوقيت UTC

activity_log

وصف النشاط الذي تم تنفيذه

user_action

نوع الإجراء: Read أو Create أو Update أو Delete

feature

وحدة المنصة التي نُفِّذ فيها الإجراء

user_email

البريد الإلكتروني للمستخدم الذي نفّذ الإجراء

user_ip_address

عنوان IP الخاص بالمستخدم

user_agent

معلومات المتصفح أو الجهاز

الأحداث المدعومة

يرصد Webhook جميع الأنشطة التي تتم على المنصة، بما في ذلك:

الإجراءات العامة

  • عرض البيانات (Read)

  • إنشاء الموارد (Create)

  • تحديث الإعدادات (Update)

  • حذف الموارد (Delete)

إجراءات إدارة المستخدمين

  • دعوة المستخدمين (بما في ذلك هوية من أرسل الدعوة)

  • تغييرات الصلاحيات

  • تحديثات بيانات المستخدمين

  • حذف المستخدمين

إدارة Webhook

يستطيع المستخدمون الذين يمتلكون دور المدير ضمن الإعدادات العامة القيام بما يلي:

  • إنشاء Webhook

  • تعديل إعدادات Webhook

  • تفعيل Webhook أو تعطيله

  • حذف Webhook

ملاحظة: يؤدي تعطيل Webhook إلى إيقاف تسليم السجلات فورًا، فيما يؤدي إعادة تفعيله إلى استئناف التسليم.

الأمان

  • يُخزَّن رمز المصادقة بشكل مشفّر

  • يُخفى الرمز بعد الحفظ

  • يمكنك تحديث الرمز أو استبداله في أي وقت

سجل النشاط

تُسجَّل جميع الإجراءات المتعلقة بـ Webhook في صفحة سجل النشاط، وتشمل:

  • إنشاء Webhook

  • تعديل Webhook

  • تفعيل Webhook

  • تعطيل Webhook

  • حذف Webhook

استكشاف الأخطاء وإصلاحها

في حال عدم استلام السجلات:

  • تأكد من أن Webhook مُفعَّل

  • تحقق من صحة رابط URL لنقطة النهاية وإمكانية الوصول إليها

  • راجع إعدادات المصادقة

في حال وجود أخطاء في الإعداد:

  • راجع متطلبات التحقق من صحة الحقول المتعلقة برمز المصادقة واسم المتغير والرابط

  • تأكد من عدم استخدام أحرف غير مدعومة في أي حقل

أفضل الممارسات

  • استخدم HTTP POST للحصول على أداء أفضل في معالجة محتوى الإرسال

  • احرص على تخزين رمز المصادقة وإدارته بشكل آمن

  • راقب سجلات التسليم من جهة نظام SIEM بانتظام

  • اختبر الإعدادات على بيئة تجريبية قبل الانتقال إلى بيئة الإنتاج

الدعم

للحصول على المساعدة في ضبط إعدادات Webhook أو اختبار التكامل، تواصل مع فريق دعم لوسيديا على [email protected].

هل أجاب هذا عن سؤالك؟