Table of Contents

• Getting Started
  • Helpful Background Information
  • Prerequisites
  • External Dependencies
  • Adapters
  • How to Install
  • Testing
• Using this Workflow Project
  • Analyze Service Path - IP Fabric - REST
  • Compare Network Routes From Snapshots - IP Fabric - REST
  • Compare Snapshot Inventory - IP Fabric - REST
  • Create Network Snapshot - IP Fabric - REST
• Additional Information
  • Support

Getting Started

This section is helpful for deployments as it provides you with pertinent information on prerequisites and properties.

Helpful Background Information

Workflows often include logic that varies from business to business. As a result, we often find that our Workflow Projects are more useful as modular components that can be incorporated into a larger process. In addition, they often can add value as a learning tool on how we integrate with other systems and how we do things within the Itential Automation Platform.

While these can be utilized, you may find more value in using them as a starting point to build around.

Prerequisites

Itential Workflow Projects are built and tested on particular versions of IAP. In addition, Workflow Projects are often dependent on external systems and as such, these Workflow Projects will have dependencies on these other systems. This version of IP Fabric - REST has been tested with:

• IAP 2023.2

External Dependencies

Adapters

How to Install

To install the Workflow Project:

• Verify you are running a supported version of the Itential Automation Platform (IAP) as listed above in the Supported IAP Versions section in order to install the Example Project.
• Import the Example Project in Admin Essentials.

Testing

Cypress is generally used to test all Itential Example Projects. While Cypress is an opensource tool, at Itential we have internal libraries that have been built around Cypress to allow us to test with a deployed IAP.

When certifying our Example Projects for a release of IAP we run these tests against the particular version of IAP and create a release branch in GitLab. If you do not see the Example Project available in your version of IAP please contact Itential.

While Itential tests this Example Project and its capabilities, it is often the case the customer environments offer their own unique circumstances. Therefore, it is our recommendation that you deploy this Example Project into a development/testing environment in which you can test the Example Project.

Using this Workflow Project

Workflow Projects contain 1 or more workflows. Each of these workflows have different inputs and outputs.

Analyze Service Path - IP Fabric - REST

Run end to end service path analysis within IP Fabric Automated Network Assurance Platform

Capabilities include:

• The workflow is used to run end to end service path analysis within IP Fabric Automated Network Assurance Platform

Entry Point IAP Component

The primary IAP component to run Analyze Service Path - IP Fabric - REST is listed below:

Inputs

The following table lists the inputs for Analyze Service Path - IP Fabric - REST:

10.1.1.1

10.2.2.1

80

80

tcp

IPFabric

Outputs

There are no outputs for Analyze Service Path - IP Fabric - REST.

Query Output

There are no query output examples for Analyze Service Path - IP Fabric - REST.

Example Inputs and Outputs

Example 1

Input:

{
  "adapterId": "IPFabric",
  "source": "10.1.1.1",
  "destination": "10.2.2.1",
  "sourcePort": "80",
  "destinationPort": "80",
  "protocol": "tcp"
} 

Output:

{} 

API Links

Compare Network Routes From Snapshots - IP Fabric - REST

Compare the last and penultimate (previous) snapshots taken by the IP Fabric Automated Network Assurance Platform

Capabilities include:

• The workflow is used to compare the last and penultimate (previous) snapshots taken by the IP Fabric Automated Network Assurance Platform

Entry Point IAP Component

The primary IAP component to run Compare Network Routes From Snapshots - IP Fabric - REST is listed below:

Inputs

The following table lists the inputs for Compare Network Routes From Snapshots - IP Fabric - REST:

IPFabric

Outputs

There are no outputs for Compare Network Routes From Snapshots - IP Fabric - REST.

Query Output

There are no query output examples for Compare Network Routes From Snapshots - IP Fabric - REST.

Example Inputs and Outputs

Example 1

Input:

{
  "adapterId": "IPFabric"
} 

Output:

{} 

API Links

Compare Snapshot Inventory - IP Fabric - REST

Compare two network snapshots leveraging the IP Fabric Automated Network Assurance Platform

Capabilities include:

• The workflow is used to compare two network snapshots leveraging the IP Fabric Automated Network Assurance Platform

Entry Point IAP Component

The primary IAP component to run Compare Snapshot Inventory - IP Fabric - REST is listed below:

Inputs

The following table lists the inputs for Compare Snapshot Inventory - IP Fabric - REST:

IPFabric

Outputs

The following table lists the outputs for Compare Snapshot Inventory - IP Fabric - REST:

[]

[
  {
    "hostname": "L35SD177",
    "loginIp": "10.35.255.169",
    "version": "15.2(CML_NIGHTLY_20150703)FLO_DSGS7",
    "uptime": null,
    "status": "removed"
  },
  {
    "hostname": "L35SD176",
    "loginIp": "10.35.255.168",
    "version": "15.2(CML_NIGHTLY_20150703)FLO_DSGS7",
    "uptime": null,
    "status": "removed"
  },
  {
    "hostname": "L35AC121",
    "loginIp": "10.35.129.176",
    "version": "15.2(20170809:194209)",
    "uptime": null,
    "status": "removed"
  },
  {
    "hostname": "L35AC122",
    "loginIp": "10.35.129.177",
    "version": "15.2(20170809:194209)",
    "uptime": null,
    "status": "removed"
  }
]

Query Output

The following items show how to query successful results from the output of Compare Snapshot Inventory - IP Fabric - REST:

Added Devices

devicesAdded

Removed Devices

devicesRemoved

Example Inputs and Outputs

Example 1

Input:

{
  "adapterId": "IPFabric"
} 

Output:

{
  "devicesAdded": [],
  "devicesRemoved": [
    {
      "hostname": "L35SD177",
      "loginIp": "10.35.255.169",
      "version": "15.2(CML_NIGHTLY_20150703)FLO_DSGS7",
      "uptime": null,
      "status": "removed"
    },
    {
      "hostname": "L35SD176",
      "loginIp": "10.35.255.168",
      "version": "15.2(CML_NIGHTLY_20150703)FLO_DSGS7",
      "uptime": null,
      "status": "removed"
    },
    {
      "hostname": "L35AC121",
      "loginIp": "10.35.129.176",
      "version": "15.2(20170809:194209)",
      "uptime": null,
      "status": "removed"
    },
    {
      "hostname": "L35AC122",
      "loginIp": "10.35.129.177",
      "version": "15.2(20170809:194209)",
      "uptime": null,
      "status": "removed"
    }
  ]
} 

API Links

Create Network Snapshot - IP Fabric - REST

Create a snapshot of the network using the IP Fabric Automated Network Assurance Platform

Capabilities include:

• The workflow is used to create a snapshot of the network using the IP Fabric Automated Network Assurance Platform

Entry Point IAP Component

The primary IAP component to run Create Network Snapshot - IP Fabric - REST is listed below:

Inputs

The following table lists the inputs for Create Network Snapshot - IP Fabric - REST:

test-snapshot2

testing purpose

[
  {
    "excludeNetworks": [],
    "network": [],
    "expirationDate": {
      "enabled": false
    },
    "username": "user",
    "password": "password",
    "syslog": true
  }
]

IPFabric

Outputs

The following table lists the outputs for Create Network Snapshot - IP Fabric - REST:

{
  "icode": "AD.200",
  "response": {
    "success": true
  }
}

Query Output

The following items show how to query successful results from the output of Create Network Snapshot - IP Fabric - REST:

Create Snapshot Request Result

snapshotDetails.response

Example Inputs and Outputs

Example 1

Input:

{
  "adapterId": "IPFabric",
  "snapshotName": "test-snapshot2",
  "snapshotNote": "testing purpose",
  "credentials": [
    {
      "excludeNetworks": [],
      "network": [],
      "expirationDate": {
        "enabled": false
      },
      "username": "user",
      "password": "password",
      "syslog": true
    }
  ]
} 

Output:

{
  "snapshotDetails": {
    "icode": "AD.200",
    "response": {
      "success": true
    }
  }
} 

API Links

Additional Information

Support

Please use your Itential Customer Success account if you need support when using this Workflow Project.