ExtremeCloud IQ
The ExtremeCloud IQ integration reads the switches and access points an ExtremeCloud IQ (XIQ) account manages, through the XIQ API. XIQ is cloud-hosted, so the CyberOptix CTEM Platform collects from it directly. No Integrator is needed, and nothing is installed on your network. For switches managed by an on-premises ExtremeCloud IQ Site Engine, use the Site Engine integration.
Discovery is read-only. One integration covers one XIQ account: every location and device in it.
What it collects
| Sync | Collects |
|---|---|
| Network discovery | The management network each device is addressed into, with its VLAN and gateway |
| Host discovery | The wired and wireless clients connected to each switch and access point, with the port or SSID and VLAN they use, and each device's LLDP and CDP neighbors |
| Configuration backup | Each switch's running configuration, with secrets stripped before it is stored, versioned whenever it changes. Optional: see below |
| Configuration review | Every configuration backup is reviewed against the configuration review checks, and what they find is raised as vulnerabilities on the device |
Every sync also reports the account's devices: switches, access points and the rest, with model, serial number, firmware and management address. Devices appear under Attack Surface > Network Devices.
What XIQ reports is kept as its own record, alongside hosts and subnets rather than written into them.
Configuration backup needs more than read access
XIQ has no read-only way to read a device's configuration. The only route is XIQ's CLI
pass-through, which needs the device:cli permission on the API token. That permission
is broader than read-only: XIQ would let a token holding it run any command.
The CyberOptix CTEM Platform sends exactly one command, and only to switches: show configuration on
Switch Engine (EXOS) and show running-config on Fabric Engine (VOSS). It never sends
any other command, and never sends commands to access points.
Whether to grant it is your choice:
- Without
device:cli, leave Configuration backup and Configuration review disabled. Discovery works with a read-only token. - With
device:cli, enable both syncs to back up and review switch configurations. If the token lacks the permission, the backup fails and earlier configurations are kept.
Create an API token
Create a token for a dedicated XIQ administrator, so it is not tied to a person:
- Sign in to the XIQ API with that administrator (
POST /login) to get a session token. - Create a long-lived API token (
POST /auth/apitoken) with only the permissions the integration needs:device:randclient:r, anddevice:clionly if you want configuration backup.
See Extreme's API authentication guide for the request formats.
The CyberOptix CTEM Platform sends the token in an Authorization: Bearer header, never in a URL.
Connect it
- Under Integrations, add ExtremeCloud IQ with a name for the account and the API token.
- Enable the syncs you want.
XIQ's certificate is always verified against the public certificate authorities. Nothing is pinned, and a certificate that fails verification fails the sync.