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.
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.
|Name||Name of the source||
|URL||IP Fabric URL||
|API Token||IP Fabric API Token||
|Verify||Validate HTTPS Certificate (use false if using a self signed certificate)||
|Description||Description for the source||
|Comments||Provide additional comments for the source||
|Tags||Apply tags to the source||
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
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.
Once the synchronization has completed you will see the number of snapshots shown within the Related Objects section.
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
$last this is IP Fabrics way of getting information from the API for the latest snapshot.
Each snapshot will show the following information:
- IP Fabric Version
- Site Count
- Device Count
- Interface Count
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.