Unify and manage your data

Connect Reltio IDE to your Reltio tenant

Learn how to connect Reltio IDE to your Reltio tenant and open your business configuration in the editor.

Prerequisites

Before you connect to your Reltio tenant, make sure you have the following requirements:

  • Reltio IDE installed in Cursor or VS Code.
  • A folder open in your editor. Reltio IDE uses the folder as your local workspace for downloading and managing business configurations.
  • A Reltio tenant and valid credentials, copied and ready to paste: An OAuth Client ID and Client secret (with your SSO routing tenant ID) from your identity provider, or a bearer token from the Reltio authentication API or your tenant administrator.
To connect to your tenant
  1. Select Reltio icon in the activity bar or Reltio IDE from the extensions to open the RELTIO IDE view.
  2. Select Connect your Reltio Tenant to start setup.
  3. Select Add Environment, then enter your environment ID (for example, test-usg.reltio.com).
    Figure 1. Add environment in Reltio IDE
  4. Authenticate using one of the following methods, using the credentials you copied in the prerequisites.
    Figure 2. Reltio environment setup sign-in method
    • Select Sign in with browser (recommended). Enter your Client ID and Client secret, then enter your SSO routing tenant ID when prompted. Reltio IDE opens your browser to complete single sign-on. Your editor stores these credentials in your operating system's secure credential store.

    • Select Paste a Bearer token, then paste the token you kept ready and press Enter. Reltio IDE keeps the token in memory for the current session only.

  5. After authentication, select your tenant from the tenant list.
  6. After you select the tenant, open and edit its local business configuration.
To open and navigate your configuration
  1. In the RELTIO IDE view, select your tenant.
  2. Select the Open L3 icon beside the tenant ID to open your configuration file in the editor.
    Figure 3. Connected tenant in RELTIO IDE
  3. Expand your tenant to browse its configuration.
  4. Use the context menu at the tenant level and on objects in the tree view to perform modeling actions, such as:
    • Adding a new entity type or relationship type

    • Adding a new attribute

    • Viewing the ontology

    • Applying your configuration changes to the tenant

Result

Reltio IDE connects to your tenant, and your configuration file opens in the editor. Your tenant appears in the RELTIO IDE view, and you can expand it to browse its configuration. You are ready to add or modify configuration objects.

Validation

To confirm the connection was successful:

  1. Confirm that your tenant appears in the RELTIO IDE view with no authentication errors.
  2. Select the Open L3 icon beside the tenant ID and confirm that your configuration opens in the editor.
  3. Expand your tenant and confirm that its configuration appears.