Place the code in the extras/plugins/ folder

Once installed, the plugin needs to be enabled in your configuration.py:

vim /opt/netbox/netbox/netbox/configuration.py

PLUGINS = ["netbox_sdn_controller"]

Install the following packages in your virtual environment with pip install.

dnacentersdk >= 2.8.3
netutils==1.14.1

Put the credentials for your Cisco Catalyst Center API in your environment variables.

Example:

DNAC_USER=my_user
DNAC_PASSWORD=my_psswd

Restart NetBox.

Run:

python3 manage.py migrate

In order to correctly import interfaces associated with Cisco modules, it is important to modify their templates. The {chassis} variable, similar to {module} but not natively supported by NetBox, must take the first position. The same mechanism should be implemented soon for devices.

Go to the plugins tab in the navbar and click Add in SDN Controllers or go to $NETBOX_URL/plugins/netbox-sdn-controller/sdn-controller/add/ to add your sdn controller

Hostname

The Sdn Controller hostname as in https://{hostname}/ for the api's base url

Version

The api's version. For example, 2.3.7.9 in Catalyst Center

Sdn Type

Right now, the default type is Catalyst Center. This is the only type implemented so far

Device Families

Select the desired families. No selection means all families

Default Tenant

The default tenant for devices that do not exist in NetBox. Can then be edited by a user

Regex Template

Regex rule to determine the site and device role from the hostname.

This project is licensed to you under the terms of the Apache License, Version 2.0.