OmniEIR

OmniEIR هو سجل هوية معدات الجيل الخامس (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 كنوع NF 5G_EIR حتى يتمكن AMF من اكتشافه.

تتطابق النتيجة مباشرة من إجراء قاعدة OmniHSS إلى EquipmentStatus الجيل الخامس:

إجراء قاعدة 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 كنوع NF 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",
  hss_api_key: "<OmniHSS API key with role eir_lookup>",
  unknown_equipment_status: "WHITELISTED"

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

الوثائق​

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

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

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

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

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