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

OmniSS7 - دليل المستخدم

OmniSS7 من خدمات شبكة Omnitouch هو مكدس إشارات SS7 شامل وعام يوفر وظائف مرنة لعناصر الشبكة.

نظرة عامة على التوجيه

نظرة عامة على الوثائق​

تم تنظيم هذه الوثائق حسب دور عنصر الشبكة. اختر الدليل الذي يتناسب مع نشر النظام الخاص بك:

📚 أدلة التكوين​

  • دليل STP - تكوين نقطة نقل الإشارة

    • توجيه حركة مرور SS7 بين أقران الشبكة
    • توجيه رمز النقطة والعنوان العالمي
    • موازنة الحمل وإخفاء الطوبولوجيا
    • استخدم هذا إذا كنت تقوم بتوجيه حركة مرور SS7 بين الشبكات

  • دليل عميل MAP - تكوين عميل MAP

    • الاتصال كعميل M3UA لإرسال طلبات MAP
    • استعلامات HLR، المصادقة، معلومات التوجيه
    • دعم بروتوكول MAP العام
    • استخدم هذا إذا كنت ترسل طلبات MAP إلى عناصر الشبكة

  • دليل مركز SMS - تكوين مركز SMS (SMSc)

    • توجيه وتسليم رسائل SMS
    • قائمة انتظار الرسائل المدعومة بقاعدة بيانات
    • تقارير التسليم والتفريغ التلقائي
    • استخدم هذا إذا كنت تدير مركز SMS

  • دليل HLR - تكوين سجل الموقع المنزلي

    • إدارة قاعدة بيانات المشتركين
    • توليد متجهات المصادقة
    • تحديثات الموقع ومعلومات التوجيه
    • استخدم هذا إذا كنت تدير HLR/HSS

  • دليل بوابة CAMEL - تكوين بوابة CAMEL

    • خدمات الشبكة الذكية (CAP/CAMEL)
    • التحكم في المكالمات في الوقت الحقيقي والفوترة
    • تكامل CGrateS للفوترة
    • منشئ الطلبات التفاعلي ومراقبة الجلسات
    • استخدم هذا إذا كنت تقدم خدمات IN أو فوترة في الوقت الحقيقي

  • دليل بوابة USSD - تكوين بوابة USSD

    • ربط SS7/MAP USSD إلى ردود HTTP/JSON
    • قوائم USSD التفاعلية متعددة الأدوار
    • توجيه الرموز القصيرة إلى عناوين ردود مختلفة
    • دفع USSD المنشأ من الشبكة عبر واجهة برمجة التطبيقات REST
    • استخدم هذا إذا كنت تبني تطبيقات USSD (تحقق من الرصيد، إعادة الشحن، إلخ)

🔧 الميزات الشائعة​

  • دليل الميزات الشائعة - المكونات المشتركة
    • نظرة عامة على واجهة المستخدم على الويب والتكوين
    • وثائق واجهة برمجة التطبيقات
    • المراقبة والقياسات (Prometheus)
    • أفضل الممارسات واستكشاف الأخطاء وإصلاحها

📖 وثائق مرجعية​

  • الملحق - مرجع تقني
    • مواصفات بروتوكول SS7
    • رموز عمليات MAP
    • تدفقات معاملات TCAP
    • ترميزات الأحرف والتنسيقات

ال��دء السريع​

1. نظرة عامة على النظام​

يمكن أن يعمل OmniSS7 في أوضاع مختلفة اعتمادًا على متطلبات شبكتك:

3. التكوين​

يختار OmniSS7 دوره من مجموعة من علامات الوضع في config/config.exs. تتكون العلامات، لذا يمكن أن تعمل مثيل واحد كعدة أدوار في وقت واحد (على سبيل المثال، عميل MAP بالإ��افة إلى SMSc).

ملاحظة: config/runtime.exs في هذا المستودع هو اختبار قصير. تحتوي الخوادم الإنتاجية على runtime.exs خاص بها يتم نشره بشكل منفصل. قم بتحرير config/config.exs (والملف المحدد للبيئة الذي يستورده) لتغيير التكوين الافتراضي.

لاختيار دور:

  1. قم بتعيين علامات الوضع ذات الصلة في config/config.exs
  2. قم بتكوين اتصال M3UA (map_client_m3ua أو cap_client_m3ua) وأي عناوين واجهة برمجة التطبيقات الخلفية
  3. أعد تشغيل التطبيق

→ انظر أدلة الوضع المحددة أدناه للحصول على تعليمات التكوين الكاملة

وضع STP — توجيه حركة مرور SCCP/M3UA بين الأقران:

config :omniss7,
  sctp_handler: %{enabled: true, local_ip: {0, 0, 0, 0}, local_port: 2905, point_code: 100},
  enable_gt_routing: true,
  m3ua_peers: [...],
  m3ua_routes: [...],
  m3ua_gt_routes: [...]

وضع HLR:

config :omniss7,
  hlr_mode_enabled: true,
  map_client_enabled: true,
  hlr_api_base_url: "https://hlr-backend:8443",
  map_client_m3ua: %{...}

وضع SMSc:

config :omniss7,
  map_client_enabled: true,
  smsc_mode_enabled: true,
  smsc_api_base_url: "https://smsc-backend:8443",
  auto_flush_enabled: true,
  map_client_m3ua: %{...}

وضع بوابة CAMEL:

config :omniss7,
  cap_client_enabled: true,
  camelgw_mode_enabled: true,
  cgrates_enabled: true,
  cgrates_url: "http://localhost:2080/jsonrpc",
  cgrates_tenant: "cgrates.org",
  cap_client_m3ua: %{...}

انظر إلى مرجع التكوين لكل معلمة، بما في ذلك بوابة USSD (ussd_gateway_enabled).

4. الوصول إلى واجهة المستخدم على الويب​

تُقدم واجهة المستخدم على الويب عبر HTTPS على المنفذ 8087 — على سبيل المثال https://localhost:8087/ (أو المضيف الذي قمت بتكوينه). تفرض نقطة النهاية TLS، لذا يتم إعادة توجيه http:// العادي.

بنية النظام​

مصفوفة الميزات​

الميزةوضع STPعميل MAPوضع SMScوضع HLRبوابة CAMEL
توجيه رمز النقطة✅❌❌❌❌
توجيه العنوان العالمي✅❌❌❌❌
إعادة كتابة SSN✅❌❌❌❌
دعم متعدد الأقران✅✅✅✅✅
طلبات MAP (إرسال)❌✅✅✅❌
استجابات MAP (استلام)❌✅✅✅❌
إدارة قائمة انتظار SMS❌❌✅❌❌
تفريغ تلقائي لـ SMS❌❌✅❌❌
قاعدة بيانات المشتركين❌❌❌✅❌
متجهات المصادقة❌❌❌✅❌
تحديثات الموقع❌❌❌✅❌
دع�� CAP/CAMEL❌❌❌❌✅
الفوترة في الوقت الحقيقي❌❌❌❌✅
التحكم في المكالمات (خدمات IN)❌❌❌❌✅
واجهة المستخدم على الويب✅✅✅✅✅
REST API✅✅✅✅✅
قياسات Prometheus✅✅✅✅✅

العمليات الشائعة​

يستمع OmniSS7 على عدة منافذ، كل منها يخدم سطحًا مختلفًا:

المنفذالبروتوكولمقدمة منالغرض
8087HTTPSControlPanel (Phoenix)لوحة تحكم واجهة المستخدم على الويب (تطبيق TLS)
8445HTTPSapi_exواجهة برمجة تطبيقات الحالة JSON (/api/status, /api/m3ua-status, /api/routing, …)
8080HTTPAPIhandler (Plug.Cowboy)واجهة برمجة تطبيقات عمليات MAP (/api/*)، واجهة Swagger (/swagger)، مواصفة OpenAPI (/swagger.json)، قياسات Prometheus (/metrics)
2905SCTPM3UA/M2PAنقل إشارات SS7

الوصول إلى واجهة المستخدم على الويب​

  • واجهة المستخدم على الويب: https://localhost:8087/ (أو المضيف المكون)
  • واجهة Swagger: http://localhost:8080/swagger
  • مواصفة OpenAPI: http://localhost:8080/swagger.json
  • القياسات: http://localhost:8080/metrics

المراقبة​

# عرض قياسات Prometheus
curl http://localhost:8080/metrics

# التحقق من حالة نظير M3UA (TLS، شهادة موقعة ذاتيًا)
curl -k https://localhost:8445/api/m3ua-status

# حالة الخدمة
curl -k https://localhost:8445/api/status

السجلات​

تُصدر السجلات كـ JSON منظم (كائن واحد لكل سطر) لتمكين الإدخال بواسطة Loki/Alloy، عبر OmniLogger.JsonFormatter. قم بتعيين مستوى السجل في config/config.exs:

config :logger,
  level: :debug  # الخيارات: :debug, :info, :warning, :error

القدرات الرئيسية​

  • دعم كامل لبروتوكول MAP - عمليات MAP المرحلة 2/3
  • دعم بروتوكول CAP/CAMEL - CAP v1/v2/v3/v4 لخدمات الشبكة الذكية
  • إشارات M3UA/SCTP - نقل SS7 القائم على IP
  • الفوترة في الوقت الحقيقي - تكامل CGrateS للفوترة المدفوعة مسبقًا/المؤجلة
  • تسليم SMS - قائمة انتظار الرسائل المدعومة بـ HTTP/JSON مع التفريغ التلقائي
  • منشئ الطلبات التفاعلي - واجهة المستخدم على الويب لاختبار CAMEL/CAP
  • مراقبة الجلسات - تتبع جلسات المكالمات CAMEL في الوقت الحقيقي
  • وثائق واجهة برمجة التطبيقات التفاعلية - واجهة Swagger للاختبار
  • قياسات Prometheus - رؤية كاملة
  • تكوين متعدد الأدوار - STP، عميل MAP، SMSc، HLR، بوابة CAMEL، بوابة USSD

نظرة عامة على مكدس البروتوكول​

أمثلة حالات الاستخدام​

بوابة الشبكة (STP)​

توجيه حركة مرور SS7 بين شبكات الهاتف المحمول المختلفة

  • ربط شبكات المشغلين
  • بوابة SS7 الدولية
  • موازنة الحمل عبر HLRs
  • ترجمة العنوان العالمي
  • NAT لـ SCCP (إعادة استخدام العنوان العالمي الذكي)
  • → دليل STP

مركز SMS (SMSc)​

تسليم رسائل SMS إلى المشتركين في الهاتف المحمول

  • تسليم MT-SMS
  • نشوء MO-SMS
  • توجيه SMS المنزلي
  • إخفاء IMSI
  • جدار حماية SMS
  • إدارة قائمة انتظار الرسائل
  • تقارير التسليم
  • متكامل مع OmniMessage للتعامل مع جميع MAP SMS
  • → دليل مركز SMS

عميل MAP​

التفاعل مع أي عناصر شبكة عبر MAP باستخدام واجهة برمجة تطبيقات RESTful بسيطة

  • PRN / SRI / ATI / إلخ
  • بناء تطبيقات SS7/MAP الخاصة بك باستخدام واجهات برمجة التطبيقات RESTful
  • بوابات USSD
  • طلبات متجهات المصادقة
  • استعلامات IMSI/MSISDN
  • استعلامات معلومات التوجيه
  • → دليل عميل MAP

قاعدة بيانات المشتركين (HLR)​

إدارة بيانات المشتركين والمصادقة

  • تحديثات الموقع
  • توليد المصادقة
  • توفير معلومات التوجيه
  • متكامل بالكامل مع OmniHSS
  • → دليل HLR

منصة الشبكة الذكية (بوابة CAMEL)​

التحكم في المكالمات والفوترة في الوقت الحقيقي لمشغلي الاتصالات

  • فوترة المكالمات المدفوعة مسبقًا/المؤجلة
  • التحكم في المكالمات (الاتصال، الإنهاء، التوجيه)
  • إدارة الجلسات وتوليد CDR
  • منشئ الطلبات التفاعلي للاختبار
  • → دليل بوابة CAMEL

الدعم والموارد​

الوثائق​

أدلة تكوين النواة:

التكامل والمرجع:

آخر تحديث في