OmniNEF
OmniNEF es la Función de Exposición de Red (NEF) para el núcleo 5G de Omnitouch. Es la puerta de enlace hacia el norte del núcleo: expone de manera segura las capacidades y eventos de la red a funciones de aplicación externas (Application Functions (AFs)) y traduce entre la API hacia el norte orientada al operador y las interfaces basadas en servicios internos (SBI).
El NEF está definido por 3GPP TS 23.501 §6.2.5 y TS 23.502 §5.2.6. Su API hacia el norte para las AFs es la interfaz T8 en 3GPP TS 29.122 y los servicios Nnef en 3GPP TS 29.522. Hacia el sur, impulsa el UDM (TS 29.503), el PCF (TS 29.514) y el UDR (TS 29.519).
OmniNEF proporciona autorización de AF y limitación de solicitudes por AF, registro de NRF como NFType
NEF, y cuatro capacidades hacia el norte: exposición de eventos de monitoreo, provisión de parámetros, sesión de AF con QoS requerida, e influencia de tráfico, todo conectado al UDM/PCF/UDR a través de SBI. Se proporciona retransmisión de notificaciones de informes de eventos de monitoreo de vuelta a la AF (el NEF registra un callback por suscripción con el NF productor, mapea los informes recibidos a unMonitoringNotificationT8 y los reenvía alnotificationDestinationde la AF).
Documentación
- Guía de Operaciones - Arquitectura, las APIs hacia el norte y sus mapeos hacia el sur, puntos finales y operación diaria
- Referencia de Configuración - Cada clave de configuración y variable de entorno, incluyendo el registro de AF anidado
- Métricas y Monitoreo - Lo que se puede observar hoy a través de registros estructurados
- Solución de Problemas - Problemas comunes y sus resoluciones
Descripción General de la Arquitectura
OmniNEF se sitúa entre AFs de terceros no confiables y el núcleo confiable. Cada solicitud hacia el norte es autorizada y limitada por AF, luego se traduce en la operación correspondiente de SBI hacia el UDM, PCF o UDR. El NF del núcleo que atiende la solicitud se resuelve desde el NRF a través de Nnrf_NFDiscovery.
Descripción General de las Funciones
Funcionalidad Principal
- Autorización de AF - Cada solicitud hacia el norte presenta una clave API (token portador o
X-Api-Key). Las claves desconocidas son rechazadas; cada AF está limitada al subconjunto de APIs que puede llamar (TS 23.501 §6.2.5). - Limitación por AF - Una ventana deslizante de un segundo impone un techo de tasa de solicitudes por AF, protegiendo al núcleo de AFs demasiado entusiastas o que se comportan mal.
- Nnef_EventExposure (Eventos de Monitoreo) - Suscripciones de alcanzabilidad, pérdida de conectividad e informes de ubicación, traducidas a
Nudm_EventExposurehacia el UDM (que impulsa el AMF). - Nnef_ParameterProvision - Provisión de parámetros específicos del servicio/comportamiento esperado del UE por parte de la AF, aplicados a través de
Nudm_ParameterProvision(UDM → UDR). - Nnef_AFsessionWithQoS - Una AF solicita QoS para una sesión de datos; el NEF crea una sesión de aplicación en el PCF a través de
Npcf_PolicyAuthorization. - Nnef_TrafficInfluence - Influencia de la AF en el enrutamiento de tráfico, enrutada al PCF para un UE individual o almacenada como
influenceDataen el UDR para un grupo/cualquier UE. - Ciclo de vida de recursos - Cada recurso creado se almacena, es legible (
GET), y se puede eliminar (DELETEdestruye el recurso en el NF del núcleo).
Puntos de Integración
- Funciones de Aplicación (T8 / Nnef) - Consumidores externos de la API hacia el norte.
- NRF (SBI) - OmniNEF se registra como NFType
NEFy envía latidos, y descubre el UDM/PCF/UDR que debe alcanzar. - UDM, PCF, UDR (SBI) - Los NFs productores en los que se traducen las solicitudes hacia el norte.
Resumen de Configuración
Toda la configuración vive bajo la clave de aplicación :omninef. Un subconjunto de claves puede ser sobrescrito por variables de entorno en la configuración de tiempo de ejecución de producción; el mapa anidado af_registry se establece a través del archivo de configuración de la aplicación (o la variable de entorno JSON NEF_AF_REGISTRY). Consulte la Referencia de Configuración para las tablas de parámetros completas.
config :omninef,
sbi_scheme: "http",
sbi_addr: "127.0.0.30",
sbi_port: 7777,
nrf_uri: "http://127.0.0.10:7777",
mcc: "999",
mnc: "70",
heartbeat_interval: 10_000,
af_registry: %{},
default_rate_limit_per_sec: 10
Estructura de Documentación
Por Rol
Operadores y Administradores:
- Comience con la Guía de Operaciones
- Revise Métricas y Monitoreo
- Mantenga a mano Solución de Problemas
Integradores de Sistemas:
- Comience con la Referencia de Configuración
- Revise las secciones de puntos finales y mapeo de la Guía de Operaciones
Por Tema
- Incorporación de una AF: Referencia de Configuración - Registro de AF
- APIs hacia el norte: Guía de Operaciones - APIs hacia el norte
- Mapeos hacia el sur: Guía de Operaciones - Interoperabilidad hacia el sur