إنشاء تكامل تنبيهات بإستخدام ويب هوكس

تشرح هذه المقالة كيفية إنشاء تكامل لحسابك في Cato يستخدم ويب هوكس للتنبيهات وإشعارات النظام.

نظرة عامة

تدعم تطبيق إدارة Cato مجموعة متنوعة من التنبيهات والإشعارات لحالات استخدام مختلفة وظروف مرتبطة بحسابك. يمكنك تحديد تكامل ويب هوك لإرسال التنبيهات إلى منصات أخرى مثل ServiceNow وJira وSlack وإنشاء تدفقات أتمتة قائمة على التنبيهات. تدعم ويب هوكس من Cato رؤوس الـ HTTP والرسائل المخصصة في التنبيه لتلبية الاحتياجات المحددة لمؤسستك.

إنشاء تكاملات ويب هوك

إنشاء تكامل ويب هوك لخدمة التذاكر المعنية. أنت بحاجة إلى توفير الرابط (URL) للخدمة التي تتلقى التنبيه عبر الويب هوك مع معلومات المصادقة المناسبة. طرق المصادقة التالية متاحة:

  • أساسي - مصادقة أساسية مع اسم المستخدم وكلمة المرور.

  • حامل - مصادقة حامل مع رمز حامل.

  • مخصص - بعض الخدمات تستخدم مصادقة مخصصة وقد تحتاج إلى رؤوس مصادقة وتخويل مخصصة. بالنسبة لهذه الخدمات، اختر مصادقة مخصصة وقدم المفتاح والقيمة المعنيين لكل رأس مخصص.

لديك الخيار لتكوين رؤوس HTTP مخصصة للويب هوك. يمكنك استخدام الجسم الافتراضي لرسالة التنبيه أو تخصيص أحد هذه القوالب JSON:

ملاحظة

ملاحظة: إذا كان الوصول إلى الخدمة الثالثة محدودًا لعناوين IP معينة، يرجى الرجوع إلى هذه المقالة لقائمة عناوين IP الخاصة بـ Cato التي تحتاج إلى السماح بها (يجب أن تكون مسجلاً للدخول لعرض هذه المقالة).

  • أساسي - معرف الحساب، اسم الحساب، العنوان، الموضوع، نوع التنبيه، ومحتوى التنبيه

    الحقول في القالب الأساسي مشمولة في معظم تنبيهات Cato

  • جميع الحقول - جميع الحقول المحددة مسبقًا تم تضمينها في القالب

  • ServiceNow - ملاحظات العمل (محتوى التنبيه)، وصف قصير (اسم الحساب والعنوان)

  • Jira - ملخص (اسم الحساب والعنوان)، وصف (محتوى التنبيه)

  • مخصص - حدد محتوى جسم الويب هوك، يمكنك البدء بأحد القوالب أعلاه وإجراء التغييرات

تخصيص محتوى التنبيه

يحتوي الحقل المحتوى في القالب على ملخص مقروء مولّد للتنبيه، مشابه لمحتوى تنبيه البريد الإلكتروني. يمكنك اختيار هذه الصيغ للمحتوى: contentText، contentMarkdown، أو contentHTML.

إذا اخترت تخصيص الجسم، هناك عدد من حقول البيانات التي يمكنك استخدامها في محتوى الرسالة. لذا يمكنك تحديد جسم مخصص (أو بنية)، ثم تضمين حقول بيانات Cato. عند إدخال $، تُعرض الحقول المتاحة ثم حدد الحقل المطلوب. تستخدم الحقول الإكمال التلقائي لتصفية القائمة. لمزيد من المعلومات حول حقول Cato، انظر فهم حقول JSON لتكامل التنبيهات.

صفحة Webhooks

لإنشاء تكامل ويب هوك:

  1. من قائمة التنقل، انقر الحساب > الاشتراكات وحدد علامة التبويب تكاملات.

  2. انقر تكامل جديد > ويب هوك. يفتح اللوحة تكامل ويب هوك جديد.

  3. قم بتكوين إعدادات التكامل هذه:

    1. أدخل الاسم للتكامل.

    2. انقر على شريط التمرير لتمكين (بالأخضر) أو تعطيل (بالرمادي) التكامل (ممكن افتراضيًا).

  4. قم بتكوين تفاصيل الاتصال:

    1. أدخل URL للخدمة التي تتلقى الويب هوك.

    2. إذا لزم الأمر، قم بتكوين طريقة المصادقة والإعدادات لهذه الخدمة.

    3. انقر اختبار. إذا تمكن التكامل من الاتصال بالخدمة، يتم عرض رسالة نجح الاختبار بنجاح.

      إذا كان هناك خطأ في الاتصال، تعرض الصفحة رمز خطأ HTTP والرسالة المبلغ عنها من قبل الخدمة.

  5. (اختياري) في رؤوس مخصصة، حدد المفتاح والقيمة لكل رأس HTTP إضافي للتكامل.

  6. في الجسم المخصص، حدد محتوى تنبيه الويب هوك:

    1. في ابدأ من قالب، حدد قالب JSON لرسالة التنبيه.

    2. (اختياري) في تعديل القالب، قم بتخصيص محتوى التنبيه.

      • أدخل $ لتضمين حقول أخرى

      • أدخل / كحرف هروب

      بعد تحرير وحفظ محتوى قالب محدد سلفاً، يتم تعريف التكامل كقالب مخصص.

  7. انقر حفظ. تم حفظ تكامل الويب هوك وإضافته إلى صفحة التكاملات.

تحديد إشعارات السياسة باستخدام ويب هوكس

تتيح سياسات الأمان في Cato إرسال الإشعارات عند مطابقة قاعدة معينة. يمكنك تكوين إعدادات التتبع لإرسال الإشعارات إلى تكامل محدد أو إلى مجموعة اشتراك تحتوي التكامل.

قاعدة Webhook

لتحديد إشعار ويب هوك لقاعدة:

  1. في السياسة المعنية، قم بتحرير القاعدة وقم بتوسيع قسم الإجراءات.

  2. حدد إرسال الإشعار.

  3. حدد التكرار لعدد مرات إرسال التنبيه.

  4. في إرسال الإشعار إلى، اختر مجموعة الاشتراك أو التكامل وحدد العنصر المعني.

  5. انقر تطبيق.

هل كان هذا المقال مفيداً؟

0 من 1 وجدوا هذا مفيداً

لا توجد تعليقات