Creating a connection

    Last updated on:

    In this page

    Overview

    A connection in Log360 Cloud provides the actual credentials or authorization details required to access an external service. Once created, connections can be reused across multiple areas of the product, including Custom Widgets, Custom Functions, Marketplace applications, and automated workflows.

    This page explains the steps required to create a connection using any supported authentication type.

    Note If you have already created a custom service, you can also create a connection by navigating to the Connections page and selecting the service you created earlier.
    Selecting the configured custom service
    Figure 1: Selecting the configured custom service

    In the window that opens, click Create Connection.

    Creating a connection
    Figure 2: Creating a connection

    Setting up an agent-based connection

    When creating a connection for an agent-based service, an agent is automatically selected by default. Log360 Cloud attempts to test the connection using this agent. If the test fails (for example, if the agent cannot reach the external service), you will be prompted with options such as Select another agent or Install a new agent.

    To continue with an agent-based connection, follow the steps below:

    1. Select Click here to manually select an agent.
      Selecting an agent for an agent-based connection
      Figure 3: Selecting an agent
    2. In the Select Agent dropdown, choose an available agent.
      Selecting an agent
      Figure 4: Selecting an agent 
    3. Click Proceed to save the changes.
      Confirming agent selection
      Figure 5: Confirming agent selection

    Using API key

    Once you click Create and Setup Connection for a custom service that uses API Key authentication, the Create Connection window opens. Follow the steps below to configure and save the connection.

    1. In the Authentication Type dropdown, API Key is automatically selected. This is based on the authentication type configured when creating the custom service.
      Selecting an authentication type for API key connection
      Figure 6: Selecting an authentication type
    2. Enter a Connection Name. This name uniquely identifies the connection within Log360 Cloud and is used when linking the connection to dashboards, custom functions, workflows, and other modules.
      Entering a connection name for API key connection
      Figure 7: Entering a connection name
    3. Provide the required API Key value as issued by the external service.
      Entering an API key value
      Figure 8: Entering an API key
    4. Click Authorize and Save to validate the credentials and create the connection.

    Using basic authentication

    Once you click Create and Setup Connection, the Create Connection window opens. Follow the steps below to configure a connection that uses Basic Authentication.

    1. In the Authentication Type dropdown, Basic Authentication is automatically selected. This is based on the authentication type configured when creating the custom service.
      Selecting an authentication type for basic authentication connection
      Figure 9: Selecting an authentication type
    2. Enter a Connection Name. This name uniquely identifies the connection within Log360 Cloud and is used when linking the connection to dashboards, custom functions, workflows, and other modules.
      Entering a connection name for basic authentication connection
      Figure 10: Entering a connection name
    3. Enter the User Name and Password that is used to sign in to the external application.
      Entering credentials for basic authentication connection
      Figure 11: Entering credentials
    4. Click Authorize and Save to validate the credentials and create the connection.

    Using OAuth 1

    Once you click Create and Setup Connection, follow the steps below to complete the OAuth 1 connection:

    1. In the Create Connection window, from the Authentication Type dropdown, OAuth 1 is automatically selected. This is based on the authentication type configured when creating the custom service.
    2. Enter a Connection Name.
      Entering a connection name for OAuth 1
      Figure 12: Entering a connection name
    3. Click Authorize and Save.
    4. You will be redirected to the external service's authorization page. Review the access permissions requested by the application
    5. Once the authorization is completed, Log360 Cloud establishes the connection and returns you to the product console.

    Using OAuth 2

    When establishing a connection for a service that uses OAuth 2, the required steps depend on the grant type configured for that service.

    The product console supports connections using:

    Using OAuth 2 with automatic configuration

    Once you click Create and Setup Connection, the Create Connection window opens.

    1. In the Authentication Type dropdown, OAuth 2 is automatically selected. This is based on the authentication type configured when creating the custom service.
    2. Enter a Connection Name. This name will identify the connection within Log360 Cloud.
      Entering a connection name for OAuth 2
      Figure 13: Entering a connection name
    3. Under Select Scope(s), select the checkbox next to the scopes that should be authorized for this connection, such as Read, Write, or Delete, as specified by the external service.
      Selecting scopes for OAuth 2 connection
      Figure 14: Selecting scopes
    4. Click Authorize and Save to initiate the OAuth 2 authorization flow.
      Creating an OAuth 2 connection
      Figure 15: Creating a connection
    5. Complete the authorization in the external service page when prompted. Once the authorization is complete, the connection is created and added to the Connections list.
    6. After authorization completes, the new connection appears in the Connections page.

    Using OAuth 2 with manual configuration

    Once you click Create and Setup Connection, the Create Connection window opens.

    1. In the Authentication Type dropdown, OAuth 2 is automatically selected. This is based on the authentication type configured when creating the custom service.
    2. Enter a Connection Name. This name will identify the connection within Log360 Cloud.
      Entering a connection name
      Figure 16: Entering a connection name
    3. Enter the following OAuth fields:
      • Client ID - Unique identifier issued by the service provider.
      • Client Secret - Secret key issued to your application.
      Creating a connection
      Figure 17: Creating a connection
    4. Under Select Scope(s), select the checkbox next to the scopes that must be authorized for this connection, such as Read, Write, or Delete, based on the permissions required by the external service.
      Selecting scopes
      Figure 18: Selecting scopes
    5. Click Authorize and Save to begin the authorization process.
      Creating a connection
      Figure 19: Creating a connection
    6. Complete the authorization in the external service page when prompted. Once the authorization is complete, the connection is created and added to the Connections list.
    7. After authorization completes, the new connection appears in the Connections page.

    Using OAuth 2 with manual and automatic configuration

    Once you click Create and Setup Connection, the Create Connection window opens.

    1. In the Authentication Type dropdown, OAuth 2 is automatically selected. This is based on the authentication type configured when creating the custom service.
    2. Enter a Connection Name.
      Entering a connection name for OAuth 2 configuration
      Figure 20: Entering a connection name
      Note You can proceed with either Auto or Manual configuration, depending on the setup defined for your custom service.
    3. If the Auto configuration method is chosen,
      • From the Configuration Type dropdown, choose Auto.
        Selecting auto configuration type for OAuth 2
        Figure 21: Selecting configuration type
      • In the Select Scope(s) section, select the checkbox next to the scopes that should be granted for this connection, such as Read, Write, or Delete.
        Selecting scopes for OAuth 2 connection
        Figure 22: Selecting scopes
      • Click Authorize and Save to proceed with automatic authorization and complete the connection setup.
        Creating a connection with OAuth 2 auto configuration
        Figure 23: Creating a connection
    4. If the Manual configuration method is chosen,
      • From the Configuration Type dropdown, choose Manual.
        Selecting manual configuration type for OAuth 2
        Figure 24: Selecting configuration type
      • Enter the following OAuth fields:
        • Client ID - Unique identifier issued by the service provider.
        • Client Secret - Secret key issued to your application.
        Creating a connection in the interface
        Figure 25: Creating a connection
      • Under Select Scope(s), select the checkbox next to the scopes that must be authorized for this connection, such as Read, Write, or Delete, based on the permissions required by the external service.
        Selecting scopes for the connection
        Figure 26: Selecting scopes
      • Click Authorize and Save to begin the authorization process.
        Completing the connection creation
        Figure 27: Creating a connection

    Using authorization code with PKCE

    Once you click Create and Setup Connection, the Create Connection window opens.

    1. In the Authentication Type dropdown, OAuth 2 is automatically selected. This is based on the authentication type configured when creating the custom service.
    2. Enter a Connection Name.
      Entering a connection name for authorization code with PKCE
      Figure 28: Entering a connection name
    3. From the Configuration Type dropdown, select the configuration method supported by the external service and follow the corresponding steps below:
      Note
      • If you select Auto, refer to this section to complete the remaining setup.
      • If you select Manual, refer to this section to complete the remaining setup.
      • If you select Manual and Automatic, refer to this section to complete the remaining setup.

    Using client credentials

    Once you click Create and Setup Connection, the Create Connection window opens.

    1. In the Authentication Type dropdown, ensure OAuth 2 is selected.
    2. Enter a Connection Name. This name will identify the connection within Log360 Cloud.
      Entering a connection name for client credentials
      Figure 29: Entering a connection name
    3. Enter the following OAuth fields:
      • Client ID - Unique identifier issued by the service provider.
      • Client Secret - Secret key issued to your application.
      Creating a connection with client credentials
      Figure 30: Creating a connection
    4. Under Select Scope(s), select the checkbox next to the scopes that must be authorized for this connection, such as Read, Write, or Delete, based on the permissions required by the external service.
      Selecting scopes for the connection
      Figure 31: Selecting scopes
    5. Click Authorize and Save to begin the authorization process.
      Creating a connection with authorize and save
      Figure 32: Creating a connection

    Using multiple authentication

    Once you click Create and Setup Connection, the Create Connection window opens.

    1. The Authentication Type dropdown allows you to choose the method you want to use for establishing the connection.
      Selecting an authentication type in the Create Connection window
      Figure 33: Selecting an authentication type
    2. The fields displayed will automatically vary depending on the authentication method you select.
      Note Refer to this section to learn how to create a connection based on the authentication type you've selected.
    3. After selecting the required authentication method, provide the corresponding details and click Authorize and Save to complete the setup.

    Read also

    This page explained how to create a connection using various authentication types. For related configuration and management tasks, refer to the following articles: