What is NetBox? #
NetBox is an application that models and documents modern networks. The application includes IP address management (IPAM), datacenter infrastructure management (DCIM), and APIs and extensions.
Why Should You Use the NetBox Connector? #
The NetBox connector provides visibility into the assets in your environment. You can use this visibility to:
-
ensure assets are managed per your security policies
-
derive relationships between assets, users, applications, and data
How Does This Connector Work? #
Lucidum executes read-only requests to the NetBox REST API and ingests only meta-data about NetBox devices. Lucidum does not retrieve any data stored on your assets.
Configuring the Connector in Lucidum #
|
Field |
Description |
Example |
|---|---|---|
|
URL |
The URL for the NetBox API. |
http://ip_address:port_number/imcrs |
|
API Token |
API Token for a NetBox account with read access. |
************ |
|
Proxy |
If you are using a proxy server to allow this connector to communicate with on-premises devices, enter the IP address: port for the proxy server, usually 192.168.255.6:3128 |
192.168.255.6:3128 |
Source Documentation #
Creating Credentials #
To create a user account for the Lucidum connector with permissions to view devices, see:
-
Log in to the web UI for NetBox as a user with “staff” permissions or greater.
-
In the Admin menu, select Authentication.
-
In the Django administration subsite, create a new user.
-
Assign the user View permissions for Devices.
To generate an API Token for the account:
-
Login to the web UI for netbox as the user with View permissions for Devices.
-
Click on your user profile
-
Navigate to the API tokens.
-
Generate an API token for the account.
Required Permissions #
View Devices (dcim.view_device)
