Introduction

This integration enables outbound for both SOAP API and REST API external calls to create process definition workflows. Multiple integration events can be configured as a single installed automation integration.

Automation integration is created based on one of the following types of events:

  • Alert
  • Resource
  • Incident
  • Task
  • JSON Object

After the integration is successfully installed, the name of the integration and its event details are visible for creating workflows in process definition workflows.

Configure custom automation integration

Follow these steps to configure the integration:

  1. Click All Clients, select a client.

  2. Click Setup > Account.

  3. Select the Integrations tile.

  4. The Installed Integrations screen is displayed, with all the installed applications. Click + ADD on the Installed Integrations page.

  5. If you do not have any installed applications, you will be navigated to the Available Integrations page. The Available Integrations page displays all the available applications along with the newly created application with the version.
    Note: Search for the application using the search option available. Alternatively, use the All Categories option to search.

  6. Click +ADD on the Custom (Automation) tile.

    Custom Automation - Configure screen
  7. Enter the following information:

    Table Note

    CONFIGURE

    Field NameField TypeDescription
    Use Parent configuration and eventsCheckboxSelect this option to inherit properties of a parent integration automatically.
    Select the Service Provider/Partner's custom integration from the drop-down list as applicable.
    NameStringEnter a unique name for the integration.
    DescriptionStringProvide a description for the integration.

    Note: If you select Use Parent configuration and events option, the Name and Description fields are disabled. These fields will be inherited along with other properties like configuration, events, outbound payload properties, outbound mapping attributes.

  8. Click Next. The OUTBOUND screen is displayed.

    Automation - Outbound screen

    CONFIGURATION: Click add and enter the following information in the ADD CONFIGURATION window:

    Custom Automation - Configuration screen

    Enable Internal end point option, if you want to execute any internal APIs. Once enabled, the Base URI is auto populated.

    Field NameField TypeDescription
    Base URIStringEnter the Base URI.
    Example: https://app1-internal.opsramp.net
    Notification TypeDropdownSelect notification type as REST API or SOAP API based on your requirements.
    Authentication TypeDropdownSelect an Authentication Type: None, Basic, OAuth2, JWT, Custom.
    The Authentication Types are displayed based on the Notification Type selected.

    See Outbound - Configuration for more information.

  9. Click ADD CONFIGURATION. The configuration details are added and displayed in the Configuration section.

    • Use the edit icon to edit the details.

    EVENTS: Send notifications when an action is performed on OpsRamp entities.
    Click +ADD and enter the following information in the ADD EVENT window:

    Custom Automation - Add event screen
    Field NameField TypeDescription
    NameStringEnter a name for the event.
    This name is displayed as the automation integration name and is visible on the process definition screen while creating process workflows.
    OnDropdownSelect an entity from the drop-down list.
    The integration is displayed only for events of the selected option in the process definition window.

ACTIONS: Enter the following information in the ACTIONS section:
If you want to inherit parent configuration, select Use parent configuration checkbox.

Field NameField TypeDescription
Endpoint URLStringThe Endpoint URL for API is auto populated.
If Internal end point checkbox is selected, the Endpoint URL is auto populated.
Enter the actual endpoint in continuous with the pre-populated value. Give a space and enter $ to get a list of tokens.
Notification TypeDropdownSelect notification type as REST API or SOAP API based on your requirements.
Authentication TypeDropdownSelect an Authentication Type: None, Basic, OAuth2, JWT, Custom. The Authentication Types are displayed based on the Notification Type selected.
Web MethodDropdownSelect web method: Post, Put, Get, Delete, or Patch.

See Outbound - Configuration for more information.

HEADERS: Click +ADD and select the Key and Value from the dropdowns, and click SAVE to add the header.
You can also type the values in the boxes and select the values to add.

  • Enter the payload in the box. Give a space and enter $ to get a list of tokens.

RESPONSE: Click +ADD. Select Key from the dropdown, enter Value in the box, and click SAVE to add the response.

ATTACHMENT (OPTIONAL): Click the down arrow to open the Attachment section. This section is optional.

Field NameField TypeDescription
Attachment Endpoint URLStringEnter Attachment Endpoint URL.
Give a space and enter $ to get a list of tokens.
Process TypeDropdownSelect process type: Pre process or Post process.
Web MethodDropdownSelect web method: Post, Put, Get, Delete, or Patch.

ATTACHMENT HEADERS: Click +ADD and enter the following information:

  1. Select Key and Value from the dropdowns. You can also type the values in the boxes and select the values to add.
  2. Click SAVE to add Attachment Header.
  • Attachment Payload: Enter Attachment Payload.
    Give a space and enter $ to get a list of tokens.
    See Integration Events for information on how to add a placeholder.

  • Attachment Response: Enter Key and Value in the boxes.

  1. Click ADD EVENT to add the event.

    There are some actions you can perform on the Event(s).
    See here for more details.

  2. Click FINISH. The custom automation integration is installed and displayed under Installed Integrations.

Outbound - Configuration

Based on the Notification Type selected, the values in the Authentication type change.

  • REST API: If you select REST API as Notification Type, the Authentication type dropdown will have None, Basic, OAuth2, JWT, and Custom options.

    • Basic: If you select Basic as Authentication type, enter User Name and Password.
      OAuth2: If you select OAuth2 as Authentication type, do the following:
      1. Select Grant Type from the dropdown. If you select Password Credentials or Refresh Token as Grant Type, enter the User Name and Password.
      2. Enter Access Token URL.
      3. Enter the Key and Secret.
      4. Enter the Scope.
    • JWT: If you select JWT as Authentication type, do the following:
      1. Enter Token URL in the box.
      2. Enter the User Name and Password.
      3. Enter the Token Payload in the box.

    TOKEN HEADERS: The Name and Value is displayed by default. You can change it accordingly.

    TOKENS PATH: Enter Name (displayed by default) and Value in the boxes and click SAVE.
    RESOURCE AUTHORIZATION HEADERS: Enter Name and Value (displayed by default) in the boxes and click SAVE.

    • Custom: If you select Custom as Authentication type, do the following:
      1. Enter Token URL in the box.
      2. Enter the Token Payload in the box. TOKEN HEADERS: The Name and Value is displayed by default. You can change it accordingly.

    TOKENS PATH: Enter Name (displayed by default) and Value in the boxes and click SAVE.
    RESOURCE AUTHORIZATION HEADERS: Enter Name and Value (displayed by default) in the boxes.
    CUSTOM PARAMETERS: Enter the Key and Value in the boxes and click SAVE to save the custom parameter.

  • SOAP API: If you select SOAP API as Notification Type, the Authentication type dropdown will have None and Basic options.

    • Basic: If you select Basic as Authentication type, enter User Name and Password.

Actions on Integration

You can perform actions like View Logs, Export, Edit, and Uninstall on the integration.

Audit Logs

View Outbound logs from the View Logs option for the integration. You can view if the event was successful or not.

See Audit Logs for more information.

Viewing Process Automation Integration and Events

Automation integration and its related integration events are visible in the process definition for creating process workflows.

Definitions Process Flow