Pular para o conteúdo principal

OmniNEF

OmniNEF é a Função de Exposição de Rede (NEF) para o Omnitouch 5G Core. É o gateway norte do núcleo: expõe com segurança as capacidades e eventos da rede para funções de aplicação externas (Application Functions (AFs)) e traduz entre a API norte voltada para o operador e as interfaces baseadas em serviço internas (SBI).

O NEF é definido pelo 3GPP TS 23.501 §6.2.5 e TS 23.502 §5.2.6. Sua API norte em direção às AFs é a interface T8 em 3GPP TS 29.122 e os serviços Nnef em 3GPP TS 29.522. Em direção sul, ele controla o UDM (TS 29.503), o PCF (TS 29.514) e o UDR (TS 29.519).

OmniNEF fornece autorização de AF e limitação de requisições por AF, registro NRF como NFType NEF, e quatro capacidades norte: exposição de eventos de monitoramento, provisionamento de parâmetros, sessão de AF com QoS requerida, e influência de tráfego, todas conectadas ao UDM/PCF/UDR via SBI. Encaminhamento de notificações de relatórios de eventos de monitoramento de volta para a AF (o NEF registra um callback por assinatura com o NF produtor, mapeia os relatórios recebidos para um MonitoringNotification T8 e os encaminha para o notificationDestination da AF) é fornecido.

Documentação​

Visão Geral da Arquitetura​

OmniNEF está entre AFs de terceiros não confiáveis e o núcleo confiável. Cada requisição norte é autorizada e limitada por AF, e então traduzida na operação correspondente de SBI em direção ao UDM, PCF ou UDR. O NF do núcleo que atende à requisição é resolvido a partir do NRF via Nnrf_NFDiscovery.

Visão Geral das Funcionalidades​

Funcionalidade Principal​

  • Autorização de AF - Cada requisição norte apresenta uma chave de API (token de portador ou X-Api-Key). Chaves desconhecidas são rejeitadas; cada AF é limitada ao subconjunto de APIs que pode chamar (TS 23.501 §6.2.5).
  • Limitação por AF - Uma janela deslizante de um segundo impõe um teto de taxa de requisição por AF, protegendo o núcleo de AFs excessivamente ansiosos ou mal comportados.
  • Nnef_EventExposure (Eventos de Monitoramento) - Assinaturas de conectividade, perda de conectividade e relatório de localização, traduzidas para Nudm_EventExposure em direção ao UDM (que controla o AMF).
  • Nnef_ParameterProvision - Provisionamento de AF de parâmetros de comportamento esperado do UE / específicos de serviço, aplicados via Nudm_ParameterProvision (UDM → UDR).
  • Nnef_AFsessionWithQoS - Uma AF solicita QoS para uma sessão de dados; o NEF cria uma sessão de aplicação no PCF via Npcf_PolicyAuthorization.
  • Nnef_TrafficInfluence - Influência da AF no roteamento de tráfego, roteada para o PCF para um UE individual ou armazenada como influenceData no UDR para um grupo / qualquer-UE.
  • Ciclo de vida de recursos - Cada recurso criado é armazenado, legível (GET), e deletável (DELETE remove o recurso no NF do núcleo).

Pontos de Integração​

  • Funções de Aplicação (T8 / Nnef) - Consumidores externos da API norte.
  • NRF (SBI) - OmniNEF se registra como NFType NEF e envia heartbeat, e descobre o UDM/PCF/UDR que deve alcançar.
  • UDM, PCF, UDR (SBI) - Os NFs produtores para os quais as requisições norte são traduzidas.

Resumo da Configuração​

Toda a configuração reside sob a chave de aplicação :omninef. Um subconjunto de chaves pode ser substituído por variáveis de ambiente na configuração de tempo de execução de produção; o mapa aninhado af_registry é definido através do arquivo de configuração da aplicação (ou pela variável de ambiente JSON NEF_AF_REGISTRY). Veja a Referência de Configuração para as tabelas completas de parâmetros.

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

Estrutura da Documentação​

Por Função​

Operadores e Administradores:

  1. Comece com o Guia de Operações
  2. Revise Métricas e Monitoramento
  3. Mantenha Solução de Problemas à mão

Integradores de Sistema:

  1. Comece com a Referência de Configuração
  2. Revise as seções de endpoint e mapeamento do Guia de Operações

Por Tópico​

Última atualização em