Skip to content

Sources

Sources are a key part of the plugin, they are used to define the connection to IP Fabric. Once configured sources will be used by background tasks to synchronize data from IP Fabric to NetBox. Multiple sources can be configured if multiple IP Fabric instances are being used such as a production and development instance.

Pre-requisites

Before creating a source you will need to have the following information to hand:

  • IP Fabric URL
  • IP Fabric API Token

To create an API Token please see the IP Fabric Documentation.

Parameters

Field Description Type
Name Name of the source CharField
URL IP Fabric URL CharField
API Token IP Fabric API Token CharField
Verify Validate HTTPS Certificate (use false if using a self signed certificate) Boolean
Description Description for the source CharField
Comments Provide additional comments for the source CharField
Tags Apply tags to the source ForeignKey

Info

If your IP Fabric instance is using a self signed certificate you will need to set the Verify field to false. This will disable the validation of the certificate. Currently there is no way to validate custom certificates, we are working on that.

Creating a source

To create a source navigate to Plugins > IP Fabric > Sources > Add. This will bring up a form to enter the details of the IP Fabric instance. Create Source

Syncing a source

Once a source has been added to NetBox it does not mean that data will be synchronized. NetBox does not know what snapshots to synchronize from IP Fabric. So first the snapshots must be synchronized.

Navigate to your source and click the Sync button. This will create a background task to synchronize the snapshots from IP Fabric.

Sync Source

Once the synchronization has completed you will see the number of snapshots shown within the Related Objects section.

Source Snapshots

Snapshots

Clicking through to the snapshots will show you all the snapshots that have been synchronized from IP Fabric into NetBox. There will be one snapshot created with the snapshot_id of $last this is IP Fabrics way of getting information from the API for the latest snapshot.

Snapshots

Each snapshot will show the following information:

  • IP Fabric Version
  • Status
  • Site Count
  • Sites
  • Device Count
  • Interface Count
  • Note

This information is used when creating an ingestion to determine the snapshot and site to synchronize from IP Fabric to NetBox. this page also contains the raw JSON for the snapshot that is returned via the IP Fabric API.

Snapshot Detail