> For the complete documentation index, see [llms.txt](https://docs.gxc.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gxc.io/docs/application-notes/4g-and-5g-onyx-networking-modes.md).

# 4G & 5G Onyx Networking Modes

## Introduction

This document explains the networking modes supported by the GXC 4G and 5G Onyx Platforms and their applicability to different enterprise network architectures. This application note focuses on Onyx Edge On-Premises deployments.

The Onyx Platform is a flexible system designed to support multiple deployment modes, enabling enterprises to integrate private cellular networks with their existing infrastructure. Understanding these networking modes is essential to ensure proper connectivity, maintain security, and achieve seamless integration with enterprise networks.

## Networking Modes

The Onyx Platform supports multiple networking modes that determine how the Onyx Edge integrates with enterprise networks and how it manages UE and AP/FHM traffic. Each mode varies in its balance of security, visibility, operational complexity, and integration requirements. Selecting the correct mode allows enterprises to meet their architectural, security, scalability, and management objectives.

The networking modes described in this document align with standard 3GPP EPC (4G) and 5GC (5G) architectures and common deployment practices.

### 4G Networking Modes

The Onyx 4G Platform supports the following networking modes:

* [*4G NAT Modes*](#4g-nat-modes)
  * [*4G NAT Classic Mode*](#4g-nat-classic-mode)
  * [*4G NAT Flat Mode*](#4g-nat-flat-mode)
* [*4G Bridge (APN-on-VLAN) Modes*](#4g-bridge-apn-on-vlan-modes)
  * [*4G Bridge (APN-on-VLAN) Classic Mode*](#4g-bridge-apn-on-vlan-classic-mode)
  * [*4G Bridge (APN-on-VLAN) Flat Mode*](#4g-bridge-apn-on-vlan-flat-mode)

#### 4G NAT Modes

In the 4G NAT modes, the Onyx Edge acts as a secure gateway and applies Network Address Translation (NAT) to UE traffic before forwarding it to the enterprise network. The Onyx Edge assigns private IP addresses to UE from its local pool, while the enterprise network sees only the Onyx Edge's NAT IP address. This mode provides simple IP management and strong isolation between enterprise systems and UE. NAT modes are ideal for enterprises prioritizing security and privacy over direct device visibility.

**4G NAT Classic Mode**

<p align="center"><strong>4G NAT Classic Mode Topology</strong></p>

<div data-with-frame="true"><figure><img src="https://4071075005-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZc9hpHmiTCrh1sn4mWXn%2Fuploads%2F3NA10YBDFIUyjagkTcNH%2F4g-nat-classic-mode.png?alt=media&amp;token=82ac31c7-67de-447e-85d3-e6607e33dc24" alt=""><figcaption></figcaption></figure></div>

In the 4G NAT Classic mode, APs connect to the Onyx Edge via a dedicated private interface (eth1), isolated from the enterprise network. The Onyx Edge assigns IP addresses to both UE (from its local pool) and APs (via its DHCP service). NAT applied on the SGi interface (eth0) provides strong network isolation — the enterprise LAN sees only the Onyx Edge's NAT IP address and cannot directly access APs or UE. This dual-interface architecture ensures separation between RAN and enterprise traffic.

**4G NAT Flat Mode**

<p align="center"><strong>4G NAT Flat Mode Topology</strong></p>

<div data-with-frame="true"><figure><img src="https://4071075005-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZc9hpHmiTCrh1sn4mWXn%2Fuploads%2Fgu18AnwAwSLOgCcdCCXw%2F4g-nat-flat-mode.png?alt=media&amp;token=5c2852b6-98fc-4aa4-b66e-6b76f420e6e4" alt=""><figcaption></figcaption></figure></div>

In the 4G NAT Flat mode, APs connect to the Onyx Edge via the enterprise LAN. The Onyx Edge assigns IP addresses to UE from its local pool and applies NAT to UE traffic before forwarding to the enterprise network. Enterprise DHCP service assigns IP addresses to APs. The Onyx Edge uses a single interface (eth0) for both SGi and S1 traffic. This mode uses a single-interface topology where both S1 control and SGi user-plane traffic share eth0. This simplifies small-site deployments where enterprise switch VLAN support may not be available. However, network isolation is weaker compared to Classic mode as APs reside on the enterprise subnet. NAT provides protection for UE, which are not directly accessible from the enterprise network without additional configuration.

**4G NAT Modes Comparison**

Each mode offers different trade-offs between ease of deployment, visibility, isolation, and enterprise integration. The following table summarizes their characteristics for deployment considerations.

<p align="center"><strong>Onyx 4G NAT Modes Comparison</strong></p>

<table><thead><tr><th width="200" valign="top"></th><th valign="top">4G NAT Classic Mode</th><th valign="top">4G NAT Flat Mode</th></tr></thead><tbody><tr><td valign="top"><strong>Architecture</strong></td><td valign="top">NAT gateway model with dual-interface design. Onyx Edge acts as secure gateway, applying NAT to all UE traffic before forwarding to the enterprise network. AP traffic terminates at the Onyx Edge. Provides complete isolation between RAN and enterprise networks.</td><td valign="top">NAT gateway model with single-interface design. Onyx Edge acts as gateway for UE traffic only, applying NAT before forwarding to enterprise network. APs share enterprise network infrastructure.</td></tr><tr><td valign="top"><strong>Traffic Flow</strong></td><td valign="top"><p>UE traffic: UE > AP > Onyx Edge (NAT applied) > enterprise network via eth0.</p><p>AP traffic: APs > Onyx Edge eth1 (private interface) > Onyx Edge eth0 > enterprise network. Complete separation of RAN and enterprise traffic paths.</p></td><td valign="top"><p>UE traffic: UE > AP > Onyx Edge (NAT applied) > enterprise network via eth0.</p><p>AP traffic: APs > enterprise network > Onyx Edge eth0. Both UE and AP traffic share a single interface (eth0), doubling interface load.</p></td></tr><tr><td valign="top"><strong>IP Address Management</strong></td><td valign="top">Onyx Edge assigns IP addresses to UE from its local pool. Onyx Edge assigns IP addresses to APs via its DHCP service. Enterprise network sees only the Onyx Edge's NAT IP address.</td><td valign="top">Onyx Edge assigns IP addresses to UE from its local pool. Enterprise DHCP service assigns IP addresses to APs. Enterprise network sees only the Onyx Edge's NAT IP address for UE traffic.</td></tr><tr><td valign="top"><strong>Network Isolation</strong></td><td valign="top">Strong isolation. APs and UE are completely isolated from the enterprise network behind NAT. APs can only communicate with the Onyx Edge via dedicated private interface. Enterprise devices cannot directly access RAN infrastructure or UE.</td><td valign="top">Weaker isolation. UE are hidden behind NAT, but APs reside on enterprise subnet where they can be accessed by other enterprise devices. Creates higher security risk for RAN infrastructure. Enterprise cannot directly access UE.</td></tr><tr><td valign="top"><strong>Interfaces</strong></td><td valign="top">Dual interfaces provide physical separation: eth1 (dedicated private interface for S1/AP connections) and eth0 (SGi interface connecting to enterprise network). Ensures predictable and controlled traffic separation.</td><td valign="top">Single interface handles all traffic: eth0 handles both SGi (UE traffic) and S1 (AP control) traffic. Simplifies cabling but combines RAN control and user plane traffic.</td></tr><tr><td valign="top"><strong>APN/VLAN Integration</strong></td><td valign="top">No APN-to-VLAN mapping. All UE traffic from different APNs is collapsed behind NAT and appears as single Onyx Edge IP address on the enterprise network. No VLAN segmentation required.</td><td valign="top">Same as 4G NAT Classic Mode.</td></tr><tr><td valign="top"><strong>Deployment Complexity</strong></td><td valign="top">Straightforward setup with clear network boundaries. Requires basic IP planning and dual network interfaces on the Onyx Edge. No enterprise VLAN coordination required.</td><td valign="top">Requires coordination with enterprise networking team to ensure APs can access enterprise DHCP and routing services. May need firewall rules to allow AP connectivity.</td></tr><tr><td valign="top"><strong>Best For</strong></td><td valign="top">Recommended for most deployments. Ideal for enterprises prioritizing security, isolation, and predictable performance. Suitable for medium to large sites. Provides best balance of control, security, and scalability.</td><td valign="top">Small sites or "quick-start" deployments where enterprise switch VLAN support is not available. Suitable for temporary installations or pilot programs where simplified cabling is prioritized over security.</td></tr><tr><td valign="top"><strong>Cautions</strong></td><td valign="top">Requires proper IP address planning to avoid conflicts. UE remain invisible to enterprise monitoring and management tools. Inbound access to UE is not possible without port forwarding configuration.</td><td valign="top">eth0 must carry both S1 control and SGi user-plane traffic, which may reduce effective throughput under high load. Capacity planning should account for combined traffic on a single interface. APs exposed on enterprise subnet. Harder to isolate RAN infrastructure.</td></tr></tbody></table>

#### 4G Bridge (APN-on-VLAN) Modes

The 4G Bridge modes provide direct enterprise integration by bridging UE traffic into enterprise VLANs without NAT. Each APN is mapped to a dedicated VLAN, enabling the enterprise network to assign IP addresses and apply security, QoS, and routing policies per VLAN. Unlike the NAT modes where UE are hidden behind the Onyx Edge IP address, Bridge modes make UE directly accessible as native enterprise devices, with IP addresses assigned by the enterprise DHCP service per VLAN. Bridge modes are ideal for enterprises requiring per-APN traffic segregation, full device visibility, and integrated policy enforcement.

**4G Bridge (APN-on-VLAN) Classic Mode**

<p align="center"><strong>4G Bridge Classic Mode Topology</strong></p>

<div data-with-frame="true"><figure><img src="https://4071075005-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZc9hpHmiTCrh1sn4mWXn%2Fuploads%2FGiVR31oubHIR4U1snQbz%2F4g-bridge-classic-mode.png?alt=media&amp;token=b1bb15d3-c1d7-4fc5-934f-b671b100efc5" alt=""><figcaption></figcaption></figure></div>

In the 4G Bridge Classic mode, APs connect to the Onyx Edge via a dedicated private interface (eth1), isolated from the enterprise network. The Onyx Edge bridges UE data traffic directly into enterprise VLANs without applying NAT. Each APN is mapped to a dedicated VLAN, allowing traffic segregation and policy enforcement. Enterprise DHCP service assigns IP addresses to UE per VLAN, making them directly accessible as native enterprise devices. The Onyx Edge assigns IP addresses to APs via its own DHCP service on eth1. The eth0 interface is configured as a VLAN trunk to carry tagged UE traffic to the enterprise network. This architecture provides strong RAN isolation while enabling full enterprise visibility and control over UE.

**4G Bridge (APN-on-VLAN) Flat Mode**

<p align="center"><strong>4G Bridge Flat Mode Topology</strong></p>

<div data-with-frame="true"><figure><img src="https://4071075005-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZc9hpHmiTCrh1sn4mWXn%2Fuploads%2FpbDSBpxW5GCXS0pq7IXs%2F4g-bridge-flat-mode.png?alt=media&amp;token=885abaaf-123b-4ed2-93a7-858c20d80e82" alt=""><figcaption></figcaption></figure></div>

In the 4G Bridge Flat mode, APs connect to the Onyx Edge via the enterprise LAN. The Onyx Edge bridges UE traffic directly into enterprise VLANs with each APN mapped to a specific VLAN. Enterprise DHCP service assigns IP addresses to both UE (per VLAN) and APs. The Onyx Edge uses a single trunk interface (eth0) for both SGi and S1 traffic, with UE data and AP control traffic sharing the same physical link. However, network isolation is weaker compared to Bridge Classic mode — APs reside on the enterprise subnet where they can be accessed by other enterprise devices — and the eth0 interface must handle both S1 (AP control) and SGi (UE data) traffic, doubling the bandwidth requirements. This mode is suitable for sites requiring APN-to-VLAN mapping where operational simplicity and single-interface architecture are preferred.

**4G Bridge (APN-on-VLAN) Modes Comparison**

Each mode offers different trade-offs between ease of deployment, visibility, isolation, and enterprise integration. The following table summarizes their characteristics for deployment considerations.

<p align="center"><strong>4G Bridge (APN-on-VLAN) Modes Comparison</strong></p>

<table><thead><tr><th width="200" valign="top"></th><th valign="top">4G Bridge Classic Mode</th><th valign="top">4G Bridge Flat Mode</th></tr></thead><tbody><tr><td valign="top"><strong>Architecture</strong></td><td valign="top">VLAN bridge model with dual-interface design. Onyx Edge bridges UE traffic directly into enterprise VLANs without NAT. Each APN maps to a dedicated VLAN, enabling enterprise to apply per-APN policies. APs isolated on private interface.</td><td valign="top">VLAN bridge model with single-interface design. Onyx Edge bridges UE traffic directly into enterprise VLANs without NAT. Each APN maps to a dedicated VLAN. APs share enterprise network infrastructure.</td></tr><tr><td valign="top"><strong>Traffic Flow</strong></td><td valign="top"><p>UE traffic: UE > AP > Onyx Edge (bridged to VLAN) > Enterprise VLANs via eth0 trunk port.</p><p>AP traffic: APs > Onyx Edge eth1 (private interface). VLAN-tagged UE traffic separated from AP control traffic.</p></td><td valign="top"><p>UE traffic: UE > AP > Onyx Edge (bridged to VLAN) > Enterprise VLANs via eth0 trunk port.</p><p>AP traffic: APs > Enterprise network > Onyx Edge eth0. VLAN-tagged UE traffic and AP control traffic share single interface.</p></td></tr><tr><td valign="top"><strong>IP Address Management</strong></td><td valign="top">Enterprise DHCP service assigns IP addresses to UE per VLAN. The Onyx Edge assigns IP addresses to APs via its own DHCP service. UE appear as native devices on enterprise subnets.</td><td valign="top">Enterprise DHCP service assigns IP addresses to both UE (per VLAN) and APs. UE appear as native devices on enterprise subnets. APs appear as standard enterprise network devices.</td></tr><tr><td valign="top"><strong>Network Isolation</strong></td><td valign="top">Strong per-APN VLAN isolation. Each APN is tied to a dedicated VLAN with isolation maintained by enterprise switch/router policies. APs completely isolated on a dedicated private interface. Enterprise IT has full visibility and control over UE while RAN infrastructure remains protected.</td><td valign="top">Strong per-APN VLAN isolation for UE traffic. Each APN is tied to a dedicated VLAN with isolation maintained by enterprise switch/router policies. However, APs reside on enterprise subnet where they can be accessed by other devices, reducing RAN infrastructure isolation.</td></tr><tr><td valign="top"><strong>Interfaces</strong></td><td valign="top">Dual interfaces handle traffic: eth0 (VLAN trunk port carrying tagged UE traffic to enterprise) and eth1 (dedicated private interface for AP connections). Provides clean separation between user plane and RAN control.</td><td valign="top">Single interface handles all traffic: eth0 (VLAN trunk port carrying both tagged UE traffic and AP control traffic). Simplifies cabling and switch configuration but doubles interface load.</td></tr><tr><td valign="top"><strong>APN/VLAN Integration</strong></td><td valign="top">Full APN-to-VLAN mapping. Each APN is mapped to a unique VLAN. Enterprise can apply distinct firewall, QoS, and routing policies per VLAN. Scales for multiple network slices with granular control.</td><td valign="top">Same as 4G Bridge Classic Mode.</td></tr><tr><td valign="top"><strong>Deployment Complexity</strong></td><td valign="top">Requires comprehensive planning: VLAN design per APN, enterprise DHCP/DNS coordination per VLAN, trunk port configuration on enterprise switches, and IT integration for policy enforcement. Requires significant enterprise networking team involvement.</td><td valign="top">Requires the same VLAN planning, DHCP/DNS coordination, and policy configuration as Classic mode. Simplified physical cabling (single interface) but increased configuration complexity to ensure proper traffic separation. Requires careful enterprise network capacity planning.</td></tr><tr><td valign="top"><strong>Best For</strong></td><td valign="top">Enterprises requiring maximum security with per-APN isolation, direct UE device access, and advanced network policies. Ideal for mission-critical deployments where RAN infrastructure must remain isolated while UE require full enterprise integration. Suitable for large-scale, permanent installations.</td><td valign="top">Enterprises requiring per-APN isolation and direct UE device access but lacking infrastructure for dedicated AP connections. Suitable for sites with limited switching capacity or where running separate AP network is not feasible. Good for cost-sensitive deployments prioritizing UE visibility over RAN isolation.</td></tr><tr><td valign="top"><strong>Cautions</strong></td><td valign="top">Heavily dependent on enterprise DHCP and routing infrastructure. Misconfigurations can result in broadcast storms, VLAN leakage, or inter-VLAN routing issues. UE are fully exposed on the enterprise network requiring appropriate security controls and network segmentation policies.</td><td valign="top">Same as 4G Bridge Classic Mode, plus additional risks: APs fully exposed on enterprise network create RAN security vulnerability. Single interface doubles traffic load and creates potential performance degradation. Enterprise network issues affect both UE and AP connectivity simultaneously.</td></tr></tbody></table>

#### 4G Networking Mode Selection

The following figure outlines the decision-making process for selecting the appropriate 4G networking mode for your network.

<p align="center"><strong>4G Networking Mode Selection</strong></p>

<div data-with-frame="true"><figure><img src="https://4071075005-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZc9hpHmiTCrh1sn4mWXn%2Fuploads%2F4Z6VFEJVXblkgBT9H9of%2Fimage.png?alt=media&amp;token=a86915cd-415f-4db0-85bf-563e734c57b3" alt=""><figcaption></figcaption></figure></div>

### 5G Networking Modes

The Onyx 5G Platform supports two primary networking modes that determine how the Onyx Edge integrates with enterprise networks and manages UE traffic.

* 5G NAT Mode
* 5G Bridge (APN-on-VLAN) Mode

Unlike 4G, there are no Flat modes in 5G as fronthaul connections to RUs/FHMs must always remain private as they are highly time sensitive. The 5G NAT and Bridge modes provide flexibility between fully isolated, NAT-protected networks and slice-aware VLAN-integrated networks where enterprise IT retains control of addressing and policies.

#### 5G NAT Mode

<p align="center"><strong>5G NAT Mode Topology</strong></p>

<figure><img src="https://4071075005-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZc9hpHmiTCrh1sn4mWXn%2Fuploads%2F71XsgR24iq3i2hqw7XwT%2F5g-nat-mode.png?alt=media&amp;token=2faebaa3-fdaf-464c-b545-7baa977d4ce9" alt=""><figcaption></figcaption></figure>

In the 5G NAT mode, the Onyx Edge functions as a secure gateway between the private 5G RAN and the enterprise network (N6 interface). APs and FHMs connect to the Onyx Edge via dedicated private fronthaul link, isolated from the enterprise LAN. The Onyx Edge assigns IP addresses to UE (from its local pool) and to APs and FHMs (via its DHCP service on the fronthaul network). NAT applied on the N6 interface ensures strong isolation — the enterprise LAN sees only the Onyx Edge's NAT IP address and cannot directly access APs, FHMs, or UE. This mode provides simplified IP management and complete control over RAN infrastructure, ideal for security- and privacy-focused deployments where enterprises do not require direct access to individual UE.

#### 5G Bridge (APN-on-VLAN) Mode

<p align="center"><strong>5G Bridge Mode Topology</strong></p>

<div data-with-frame="true"><figure><img src="https://4071075005-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZc9hpHmiTCrh1sn4mWXn%2Fuploads%2F6IPv8t4fGGfT4GG43bVa%2F5g-bridge-mode.png?alt=media&amp;token=1c89f859-771b-414e-b3d4-f17b07c8d280" alt=""><figcaption></figcaption></figure></div>

In the 5G Bridge mode, the Onyx Edge bridges UE traffic directly into enterprise VLANs without applying NAT. APs/FHMs connect to the Onyx Edge via dedicated private fronthaul links, isolated from the enterprise LAN. The Onyx Edge assigns IP addresses to APs and FHMs via its DHCP service on the fronthaul network. Each APN is mapped to a dedicated VLAN by the Onyx Edge, allowing traffic segregation and policy enforcement. Enterprise DHCP service assigns IP addresses to UE per VLAN, making them directly accessible as native enterprise devices. The N6 interface is configured as a VLAN trunk to carry tagged UE traffic to the enterprise network. Unlike NAT mode — where UE are hidden behind the Onyx Edge IP address — Bridge mode provides complete enterprise visibility and policy control over connected UE while maintaining strong RAN isolation and per-APN traffic segregation through VLAN isolation. This mode is recommended for organizations seeking deep integration with enterprise routing, security, and management tools.

#### 5G Networking Modes Comparison

<p align="center"><strong>Onyx 5G Deployment Modes Comparison</strong></p>

<table><thead><tr><th width="200" valign="top"></th><th valign="top">5G NAT Mode</th><th valign="top">5G Bridge (APN-on-VLAN) Mode</th></tr></thead><tbody><tr><td valign="top"><strong>Architecture</strong></td><td valign="top">NAT gateway model with dedicated fronthaul. Onyx Edge functions as secure gateway between private 5G RAN and enterprise network (N6 interface). All UE traffic NAT-translated before enterprise entry. APs/FHMs are always on dedicated private fronthaul links due to timing requirements.</td><td valign="top">VLAN bridge model with dedicated fronthaul. Onyx Edge bridges UE traffic directly into enterprise VLANs without NAT. Each APN maps to dedicated VLAN for granular enterprise policy control. APs/FHMs are always on dedicated private fronthaul links due to timing requirements.</td></tr><tr><td valign="top"><strong>Traffic Flow</strong></td><td valign="top"><p>UE traffic: UE > AP/FHM > Onyx Edge (NAT applied) > Enterprise network via N6 interface. </p><p>AP/FHM traffic: APs/FHMs > Onyx Edge via dedicated fronthaul links (point-to-point, timing-sensitive). Complete isolation of RAN infrastructure from enterprise.</p></td><td valign="top"><p>UE traffic: UE > AP/FHM > Onyx Edge (bridged to VLAN) > Enterprise VLANs via N6 trunk port.</p><p>AP/FHM traffic: Same as 5G NAT Mode. Complete isolation of RAN infrastructure from enterprise. Only UE backhaul handling differs from NAT mode.</p></td></tr><tr><td valign="top"><strong>IP Address Management</strong></td><td valign="top">Onyx Edge assigns IP addresses to UE from its local pool. Onyx Edge assigns IP addresses to APs and FHMs via its DHCP service. Enterprise network sees only the Onyx Edge's NAT IP address.</td><td valign="top">Enterprise DHCP service assigns IP addresses to UE per VLAN. Onyx Edge assigns IP addresses to APs and FHMs via its DHCP service. UE appear as native devices on enterprise subnets with enterprise-controlled addressing.</td></tr><tr><td valign="top"><strong>Network Isolation</strong></td><td valign="top">Maximum isolation. APs/FHMs can only communicate with Onyx Edge via private fronthaul (no intermediate switches). UE are hidden behind NAT. Enterprise cannot directly access any RAN infrastructure or UE. Complete security boundary between 5G network and enterprise.</td><td valign="top">Strong per-APN VLAN isolation for UE traffic. Each APN is bridged into a dedicated VLAN with enterprise-controlled policies. APs/FHMs remain isolated on private fronthaul. UE are fully visible and manageable by enterprise IT. RAN infrastructure is protected while UE are integrated into the enterprise security framework.</td></tr><tr><td valign="top"><strong>Interfaces</strong></td><td valign="top"><p>Fronthaul: 10G+ point-to-point links between APs/FHMs and Onyx Edge (no switches, timing-critical).</p><p>N6 (backhaul): Connects to enterprise network with NAT applied.</p></td><td valign="top"><p>Fronthaul: Same as 5G NAT Mode.</p><p>N6 (backhaul): Configured as VLAN trunk port connecting to enterprise network. RAN elements are isolated; only UE traffic reaches enterprise via tagged VLANs.</p></td></tr><tr><td valign="top"><strong>APN/VLAN Integration</strong></td><td valign="top">No APN-to-VLAN mapping at enterprise level. All APN traffic is collapsed behind NAT. APN distinction is not visible to the enterprise network.</td><td valign="top">Full APN-to-VLAN mapping. Each APN maps to a unique VLAN. Enterprise can apply distinct firewall rules, QoS priorities, and routing policies per VLAN. Enables enterprise policy enforcement per slice.</td></tr><tr><td valign="top"><strong>Deployment Complexity</strong></td><td valign="top">NAT simplifies IP management and reduces enterprise coordination. Requires proper IP address planning for local pools. Fronthaul requires high-speed point-to-point links with no intermediate switches. Less enterprise networking team involvement. Faster deployment.</td><td valign="top">Requires comprehensive VLAN-per-APN design, enterprise DHCP/DNS coordination per VLAN, N6 trunk port configuration, and deep enterprise IT integration. Fronthaul requirements are same as NAT mode. Significant planning and coordination required. Longer deployment timeline.</td></tr><tr><td valign="top"><strong>Best For</strong></td><td valign="top">Enterprises needing maximum security and isolation where UE are completely shielded from the enterprise LAN. Ideal for high-security environments, quick deployments, or scenarios where the enterprise IT team has limited 5G expertise. Suitable when UE traffic patterns do not require enterprise-level differentiation.</td><td valign="top">Enterprises needing direct UE access, deep IT/security integration, and per-APN network policies. Ideal for complex deployments with multiple network slices (e.g., separate policies for video surveillance, IoT sensors, voice communications). Suitable for organizations with advanced enterprise networking capabilities.</td></tr><tr><td valign="top"><strong>Cautions</strong></td><td valign="top">Requires proper IP address planning to avoid conflicts. Enterprise cannot directly access UE for management or monitoring. UE traffic patterns are not visible at the enterprise level. May not meet compliance requirements for device visibility in regulated industries.</td><td valign="top">Heavily dependent on enterprise DHCP, routing, and VLAN infrastructure. Misconfigurations can expose UE to unauthorized access or break VLAN isolation. Requires skilled network administrators familiar with both 5G and enterprise networking. UE are directly accessible on enterprise VLANs, requiring appropriate security controls and network segmentation policies.</td></tr></tbody></table>

#### 5G Networking Mode Selection

The following figure outlines the decision-making process for selecting the appropriate 5G networking mode for your network.

<p align="center"><strong>5G Networking Mode Selection</strong></p>

<div data-with-frame="true"><figure><img src="https://4071075005-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZc9hpHmiTCrh1sn4mWXn%2Fuploads%2FJBsQXvlzt0KHMx2fGS1Y%2Fimage.png?alt=media&amp;token=ee5bf325-d60d-49ed-aafc-7a9ea95bee2e" alt=""><figcaption></figcaption></figure></div>

## Networking Mode Configuration

{% hint style="info" %}
**NOTE**: This section covers only the essential configuration steps for each networking mode. For complete configuration instructions, refer to the *Onyx Portal Operations Guide*.
{% endhint %}

**The networking mode configuration follows this workflow:**

The networking mode configuration follows this workflow:

1. Configure Network for NAT or Bridge Mode Support.
2. Add APNs.
3. Add/edit the Onyx Edge.
4. Add/edit subscriber groups / subscribers and associate them to APNs and VLANs.

### Configure Network for NAT or Bridge Mode Support

**To enable NAT or Bridge mode at the network level:**

{% stepper %}
{% step %}
In the header area, click <img src="https://4071075005-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZc9hpHmiTCrh1sn4mWXn%2Fuploads%2FBPOlQeWN9WyjGCnltmwx%2Fimage.png?alt=media&amp;token=6ed6dd1b-e7b6-4f86-8628-2737c943987d" alt="" data-size="line"> (switch network).

The **Networks** page displays the summary details of all networks configured under the selected Onyx Portal account.
{% endstep %}

{% step %}
For the network that you want to edit, in the **Actions** column, click the corresponding ⋮ (options) icon, then click **Edit**.

The **Edit Network** page > **Network** tab is displayed.
{% endstep %}

{% step %}
In the **Core/RAN** tab:

* To enable NAT mode, turn off the **APN on a VLAN** toggle switch.
* To enable Bridge mode, turn on the **APN on a VLAN** toggle switch.

<p align="center"><strong>Network-Level Configuration to Enable NAT or Bridge Mode</strong></p>

<div data-with-frame="true"><figure><img src="https://4071075005-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZc9hpHmiTCrh1sn4mWXn%2Fuploads%2FStJUwAZZXdkDsHU6nSIM%2Fimage.png?alt=media&amp;token=3d263cca-c43f-4aec-91c5-63aabfae9c25" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
To save your edits, in the upper-right corner of the page, click **Save Network**.
{% endstep %}
{% endstepper %}

### Add APNs

**To add APNs:**

{% stepper %}
{% step %}
In the Onyx Portal navigation pane, click **Traffic**.

The **Traffic** page > **APNs** tab displays the list of APNs configured in the network.
{% endstep %}

{% step %}
To add an APN, in the upper-right corner of the page, click **Add APN**.

The **Add APN** page > **Add APN** tab is displayed.

<div data-with-frame="true"><figure><img src="https://4071075005-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZc9hpHmiTCrh1sn4mWXn%2Fuploads%2FpIVBjzTjXeojfsdyTRTA%2F4g-apn-add-add-apn-tab.png?alt=media&amp;token=cd7133e8-794c-4bc7-bf95-5ef0d9bb80bd" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
In the **Add APN** tab, configure the APN's details.
{% endstep %}

{% step %}
In the **Add Per APN Per Onyx Edge Config** tab, configure the per APN per Onyx Edge details for each Onyx Edge in the network.

{% hint style="info" %}
**NOTE**: This tab is only applicable after the Onyx Edge has been added to the network. If you are adding an APN before addig the Onyx Edge, this tab will be completed during the Onyx Edge configuration step.
{% endhint %}

<div data-with-frame="true"><figure><img src="https://4071075005-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZc9hpHmiTCrh1sn4mWXn%2Fuploads%2F65QIO0rWiPDaMNl7ajaK%2F4g-apn-add-per-apn-tab.png?alt=media&amp;token=24ee7654-1983-48d4-b3c4-7e1d7f7c780f" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
To save the APN, in the upper-right corner of the page, click **Save APN**.
{% endstep %}
{% endstepper %}

## 4G Onyx Edge Configuration

{% hint style="info" %}
This section covers only the key configurations to set up Onyx Edge for each 4G networking mode. For detailed configuration instructions, refer to the *4G Onyx Portal Operations Guide*.
{% endhint %}

This section covers the following configurations:

* [*Configure 4G Onyx Edge for NAT Classic Mode*](#configure-4g-onyx-edge-for-nat-classic-mode)
* [*Configure 4G Onyx Edge for NAT Flat Mode*](#configure-4g-onyx-edge-for-nat-flat-mode)
* [*Configure 4G Onyx Edge for Bridge Classic Mode*](#configure-4g-onyx-edge-for-bridge-classic-mode)
* [*Configure 4G Onyx Edge for Bridge Flat Mode*](#configure-4g-onyx-edge-for-bridge-flat-mode)

### Configure 4G Onyx Edge for NAT Classic Mode

**To configure a 4G Onyx Edge for NAT Classic mode:**

{% stepper %}
{% step %}
Confirm that the 4G network is configured in NAT mode.

See [*Configure Network for NAT or Bridge Mode Support*](#configure-network-for-nat-or-bridge-mode-support).
{% endstep %}

{% step %}
Add or edit the Onyx Edge for NAT Classic mode.

1. In the **Onyx Edge** tab, add/verify the Onyx Edge configuration.

   <div data-with-frame="true"><figure><img src="https://4071075005-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZc9hpHmiTCrh1sn4mWXn%2Fuploads%2FgpzbXAdXjfXPHlMLGUU7%2F4g-oe-add-nat-classic-mode-onyx-edge-tab.png?alt=media&amp;token=e3c79f62-79db-47bb-a46a-73c2fb16d2fb" alt=""><figcaption></figcaption></figure></div>
2. In the **Core** tab, configure the following parameters.

   <div data-with-frame="true"><figure><img src="https://4071075005-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZc9hpHmiTCrh1sn4mWXn%2Fuploads%2FU8MCAKWHm79DbxiFmkss%2F4g-oe-add-nat-classic-mode-core-tab.png?alt=media&amp;token=bc55346f-23fd-4cfc-9d9d-2e9f5279de53" alt=""><figcaption></figcaption></figure></div>

   * **LTE-UE-IP-Assignment**:
     * **IP Block**: The IP address pool from which the Onyx Edge will allocate IP addresses to UE. Default value: 192.168.128.0/24.
     * **Onyx Edge-as-DNS-Server**: On.
       * **Second Server**: Off.
   * **SGi Interface**:
     * **Static/DHCP** — Select the IP assignment mode for the SGi interface (eth0). Choose **Static** to manually configure IP settings, or **DHCP** to automatically obtain IP address, gateway, and DNS settings from the enterprise network's DHCP server. Default: DHCP.
       * **Static**: When On, configure the following. Default: Off.
         * **IP/Subnet**: The static IP address and subnet mask for the Onyx Edge's SGi interface (eth0), used for management connectivity to the enterprise network and Internet access. This is the IP address from which NATed UE traffic will originate as seen by the enterprise network. Default value: 1.1.1.1/24.
         * **Gateway**: The IP address of the enterprise network's default gateway router for the SGi interface. This gateway enables the Onyx Edge to route traffic to other networks and the Internet. Must be reachable within the IP/Subnet range configured above. Default value: 1.1.1.0.
         * **DNS Primary**: Primary DNS server's IP address. Default value: 8.8.8.8.
         * **DNS Secondary**: Secondary DNS server's IP address. Default value: 8.8.4.4.
       * **DHCP**: Default: On.
3. In the **RAN** tab, configure the following parameters:

   <div data-with-frame="true"><figure><img src="https://4071075005-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZc9hpHmiTCrh1sn4mWXn%2Fuploads%2FA7rk5UCVh8ig1I550r4s%2F4g-oe-add-nat-classic-mode-ran-tab.png?alt=media&amp;token=cd766020-154a-4930-85d8-d0c1a39f5ffe" alt=""><figcaption></figcaption></figure></div>

   * **S1 Interface**:
     * **Static**: On.
       * **IP/Subnet**: Default value: 10.0.2.1/24.

         <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>NOTE:</strong> This IP must be different than <strong>Start IP</strong> (see below) but must be from the same subnet.</p></div>
   * **Access Point DHCP Service**: On.
     * **Start IP**: Default value: 10.0.2.240.
     * **No. of IPs**: Default value: 15.
4. To save your edits, in the upper-right corner of the page, click **Save Onyx Edge**.
   {% endstep %}

{% step %}
Create/configure subscriber groups / subscriber accounts.

For detailed information, see the *4G Onyx Portal Operations Guide*.
{% endstep %}
{% endstepper %}

### Configure 4G Onyx Edge for NAT Flat Mode

**To configure a 4G Onyx Edge for NAT Flat mode:**

{% stepper %}
{% step %}
Confirm that the 4G network is configured in NAT mode.

See [*Configure Network for NAT or Bridge Mode Support*](#configure-network-for-nat-or-bridge-mode-support).
{% endstep %}

{% step %}
Add or edit the Onyx Edge for NAT Flat mode.

1. In the **Onyx Edge** tab, add/verify the Onyx Edge configuration.

   <div data-with-frame="true"><figure><img src="https://4071075005-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZc9hpHmiTCrh1sn4mWXn%2Fuploads%2FTZ5EAYsl678OX7txUiOg%2F4g-oe-add-nat-flat-mode-onyx-edge-tab.png?alt=media&amp;token=a399e7ad-74e0-4a7c-b912-c2528ee43b05" alt=""><figcaption></figcaption></figure></div>
2. In the **Core** tab, configure the following parameters:

   <div data-with-frame="true"><figure><img src="https://4071075005-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZc9hpHmiTCrh1sn4mWXn%2Fuploads%2F16d5bY3JUd3ZJxkkZwBl%2F4g-oe-add-nat-flat-mode-core-tab.png?alt=media&amp;token=b25ded38-c63f-4e8f-9bf0-61135c1910df" alt=""><figcaption></figcaption></figure></div>

   * **LTE-UE-IP-Assignment**:
     * **IP Block**: The IP address pool from which the Onyx Edge will allocate IP addresses to UE. Default value: 192.168.128.0/24.
     * **Onyx Edge-as-DNS-Server**: On.
       * **Second Server**: Off.
   * **SGi Interface**:
     * **Static/DHCP** — Select the IP assignment mode for the SGi interface (eth0). Choose **Static** to manually configure IP settings, or **DHCP** to automatically obtain IP address, gateway, and DNS settings from the enterprise network's DHCP server. Default: DHCP.
       * **Static**: When On, configure the following. Default: Off.
         * **IP/Subnet**: The static IP address and subnet mask for the Onyx Edge's SGi interface (eth0), used for management connectivity to the enterprise network and Internet access. This is the IP address from which NATed UE traffic will originate as seen by the enterprise network.
         * **Gateway**: The IP address of the enterprise network's default gateway router for the SGi interface. This gateway enables the Onyx Edge to route traffic to other networks and the Internet. Must be reachable within the IP/Subnet range configured above.
         * **DNS Primary**: Primary DNS server's IP address.
         * **DNS Secondary**: Secondary DNS server's IP address.
       * **DHCP**: Default: On.
3. In the **RAN** tab, configure the following parameters:

   <div data-with-frame="true"><figure><img src="https://4071075005-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZc9hpHmiTCrh1sn4mWXn%2Fuploads%2FKHBU8JXk3Ap7o6c4q08p%2F4g-oe-add-nat-flat-mode-ran-tab.png?alt=media&amp;token=a0380630-032a-453b-9ac1-a3e9cf3f4f0a" alt=""><figcaption></figcaption></figure></div>

   * **S1 Interface**:
     * **Static**: Off.
     * **DHCP**: Off.
     * **Same as SGi**: On. In NAT Flat mode, both S1 and SGi traffic use the same physical interface (eth0). APs connect through the enterprise network simplifying deployment.
4. To save your edits, in the upper-right corner of the page, click **Save Onyx Edge**.
   {% endstep %}

{% step %}
Create/configure subscriber groups / subscriber accounts.

For detailed information, see the *4G Onyx Portal Operations Guide*.
{% endstep %}
{% endstepper %}

### Configure 4G Onyx Edge for Bridge Classic Mode

**To configure a 4G Onyx Edge for Bridge Classic mode:**

{% stepper %}
{% step %}
Confirm that the 4G network is configured in Bridge mode.

See [*Configure Network for NAT or Bridge Mode Support*](#configure-network-for-nat-or-bridge-mode-support).
{% endstep %}

{% step %}
Add APNs required for Bridge mode support.

See [*Add APNs*](#add-apns).
{% endstep %}

{% step %}
Add or edit the Onyx Edge for Bridge Classic mode.

1. In the **Onyx Edge** tab, add/verify the Onyx Edge configuration.

   <div data-with-frame="true"><figure><img src="https://4071075005-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZc9hpHmiTCrh1sn4mWXn%2Fuploads%2FWBbDHTl1LFrIOefSX58X%2F4g-oe-add-nat-bridge-mode-oe-tab.png?alt=media&amp;token=978fe1ff-39af-4a17-8afa-740a49403cd6" alt=""><figcaption></figcaption></figure></div>
2. In the **Core** tab, configure the following parameters:

   <div data-with-frame="true"><figure><img src="https://4071075005-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZc9hpHmiTCrh1sn4mWXn%2Fuploads%2FG4q2h2jN1U7U4bYwxoh8%2F4g-oe-add-bridge-classic-mode-core-tab.png?alt=media&amp;token=b8ca0e7b-07aa-405a-bc2b-3b75ff35ab5a" alt=""><figcaption></figcaption></figure></div>

   * **Onyx Edge-as-DNS-Server**: Disabled.
   * **DNS Primary**: The primary DNS server's IP address. Default value: 8.8.8.8.
   * **DNS Secondary**: The secondary DNS server's IP address. Default value: 8.8.4.4.
   * **SGi Interface**:
     * **Static**: On.
       * **IP/Subnet**: The management IP address for Onyx Edge to reach enterprise network/Internet.
       * **Gateway**: The enterprise gateway router's IP address.
       * **DNS Primary**: The primary DNS server's IP address.
       * **DNS Secondary**: The secondary DNS server's IP address.
       * **SGi Management VLAN**: The SGi Management VLAN ID. Default value: 0. (default value of 0 means untagged; management traffic will not carry a VLAN tag. Set to a non-zero VLAN ID if management traffic must be carried on a specific VLAN.)
3. In the **RAN** tab, configure the following parameters:

   <div data-with-frame="true"><figure><img src="https://4071075005-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZc9hpHmiTCrh1sn4mWXn%2Fuploads%2FsnxsCsfu0c3sXGpJP0QI%2F4g-oe-add-bridge-classic-ran-tab.png?alt=media&amp;token=3a8d6a6f-7505-40ce-b0a8-b64754fa50e8" alt=""><figcaption></figcaption></figure></div>

   * **S1 Interface**:
     * **Static**: On.
       * **IP/Subnet**: The IP address/subnet for the Onyx Edge's S1 interface. Default value: 10.0.2.1/24.
     * **Access Point DHCP Service**: On.
       * **Start IP**: The Access Point DHCP pool's start IP address. Default value: 10.0.2.240.
       * **No. of IPs**: The number of IP addresses. Default value: 15.
4. In the **Per APN Per Onyx Edge Config** tab, configure the Per-APN-Per-Onyx-Edge configurations:

   <div data-with-frame="true"><figure><img src="https://4071075005-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZc9hpHmiTCrh1sn4mWXn%2Fuploads%2Fhu6pKYeXY8zIKjVWurtC%2F4g-oe-add-bridge-classic-mode-per-apn-tab.png?alt=media&amp;token=8161d41b-d27a-4016-9ab4-25accbf98c86" alt=""><figcaption></figcaption></figure></div>

   * **APN ID**: Read-only field. Cannot be edited.
   * **Local IP / Subnet**: Enterprise subnet for the APN.
   * **Default GW IP**: Enterprise gateway IP address for the VLAN.
   * **VLAN ID**: VLAN identifier for the APN.
   * **Default GW MAC**: MAC address of the enterprise gateway router on this VLAN.
5. To save your edits, in the upper-right corner of the page, click **Save Onyx Edge**.
   {% endstep %}

{% step %}
Create/configure subscriber groups / subscriber accounts to use APNs configured for Bridge mode support.

For detailed information, see the *4G Onyx Portal Operations Guide*.
{% endstep %}
{% endstepper %}

### Configure 4G Onyx Edge for Bridge Flat Mode

**To configure a 4G Onyx Edge for Bridge Flat mode:**

{% stepper %}
{% step %}
Confirm that the 4G network is configured in Bridge mode.

See [*Configure Network for NAT or Bridge Mode Support*](#configure-network-for-nat-or-bridge-mode-support).
{% endstep %}

{% step %}
Add APNs required for Bridge mode support.

See [*Add APNs*](#add-apns).
{% endstep %}

{% step %}
Add or edit the Onyx Edge for Bridge Flat mode.

1. In the **Onyx Edge** tab, add/verify the Onyx Edge configuration.

   <div data-with-frame="true"><figure><img src="https://4071075005-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZc9hpHmiTCrh1sn4mWXn%2Fuploads%2FJNZeEYJiugqlsutVccCn%2F4g-oe-add-bridge-flat-mode-oe-tab.png?alt=media&amp;token=5f834d1d-7bf2-4579-ba71-e8cdd5a4b5ed" alt=""><figcaption></figcaption></figure></div>
2. In the **Core** tab, configure the following parameters:

   <div data-with-frame="true"><figure><img src="https://4071075005-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZc9hpHmiTCrh1sn4mWXn%2Fuploads%2Ftyc7KqAXb1z6S0wGZe28%2F4g-oe-add-bridge-flat-mode-core-tab.png?alt=media&amp;token=9bb02455-ab2d-4f0d-ba39-1ec95359de19" alt=""><figcaption></figcaption></figure></div>

   * **Onyx Edge-as-DNS-Server**:
     * **DNS Primary**: Primary DNS server's IP address. Default value: 8.8.8.8.
     * **DNS Secondary**: Secondary DNS server's IP address. Default value: 8.8.4.4.
   * **SGi Interface**:
     * **Static**: On.
     * **IP/Subnet**: Management IP address for Onyx Edge to reach enterprise network/Internet.
     * **Gateway**: Enterprise gateway router's IP address.
     * **DNS Primary**: Primary DNS server's IP address.
     * **DNS Secondary**: Secondary DNS server's IP address.
     * **SGi Management VLAN**: SGi Management VLAN ID. Default value: 0. (default value of 0 means untagged management traffic. Set to a non-zero VLAN ID if management traffic must be carried on a specific VLAN.)
3. In the **RAN** tab, configure the following parameters:

   <div data-with-frame="true"><figure><img src="https://4071075005-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZc9hpHmiTCrh1sn4mWXn%2Fuploads%2F0CdCbIVMuqnpyqGFI0Zl%2F4g-oe-add-bridge-flat-mode-ran-tab.png?alt=media&amp;token=012fa998-dfa0-41bc-83dd-a2655e43220b" alt=""><figcaption></figcaption></figure></div>

   * **S1 Interface**:
     * **Static**: Off.
     * **DHCP**: Off.
     * **Same as SGi**: On. In Bridge Flat mode, both S1 and SGi traffic use the same physical interface (eth0), configured as a VLAN trunk. APs connect through the enterprise network simplifying deployment.&#x20;
4. In the **Per APN Per Onyx Edge Config** tab, configure the Per-APN-Per-Onyx-Edge settings as required for each APN:

   <div data-with-frame="true"><figure><img src="https://4071075005-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZc9hpHmiTCrh1sn4mWXn%2Fuploads%2F5xxXpV46ZyDOfnhNgNLo%2F4g-oe-add-bridge-flat-mode-per-apn-tab.png?alt=media&amp;token=9ee32f22-0600-4bf5-a616-bcb75fc934c6" alt=""><figcaption></figcaption></figure></div>

   * **Local IP / Subnet**: Enterprise subnet for the APN.
   * **Default GW IP**: Enterprise gateway IP for the VLAN.
   * **VLAN ID**: VLAN identifier for the APN.
   * **Default GW MAC**: MAC address of the enterprise gateway router on this VLAN.

     <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Each APN must be mapped to a unique VLAN to enable proper traffic segregation and enterprise policy enforcement.</p></div>
5. In the upper-right corner of the page, click **Save Onyx Edge**.
   {% endstep %}

{% step %}
Create/configure subscriber groups / subscriber accounts to use APNs configured for Bridge mode support.

For detailed information, see the *4G Onyx Portal Operations Guide*.
{% endstep %}
{% endstepper %}

## 5G Onyx Edge Configuration

{% hint style="info" %}
This section applies to 5G Onyx Edge (NR + Core) configurations and outlines only the key configurations required to set up Onyx Edge for each 5G networking mode. For detailed configuration instructions, refer to the *5G Onyx Portal Operations Guide*.
{% endhint %}

This section covers the following configurations:

* [*Configure 5G Onyx Edge for NAT Mode*](#configure-5g-onyx-edge-for-nat-mode)
* [*Configure 5G Onyx Edge for Bridge Mode*](#configure-5g-onyx-edge-for-bridge-mode)

### Configure 5G Onyx Edge for NAT Mode

**To configure a 5G Onyx Edge for NAT mode:**

{% stepper %}
{% step %}
Confirm that the 5G network is configured in NAT mode.

*See* [*Configure Network for NAT or Bridge Mode Support*](#configure-network-for-nat-or-bridge-mode-support).
{% endstep %}

{% step %}
Add or edit the Onyx Edge for NAT mode.

1. In the **Onyx Edge** tab, configure the Onyx Edge parameters.

   <div data-with-frame="true"><figure><img src="https://4071075005-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZc9hpHmiTCrh1sn4mWXn%2Fuploads%2FtMwSzYCyFyStIEs4ghg0%2F5g-oe-add-nat-mode-onyx-edge-tab.png?alt=media&amp;token=5517ea8c-e34b-4d42-88f7-d0977fa332dd" alt=""><figcaption></figcaption></figure></div>
2. In the **Core** tab, configure the following parameters:

   <div data-with-frame="true"><figure><img src="https://4071075005-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZc9hpHmiTCrh1sn4mWXn%2Fuploads%2FcVu2swcw9WpWy3bgMhod%2F5g-oe-add-nat-mode-core-tab.png?alt=media&amp;token=d5a141dd-e91b-4892-88d7-4bdb7c868a5d" alt=""><figcaption></figcaption></figure></div>

   * **UE Configurations**:
     * **IP Range**: The IP address pool from which the Onyx Edge will allocate IP addresses to UE. Example: 192.168.128.0/24.
     * **DNS Server**:
       * **Onyx Edge-as-DNS-Server**: On. The Onyx Edge provides DNS to UE.
       * **Second Server**: Off (enable and configure if a secondary DNS is required).
     * Management Interface: Static/DHCP — select IP assignment for the N6 interface.
       * **Static:** IP/Subnet (enterprise-facing IP), Gateway (enterprise default gateway), DNS Primary, DNS Secondary.
       * **DHCP:** N6 interface obtains IP settings automatically from enterprise DHCP.
3. In the **RAN** tab, configure the RAN parameters.

   <div data-with-frame="true"><figure><img src="https://4071075005-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZc9hpHmiTCrh1sn4mWXn%2Fuploads%2F4k0HnR5y5GliMnVw3vqt%2F5g-oe-add-nat-mode-ran-tab.png?alt=media&amp;token=adc0950c-ab84-49bd-9823-29207238b6c7" alt=""><figcaption></figcaption></figure></div>
4. To save your edits, in the upper-right corner of the page, click **Save Onyx Edge**.
   {% endstep %}

{% step %}
Create/configure subscriber groups / subscriber accounts.

For detailed information, see the *5G Onyx Portal Operations Guide*.
{% endstep %}
{% endstepper %}

### Configure 5G Onyx Edge for Bridge Mode

**To configure a 5G Onyx Edge for Bridge mode:**

{% stepper %}
{% step %}
Confirm that the 5G network is configured in Bridge mode.

*See* [*Configure Network for NAT or Bridge Mode Support*](#configure-network-for-nat-or-bridge-mode-support).
{% endstep %}

{% step %}
Add APNs required for Bridge mode support.

See [*Add APNs*](#add-apns).
{% endstep %}

{% step %}
Add or edit the Onyx Edge for Bridge mode.

1. In the **Onyx Edge** tab, add/verify the Onyx Edge configurations.

   <div data-with-frame="true"><figure><img src="https://4071075005-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZc9hpHmiTCrh1sn4mWXn%2Fuploads%2FTxt1fGj6lWsMpeMjhFCC%2F5g-oe-add-bridge-mode-onyx-edge-tab.png?alt=media&amp;token=c8ec2bea-4830-4d43-b615-72070bb0f479" alt=""><figcaption></figcaption></figure></div>
2. In the **Core** tab, configure the following parameters:

   <div data-with-frame="true"><figure><img src="https://4071075005-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZc9hpHmiTCrh1sn4mWXn%2Fuploads%2F7oZRkAw8fkYQJ2sUKPJO%2F5g-oe-add-bridge-mode-core-tab.png?alt=media&amp;token=2c47a4f7-a54b-470d-9e97-97732fc9d24f" alt=""><figcaption></figcaption></figure></div>

   * **Onyx Edge-as-DNS-Server**: Disabled. In 5G Bridge mode, UE obtain DNS from the enterprise DHCP service on their assigned VLAN, not from the Onyx Edge.
     * **DNS Primary**: The IP address of the primary DNS server that the Onyx Edge itself uses for system operations and management functions.
     * **DNS Secondary**: The IP address of the secondary/backup DNS server that the Onyx Edge itself uses for system functions if the primary DNS server becomes unavailable.
   * **Management Interface**:
     * **Static**: On.
       * **Management IP/Subnet**: Management IP address for Onyx Edge to reach enterprise network/Internet.
       * **N6 IP**: IP address for N6 interface.
       * **Gateway**: Enterprise gateway router IP address.
       * **Management VLAN**: Management VLAN ID.
       * **DNS Primary**: Onyx Edge's primary DNS server's IP address.
       * **DNS Secondary**: Onyx Edge's secondary DNS server's IP address.
3. In the **RAN** tab, configure the required RAN parameters.

   <div data-with-frame="true"><figure><img src="https://4071075005-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZc9hpHmiTCrh1sn4mWXn%2Fuploads%2FkZhtha0xTwPh36fyK8Ic%2F5g-oe-add-bridge-mode-ran-tab.png?alt=media&amp;token=6a745125-b599-42e7-82fa-3c7451b62daa" alt=""><figcaption></figcaption></figure></div>
4. In the **Per APN Per Onyx Edge Config** tab, configure the following for each APN:

   <div data-with-frame="true"><figure><img src="https://4071075005-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZc9hpHmiTCrh1sn4mWXn%2Fuploads%2Fmhzj1pAwkHNJdja0n5US%2F5g-oe-add-bridge-mode-per-apn-tab.png?alt=media&amp;token=712915dd-103d-4885-a197-4beee81fe30f" alt=""><figcaption></figcaption></figure></div>

   * **APN ID**: Read-only field. Cannot be edited.
   * **Local IP / Subnet**: Enterprise subnet for this APN.
   * **Default GW IP**: Enterprise gateway IP address for this VLAN.
   * **VLAN ID**: VLAN identifier for this APN.
   * **Default GW MAC**: MAC address of the enterprise gateway router on this VLAN.

     <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>NOTE</strong>: Each APN must be mapped to a unique VLAN to enable proper traffic segregation and enterprise policy enforcement. The N6 interface is configured as a VLAN trunk to carry tagged UE traffic to the enterprise network.</p></div>
5. In the upper-right corner of the page, click **Save Onyx Edge**.
   {% endstep %}

{% step %}
Create/configure subscriber groups / subscriber accounts to use APNs configured for Bridge mode support.

For detailed information, see the *5G Onyx Portal Operations Guide*.
{% endstep %}
{% endstepper %}

## Related Documentation

* *4G Onyx Portal Operations Guide*
* *5G Onyx Portal Operations Guide*
* *GXC Glossary*

## Contact GXC

To get in touch with GXC, please visit <https://gxc.io/contact-us/>.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.gxc.io/docs/application-notes/4g-and-5g-onyx-networking-modes.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
