OmniEIR

OmniEIR es el Registro de Identidad de Equipos 5G (5G-EIR) para el Núcleo 5G de Omnitouch. Responde a una sola pregunta para el AMF durante el registro: ¿está la identidad del equipo de este dispositivo (PEI/IMEI) en la lista blanca, en la lista negra o en la lista gris? Esto permite al operador negar el servicio a teléfonos robados o prohibidos y hacer cumplir los controles regulatorios de IMEI.

El 5G-EIR está definido por 3GPP TS 23.501 §6.2.16; el AMF lo invoca durante el registro según 3GPP TS 23.502 §4.2.2.2, y el servicio N5g-eir_EquipmentIdentityCheck está especificado en 3GPP TS 29.511.

OmniEIR no tiene su propia base de datos de dispositivos, por diseño. Las reglas de permitir/bloquear/grisear del IMEI del operador se provisionan en OmniHSS (el mismo almacén eir_rule que respalda la interfaz S13 de 4G), y OmniEIR las lee a través de la API REST del HSS y aplica la misma lógica de coincidencia, por lo que un dispositivo prohibido en 4G está prohibido en 5G con un solo conjunto de reglas. Termina TLS en un proxy externo frente al oyente SBI.

Documentación

Guía de Operaciones - Arquitectura, el flujo de verificación de equipos, puntos finales y operación diaria
Referencia de Configuración - Cada clave de configuración y variable de entorno
Métricas y Monitoreo - Lo que es observable hoy (registros estructurados y telemetría)
Solución de Problemas - Problemas comunes y sus resoluciones

Resumen de Arquitectura

OmniEIR se sitúa entre el AMF (que pregunta) y OmniHSS (que tiene las reglas del operador). Se registra con el NRF como NFType 5G_EIR para que el AMF pueda descubrirlo.

El veredicto se mapea directamente desde la acción de regla de OmniHSS al EquipmentStatus de 5G:

Acción de regla de OmniHSS	`EquipmentStatus` de 5G	Comportamiento del AMF
`whitelist`	`WHITELISTED`	El registro continúa
`greylist`	`GREYLISTED`	El registro continúa (el dispositivo es rastreado, no prohibido)
`blacklist`	`BLACKLISTED`	Registro rechazado: causa 5GMM #5 "PEI no aceptado"
(no coincide ninguna regla)	predeterminado configurado (`WHITELISTED`)	Por defecto

Resumen de Características

Funcionalidad Principal

N5g-eir_EquipmentIdentityCheck (Obtener) - GET /n5g-eir-eic/v1/equipment-status?pei={pei}&supi={supi} devolviendo EirResponseData (TS 29.511).
Decisiones respaldadas por HSS - Lee el conjunto de eir_rule del operador desde OmniHSS (GET /api/eir/rule); sin superficie de aprovisionamiento separada.
Coincidencia fiel a la especificación - Refleja el orden de verificación de equipos de 4G (IMEISV → IMEI → IMSI, la primera coincidencia de regex gana), por lo que un conjunto de reglas rige tanto 4G como 5G.
Comportamiento configurable para equipos desconocidos - Abierto por defecto (WHITELISTED), coincidiendo con el HSS; puede configurarse como BLACKLISTED para un despliegue cerrado.

Puntos de Integración

AMF (N5g-eir) - Consulta a OmniEIR durante el registro y actúa según el veredicto.
OmniHSS (REST) - La fuente de verdad para las reglas de permitir/bloquear/grisear IMEI.
NRF (SBI) - OmniEIR se registra como NFType 5G_EIR y envía latidos.

Resumen de Configuración

Toda la configuración se encuentra bajo la clave de aplicación :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"

Consulte la Referencia de Configuración para las tablas completas de parámetros y las claves del lado del AMF (eir_enabled, eir_uri) que activan la verificación.

Documentación​

Resumen de Arquitectura​

Resumen de Características​

Funcionalidad Principal​

Puntos de Integración​

Resumen de Configuración​