Skip to main content

Infoblox

The Infoblox integration reads an Infoblox NIOS grid through the grid master's web API (WAPI). It runs on an Integrator inside your network, so the grid master is never exposed to the CyberOptix CTEM Platform.

It is read-only. The integration only queries the WAPI and never changes a network, lease, record or grid setting.

What it collects​

SyncCollects
Host discoveryActive DHCP leases with their MAC and client name, fixed addresses, and the addresses of host, A, AAAA and PTR records
Network discoveryIPv4 and IPv6 networks with their comment, network view, default gateway (DHCP routers option) and VLAN, and network containers

Every sync also reports the grid master as the device these belong to, with its platform, NIOS version and virtual IP. It appears under Attack Surface > Network Devices; leases and records under its endpoints, networks under its networks.

A network view other than default is reported as the network's VRF. VLANs come from grids with the VLAN feature (NIOS 8.4 or later); a grid without it is read without them.

An IPAM holds no device configuration, so this integration has no configuration backup or configuration review.

Create a read-only API admin​

Give the integration its own admin in a group that can only read, through the API only.

  1. Under Administration > Administrators > Groups, add a group (for example api-readonly). On the Interfaces tab allow only the API interface, so the admin cannot log in to the grid manager.
  2. On the group's Permissions tab, grant Read-only on all DHCP objects, all DNS objects and all IPAM objects (networks, network containers, network views and VLANs). Grant Read-only on Grid and Members as well, so the integration can name the grid master; leave every other permission denied.
  3. Under Administration > Administrators > Admins, add an admin (for example inventory) with a strong password, authenticated locally, in that group.
  4. The group needs no superuser rights and no permission on the file distribution, upgrade or restart features.

Test the admin from the Integrator before connecting it:

curl -u inventory --cacert gridmaster.pem \
'https://gridmaster.example.com/wapi/v2.12/grid?_return_fields=name'

The grid answers with the grid's name. A 401 means the password or group is wrong; a 403 means the group lacks read permission on the object.

Connect it​

  1. Under Integrations, add Infoblox with the grid master's hostname or virtual IP, the admin's username and its password.
  2. In the integration's settings, assign the Integrator that can reach the grid master on port 443.
  3. Enable the syncs you want.

The grid master serves a self-signed certificate unless you have installed one from your CA. The first connection records the certificate's fingerprint on the integration, and every later connection must present the same certificate. After replacing the certificate, clear the pinned fingerprint in the integration's settings so the new one is recorded. A certificate issued by a trusted CA is verified normally and never pinned.

A refused username or password fails the sync with an error. It does not report an empty grid.