Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/robertcsapo/ciscodnacnetbox

Cisco DNA Center Integration with NetBox
https://github.com/robertcsapo/ciscodnacnetbox

api cisco cisco-dna-center django netbox netbox-plugin netbox-script python

Last synced: about 6 hours ago
JSON representation

Cisco DNA Center Integration with NetBox

Host: GitHub
URL: https://github.com/robertcsapo/ciscodnacnetbox
Owner: robertcsapo
License: other
Created: 2021-01-21T19:59:43.000Z (almost 4 years ago)
Default Branch: main
Last Pushed: 2023-11-09T14:07:10.000Z (about 1 year ago)
Last Synced: 2024-09-15T05:24:57.306Z (2 months ago)
Topics: api, cisco, cisco-dna-center, django, netbox, netbox-plugin, netbox-script, python
Language: Python
Homepage:
Size: 1.63 MB
Stars: 34
Watchers: 7
Forks: 14
Open Issues: 6
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        # ciscodnacnetbox

![PyPI - Downloads](https://img.shields.io/pypi/dm/ciscodnacnetbox)

![PyPI - Wheel](https://img.shields.io/pypi/wheel/ciscodnacnetbox)

![PyPI](https://img.shields.io/pypi/v/ciscodnacnetbox)

*Cisco DNA Center Integration with NetBox*

---

```ciscodnacnetbox``` is a NetBox Plugin for Cisco DNA Center.  

It uses the Cisco DNA Center Platform APIs to sync data.

## Prerequisites

- Cisco DNA Center

    - Supported release: 1.3.3+

- NetBox

    - Supported release: 3.2

        - version ciscodnacnetbox 3.2.1

    - Supported release: 3.0

        - version ciscodnacnetbox 3.0.3

    - Supported release: 2.10

        - version ciscodnacnetbox 1.0.1

- Python

  - Version: 3.3+

## Data that is synced

- [x] Sites

- [x] Devices

- [x] IP Address (/32 of Devices)

## Screenshots

### Settings  

![](./img/settings_add.png)  

![](./img/settings.png)

### Status  

![](./img/status.png)

### Sync  

![](./img/task.png)  

![](./img/sync.png)

### NetBox Inventory

![](./img/sites.png)  

![](./img/devices.png)

## Getting Started

- Install the plugin from PyPi

    - ```pip install ciscodnacnetbox```

- Enable the plugin in ```configuration.py``` of NetBox

    ```

    PLUGINS = [

        'ciscodnacnetbox',

    ]

    ```

(More details at https://netbox.readthedocs.io/en/stable/plugins/)

If using Docker with NetBox, follow instructions on https://github.com/netbox-community/netbox-docker/wiki/Using-Netbox-Plugins

## Sync your data from Cisco DNA Center to NetBox

* Add your Cisco DNA Center(s) in Settings at the ciscodnacnetbox plugin

* Check status dashboard that API calls are OK towards your Cisco DNA Center (refresh if being cached)

* Use the buttons on the Dashboard to sync (Sites is mandatory for Devices to be assigned in Netbox)

## Technologies & Frameworks Used

**Cisco Products & Services:**

- [Cisco DNA Center](https://developer.cisco.com/docs/dna-center/#!cisco-dna-center-platform-overview)

**Third-Party Products & Services:**

- [NetBox](https://github.com/netbox-community/netbox)

**Tools & Frameworks:**

- [dnacentersdk](https://github.com/cisco-en-programmability/dnacentersdk) (Python SDK)

- [django](https://www.djangoproject.com/)

## Authors & Maintainers

- Robert Csapo 

## License

This project is licensed to you under the terms of the [Cisco Sample

Code License](./LICENSE).