OmniNEF
OmniNEF 是 网络暴露功能 (NEF)，用于 Omnitouch 5G 核心。它是核心的北向网关：它安全地向外部 应用功能 (AFs) 暴露网络能力和事件，并在操作员面向的北向 API 和内部服务基础接口 (SBI) 之间进行转换。
NEF 的定义见于 3GPP TS 23.501 §6.2.5 和 TS 23.502 §5.2.6。其面向 AFs 的北向 API 是 3GPP TS 29.122 中的 T8 接口，Nnef 服务在 3GPP TS 29.522 中定义。向南，它驱动 UDM (TS 29.503)、PCF (TS 29.514) 和 UDR (TS 29.519)。
OmniNEF 提供 AF 授权和每个 AF 请求的限流，NRF 注册为 NFType
NEF，以及四个北向能力：监控事件暴露、参数配置、具有所需 QoS 的 AF 会话和流量影响，所有这些都通过 SBI 连接到 UDM/PCF/UDR。通知中继 监控事件报告返回给 AF（NEF 为每个订阅注册回调与生产者 NF，映射接收到的报告到 T8MonitoringNotification，并将其转发到 AF 的notificationDestination）也得到了提供。
文档
- 操作指南 - 架构、北向 API 及其南向映射、端点和日常操作
- 配置参考 - 每个配置键和环境变量，包括嵌套的 AF 注册表
- 指标和监控 - 通过结构化日志今天可以观察到的内容
- 故障排除 - 常见问题及其解决方案
架构概述
OmniNEF 位于不受信任的第三方 AFs 和受信任的核心之间。每个北向请求都经过授权和每个 AF 的限流，然后转换为相应的 SBI 操作，向 UDM、PCF 或 UDR。服务该请求的核心 NF 通过 Nnrf_NFDiscovery 从 NRF 中解析。
功能概述
核心功能
- AF 授权 - 每个北向请求都提供一个 API 密钥（承载令牌或
X-Api-Key）。未知密钥会被拒绝；每个 AF 的访问范围限于其可以调用的 API 子集 (TS 23.501 §6.2.5)。 - 每个 AF 限流 - 滑动的一秒窗口强制执行每个 AF 的请求速率上限，保护核心免受过于积极或行为不当的 AF 的影响。
- Nnef_EventExposure (监控事件) - 可达性、连接丢失和位置报告订阅，转换为
Nudm_EventExposure以向 UDM 发送（驱动 AMF）。 - Nnef_ParameterProvision - AF 提供预期 UE 行为/服务特定参数，通过
Nudm_ParameterProvision应用（UDM → UDR）。 - Nnef_AFsessionWithQoS - AF 请求数据会话的 QoS；NEF 通过
Npcf_PolicyAuthorization在 PCF 创建应用会话。 - Nnef_TrafficInfluence - AF 对流量路由的影响，路由到 PCF 以供单个 UE 使用，或作为
influenceData存储在 UDR 中以供一组/任意 UE 使用。 - 资源生命周期 - 每个创建的资源都是可存储、可读取（
GET）和可删除的（DELETE在核心 NF 中拆除资源）。
集成点
- 应用功能 (T8 / Nnef) - 北向 API 的外部消费者。
- NRF (SBI) - OmniNEF 注册为 NFType
NEF并进行心跳，发现必须到达的 UDM/PCF/UDR。 - UDM、PCF、UDR (SBI) - 北向请求转换到的生产者 NF。
配置摘要
所有配置都位于 :omninef 应用键下。生产运行时配置中，部分键可以通过环境变量覆盖；嵌套的 af_registry 映射通过应用配置文件（或 NEF_AF_REGISTRY JSON 环境变量）设置。请参见 配置参考 以获取完整的参数表。
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
文档结构
按角色
操作员和管理员：
系统集成商：
按主题
- 为 AF 上线： 配置参考 - AF 注册表
- 北向 API： 操作指南 - 北向 API
- 南向映射： 操作指南 - 南向互通