Webhook
إرسال أحداث MDM إلى النظام المستقبِل. قبل الاتصال، اتفق مع مالك المستقبِل على صيغة الحدث وطريقة التحقق من الأصالة.
افتح Integrations → إضافة تكامل → Webhook. للاتصال المثبّت مسبقًا استخدم إعداد.
التحضير
- أنشئ في النظام المستقبِل endpoint مستقلًّا عبر HTTPS لأحداث MDM وحدّد الأساليب والترويسات والردود المسموح بها.
- أنشئ سرًّا مشتركًا عشوائيًا في جهة المستقبِل واضبط هناك التحقق من التوقيع/السر وفق عقد التكامل.
- أضف الترويسات غير السرية الضرورية فقط ككائن JSON. احفظ الأسرار في الحقل المستقل secret.
- تحقق من حدث اختباري ورمز الردّ والحماية من إعادة التسليم وسجلات النظامين.
المعلمات
| الحقل | النوع | الغرض وقواعد التعبئة |
|---|---|---|
| عنوان مستقبِل الأحداث | إعداد | عنوان HTTPS URL عام على المنفذ 443 بدون fragment (#…)، مثل https://hooks.example.com/mdm. |
| ترويسات إضافية | إعداد | كائن JSON من الترويسات النصية، مثل {“X-Source”:“mdm”}. ترويسة Authorization ممنوعة؛ حدّد السر المشترك في حقل مستقل. |
| السر المشترك | سر | قيمة عشوائية لا يقل طولها عن 32 حرفًا، تُضبط أيضًا في النظام المستقبِل. |
الحفظ والتعديل
املأ المعلمات وانقر «حفظ». عند إعادة الفتح لا تُعرض الأسرار: مؤشر وجود السر ليس قيمته. الحقل الفارغ لسر موجود يحتفظ بالقيمة السابقة؛ والقيمة الجديدة تستبدلها. بعد التعديل تحقق من الاتصال من جديد.
نوع Webhook متاح في كتالوج التكاملات الكامل.
التحقق من النتيجة
- جهّز endpoint عامًّا عبر HTTPS يمكن لخادم MDM الوصول إليه.
- اضبط السر المشترك على الجانبين؛ وأضف الترويسات النصية الضرورية فقط.
- تحقق من الاتصال ومن حدث اختباري مسموح به؛ وأكّد في سجل المستقبِل استلام الحدث ومعالجته.
تعني الحالة «Configured» أن الإعدادات محفوظة. قيّم نتيجة فحص الاتصال ونتيجة العملية المستهدفة كلًّا على حدة. تتوفر تفاصيل الفحص في بطاقة الاتصال.
القيود والتبعيات
يجب ألا يقل السر عن 32 حرفًا. لا يمكن استنتاج مخطط التوقيع واسم الترويسة وإعادة المحاولات وضمانات التسليم من النموذج: يجب الاتفاق عليها بحسب عقد backend لديكم. في جهة المستقبِل راعِ الأحداث المتكررة وتحقق من أصالة الطلب.
عند عدم العمل
| العرض | ما يجب فحصه |
|---|---|
| يرفض النموذج عنوان URL | تحقق من HTTPS والمنفذ 443 وعدم وجود fragment وأن العنوان عام. |
| يرفض النموذج الترويسات (headers) | يجب أن تكون القيمة كائن JSON من نصوص؛ ولا يمكن تحديد Authorization في هذا الحقل. |
| يرفض المستقبِل الحدث | طابق السر وعقد التوقيع وصيغة الجسم وردّ endpoint. |
| نجاح HTTP موجود لكن لا يوجد إجراء عمل | تحقق من معالج المستقبِل: استلام HTTP والمعالجة الناجحة مرحلتان مختلفتان. |