Cisco DNA Center Platform APIs and Integrations Overview This page explain Cisco DNA Center integration options: Intent APIs provide REST access to the Cisco DNA Center platform. Integration APIs enable IT Service Management workflows. Events and Notifications WebHooks enables notification on key events. The Multivendor API enables direct support for non-Cisco devices.

Cisco DNA Center Platform Overview

Cisco DNA Center is at the heart of Cisco’s intent-based network architecture. Cisco DNA Center supports the expression of business intent for network use cases, such as base automation capabilities in the enterprise network. The Analytics and Assurance features of Cisco DNA Center provide end-to-end visibility into the network with full context through data and insights.

Cisco customers and partners can use the Cisco DNA Center platform to create value-added applications that leverage the native capabilities of Cisco DNA Center. Use Cisco DNA Center Intent APIs, Integration Flows, Events and Notification Services to enhance the overall network experience by optimizing end-to-end IT processes, reducing Total Cost of Ownership (TCO), and creating value-added networks.

Intent API (Northbound)

The Intent API is a Northbound REST API that exposes specific capabilities of the Cisco DNA Center platform. The Intent API provides policy-based abstraction of business intent, allowing focus on an outcome rather than struggling with individual mechanisms steps. The RESTful Cisco DNA Center Intent API uses HTTPS verbs (GET, POST, PUT, and DELETE) with JSON structures to discover and control the network. For more information, see Intent API. The Intent API is grouped, hierarchically into functional 'domains' and 'subdomains' of service. These are:

Authentication Domain

Cisco DNA Center platform REST methods require caller Authentication.

  • Authentication method obtains a security token that identifies the privileges of an authenticated REST caller. Cisco DNA Center authorizes each requested operation according to the access privileges associated with the security token that accompanies the request.

Know Your Network Domain

Use the Know Your Network REST methods to GET information about clients, sites, topology, devices, and issues; Create (POST) and manage (PUT, DELETE) sites, devices, IP Pools, edge and border devices, and authentication profiles. Know Your Network methods are organized into the following subdomains:

  • Sites

    Create and manage sites, assign devices to sites, obtain site information, site count, and site membership. Sites are hierarichal collectons of other sites and 'builings'

  • Topology

    Retrieve network health information and site and network physical, Layer 2, Layer 3, and VLAN information.

  • Devices

    Create, manage, and retrieve detailed information about devices by a wide range of attributes such as timestamp, MAC address, UUID, name, or nwDeviceName, functional capabilities, interfaces, device config, certificate validation status, values of specified fields,modules, and VLAN data associated with specified interfaces.

  • Clients

    Obtain (GET) detailed client and client health information.

  • Users

    Obtain (GET) detailed information about a 'User' given an identifying network user-id or MAC address.

  • Issues

    Obtain (GET) detailed information and recommended mitigation for an 'Issue' given an identifying issue-id or MAC address.

Site Management

  • Site Design

    These methods to create and obtain information about provisioned NFV devices.

  • Network Settings

    Includes methods to GET device credentials, global pool information, and service provider details. It also supports DELETion of device credentials, service provider profiles, and global IP pools.

  • Software Image Management (SWIM)

    Software Image Management (SWIM) manages the software image and update repository for network devices. Software images can be stored on the Cisco DNA Center or imported from a designated URL. These methods support phases of Software Image Management including the ability to import software images, and distribute and activate images to and on devices.

  • Device Onboarding (PnP)

    This set of methods support management of device onboarding projects, settings, workflows, virtual accounts, and PnP-managed devices. They provide means of zero-touch deployment of Cisco Enterprise Network routers, switches and wireless controllers, and wireless access points.

  • Configuration Templates

    Configuration Templates with the Template Programmer/Editior is a centralized CLI-management tool that facilitates design and provisioning of workflows in Cisco DNA Center. CLI templates also known as configuration templates. These methods provide management of CLI templates. CLI templates may be grouped into projects. Use this API to create, view, edit, delete and version templates and projects.

Connectivity

Connectivity methods provides the means for configuring and managing Fabric Wired and Non-Fabric Wireless networks.

  • Fabric Wired

    These methods to manage fabric wired devices, including creation, update, and deletion of edge, border, user devices, and authentiation profiles,

  • Non-Fabric Wireless

    These methods to manage and provision non-fabric wireless devices, including Enterprise SSIDs, wireless profiles, RF profiles, and access points.

Operational Tasks

Operational Tools enable access to CLI keywords, discover network devices, trace paths through the network, identify and discover network components using SNMP and other discovery protocols,

  • Command Runner

    These methods support retrieval of CLI keywords and enable execution of read-only commands on a target network device.

  • Network Discovery

    Discovery is the process of scanning a target network in order to add existing devices to the device Inventory. Discovery service methods using SNMP and other protocols to create, update, delete and manage discovery tasks and associated credentials.

  • Path Trace

    These methods provide flow-analysis between two endpoints on the network. New path-traces analysis can be initiated, and prior path-traces can be read. Multiple prior path traces can be summarized.

  • File

    File services to list file namespaces, files in a namespace, and to download a specific file.

  • Task

    Tasks are Cisco DNA Center activities methods initiated for asynchronous execution via an API request. These GET methods include status information about a single task, indicating completion or if, in-progress. Task methods also can return a count of tasks, and lists of tasks by 'tree', task-id, OperationId.

  • Tags

    A 'tag' is a named set of attributes that can be associated with 'members'. Tags services provide the means to create, discover, update membership of, and remove tags.

Policy

  • Application Policy

    The Cisco DNA Center platform enables creation of application policies used to reflect your organization's business intent and translates it into network-specific and device-specific configurations required by the different types, makes, models, operating systems, roles, and resource constraints of your network devices. Application Policy methods supports the creation, update, adn management of applications and application sets.

Event Management

  • Event Management

    The Cisco DNA Center platform provides the ability to receive custom notifications when specific events are triggered, such as Cisco DNA Assurance and Automation (SWIM) events. This mechanism enables third party systems to take business actions in response to a particular event. For example, a custom application could execute a software upgrade action in response to notification of network devices that are out of compliance. Event subscriptions allow association of a notification method with a DNA Center event. These methods provide the means to create, read, update, and delete event subscriptions.

Events and Notifications (Eastbound)

The Cisco DNA Center platform provides the ability to establish a notification handler when specific events are triggered, such as Cisco DNA Assurance and Automation (SWIM) events. This mechanism enables external systems to take actions in response to an event. For example, a custom application could execute a software upgrade action in response to notification of network devices that are out of compliance. Notifications may also be triggered by events internal DNA Center events. For example, Assurance events can be customized for IT Service Management incidents.

Integration API (Westbound)

Integration capabilities are part of Westbound interfaces. To meet the need to scale and accelerate operations in modern data centers, IT operators require intelligent, end-to-end work flows built with open APIs. The Cisco DNA Center platform provides mechanisms for integrating Cisco DNA Assurance workflows and data with third-party IT Service Management (ITSM) solutions.

IT Service Management (ITSM) minimizes handoffs, reduces duplication of issues, and optimizes processes by integrating the Cisco DNA Center platform into incident-management, change-management and problem-management systems. It also integrates the Cisco DNA Center platform into approval- and pre-approval chains, and it links the Cisco DNA Center platform with formal change- and maintenance-window schedules.

The platform also integrates with Reporting and Analytics capabilities for capacity planning, asset management, compliance control, and auditing. The Cisco DNA Center platform boosts IT efficiency and automation by integrating seamlessly with other IT systems through RESTful APIs.

The Cisco DNA Center platform supports the IT4IT™ Reference Architecture, including the standards for events, incidents, problems, and request for changes. If you are using an ITSM system that supports this reference architecture, then the Cisco DNA Center platform can integrate with your system.

For more information, see Integration API Capabilities