Sites
The Sites page manages site connectors. A site connector is a small Linux host on a site’s LAN that serves network devices the cloud cannot reach directly: devices on private addresses behind NAT, or devices without RadSec. It relays their RADIUS over RadSec or an HTTPS tunnel, delivers CoA and Disconnect to them, tunnels TACACS+ and collects DHCP fingerprints for profiling. It only connects out (HTTPS, optionally RadSec on TCP 2083), so the site needs no inbound firewall rules.
What this page shows
Section titled “What this page shows”Network › Sites lists the site connectors of the tenant, 50 per page. The list refreshes every 30 seconds while Live is on.
When no connector exists yet, the page shows the three steps: Create a connector, Enroll a site host (run nac-edge enroll on the host) and Assign NADs (point the site’s devices at the connector’s LAN address for RADIUS, CoA, TACACS+ and as a DHCP helper).
A Needs attention box groups connectors with problems: offline, upstream unhealthy, RadSec certificate expired or expiring within 30 days, set to RadSec without a certificate, not enrolled, waiting for a certificate upgrade, or running an older version than the latest. Select a name to open it, or Show N connectors to filter.
Each connector has one status:
| Status | Meaning |
|---|---|
| Online | Enrolled and heard from within the offline threshold (90 seconds by default). |
| Offline | Enrolled, but no contact for longer than the offline threshold. |
| Pending enrollment | Not enrolled yet; a valid enrollment token is outstanding. |
| Not enrolled | No credentials and no valid enrollment token. |
| Disabled | API calls, RADIUS relay, CoA relay and TACACS+ tunnels are refused. |
Select a row to open the connector panel. It has these tabs:
- Overview: notes about the connector’s state (disabled, not enrolled, waiting for enrollment, offline, upstream unhealthy, no NADs assigned) and its settings: sites, RADIUS transport, DHCP fingerprinting, TACACS+ tunnel, authentication, enrolled, created and updated, connector ID.
- NADs: the network devices behind the connector (name, IP or prefix, vendor, CoA, status), with Assign NADs and Detach.
- CoA jobs: CoA and Disconnect requests relayed through the connector in the last 24 hours, with their status (Pending, Dispatched, Done, Failed, Expired), the device’s verdict, latency and error.
- Heartbeat: version, uptime and counters the connector reports every 30 seconds, including RADIUS requests, replies, reply rate and average RADIUS latency.
- Credentials: enrollment state and token, the RadSec client certificate (common name, serial, SHA-256 fingerprint, valid until), and a Danger zone with Revoke and Delete.
Fields and columns
Section titled “Fields and columns”List columns
Section titled “List columns”| Column | Meaning |
|---|---|
| Name | The connector name, its sites and description. |
| Status | The status, a short note (token expiry, how long it has been silent, upstream unhealthy, certificate expiry, re-enrollment token out) and attention badges. |
| Last seen | When the connector last called in, and from which IP address. |
| Version | The connector version, marked when it is older than the latest, and the host name. |
| NADs | Number of network devices behind the connector. Select it to open the NADs tab. |
| Relay | The RADIUS transport, the authentication mode (Certificate, API token or Not enrolled), and whether DHCP and TACACS+ are on. |
Add and edit form
Section titled “Add and edit form”| Field | Meaning |
|---|---|
| Name | Required and unique in the tenant, for example the site or closet name. |
| Sites | The locations this connector serves, for example Branch 12. Press Enter to add each one. Searchable. |
| Description | For example Closet A, rack 2. |
| RADIUS transport to the cloud | Auto (recommended): RadSec (TLS, TCP 2083) when the connector holds a certificate, otherwise the HTTPS tunnel. RadSec: same as Auto, but the connector logs a warning while it has no RadSec certificate. HTTPS tunnel: always relay RADIUS over HTTPS, with no automatic certificate upgrade, for sites that cannot reach TCP 2083. |
| Enabled | When off, every API call, RadSec connection, relayed RADIUS request, CoA relay and TACACS+ tunnel of this connector is refused. |
| DHCP fingerprinting | Accept DHCP fingerprints, with the connector as an extra ip helper-address, for the profiler. |
| TACACS+ tunnel | Tunnel device-administration sessions (TCP 49) from local devices to the cloud TACACS+ service. Turning it off closes open tunnels at once. |
| Issue a one-time enrollment token now | New connectors only. Choose how long it is valid: 1 hour, 4 hours, 24 hours, 3 days, 7 days or 30 days. The token and the nac-edge enroll command are shown once, right after creation. |
Actions
Section titled “Actions”| Action | What it does |
|---|---|
| Add site | Opens the form (shortcut n). A new connector opens in the panel, with the install command if you issued a token. |
| Export | Downloads the filtered list as edge-connectors-<date>.csv, up to 1,000 connectors, with status, sites, version, last seen, NAD count, authentication mode, transport, services and certificate details. |
| Search | Name, site, hostname or IP. Press / to jump to the box. |
| Filters | Any status, Any authentication (Certificate, API token, Not enrolled), Any transport, Any version (including Never reported), Attention: any (Needs attention, No attention needed). Clear filters resets them. |
| Sort | Name, Status, Last seen (newest), Last seen (oldest), Most NADs, Version, Certificate expiry, Newest, Oldest. |
| Live | Turns the 30-second auto-refresh on or off. |
| Refresh | Reloads the list. |
| Install / token / Re-enroll (key icon) | Opens the token dialog. Choose Valid for and select Issue token. The next screen shows the Enrollment token and the commands for the site host, with Tunnel only (–no-certificate), Pass token via environment and an optional --hostname. The token is single-use, stored only as a hash and shown once; issuing another replaces it. Re-enrolling is for hardware replacement. The connector must be enabled. |
| Cancel token | In the panel, cancels an outstanding enrollment token. |
| Edit | Opens the form. |
| Enable / Disable | Disabling takes effect immediately: the connector’s API calls, RadSec connections, relayed RADIUS and CoA relay are refused and its TACACS+ tunnels are closed. Devices behind it can no longer authenticate. |
| Revoke | Drops the connector’s API token and RadSec certificate (the certificate is revoked). Its next API call and RadSec request are refused, open TACACS+ tunnels close, RADIUS from its devices stops being relayed, and it must be enrolled again. Optionally also cancels an outstanding enrollment token. |
| Delete | After confirmation, revokes the RadSec certificate, deletes pending CoA relay jobs, closes open TACACS+ tunnels and detaches the assigned devices. A replacement needs a new enrollment. |
| Assign NADs | On the NADs tab, picks network devices to place behind this connector. Devices behind another connector are moved. |
| Detach | On the NADs tab, after confirmation, takes a device off the connector. The connector stops relaying for it within one heartbeat (about 30 seconds); unless the device can then reach the cloud directly (RadSec or a reachable public address), its authentications fail. |
| Bulk Enable, Disable, Delete | Select rows on the current page, then choose an action. Disable and Delete ask for confirmation. |
Permissions
Section titled “Permissions”- View:
policy:read: Tenant Administrator, Network Administrator, Help Desk, Read-only Administrator and Platform Administrator. Without write access the page shows Read-only. - Change:
policy:write: Tenant Administrator, Network Administrator and Platform Administrator.