OmniEIR

OmniEIR es el Registro de Identidad de Equipos 5G (5G-EIR) para el Núcleo 5G de Omnitouch. Responde a una única 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 denegar el servicio a teléfonos robados o prohibidos y hacer cumplir las verificaciones regulatorias 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/grisar el IMEI del operador están provisionadas en OmniHSS (el mismo almacén eir_rule que respalda la interfaz 4G S13), 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)
Resolució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 la regla de OmniHSS al EquipmentStatus 5G:

Acción de regla de OmniHSS	`EquipmentStatus` 5G	Comportamiento del AMF
`whitelist`	`WHITELISTED`	El registro continúa
`greylist`	`GREYLISTED`	El registro continúa (el dispositivo está rastreado, no prohibido)
`blacklist`	`BLACKLISTED`	Registro rechazado: causa 5GMM #5 "PEI no aceptado"
(ninguna regla coincide)	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); no hay superficie de aprovisionamiento separada.
Coincidencia fiel a la especificación - Refleja el orden de verificación de equipos 4G (IMEISV → IMEI → IMSI, la primera coincidencia de regex gana), por lo que un conjunto de reglas gobierna tanto 4G como 5G.
Comportamiento configurable para equipos desconocidos - Fallo-abierto (WHITELISTED) por defecto, coincidiendo con el HSS; se puede configurar como BLACKLISTED para un despliegue de fallo-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/grisar 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",
  hss_api_key: "<Clave API de OmniHSS con rol eir_lookup>",
  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​