Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/robertcsapo/cisco-dnac-platform-webex-notifications

Receive Events from Cisco DNA Center and push the information to Cisco Webex Teams
https://github.com/robertcsapo/cisco-dnac-platform-webex-notifications

cisco cisco-dna-center cisco-webex-teams dna dna-center dnac docker docker-compose flask python python-webhook receive-events webex webhook

Last synced: 26 days ago
JSON representation

Receive Events from Cisco DNA Center and push the information to Cisco Webex Teams

Host: GitHub
URL: https://github.com/robertcsapo/cisco-dnac-platform-webex-notifications
Owner: robertcsapo
License: other
Created: 2019-01-15T15:51:02.000Z (almost 6 years ago)
Default Branch: master
Last Pushed: 2020-09-07T12:24:09.000Z (over 4 years ago)
Last Synced: 2024-08-03T20:02:59.100Z (4 months ago)
Topics: cisco, cisco-dna-center, cisco-webex-teams, dna, dna-center, dnac, docker, docker-compose, flask, python, python-webhook, receive-events, webex, webhook
Language: Python
Homepage:
Size: 704 KB
Stars: 10
Watchers: 2
Forks: 9
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

awesome-cisco-dnac - cisco-dnac-platform-webex-notifications

README

# cisco-dnac-platform-webex-notifications
[![published](https://static.production.devnetcloud.com/codeexchange/assets/images/devnet-published.svg)](https://developer.cisco.com/codeexchange/github/repo/robertcsapo/cisco-dnac-platform-webex-notifications)
## Receive Events from Cisco DNA Center and push the information to Cisco Webex Teams

## Disclaimer
* This solution isn't using Username/Password header with Cisco DNA Center (let me know if needed)
* You need to use HTTPS with Cisco DNA Center for Events API
- It's recommended to use this service with non-https and have a loadbalancer infront (https)
- SSL is now supported (ad-hoc) on this service (without LB) - not recommended for production

![](cisco.dnac.webex.teams.assurance.jpg)

## How to setup
### Python Webhook
#### Prerequisites
* Docker support
* Cisco Webex Teams Token and Teams ID
- How-To Guide https://developer.webex.com/docs/api/getting-started

### Start Python Webhook

```
docker run -d -p 5000:5000 -e WEBEX_TEAMS_ACCESS_TOKEN="TOKEN" -e WEBEX_TEAMS_ROOM_ID="ID" robertcsapo/cisco-dnac-platform-webex-notifications
```

If SSL is need

```
docker run -d -p 5000:5000 -e WEBEX_TEAMS_ACCESS_TOKEN="TOKEN" -e WEBEX_TEAMS_ROOM_ID="ID" robertcsapo/cisco-dnac-platform-webex-notifications --ssl
```

### Cisco DNA Center
#### Prerequisites
* Enable Cisco DNA Center as a Platform
- How-To Guide https://www.cisco.com/c/en/us/td/docs/cloud-systems-management/network-automation-and-management/dna-center-platform/1-3-1-0/user_guide/b_dnac_platform_ug_1_3_1_0/b_dnac_platform_ug_1_3_1_0_chapter_010.html
* Configure Cisco DNA Center Events (https:///dna/systemSettings/settings?settings-item=dnacp-events-settings)
- How-To Guide https://www.cisco.com/c/en/us/td/docs/cloud-systems-management/network-automation-and-management/dna-center-platform/1-3-1-0/user_guide/b_dnac_platform_ug_1_3_1_0/b_dnac_platform_ug_1_3_1_0_chapter_010.html
- Adam Radford's Blog https://blogs.cisco.com/developer/event-notifications-in-webex-teams

## Troubleshooting
### DNAC - /dnac URL (GET)
#### http://localhost:5000/dnac
The URL that you need to configure on Cisco DNA Center
#### Response
```cisco-dnac-platform-webex-notifications version -> by Robert Csapo ([email protected])```
### Sample - /sample URL (GET)
#### GET http://localhost:5000/sample
Sends Sample data from outputdata.json
#### Response
```Sample JSON Payload received```

### Webex - /webex URL (GET)
#### GET http://localhost:5000/webex
Sends Sample data to Webex Room
#### Response
```Sample Webex Teams Message```

### Post Sample (POST) - /postsample URL
#### POST http://localhost:5000/postsample
Send your own JSON sample data (use POST Method and Postman)
#### POST JSON Sample Data (through Postman or curl)

### Cisco DNA Center (POST) - /dnac URL
#### POST http://localhost:5000/dnac
This is the URL Path that Cisco DNA Center uses
#### You configure this in Systems Settings (Cisco DNA Center)
```
{
"id": "AWZJw6y7OyE4MOPs83V-",
"instanceId": "E-NETWORK-EVENT-AWZJw6y7OyE4MOPs83V--1538835787576",
"category": "Warn",
"status": "NEW",
"timestamp": 1538835787576,
"severity": "P1",
"domain": "Availability",
"source": "DNAC",
"priority": "P1",
"type": "Network",
"title": "Device unreachable",
"description": "This network device {network_device} is unreachable from controller. The device role is {fabricOrDeviceRole}.",
"actualServiceId": "100.68.0.66",
"assignedTo": "",
"enrichmentInfo": {
"issueDetails": {
"issue": [{
"issueId": "AWZJw6y7OyE4MOPs83V-",
"issueSource": "Cisco DNA",
"issueCategory": "Availability",
"issueName": "snmp_device_down",
"issueDescription": "This network device {network_device} is unreachable from controller. The device role is {fabricOrDeviceRole}.",
"issueEntity": "network_device",
"issueEntityValue": "100.68.0.66",
"issueSeverity": "HIGH",
"issuePriority": "",
"issueSummary": "Network Device 100.68.0.66 Is Unreachable From Controller",
"issueTimestamp": 1538835787576,
"suggestedActions": [{
"message": "From the controller, verify whether the last hop is reachable.",
"steps": []
}, {
"message": "Verify that the physical port(s) on the network device associated with the network device discovery(IP) is UP.",
"steps": []
}, {
"message": "Verify access to the device.",
"steps": []
}],
"impactedHosts": [{
"hostName": "Unknown",
"hostOs": "Unknown",
"ssid": "Unknown",
"connectedInterface": "Unknown",
"macAddress": "100.67.0.35",
"failedAttempts": 3,
"location": {
"siteId": "UNASSIGNED",
"siteType": "BUILDING",
"area": "Global",
"building": "UNASSIGNED",
"apsImpacted": []
},
"timestamp": 1538835787576
}, {
"hostName": "Unknown",
"hostOs": "Unknown",
"ssid": "Unknown",
"connectedInterface": "Unknown",
"macAddress": "100.69.0.68",
"failedAttempts": 3,
"location": {
"siteId": "UNASSIGNED",
"siteType": "BUILDING",
"area": "Global",
"building": "UNASSIGNED",
"apsImpacted": []
},
"timestamp": 1538835787576
}, {
"hostName": "Unknown",
"hostOs": "Unknown",
"ssid": "Unknown",
"connectedInterface": "Unknown",
"macAddress": "100.68.0.66",
"failedAttempts": 3,
"location": {
"siteId": "UNASSIGNED",
"siteType": "BUILDING",
"area": "Global",
"building": "UNASSIGNED",
"apsImpacted": []
},
"timestamp": 1538835787576
}, {
"hostName": "Unknown",
"hostOs": "Unknown",
"ssid": "Unknown",
"connectedInterface": "Unknown",
"macAddress": "100.68.0.67",
"failedAttempts": 3,
"location": {
"siteId": "UNASSIGNED",
"siteType": "BUILDING",
"area": "Global",
"building": "UNASSIGNED",
"apsImpacted": []
},
"timestamp": 1538835787576
}, {
"hostName": "Unknown",
"hostOs": "Unknown",
"ssid": "Unknown",
"connectedInterface": "Unknown",
"macAddress": "100.66.10.35",
"failedAttempts": 3,
"location": {
"siteId": "UNASSIGNED",
"siteType": "BUILDING",
"area": "Global",
"building": "UNASSIGNED",
"apsImpacted": []
},
"timestamp": 1538835787576
}, {
"hostName": "Unknown",
"hostOs": "Unknown",
"ssid": "Unknown",
"connectedInterface": "Unknown",
"macAddress": "100.65.253.18",
"failedAttempts": 3,
"location": {
"siteId": "UNASSIGNED",
"siteType": "BUILDING",
"area": "Global",
"building": "UNASSIGNED",
"apsImpacted": []
},
"timestamp": 1538835787576
}, {
"hostName": "Unknown",
"hostOs": "Unknown",
"ssid": "Unknown",
"connectedInterface": "Unknown",
"macAddress": "100.67.0.34",
"failedAttempts": 3,
"location": {
"siteId": "UNASSIGNED",
"siteType": "BUILDING",
"area": "Global",
"building": "UNASSIGNED",
"apsImpacted": []
},
"timestamp": 1538835787576
}]
}]
},
"connectedDevice": [{
"deviceDetails": {
"cisco360view": "https://100.65.1.10/dna/assurance/home#networkDevice/undefined"
}
}]
}
}
```
#### Response
```Sample JSON Payload received```