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

واجهة Sh (استرجاع بيانات المشتركين)

📖 العودة إلى الوثائق الرئيسية

تتيح واجهة Sh الوصول إلى بيانات ملف تعريف المشترك من HSS/Repository عبر Diameter.

الوثائق ذات الصلة​

الوثائق الأساسية​

تكامل معالجة المكالمات​

الواجهات ذات الصل��​

المراقبة​

واجهة Sh (استرجاع بيانات المشتركين)​

تُستخدم واجهة Sh لاسترجاع بيانات ملف تعريف المشترك من HSS/Repository قبل معالجة المكالمات. تشمل هذه البيانات هويات المشتركين والخدمات وتكوين MMTel.

ما هي واجهة Sh؟​

واجهة Sh هي واجهة Diameter موحدة من قبل 3GPP بين TAS و HSS/Repository (Repo). توفر وصولًا في الوقت الفعلي إلى:

  • هويات مشترك IMS (IMPI/IMPU)
  • إعدادات إعادة توجيه المكالمات (MMTel-Config)
  • تفويض خدمة المشترك
  • تعيين S-CSCF

متى تحدث عمليات البحث في Sh​

تحدث عمليات البحث في Sh على:

  • مكالمات MT: البحث عن الطرف المتصل به (المشترك الوجهة)
  • مكالمات MO: البحث عن الطرف المتصل (المشترك المصدر)
  • المكالمات الطارئة: البحث عن الطرف المتصل (للموقع/الهوية)

البيانات المسترجعة من واجهة Sh​

يستعلم TAS عن Sh-User-Data الذي يعيد مستند XML يحتوي على:

1. هويات IMS:

  • IMPI (الهوية الخاصة): username@domain - تُستخدم للمصادقة
    • التنسيق: {IMSI}@ims.mnc{MNC}.mcc{MCC}.3gppnetwork.org
    • المثال: 505014001234567@ims.mnc001.mcc505.3gppnetwork.org
  • IMPU (الهوية العامة): sip:+number@domain - تُستخدم للتوجيه
    • التنسيق: sip:+{MSISDN}@ims.mnc{MNC}.mcc{MCC}.3gppnetwork.org
    • المثال: sip:+61403123456@ims.mnc001.mcc505.3gppnetwork.org

2. تعيين S-CSCF:

  • اسم خادم S-CSCF والنطاق الذي تم تسجيل المشترك فيه
  • يُستخدم لتوجيه المكالمات داخل الشبكة إلى نواة IMS

3. خدمات MMTel (تكوين الهاتف متعدد الوسائط):

  • إعادة توجيه المكالمات الكل (CFA): إعادة توجيه غير مشروط إلى رقم آخر
  • إعادة توجيه المكالمات عند الانشغال (CFB): إعادة التوجيه عندما يكون المشترك مشغولًا
  • إعادة توجيه المكالمات عند عدم الرد (CFNRy): إعادة التوجيه بعد انتهاء المهلة (يشمل قيمة المؤقت)
  • إعادة توجيه المكالمات عند عدم الوصول (CFNRc): إعادة التوجيه عندما يكون المشترك غير متصل/غير مسجل

ما هو MMTel-Config؟​

MMTel-Config هو تكوين خدمة الهاتف متعدد الوسائط للمشترك المخزن في HSS/Repository. يحتوي على:

<MMTelSS>
  <CDIV>
    <SS-ActivationState>active</SS-ActivationState>
    <Ruleset>
      <Rule>
        <RuleCondition>communication-diverted</RuleCondition>
        <ForwardTo>+61403555123</ForwardTo>
        <NotificationType>notify</NotificationType>
      </Rule>
    </Ruleset>
  </CDIV>
</MMTelSS>

خدمات MMTel الشائعة:

  • CDIV (تحويل الاتصال): قواعد إعادة توجيه المكالمات
  • OIP (عرض الهوية الأصلية): قواعد عرض هوية المتصل
  • TIP (عرض الهوية النهائية): قواعد رقم الطرف المتصل

متغيرات خطة الاتصال التي تم تعيينها من بيانات Sh​

بعد عملية بحث ناجحة في Sh، يتم تعبئة هذه المتغيرات:

المتغيرالمصدرقيمة المثالالوصف
ims_private_identityIMPI505014001234567@ims.domainالهوية الخاصة للمستخدم للمصادقة
ims_public_identityIMPUsip:+61403123456@ims.domainالهوية العامة للمستخدم للتوجيه
msisdnIMPU (محلل)61403123456رقم المشترك (+ تمت إزالته)
imsiIMPI (محلل)505014001234567IMSI من الهوية الخاصة
ims_domainIMPI/IMPUims.mnc001.mcc505.3gppnetwork.orgنطاق IMS
scscf_addressاسم S-CSCFscscf01.ims.domain أو "none"عنوان خادم S-CSCF
scscf_domainنطاق S-CSCFims.domain أو "none"نطاق S-CSCF
call_forward_all_destinationMMTel CDIV61403555123 أو "none"رقم وجهة CFA
call_forward_not_reachable_destinationMMTel CDIV2222 أو القيمة الافتراضية للتكوينوجهة CFNRc (البريد الصوتي)
no_reply_timerMMTel CDIV30 أو القيمة الافتراضية للتكوينالمهلة قبل تفعيل CFNRy

الأولوية: بيانات Sh مقابل القيم الافتراضية للتكوين​

يستخدم TAS هذه الأولوية لبيانات إعادة توجيه المكالمات:

  1. MMTel-Config من Sh (أعلى أولوية - إعدادات خاصة بالمشترك)
  2. بيانات HLR من SS7 MAP (تتجاوز Sh لمكالمات MT إذا كانت التجوال/إعادة التوجيه نشطة)
  3. القيم الافتراضية للتكوين (أدنى أولوية - تُستخدم عندما لا تتوفر بيانات Sh)

مثال:

# القيم الافتراضية للتكوين (تستخدم فقط إذا لم يعد Sh أي MMTel-Config)
config :tas,
  call_forward_not_reachable_destination: "2222",  # البريد الصوتي
  default_no_reply_timer: 30

ماذا يحدث عندما تفشل عملية البحث في Sh​

سيناريوهات الفشل:

  1. المشترك غير موفر في HSS:

    • تعيد Sh خطأ "المستخدم غير معروف"
    • يتم تعيين متغير hangup_case إلى "UNALLOCATED_NUMBER"
    • يتم رفض المكالمة مع استجابة SIP المناسبة

  2. HSS غير متاح / انتهاء المهلة:

    • تنتهي مهلة طلب Sh (الافتراضي: 5000 مللي ثانية)
    • يتم تسجيل الخطأ وتوثيق القياس
    • قد يتم رفض المكالمة أو توجيهها بالقيم الافتراضية (حسب النشر)

  3. لا يوجد MMTel-Config في الاستجابة:

    • المشترك موجود ولكن ليس لديه إعادة توجيه مكالمات مكونة
    • تُستخدم القيم الافتراضية للتكوين لوجهة call_forward_not_reachable_destination و no_reply_timer
    • تستمر المكالمة بشكل طبيعي بالقيم الافتراضية

مراقبة واجهة Sh​

المقاييس الرئيسية:

# معدل نجاح البحث في Sh
rate(subscriber_data_lookups_total{result="success"}[5m]) /
rate(subscriber_data_lookups_total[5m]) * 100

# زمن استجابة البحث في Sh (P95)
histogram_quantile(0.95,
  rate(subscriber_data_duration_milliseconds_bucket[5m]))

# معدل أخطاء البحث في Sh
rate(subscriber_data_lookups_total{result="error"}[5m])

عتبات التنبيه:

  • زمن الاستجابة P95 > 100 مللي ثانية: استجابات HSS بطيئة
  • معدل الأخطاء > 5%: مشاكل في الاتصال بـ HSS
  • معدل الأخطاء > 20%: فشل حرج في HSS

استكشاف الأخطاء:

  1. تحقق من حالة نظير Diameter في واجهة الويب (/diameter)
  2. اختبار البحث في Sh في واجهة الويب (/sh_test) مع مشترك معروف
  3. مراجعة السجلات للبحث عن أخطاء "بيانات المشترك"
  4. تحقق من أن HSS/Repository متاحة من TAS
  5. تحقق من قياس subscriber_data_lookups_total للأنماط

اختبار واجهة Sh​

استخدم أداة اختبار Sh في واجهة الويب (/sh_test):

  1. انتقل إلى /sh_test في لوحة التحكم
  2. أدخل MSISDN الخاص بالمشترك (مثل +61403123456)
  3. انقر على "استعلام Sh"
  4. مراجعة البيانات المسترجعة:
    • هويات IMPI/IMPU
    • تعيين S-CSCF
    • خدمات MMTel
    • تكوين إعادة توجيه المكالمات

سيناريوهات الاختبار الشائعة:

  • تحقق من أن المشتركين الجدد الموفرين موجودون في HSS
  • تحقق من إعدادات إعادة توجيه المكالمات لمشترك محدد
  • تحقق من تعيين S-CSCF بعد تسجيل IMS
  • اختبار الاتصال بـ HSS وأوقات الاستجابة