OmniEIR

OmniEIR هو سجل هوية معدات 5G (5G-EIR) لنواة Omnitouch 5G. يجيب على سؤال واحد لـ AMF أثناء التسجيل: هل هوية معدات هذا الجهاز (PEI/IMEI) مدرجة في القائمة البيضاء، أو السوداء، أو الرمادية؟ هذا يسمح للمشغل برفض الخدمة للأجهزة المسروقة أو المحظورة وفرض فحوصات IMEI التنظيمية.

تم تعريف 5G-EIR بواسطة 3GPP TS 23.501 §6.2.16؛ يستدعي AMF ذلك أثناء التسجيل وفقًا لـ 3GPP TS 23.502 §4.2.2.2، و يتم تحديد خدمة N5g-eir_EquipmentIdentityCheck في 3GPP TS 29.511.

يحتفظ OmniEIR بعدم وجود قاعدة بيانات للأجهزة خاصة به، حسب التصميم. يتم توفير قواعد السماح/الحظر/الرمادي لـ IMEI الخاصة بالمشغل في OmniHSS (نفس متجر eir_rule الذي يدعم واجهة 4G S13)، ويقرأ OmniEIR هذه القواعد عبر واجهة HSS REST API ويطبق نفس منطق المطابقة، لذا فإن الجهاز المحظور على 4G محظور على 5G بمجموعة واحدة من القواعد. إنهاء TLS عند وكيل خارجي أمام مستمع SBI.

الوثائق

دليل العمليات - الهندسة المعمارية، تدفق فحص المعدات، النقاط النهائية، والعمليات اليومية
مرجع التكوين - كل مفتاح تكوين ومتغير بيئي
المقاييس والمراقبة - ما يمكن ملاحظته اليوم (السجلات المنظمة والقياسات)
استكشاف الأخطاء وإصلاحها - المشكلات الشائعة وحلولها

نظرة عامة على الهندسة المعمارية

يجلس OmniEIR بين AMF (الذي يسأل) و OmniHSS (الذي يحتفظ بقواعد المشغل). يسجل مع NRF كـ NFType 5G_EIR حتى يتمكن AMF من اكتشافه.

تتوافق النتيجة مباشرة من إجراء قاعدة OmniHSS إلى EquipmentStatus 5G:

إجراء قاعدة OmniHSS	5G `EquipmentStatus`	سلوك AMF
`whitelist`	`WHITELISTED`	يستمر التسجيل
`greylist`	`GREYLISTED`	يستمر التسجيل (يتم تتبع الجهاز، وليس محظورًا)
`blacklist`	`BLACKLISTED`	تم رفض التسجيل: سبب 5GMM #5 "PEI غير مقبول"
(لا توجد قاعدة مطابقة)	الافتراضي المكون (`WHITELISTED`)	حسب الافتراضي

نظرة عامة على الميزات

الوظائف الأساسية

N5g-eir_EquipmentIdentityCheck (Get) - GET /n5g-eir-eic/v1/equipment-status?pei={pei}&supi={supi} تعيد EirResponseData (TS 29.511).
قرارات مدعومة من HSS - تقرأ مجموعة eir_rule الخاصة بالمشغل من OmniHSS (GET /api/eir/rule)؛ لا توجد واجهة توفير منفصلة.
مطابقة وفية للمواصفات - تعكس ترتيب فحص المعدات 4G (IMEISV → IMEI → IMSI، أول تطابق regex يفوز)، لذا تحكم مجموعة واحدة من القواعد كل من 4G و 5G.
سلوك المعدات غير المعروفة القابل للتكوين - فشل مفتوح (WHITELISTED) بشكل افتراضي، يتطابق مع HSS؛ يمكن تعيينه إلى BLACKLISTED لنشر مغلق.

نقاط التكامل

AMF (N5g-eir) - يستفسر OmniEIR أثناء التسجيل ويتصرف بناءً على النتيجة.
OmniHSS (REST) - مصدر الحقيقة لقواعد السماح/الحظر/الرمادي لـ IMEI.
NRF (SBI) - يسجل OmniEIR كـ NFType 5G_EIR ويقوم بإرسال نبضات.

ملخص التكوين

تعيش جميع التكوينات تحت مفتاح التطبيق :omnieir.

config :omnieir,
  sbi_scheme: "http",
  sbi_addr: "127.0.0.23",
  sbi_port: 7777,
  nrf_uri: "http://127.0.0.10:7777",
  mcc: "999",
  mnc: "70",
  heartbeat_interval: 10_000,
  hss_api_base_url: "https://127.0.0.1:8443",
  unknown_equipment_status: "WHITELISTED"

انظر إلى مرجع التكوين للحصول على جداول المعلمات الكاملة ومفاتيح جانب AMF (eir_enabled, eir_uri) التي تقوم بتشغيل الفحص.

الوثائق​

نظرة عامة على الهندسة المعمارية​

نظرة عامة على الميزات​

الوظائف الأساسية​

نقاط التكامل​

ملخص التكوين​