Updated on 2022-12-05 GMT+08:00

Connecting to a WebSocket Data Source

Overview

ROMA Connect can use WebSocket as a data source for data integration tasks. Before using the WebSocket data source, you need to connect it to ROMA Connect.

Prerequisites

Each connected data source must belong to an integration application. Before connecting a data source, ensure that an integration application is available. Otherwise, create an integration application first.

Procedure

  1. Log in to the ROMA Connect console. On the Instances page, click View Console next to a specific instance.
  2. In the navigation pane on the left, choose Data Sources. In the upper right corner of the page, click Access Data Source.
  3. On the Default tab page, select WebSocket and click Next.
  4. Configure the data source connection information.
    Table 1 Data source connection information

    Parameter

    Description

    Name

    Enter a data source name. It is recommended that you enter a name based on naming rules to facilitate search.

    Integration Application

    Select the integration application to which the data source belongs.

    Description

    Enter the descriptive information.

    Address

    Enter the IP address of WebSocket.

    • ws (WebSocket) indicates a plaintext connection. If a plaintext connection is used, the URL must be in the ws://example.com or IP:PORT format.
    • wss (WebSocket Secure) indicates an encrypted connection. If an encrypted connection is used, the URL must be in the wss://example.com or IP:PORT format.

    Authentication Mode

    Select the authentication mode used for connecting to WebSocket.

    • None: No authentication is required. Anyone can access WebSocket.
    • Basic Auth: A user must enter the username and password for authentication. After the authentication is successful, the user is allowed to access WebSocket.

    Username

    This parameter is mandatory only if Authentication Mode is set to Basic Auth.

    Enter the user name for connecting to WebSocket.

    Password

    This parameter is mandatory only if Authentication Mode is set to Basic Auth.

    Enter the password for connecting to WebSocket.

  5. Click Check Connectivity to check the connectivity between FDI and the data source.
    • If the test result is Data source connected successfully, go to the next step.
    • If the test result is Failed to connect to the data source, check the data source status and connection parameters, and click Recheck until the connection is successful.
  6. Click Create.