Introduction

OpsRamp provides you with the capability to build your integration using the Custom Ticketing Integration framework.

Custom Ticketing integration is configured between OpsRamp and your application if any third-party or other in-house applications are not present in the Available Integrations list.

You can utilize OpsRamp authentication details like key and secret, and access OpsRamp APIs.

Configure custom ticketing integration

Follow these steps to configure custom ticketing 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 (Ticketing) tile.

    Configure Custom Ticketing Integration
  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.
    DirectionDropdownSelect the direction - Inbound-Outbound, Inbound, or Outbound from the drop-down list.
    DescriptionStringProvide a description for the integration.

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

  8. Click Next. The INBOUND screen is displayed.

    Custom Integration Inbound screen

    Custom ticketing integration allows for bidirectional communication.
    Bidirectional integration includes both INBOUND (third-party application to OpsRamp) and OUTBOUND (OpsRamp to Third-party application) communication.

    Configure INBOUND communication

    AUTHENTICATION:

    Field NameField TypeDescription
    Authentication TypeDropdownOpsRamp supports APIs with OAUTH2 and WEBHOOK for Custom ticketing integration. Select OAUTH2 or WEBHOOK as required.
    RoleDropdownSelect the role of the user installing the integration.
    You can execute only those APIs that are associated with the selected role.

    GENERATE KEY: Click to generate the Tenant ID, Key and Secret. Use the copy icon to make a note of the token.
    REVOKE ACCESS TOKEN: Click to revoke access token. This option is displayed only for OAUTH2 authentication type.

    MAP ATTRIBUTES: Map the tenant entity attributes with OpsRamp entity.
    Click +ADD and enter the following information in the ADD MAP ATTRIBUTES window:

    Custom Ticketing Integration Inbound mapping attributes screen
    Field NameField TypeDescription
    OpsRamp EntityDropdownSelect OpsRamp entity from the dropdown.
    OpsRamp PropertyDropdownSelect OpsRamp property from the dropdown. It will change based on entity selection.
    CUSTOM-TICKETING EntityStringEnter the Custom Ticketing Entity in the box.
    CUSTOM-TICKETING PropertyStringEnter the Custom Ticketing Property in the box.

    PROPERTY VALUES: Click +PROPERTY VALUE. Enter the following information and click SAVE:
    Note: This section is displayed based on the OpsRamp Entity and OpsRamp Property selected.

    Field NameField TypeDescription
    CUSTOM-TICKETING Property ValueStringEnter custom ticketing property value in the box.
    OpsRamp Property ValueDropdownSelect a value from the dropdown.
    Based on the OpsRamp Property selected, the options in this field change.
  9. Click ADD MAP ATTRIBUTES. The mapped information is displayed in the MAP ATTRIBUTES section.

    • Use the three dots menu to edit or remove the map attributes.
    • Use Filter to filter the map attributes.

    PROPERTIES: Click +PROPERTIES and enter the following information:

    Field NameField TypeDescription
    PropertiesStringEnter a value.
    ValueStringEnter a value.
  10. Click Next. The OUTBOUND screen is displayed.

    Outbound screen

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

    Outbound configuration screen
    Field NameField TypeDescription
    Base URIStringEnter the Base URI.
    Example: https://abc.opsramp.net/api/v2/tenants/tenantId/
    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.

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

    • Use the edit icon to edit the details.

    MAP ATTRIBUTES: Map the tenant entity attributes with OpsRamp entity.
    Click +ADD and enter the following information in the ADD MAP ATTRIBUTES window:

    Custom Ticketing Integration Inbound mapping attributes screen
    Field NameField TypeDescription
    OpsRamp EntityDropdownSelect OpsRamp entity from the dropdown.
    OpsRamp PropertyDropdownSelect OpsRamp property from the dropdown. It will change based on entity selection.
    CUSTOM-TICKETING EntityStringEnter the Custom Ticketing Entity in the box.
    CUSTOM-TICKETING PropertyStringEnter the Custom Ticketing Property in the box.

    PROPERTY VALUES: Click +PROPERTY VALUE. Enter the following information and click SAVE.

    Field NameField TypeDescription
    CUSTOM-TICKETING Property ValueStringEnter custom ticketing property value in the box.
    OpsRamp Property ValueDropdownSelect a value from the dropdown.
    Based on the OpsRamp Property selected, the options in this field vary.

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

Outbound - Add event screen
Field NameField TypeDescription
NameStringEnter a name for the event.
Select the Entity, Entity Type, and Entity Type Event from the dropdown lists.

ADVANCED SETTINGS (Optional): Click +ADD and enter the values for Property, Operator, and Value and click SAVE.

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 URLStringEnter Endpoint URL.
Give a space and enter $ to get a list of tokens.
Select the Entity, Entity Type, and Entity Type Event from the dropdown lists.
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.
Note:

  • The event is created, only if you provide the response properties.
  • You cannot enter more than four responses.

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.

    FAILURES: In case of failure in integration, an Email is sent to the user about the failure in integration.
    To configure failure notification, click add in the FAILURES section and enter the following information in the FAILURE NOTIFICATIONS window:

    Outbound - failure notifications screen
    1. Select notification type as Email.
    2. Enter the email address(es) in the To and CC fields. To enter the email address(es) in the fields, type the email address and hit enter, or select it from the dropdown.
    3. Click ADD FAILURE NOTIFICATIONS. The details are added.
      • Use the edit icon to edit the failure notification.
      • Use the delete icon to delete the failure notification.
        Note: The Failures section is displayed only if Events are configured.

  2. Click FINISH. The custom ticketing 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, Assign Template, and Uninstall on the integration.

Audit Logs

View Outbound and Inbound 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.