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.
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.
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.
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.