البنية التحتية لتكنولوجيا المعلومات
تكامل تم التحقق منهSynology DSM
إشعارات الرسائل النصية القصيرة.
تم التحقق من تكامل FoxBox. اتبع تعليمات إعداد تطبيقك واضبط صلاحيات الوصول والمستلمين وتوجيه الرسائل القصيرة.
كيفية اتصالها
01 / حالة الاستخدام
إشعار مفيد،
من حدث قائم.
يُصدر نظام إدارة التخزين (DSM) إشعارًا يتعلق بالتخزين أو الخدمة. يقوم موفر خدمة الويب هوك المخصص بإرساله إلى الجسر؛ ويقوم FoxBox بإرساله عبر مسار الرسائل النصية القصيرة المُكوّن.
تُضيف هذه الميزة مسارًا منفصلاً لإشعارات الرسائل النصية القصيرة. وهي لا تُحدد مدى توفر الخدمة ولا تُستبدل عملية الاستجابة للحوادث وتصعيدها الحالية.
02 / المتطلبات
قبل أن تبدأ.
- موفر ويب هوك مخصص لنظام Synology DSM؛ الإصدار المراد التحقق منه
- مضيف منفصل لجسر التكامل. لا يوجد أي شيء مثبت على برنامج FoxBox الثابت.
- تم استخدام بايثون 3 للجسر وبيئة معزولة للاختبار الأول.
- واجهة FoxBox HTTP متوافقة مع الوثائق
app=ws,op=pvيجب تأكيد إصدار الجهاز والبرنامج الثابت. - لأي اختبار مباشر لاحق: يلزم وجود مستلم معتمد، وبيانات اعتماد صحيحة، ومسار رسائل نصية قصيرة مُفعّل. تتطلب مسارات شريحة SIM تغطية شبكة؛ وتتطلب الخدمات الخارجية الوصول إلى الإنترنت وإعدادات مزود الخدمة.
تم التحقق من تكامل FoxBox. اتبع تعليمات إعداد تطبيقك واضبط صلاحيات الوصول والمستلمين وتوجيه الرسائل القصيرة.
أي جهاز FoxBox يناسب هذا التكامل؟
اختر التنسيق وعدد المودمات والشبكة التي تحتاجها. احتفظ بنظام Synology DSM كسياق للمشروع.
ابحث عن جهاز FoxBox المناسب لهذا التكامل →03 / التركيب
ابدأ بالعزلة.
جهز الجسر.
قم بتنزيل حزمة المصدر. اتبع التعليمات الموجودة في ملف README الرئيسي لتكوين الجسر الخارجي في وضع التشغيل التجريبي، باستخدام عناصر نائبة ووجهة اختبار محلية.
الخطوة الثانية
راجع خيارات موفر إشعارات الويب هوك المخصصة في إصدار DSM الخاص بك.
الخطوة 3
استخدم حقول موفر الويب هوك المخصص من DSM من التكوين المقدم، مع وجود السر في رأس Authorization.
الخطوة الرابعة
اختبار تنسيق الموفر مقابل جسر التشغيل التجريبي قبل استخدام المستلمين الفعليين.
04 / مراجعة الكود
لا شيء مخفي
خلف المثال.
الملفات أدناه مأخوذة من حزمة مصادر التكامل القابلة للتنزيل. يُرجى مراجعة دليل الجسر والتكامل بالكامل قبل استخدام المثال.
Loading source…05 / التحقق من صحة المسار
اختبر المثال.
ثم اختبر عملية النشر.
اضبط إعدادات التكامل.
python3 -m unittest discover -s tests -vتحقق من البيانات المتوقعة، وسلوك التحقق، ومعالجة البيانات المكررة، واستجابات الأخطاء. يوضح المختبر أدناه سير العمل محليًا في متصفحك.
تم التحقق من تكامل FoxBox. اتبع تعليمات إعداد تطبيقك واضبط صلاحيات الوصول والمستلمين وتوجيه الرسائل القصيرة.
06 / استكشاف الأخطاء وإصلاحها
اجعل الإخفاقات مرئية.
يرفض الجسر الحمولة.
تحقق من مطابقة حقول التكامل مع الإعدادات المُقدمة. استخدم الأمثلة الاصطناعية أولاً. لا تنسخ محتويات أحداث الإنتاج أو بيانات الاعتماد إلى سجلات الدعم.
انتهت مهلة الطلب.
تأكد من إمكانية الوصول، وبروتوكول TLS، وتنسيق الطلب المتوقع. لا تقم بإعادة إرسال طلب SMS غامض تلقائيًا: فقد يكون الطلب الأول قد تم قبوله بالفعل.
قبلت واجهة برمجة التطبيقات الطلب، لكن لم تصل أي رسالة نصية قصيرة.
قبول الطلب لا يُعدّ تأكيدًا للتسليم. يُرجى التحقق من حالة رسالة FoxBox الموثقة وظروف شبكة الجوال على الجهاز الحقيقي. تكامل تم التحقق منه.
تم إرسال حدث مكرر.
راجع إعدادات مفتاح حدث الجسر وإزالة التكرار. تحقق من صحة أحداث التجميع والاسترداد في البرنامج المستهدف قبل تفعيل الإشعارات المباشرة.
من التكامل إلى الأجهزة
اختر التنسيق.
تأكد من ملاءمة المنتج.
ابدأ بـ S1 لجهاز مودم واحد، أو S2 لجهازين، أو SR لتركيب جهاز مودم في رف. لا يحدد التكامل وحده سعة المودم أو متطلبات المرونة.
FoxBox S2 · جهاز صغير الحجم مزود بمودمينالتكوين والتحقق
الإعداد التقني: Synology DSM
الاتصال عبر جسر خارجي
في إشعارات DSM، أضف رابط ويب مخصص، واختر قاعدة الإشعار المطلوبة، واستخدم طلب POST مع application/x-www-form-urlencoded. أضف رأس Authorization وحقل رسالة يحتوي على @@TEXT@@. عنوان الجسر خارجي عن DSM وFoxBox. هذا تكوين رابط ويب مخصص لـ DSM، وليس برنامج تشغيل بديل لمزود خدمة الرسائل النصية القصيرة.
يستمد هذا الإعداد هوية مكررة من نص الإشعار ضمن نطاق زمني محدد. وبالتالي، يمكن دمج التنبيهات المتكررة المتطابقة؛ بينما قد يؤدي تغيير النص إلى إنشاء حدث جديد. وافق على هذا السلوك لإشعارات التخزين والنسخ الاحتياطي والطاقة قبل تفعيل القاعدة. احتفظ بتحديد الوجهة على الجسر.
مثال على التكوين · استبدل العناصر النائبة قبل الاستخدام
URL: https://bridge.example.invalid/webhooks/synology
Method: POST
Content-Type: application/x-www-form-urlencoded
Header Authorization: Bearer <PRIVATE_BRIDGE_TOKEN>
Form field message: @@TEXT@@تحقق من صحة البيانات قبل تفعيل النقل
- اختبر حدثًا اصطناعيًا واحدًا مرتين، وحدثًا متغيرًا ونصًا يحتوي على & و + وأحرف غير ASCII؛ تأكد من ترميز النموذج وسياسة التكرار.
مراجع: Synology DSM webhooks
واجهة برمجة تطبيقات FoxBox: المعلمات والأخطاء والحالة · مصادقة المحول ومعالجة التكرارات
