robertcsapo/cisco-dnac-platform-webex-notifications
Receive Events from Cisco DNA-C and push the information to Cisco Webex Teams
Image
0
10K+
robertcsapo/cisco-dnac-platform-webex-notifications repository overview
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
How to setup
Python Webhook
Prerequisites
- Docker support
- Cisco Webex Teams Token and Teams ID
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
- 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 <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
Tag summary
Content type
Image
Digest
Size
56.4 MB
Last updated
about 6 years ago
docker pull robertcsapo/cisco-dnac-platform-webex-notifications