cisco-dnac-platform-webex-notifications
This repository is deprecated; please follow the main search page or use the ‘Related code repos’ widget on the right side of the current page.
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
- 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
- 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 (robert@nigma.org)
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
View code on GitHub
Owner
Contributors
Github contributorCategories
Products
Cisco Catalyst CenterWebexProgramming Languages
PythonLicense
Other
Code Exchange Community
Get help, share code, and collaborate with other developers in the Code Exchange community.View CommunityDisclaimer:
Cisco provides Code Exchange for convenience and informational purposes only, with no support of any kind. This page contains information and links from third-party websites that are governed by their own separate terms. Reference to a project or contributor on this page does not imply any affiliation with or endorsement by Cisco.
Cisco provides Code Exchange for convenience and informational purposes only, with no support of any kind. This page contains information and links from third-party websites that are governed by their own separate terms. Reference to a project or contributor on this page does not imply any affiliation with or endorsement by Cisco.