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 API
- استخدم هذا إذا كنت تبني تطبيقات USSD (تحقق من الرصيد، إعادة الشحن، إلخ)

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

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

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

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

🧭 أمثلة على توجيه العنوان العالمي

مثال توجيه GT - walkthrough توجيه العنوان العالمي (مطابقة البادئات، تراجع رمز النقطة)
أمثلة متقدمة على توجيه GT - سيناريوهات توجيه GT المتقدمة

بدء سريع

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

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

3. التكوين

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

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

لاختيار دور:

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

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

وضع 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 على عدة منافذ، كل منها يخدم سطحًا مختلفًا:

المنفذ	البروتوكول	يتم تقديمه بواسطة	الغرض
`8087`	HTTPS	ControlPanel (Phoenix)	لوحة معلومات واجهة الويب (TLS مفروض)
`8445`	HTTPS	api_ex	واجهة API حالة JSON (`/api/status`, `/api/m3ua-status`, `/api/routing`, …)
`9090`	HTTP	APIhandler (Plug.Cowboy)	واجهة API عمليات MAP (`/api/*`)، واجهة Swagger (`/swagger`)، مواصفات OpenAPI (`/swagger.json`)، قياسات Prometheus (`/metrics`)
`2905`	SCTP	M3UA/M2PA	نقل الإشارات SS7

الوصول إلى واجهة الويب

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

المراقبة

# عرض قياسات Prometheus
curl http://localhost:9090/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 في الوقت الفعلي
وثائق API تفاعلية - واجهة 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 للتعامل مع جميع SMS MAP
→ دليل مركز SMS

عميل MAP

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

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

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

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

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

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

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

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

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

الوثائق

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

دليل تكوين STP - توجيه نقطة نقل الإشارة
دليل تكوين عميل MAP - عميل بروتوكول MAP
دليل تكوين مركز SMS - توجيه وتسليم SMS
دليل تكوين HLR - قاعدة بيانات المشتركين
دليل تكوين بوابة CAMEL - الشبكة الذكية والفوترة

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

دليل الميزات الشائعة - المكونات المشتركة وواجهة الويب
المرجع الفني - مواصفات البروتوكول
مثال توجيه GT - walkthrough توجيه العنوان العالمي
أمثلة متقدمة على توجيه GT - سيناريوهات توجيه GT المتقدمة

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

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

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

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

🧭 أمثلة على توجيه العنوان العالمي​

بدء سريع​

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

3. التكوين​

4. الوصول إلى واجهة الويب​

هيكل النظام​

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

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

الوصول إلى واجهة الويب​

المراقبة​

السجلات​

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

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

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

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

مركز SMS (SMSc)​

عميل MAP​

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

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

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

الوثائق​