browse
Network device registration
A network device is a piece of physical hardware (often a router) that's registered as a network device in Cisco Umbrella. A network device can be described as an "Identity" in Cisco Umbrella, and you can add a policy that applies to the network device and all traffic from computers behind it. You can also report on the traffic originating from the network device.
For most users, simply configuring their egress router to use Cisco Umbrella and then applying policy to the network identity does largely the same function as having an integrated device. However, device integrations can provide some additional functionality, varying on a per-device type basis.
The integration is provided by the device manufacturer and is offered on a per-model basis depending on the device type and firmware.
A network device is registered with Cisco Umbrella through one of two methods. Authentication to register is provided in the device itself in the form of a username and password or the form of an API token and key. Information about the API key can be ignored.
Username and password
For the following device manufacturers with a Cisco Umbrella or OpenDNS integration, we ask that you enter the username and password for Cisco Umbrella in the device itself. This allows it to authenticate and auto-register:
-
Aruba Networks
-
Cradlepoint
-
Aerohive (integration is only supported on HiveManager Classic)
Log into the interface for the network device, then enter the username and password for your Cisco Umbrella account. The network device should authenticate automatically and appear in the Umbrella dashboard in a few minutes. Information about the API token (below) can be ignored.
IMPORTANT: If you are an MSP for Cisco Umbrella: Do not use your MSP Administrator username and password for this authentication. That username and password are associated with your MSP Console and not with the customer (or child) organization that you are configuring the network device. In this instance, make sure that your account is also added as a local full administrator in the child organization or use an existing administrator account for that organization. You must have one unique administrator per child or customer organization.
API token
The second way to register a network device is with an API token.
The two major appliance types that support this type of integration are the Cisco WLAN Controllers, the Cisco 1100 Series Integrated Services Routers (ISR), and the Cisco ISR4k.
For more information about these integration types, see Hardware Deployments.
Once your network device has been integrated, you need only provide a single organization-specific token (obtained from the Cisco Umbrella dashboard) to a device to have it appear in the dashboard as an Identity you can manage.
To obtain a token:
- Log into Cisco Umbrella and navigate to Identities > Network Devices.
- Click Get My API Token to obtain the token associated with your organization. The token is tied both to the organization and the device manufacturer.
- Click the
(Copy) icon to copy your API token.
- Log into your network device and paste the API token in the appropriate location.
Note: Some devices may require you to use a command line interface (CLI) or a configuration file to upload the API key to the device. If instructions are unavailable from Cisco, please refer to your device manufacturer.
Managing or deleting Network Devices
We've moved the information found here to our Cisco Umbrella documentation. For more information about deleting network devices, see Delete a Network Device (SIG Umbrella) or Delete a Network Device (DNS Umbrella).