Webhook Runbook Overview

Riverbed IQ executes the Webhook Runbook when it receives a call to a matching externally exposed Riverbed IQ Webhook API (refer to Automation Management Page).

This powerful capability enables Entities that are external to Riverbed IQ (e.g. external/third-party tooling/infrastructure) to call an externally exposed Riverbed IQ Webhook API to execute an associated Webhook Runbook. External Entities that require the execution of more than one Riverbed IQ Webhook Runbook require the configuration of multiple External Triggers (one for each of the Webhook Runbook targets).

The following sections instruct on the construction of a Simple Riverbed IQ Webhook Runbook from scratch. Each section covers in detail the following areas of the Runbook structure:

  1. Runbook Entry-point. Every Runbook automation starts with a Triggering Entity (aka trigger). Each trigger both:

    1. Represents the entry-point into the automation.

    2. Provides a pathway for passing information/context into the automation for processing.

    NOTE: External Triggers Webhook Runbooks leverage only the Webhook trigger.

  2. Runbook Native Data-format. Information may be passed into a Webhook trigger through HTTP headers and/or payload. In either case, this information must be converted into a native Runbook Data format so that the automation can process it.

  3. Runbook Processing-logic. The graph of interconnected Runbook nodes represents the processing workflows that perform the desired automation.

Conceptual-view of Example Runbook - Simple Webhook

Note for Aternity

Aternity Intelligent Service Desk (ISD) leverages Riverbed IQ Webhook Runbooks to perform automations.

Aternity ISD integrates with Riverbed IQ to access this capability.

When configuring an ISD automation on Aternity:

  • The User will be able to either choose from a list of available and existing Webhook Runbook automations, or create a new Webhook Runbook automation.

  • When complete, Aternity automatically configures the needed Automation Management on Riverbed IQ to:

    • Setup the Webhook URL which Aternity can call to trigger execution.

    • Map the specific target Webhook Runbook.

After Aternity completes configuration of an ISD Runbook, Aternity ISD can asynchronously trigger execution of that Runbook as needed.

Next Step