Skip to main content

Netbox

Installation

info

You will need your Netbox instance hostname and an API Key to set up this integration. See Netbox's documentation for more information on creating API tokens.

Configuration in Netbox

  1. Log in to your Netbox instance.
  2. Navigate to your user profile or the admin panel.
  3. Create a new API token with appropriate permissions to read the resources you want to ingest into JupiterOne.
  4. Note your Netbox instance hostname (e.g., https://netbox.example.com).

Configuration in JupiterOne

To install the Netbox integration in JupiterOne, navigate to the Integrations tab in JupiterOne and select Netbox. Click New Instance to begin configuring your integration.

Creating an instance requires the following:

  • The Account Name used to identify the Netbox account in JupiterOne. Ingested entities will have this value stored in tag.AccountName when the AccountName toggle is enabled.

  • Description to assist in identifying the integration instance, if desired.

  • Polling Interval that you feel is sufficient for your monitoring needs. You may leave this as DISABLED and manually execute the integration.

  • Your Netbox Host location (e.g., https://netbox.example.com).

  • Your Netbox API Key secret to access your Netbox instance.

  • Optionally, you can enable Disable TLS Verification to disable TLS certificate verification. This is NOT RECOMMENDED. Please install a valid TLS certificate on your Netbox server instead.

Click Create once all values are provided to finalize the integration.

Next steps

Now that your integration instance has been configured, it will begin running on the polling interval you provided, populating data within JupiterOne. Continue on to our Instance management guide to learn more about working with and editing integration instances.