Switches and APs
The Switches and APs page lists the network access devices (NADs) that may send RADIUS and TACACS+ requests to Airgate: switches, wireless controllers and access points, firewalls and VPN gateways. Airgate answers a request only when its source address matches an enabled device here.
What this page shows
Section titled “What this page shows”Network › Switches and APs lists the network devices of the tenant, sorted by name, 50 per page by default. Above the table:
- Vendors: a chip per vendor with a count, when there is more than one vendor. Select a chip to filter.
- A warning when devices accept Access-Requests without Message-Authenticator (BlastRADIUS, CVE-2024-3596).
A warning icon next to a name means the device has no RADIUS shared secret and RadSec is off, so RADIUS from it is dropped. T+ marks devices with a TACACS+ secret.
Select a row to open the device panel. Overview shows:
- Device: name, device ID, vendor (dictionary), vendor profile, site connector, created and updated.
- Authentication: whether the RADIUS and TACACS+ secrets are set, Message-Authenticator, dynamic authorization and RadSec, plus a live check of whether the address is accepted as a RADIUS client. For a subnet, Check tests one address in it.
- Device groups: explicit members and groups matched by definition.
- Platform capabilities: from the vendor profile: CoA port and supported CoA kinds, captive-portal mechanism, role and VLAN attributes, and what CoA packets need.
- Custom attributes (
Devicenamespace) and SNMP settings.
With monitor:read, an Activity tab shows active sessions, requests and failures in the last 24 hours, and the recent requests from the device.
Fields and columns
Section titled “Fields and columns”List columns
Section titled “List columns”| Column | Meaning |
|---|---|
| Name | The device name and description. |
| IP / prefix | The device address or subnet, for example 10.0.0.2 or 10.0.0.0/24. |
| Vendor | The RADIUS dictionary vendor and, below it, the vendor profile. |
| Groups | The device groups the device is in. |
| CoA | The CoA port, when dynamic authorization is on. |
| RadSec | On when RadSec is accepted. |
| Edge | The site connector the device sits behind. Select it to open the site. |
| Status | On or Off switch (read-only Enabled or Disabled without write access). |
Add and edit form
Section titled “Add and edit form”The form has four tabs.
General
| Field | Meaning |
|---|---|
| Name | Required, for example core-sw1. |
| IP address or subnet | Required, for example 10.0.0.2 or 10.0.0.0/24. Airgate warns about unusable addresses (loopback, link-local, multicast) and, when host bits are set, offers Use with the corrected prefix. Ranges wider than /16 (IPv4) or /48 (IPv6) can only be created by a Platform Administrator. |
| Description | Free text. |
| Vendor profile | The device platform. Sets the dictionary vendor and the default CoA port, and shows the platform’s capabilities. None (generic) or one of the profiles below. |
| Vendor (RADIUS dictionary) | The dictionary used for vendor attributes. Exposed to policy as Device:Device-Type. The Common group lists Aruba, Cisco, HP, Juniper, Arista, Fortinet, Ruckus, Meraki, Extreme, Aerohive and IETF; All RADIUS dictionaries lists the rest. |
| Site connector | The on-site connector the device sits behind, for CoA and TACACS+ relay and RADIUS over the connector’s RadSec. |
| Status | Enabled or Disabled. |
Vendor profiles, grouped by vendor in the picker:
| Vendor | Profiles |
|---|---|
| Aruba | Aruba AOS 8 Mobility Controller / Conductor, Aruba Instant / AOS 10 APs (Central), Aruba AOS-CX switch |
| HP | ArubaOS-Switch / HPE ProCurve |
| Cisco | Cisco IOS-XE switch (Catalyst 9k, IBNS), Cisco Catalyst 9800 WLC / AireOS |
| Meraki | Cisco Meraki MR access point, Cisco Meraki MS switch |
| Ruckus | Ruckus SmartZone / RUCKUS One / Unleashed / ZoneDirector |
| Fortinet | FortiGate (FortiAP wireless, captive portal, user groups), FortiSwitch (standalone or FortiLink) |
| Juniper | Juniper Mist access point, Juniper EX switch (Junos dot1x) |
| Arista | Arista EOS (802.1X / MAC-based authentication), Arista CloudVision CUE Wi-Fi |
| Extreme | Extreme EXOS / Universal switch / Campus Controller |
| Aerohive | ExtremeCloud IQ (Aerohive) access point |
| IETF | Ubiquiti UniFi, Generic IETF (RFC 3580 / RFC 5176) |
RADIUS, CoA & RadSec
| Field | Meaning |
|---|---|
| RADIUS shared secret | The secret the device uses. Leave empty for RadSec-only devices. On an existing device the stored secret is masked; replace it, or clear it to remove it. |
| TACACS+ shared secret | Only for device administration over TACACS+. |
| Require Message-Authenticator in Access-Requests | BlastRADIUS (CVE-2024-3596) protection. Recommended; turn off only for legacy devices that cannot send it. |
| RADIUS CoA / Disconnect (RFC 5176) | Lets policies and operators re-authenticate, bounce or disconnect sessions. |
| CoA port | Default 3799 (Cisco IOS: 1700). When it differs from the vendor profile’s port, use it restores the profile default. |
| Accept RadSec from this device | RADIUS over TLS, for devices behind NAT or shared addresses. |
| Expected certificate identity (CN) | The client certificate CN to accept, case-sensitive and unique across all tenants. Empty: the CN must be the device ID. |
Groups & attributes
| Field | Meaning |
|---|---|
| Device groups | Explicit memberships. Groups whose list, subnet or regex definition matches the device’s name or address apply automatically and are listed as Currently matched by definition. |
| Custom attributes | Name and value pairs available to policy in the Device namespace, for example Location = HQ (Device:Location). |
SNMP
| Field | Meaning |
|---|---|
| Read this device over SNMP | The profiler reads ARP and interface tables to discover and classify endpoints. |
| Version | v1, v2c or v3. |
| Port | The SNMP port. |
| Community string | v1 and v2c. |
| Username, Security level, Auth protocol, Auth password, Privacy protocol, Privacy password, Context name | v3. Security level noAuthNoPriv, authNoPriv or authPriv; auth MD5, SHA, SHA224, SHA256, SHA384, SHA512; privacy DES, AES, AES192, AES256, AES192C, AES256C. |
| Zone | Optional profiler zone or site label. |
| Read ARP table (IP ↔ MAC), Force read on every poll | Polling options. |
Actions
Section titled “Actions”| Action | What it does |
|---|---|
| Client lookup | Opens RADIUS client lookup. Enter a Source IP address to see which device serves it. |
| Export | Downloads every network device of the tenant as CSV, with groups, site connector and custom attributes. Shared secrets are not exported. |
| Import | Opens Import network devices: upload a file (up to 16 MiB or 20,000 rows) or paste CSV. When a device with the same name exists: Merge (update with the row’s non-empty cells; attributes merged) or Skip (only create new devices). Validate checks every row without saving; Import writes them. Template downloads a sample file. |
| Add device | Opens the form. A new device opens in the panel after saving. |
| Search | Name, IP / CIDR, vendor, RadSec CN…. |
| Filters | Any status, All vendors, All profiles (vendor profile), All groups and, when site connectors exist, Any edge / direct. Clear filters resets them. |
| Refresh | Reloads the list. |
| Status switch | Enables or disables one device. A disabled device’s requests are dropped. |
| Edit | Opens the form. |
| Duplicate | Opens the form pre-filled from the device, for a new one. |
| Delete | After confirmation, removes the device. RADIUS and TACACS+ requests from its address are dropped and its explicit group memberships removed. |
| Bulk Enable / Disable | Select rows, then choose an action. |
| Bulk Add to group… | Adds the selected devices to a device group. |
| Bulk Site connector… | Assign to a connector, or Detach from edge (direct). |
| Bulk Delete | Deletes the selected devices after confirmation. Devices that fail stay selected and the reasons are listed. |
| Rows per page | 25, 50, 100 or 200. |
Permissions
Section titled “Permissions”- View:
policy:read: Tenant Administrator, Network Administrator, Help Desk, Read-only Administrator and Platform Administrator. - Change:
policy:write: Tenant Administrator, Network Administrator and Platform Administrator. - Activity tab:
monitor:read.