OmniNEF

OmniNEF est la Network Exposure Function (NEF) pour le cœur 5G Omnitouch. C'est la passerelle nord du cœur : elle expose en toute sécurité les capacités et événements du réseau aux Application Functions (AFs) externes et traduit entre l'API nord orientée opérateur et les interfaces basées sur les services internes (SBI).

Le NEF est défini par 3GPP TS 23.501 §6.2.5 et TS 23.502 §5.2.6. Son API nord vers les AFs est l'interface T8 dans 3GPP TS 29.122 et les services Nnef dans 3GPP TS 29.522. En direction sud, elle gère le UDM (TS 29.503), le PCF (TS 29.514) et le UDR (TS 29.519).

OmniNEF fournit l'autorisation des AF et le throttling par demande par AF, l'enregistrement NRF en tant que NFType NEF, et quatre capacités nord : l'exposition d'événements de surveillance, la provision de paramètres, la session AF avec QoS requise, et l'influence sur le trafic, toutes connectées au UDM/PCF/UDR via SBI. Le relais de notification des rapports d'événements de surveillance vers l'AF (le NEF enregistre un rappel par abonnement avec le NF producteur, associe les rapports reçus à un MonitoringNotification T8 et les transfère à la notificationDestination de l'AF) est fourni.

Documentation

Guide des opérations - Architecture, les APIs nord et leurs mappages sud, points de terminaison et opérations quotidiennes
Référence de configuration - Chaque clé de configuration et variable d'environnement, y compris le registre AF imbriqué
Métriques et surveillance - Ce qui est observable aujourd'hui à travers des journaux structurés
Dépannage - Problèmes courants et leurs résolutions

Vue d'ensemble de l'architecture

OmniNEF se situe entre les AFs tiers non fiables et le cœur de confiance. Chaque demande nord est autorisée et throttlée par AF, puis traduite en l'opération SBI correspondante vers le UDM, PCF ou UDR. Le NF du cœur qui sert la demande est résolu à partir du NRF via Nnrf_NFDiscovery.

Vue d'ensemble des fonctionnalités

Fonctionnalité principale

Autorisation AF - Chaque demande nord présente une clé API (jeton porteur ou X-Api-Key). Les clés inconnues sont rejetées ; chaque AF est limitée au sous-ensemble d'APIs qu'elle peut appeler (TS 23.501 §6.2.5).
Throttling par AF - Une fenêtre glissante d'une seconde impose un plafond de taux de demande par AF, protégeant le cœur des AFs trop enthousiastes ou mal comportés.
Nnef_EventExposure (Événements de surveillance) - Abonnements à la connectivité, à la perte de connectivité et au rapport de localisation, traduits en Nudm_EventExposure vers le UDM (qui gère l'AMF).
Nnef_ParameterProvision - Provisionnement AF des paramètres de comportement attendu de l'UE / spécifiques au service, appliqués via Nudm_ParameterProvision (UDM → UDR).
Nnef_AFsessionWithQoS - Un AF demande QoS pour une session de données ; le NEF crée une session d'application au PCF via Npcf_PolicyAuthorization.
Nnef_TrafficInfluence - Influence de l'AF sur le routage du trafic, routée vers le PCF pour un UE individuel ou stockée en tant que influenceData dans le UDR pour un groupe / tout UE.
Cycle de vie des ressources - Chaque ressource créée est stockée, lisible (GET), et supprimable (DELETE détruit la ressource dans le NF du cœur).

Points d'intégration

Application Functions (T8 / Nnef) - Consommateurs externes de l'API nord.
NRF (SBI) - OmniNEF s'enregistre en tant que NFType NEF et envoie des heartbeats, et découvre le UDM/PCF/UDR qu'il doit atteindre.
UDM, PCF, UDR (SBI) - Les NFs producteurs sur lesquels les demandes nord sont traduites.

Résumé de la configuration

Toute la configuration se trouve sous la clé d'application :omninef. Un sous-ensemble de clés peut être remplacé par des variables d'environnement dans la configuration d'exécution en production ; la carte imbriquée af_registry est définie via le fichier de configuration de l'application (ou la variable d'environnement JSON NEF_AF_REGISTRY). Voir la Référence de configuration pour les tables de paramètres complètes.

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

Structure de la documentation

Par rôle

Opérateurs et Administrateurs :

Commencez par le Guide des opérations
Consultez Métriques et surveillance
Gardez Dépannage à portée de main

Intégrateurs système :

Commencez par la Référence de configuration
Consultez les sections des points de terminaison et des mappages du Guide des opérations

Par sujet

Intégration d'un AF : Référence de configuration - Registre AF
APIs nord : Guide des opérations - APIs nord
Mappages sud : Guide des opérations - Interopérabilité sud

Documentation​

Vue d'ensemble de l'architecture​

Vue d'ensemble des fonctionnalités​

Fonctionnalité principale​

Points d'intégration​

Résumé de la configuration​

Structure de la documentation​

Par rôle​

Par sujet​