Skip to main content

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​

SyncCollects
Network discoveryThe management network each device is addressed into, with its VLAN and gateway
Host discoveryThe 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 backupEach switch's running configuration, with secrets stripped before it is stored, versioned whenever it changes. Optional: see below
Configuration reviewEvery 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:

  1. Sign in to the XIQ API with that administrator (POST /login) to get a session token.
  2. Create a long-lived API token (POST /auth/apitoken) with only the permissions the integration needs: device:r and client:r, and device:cli only 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​

  1. Under Integrations, add ExtremeCloud IQ with a name for the account and the API token.
  2. 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.