Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Luma Automations supports integration with any third-party applications that support REST APIs to execute task tasks on the target system. The Integration enables the workflow to connect to a target system and perform a task. Here we configure the system details, authentication credentials, and mechanism for the connection.

Follow the below steps to create an Integration:

Create App 

To create an app:

  1. Navigate to Integrations in the left pan.

  2. The Connected Apps page appears as shown below. All the existing connectors are available here. These are available throughout the tenant and can be used in various workflows.

    Image RemovedImage Added
  3. To Create create a new integration, Click click on Create App. The Create App page appears as shown below.

    Image RemovedImage Added
  4. Enter the App Name. This represents the target system where you want to execute the task.

  5. Select the Integration Type based on the type of integration supported by the target system.

  6. Add an App Icon.

  7. Add a Description.

  8. Click Create to complete the App creation.
    The created app is now available in the Connected Apps list.

...

Instance represents the system environment you want to connect to. For example, For an Application (a configured target system), you may add a Trail Environment and a Production environment. Here, you may provide the Request configuration such as the Global Path parameter, Global Request Header, Global Query parameter, and authentication details required for Instance configuration and connecting to the target system. This These are the default configurations for the instance but can be over-ridden at the Web Service Operations level.

...

  1. On the Integrations page, select the required Application and click on Create Instance as shown below.

    Image RemovedImage Added

    The Create Instance page appears.

  2. Enter the instance Name. The next step is to define the credentials and connection details for this instance.

  3. In the Instance Configuration section, Enter the base URL to the target system environment where the the task should be executed.

  4. The Authorization Type is used to login log in and perform the task. The Following are the supported authorizations types:

    1. No Auth: Use this option, if you do not need any authentication to log in to the third-party systems.

    2. Basic Auth: Use this option if the target system needs login credentials to authenticate and authorize the user. ‘Basic Auth’ consists of the following fields:

      1. Username: Specify the Username used to login log in to the third-party system.

      2. Password: Specify the Password password used to authenticate access to the third-party system.

    3. Bearer Token: This is the unique authentication token required for external applications to communicate with Luma Automation. Enter the unique authentication Token required for external applications to communicate with the Automation Workflow.

  5. Global Path Parameter: The path parameter is part of a path segment that occurs after its name. Path parameters offer a unique opportunity to dynamically replace the values and pass them in the URL. Example, http://myserver.com/some-path/{parameter1}/path-continued/{parameter2}.

    1. Enter the External Field and the Value.

  6. Global Query Parameter: The query parameters are sometimes referred to as optional parameters. The query parameters are separated from the hierarchical parameters by the question mark. Query parameters appear in the URL after the question mark (?) after the resource name. Example, https://myserver.com/resource-name?param1=value1&param2=value2. 

    1. Enter the External Field and the Value.

  7. Global Headers: Headers are mostly classified as Request Headers. You will have to set the request headers when you are sending the request.

    1. Enter the External Field and the Value.
      The following sample headers are encountered the most.

      • Authorization: Includes credentials containing the authentication information of the client for the resource being requested. 

      • Accept-Charset: This is a header that is set with the request and tells the server about which character sets are acceptable by the client. 

      • Content-Type: Indicates the media type (text/HTML or text/JSON, XML/custom) of the response sent to the client by the server, this will help the client in processing the response body correctly.

  8. Click Create to create the App Instance.

...