Accelerate the Value of Data

Configuration parameters for MuleSoft connector

Learn how to use the Reltio MuleSoft connector when you establish a connection with your tenant.

The configuration parameters are used by the Mulesoft pipelines to connect to Reltio.

To use the MuleSoft Connector, you must configure the parameters. Examples of the configuration parameters are: Token URL, Username, Password, and so on.

  1. Use the parameters listed in Table 1: Mulesoft Connector Configuration Parameters.
    Note: By default, the General tab is selected and the parameters to configure the connector are displayed.
    Table 1. Mulesoft connector configuration parameters
    NameTypeExamples: ValuesDescription
    Token URLString reltio.tokenUrl=https://auth.reltio.com/oauth/tokenThis parameter defines the Reltio authorization endpoint. The client authenticates with the authorization server and requests an access token from the token URL.

    For example, https://auth.reltio.com/oauth/token.

    UsernameStringreltio.username=your.user.nameThis parameter defines the username of the API user.
    PasswordStringreltio.password=your.passwordThis parameter defines the password of the API user.
    Base URLStringreltio.baseUrl=https://env.reltio.com/reltio/api/This parameter defines the Reltio Base URL. This is the URL prefix of your Tenant URL.

    For example, your tenant URL is https://abc-01.reltio.com/ui/ddHXrrrotBeNhNO. This indicates that your base URL environment is https://abc-01.reltio.com/reltio/api/.

    Tenant IDStringyour.tenant.idThis parameter defines the Reltio Tenant ID. This is the unique identification of the Reltio system assigned to you. The Tenant ID can be obtained from your tenant URL.

    For example, if your tenant URL is https://abc-01.reltio.com/ui/ddHXrrrotBeNhNO of Tenant ID from the above URL is: ddHXrrrotBeNhNO.

    Client KeyStringreltio.clientKey=cmVsdGlvX3VpOm1ha2l0YQ==The parameter defines the Client Key.
    This parameter helps you to use a client Id and secret in the Reltio MuleSoft connector instead of a user Id and password by specifying the Token URL. You can run the Reltio Mulesoft connector using a client Id.
    https://auth.reltio.com/oauth/token?grant_type=client_credentials
    
    You can place any values in the Username and Password fields. They'll be ignored. You can add a client Id and secret in the Client key field, which is encoded in Base64 in the format:
    clientId:secret
    In this scenario, you'll receive the token for the client id and secret
    Token RetryString5This parameter defines the number of token retries to get the token request.
    Connection timeoutString600000 milliseconds or 10 minutesThis parameter defines the frequency (ms) as the delay between retries in meter/sec.
    Export Service URLStringreltio.exportServiceUrl=https://dev.reltio.com/jobs/This parameter defines the URL that we use while we run the Export jobs.
  2. In the Reltio Cloud Connector Config dialog box, select Advanced tab.

  3. Use the Table 2: Advanced tab in Connector Configuration Parameters to list the available parameters.
    NameTypeExamples: ValuesDescription
    Reconnection StrategyThe values can be as follows:
    • None
    • Forever
    • Standard
    Select the Reconnection Strategy as Forever or Standard. By default the value chosen will be None.
    Frequency (ms)Integer The frequency can be as follows:
    • 2000 ms or 2 seconds
    • 5000 ms or 5 seconds
    This parameter defines the frequency in milliseconds. For example, 2000 ms or 2 seconds.
    Reconnection attemptsIntegerWhen you select the Reconnection strategy as Standard, reconnection attempts display the number of attempts while reconnecting.