Skip to main content

Cisco IOS / IOS-XE

The Cisco IOS / IOS-XE integration reads Catalyst switches and routers over SSH. It runs on an Integrator inside your network, so no device is exposed to the CyberOptix CTEM Platform. It is listed under Network beside the other switching integrations. Nexus switches connect through Cisco NX-OS, and ASA firewalls through the Cisco integration under Firewall. Pointed at either, this integration stops with an error naming the right one.

It is read-only: the Integrator runs show commands and never enters configuration mode.

What it collects​

SyncCollects
Configuration backupshow running-config, with secrets stripped on the Integrator before it leaves your network, versioned whenever it changes; ACLs and the interfaces they are applied to
Configuration reviewEvery configuration backup is reviewed against the configuration review checks, and what they find is raised as vulnerabilities on the device
Network discoveryInterfaces with their link state and speed, the VLANs the switch has defined, SVIs and the subnets they address, and the routing table
Host discoveryThe connected endpoints: the learned MAC address table, ARP, and CDP and LLDP neighbors

Every sync also reports the device itself, with model, serial number and software version. Devices appear under Attack Surface > Network Devices. What the device reports is kept as its own record, alongside hosts and subnets rather than written into them.

A VLAN with an SVI is reported as the subnet the SVI addresses, named after the VLAN. A VLAN without one is still reported, as a network with no address, so the segments a switch carries are visible even where nothing routes them. A switch stack is one device.

Create a read-only account​

The account needs to run show commands, including show running-config: a local or AAA user at privilege 15 restricted to show commands by your command authorization, or a lower-privilege user plus an enable secret in the integration.

username inventory privilege 15 secret <password>

SSH must be enabled on the management interface for the Integrator's address.

Connect it​

  1. Under Integrations, add Cisco IOS / IOS-XE with the device's management hostname, the SSH port if it is not 22, the username and password, and the enable secret if the account needs one.
  2. In the integration's settings, assign the Integrator that can reach the device.
  3. Enable the syncs you want.

Each switch or router is its own integration.

Host keys and algorithms​

The first connection records the device's SSH host key; every later connection must present the same key. If you replace or re-key the device, clear the pinned host key in the integration's settings so the new one is recorded.

Only modern SSH algorithms are offered. An older device that supports nothing else can be allowed legacy algorithms in the integration's settings; that change is recorded in the audit log.