استخدام معالجات الأحداث

يمكنك استخدام معالجات الأحداث في SolusVM 2 لتنفيذ إجراءات معينة تلقائيًا عند وقوع أحداث معينة. في الوقت الحالي، تعد خطافات الويب هي نوع معالج الأحداث الوحيد المدعوم. يمكن إضافة أنواع أخرى من معالجات الأحداث في المستقبل.

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

إنشاء خطاف ويب

خطاف الويب هو رد اتصال HTTP/HTTPS محدد من قبل المستخدم. في كل مرة يتم تشغيل معالج حدث من هذا النوع، فإنه ينفذ خطاف الويب، ثم يرسل SolusVM 2 طلب POST إلى عنوان URL الخاص بخطاف الويب. يتابع SolusVM 2 ما يصل إلى خمس عمليات إعادة توجيه، ولا يتحقق من صحة شهادة SSL/TLS الخاصة بموقع الويب (إن وجدت). يتم دائمًا تمرير عدد من المعلمات المحددة مسبقًا عبر عنوان URL (على سبيل المثال، معرف الخادم الذي يتم حذفه، أو عنوان IP الذي تتم إضافته). يمكن أيضًا تكوين خطاف ويب لتمرير معلمات إضافية يحددها المستخدم.

في كل مرة يتم فيها تشغيل خطاف ويب، يتم إنشاء مهمة في SolusVM 2. ستكون المهمة بالحالة "فشلت" إذا قام البرنامج النصي بإرجاع رمز حالة HTTP 4xx أو 5xx.

لإنشاء خطاف ويب:

1. قم بتسجيل الدخول إلى SolusVM 2.
2. انتقل إلى الإعدادات > معالجات الأحداث، ثم انقر فوق إضافة خطاف ويب.
3. امنح خطاف الويب الخاص بك اسمًا فريدًا.
4. حدد عنوان URL للخطاف على الويب. سيتم إرسال طلب إلى عنوان URL هذا في كل مرة يتم فيها تشغيل خطاف الويب.
5. حدد حدثًا واحدًا أو أكثر من القائمة المنسدلة. في كل مرة يتم فيها إجراء حدث مدعوم، سيتم تشغيل خطاف الويب.
6. (اختياري) حدد معلمات الطلب الإضافية لتمريرها عبر عنوان URL للخطاف على الويب. يجب أن تكون المعلمات بتنسيق JSON.
7. (اختياري) حدد مربع الاختيار "ممكّن" إذا كنت تريد أن يصبح خطاف الويب نشطًا بعد الإنشاء. وبدلاً من ذلك، يمكنك تمكين خطاف الويب لاحقًا.
8. انقر حفظ.

تم إنشاء خطاف الويب. يمكنك العثور عليه في الإعدادات > معالجات الأحداث. إذا قمت بتمكين خطاف الويب أثناء الإنشاء، ففي المرة التالية التي يحدث فيها حدث مدعوم، سيتم تشغيل خطاف الويب، وسيتم إرسال طلب إلى عنوان URL لخطاف الويب.

تعديل وتعطيل وإزالة Webhooks

لتعديل خطاف ويب:

1. قم بتسجيل الدخول إلى SolusVM 2.
2. انتقل إلى الإعدادات > معالجات الأحداث.
3. انقر على أيقونة المقابلة لخطاف الويب الذي تريد تعديله.
4. قم بإجراء التغييرات المطلوبة، ثم انقر فوق حفظ.

التغييرات سارية المفعول الآن.

لتمكين أو تعطيل خطاف ويب:

1. قم بتسجيل الدخول إلى SolusVM 2.
2. انتقل إلى الإعدادات > معالجات الأحداث.
3. انقر فوق زر التبديل المتوافق مع خطاف الويب الذي تريد تمكينه أو تعطيله بحيث يظهر "ممكّن" (أزرق) أو "معطل" (رمادي).

تم الآن تمكين خطاف الويب (أو تعطيله).

لحذف خطاف ويب:

1. قم بتسجيل الدخول إلى SolusVM 2.
2. انتقل إلى الإعدادات > معالجات الأحداث.
3. انقر فوق الأيقونة المقابلة لخطاف الويب الذي تريد حذفه، ثم انقر فوق حذف.

يتم حذف خطاف الويب.

قائمة المعلمات التي تم تمريرها بواسطة Webhooks

في كل مرة يتم تشغيل خطاف ويب، فإنه يمرر المعلمات التالية عبر عنوان URL:

• crId
• crHostname
• crStatus (commissioning, configure_network, active, failed, unavailable)
• crLicenseType (micro, mini, standard)
• serverId
• serverIps (على سبيل المثال، ["10.0.0.1"، و10.0.0.2"])
• serverHostname
• serverUuid
• حالة الخادم (غير موجود، بدأ، متوقف، غير متاح)
• userId
• billingUserId
• userEmail
• حالة المستخدم (نشط، مقفل، معلق)
• userAllowedIps (على سبيل المثال، ["10.0.0.1"، "10.0.0.2"])

مثال على الويب هوك

يمكنك إنشاء خطاف ويب يقوم تلقائيًا بتحديث عناوين IP للخوادم التي تم ترحيلها من مورد حسابي إلى آخر في WHMCS.

لإنشاء خطاف الويب:

1. قم بتسجيل الدخول إلى خادم WHMCS الخاص بك عبر SSH.

2. حدد موقع الملف hook_example.php المرفق مع الملحق SolusVM 2 WHMCS. يجب أن يكون الملف في الدليل modules/servers/solusvm2vps/.

3. قم بإنشاء نسخة من الملف، ثم ابدأ في تحرير النسخة.

4. قم بإزالة exit(); في السطر 6.

5. أضف سرك (أسرارك) إلى المتغير $securitySecrets.

6. أضف عنوان (عناوين) IP الخاصة بعقدة إدارة SolusVM 2 إلى المتغير $connectionIPs.

7. حفظ التغييرات.

8. قم بتسجيل الدخول إلى SolusVM 2.

9. انتقل إلى الإعدادات > معالجات الأحداث، ثم انقر فوق إضافة خطاف ويب.

10. امنح خطاف الويب الخاص بك اسمًا فريدًا.

11. حدد عنوان URL للبرنامج النصي الذي تم تحريره.

12. حدد "إضافة أو إزالة عنوان IP إضافي" من القائمة المنسدلة.

13. حدد السر (الأسرار) الذي أضفته إلى البرنامج النصي أثناء الخطوة 5 من هذا الإجراء:

    {
     "secret": "<your secret goes here>"
    }
    

14. حدد خانة الاختيار "ممكّن"، ثم انقر فوق حفظ.

الآن، في كل مرة يتم فيها ترحيل الخادم، سيتم إنشاء مهمة لتحديث عنوان IP الخاص بالخادم في WHMCS في SolusVM 2.