Overview

NetBox is the leading solution for modeling and documenting modern networks. By combining the traditional disciplines of IP address management (IPAM) and datacenter infrastructure management (DCIM) with powerful APIs and extensions, NetBox provides the ideal “source of truth” to power network automation. Read on to discover why thousands of organizations worldwide put NetBox at the heart of their infrastructure.

Connecting NetBox to Keep

To connect NetBox to Keep, you need to create a webhook in NetBox.

  1. Go to NetBox dashboard, click on Webhooks under Operations section in the sidebar.
  1. Add a new webhook by clicking on Add button.
  1. Enter https://api.keephq.dev/alerts/event/netbox as the URL and select the request method as POST.

  2. Follow the below steps to create a new API key in Keep.

  3. Go to Keep dashboard and click on the profile icon in the botton left corner and click Settings.

  1. Select Users and Access tab and then select API Keys tab and create a new API key.
  1. Give name and select the role as webhook and click on Create API Key.
  1. In the Additional headers field enter X-API-KEY as the key and the API key generated in step 7 as the value. It should look like below. Refer the screenshot from step 3.
X-API-KEY: your-api-key
  1. Disable the SSL verification (Optional) or enable it based on your requirement.
  1. Click on Save to save the webhook.

  2. Go to Event Rules under Operations section in the sidebar and click on Add button to create a new event rule.

  1. Fill the required fields based on your requirement. Select the Object types and Event types for which you want to receive the events.
  1. In the Action type select Webhook and select the webhook created in step 3 and click on Save.

Now, you have successfully connected NetBox to Keep. You will start receiving the events in Keep based on the event rules you have created.