Connecting to Relativity

This BluePrint guides you through connecting ReadySuite to Relativity.

ReadySuite can connect to Relativity One, Relativity Server 2023, Relativity Server 2022, and Relativity Server 2021.

You can setup your connection to Relativity from both the Import Setup page of the Relativity Import wizard and the Export Setup page of the Relativity Export wizard.

Relativity One requires OAuth2 authentication, while Relativity Server can connect with either Username/Password or OAuth2 authentication. You can set up OAuth2 authentication and username and password using the Manage Credential dialog box.

To set up the connection between ReadySuite and Relativity

  1. Do one of the following:
    • If you are connecting to Relativity to import data, in the ReadySuite ribbon, click Platform Source and in the Review list, click Relativity to open the Relativity Import wizard.
    • If you are connecting to Relativity to export data, import to ReadySuite the data set you want to export to Relativity, then in the ReadySuite ribbon, click External Data and click Relativity to open the Relativity Import wizard.
  2. If the Select Platform dialog box appears, select the version of Relativity you want to use: RelativityOne or Relativity Server.

    3. Note: ReadySuite continues to use the selected version of Relativity until you close and restart ReadySuite. Alternatively, you can hold SHIFT on your keyboard before clicking the Relativity Import or Relativity Export button in the Ribbon to select a different platform version.

  3. In both Relativity wizards, the Import Setup page and Export Setup page have a Sign in and select the workspace section.
    If this is the first time you are connecting to Relativity, click Sign In to open and complete the Manage Credentials dialog box.

Manage Credentials

With the Manage Credentials dialog box, you can add new connections to Relativity and Nebula, as well as update or delete existing connection credentials.

Username and password credentials can be set up for Relativity Server.

Two factor authentication to RelativityOne or Relativity Server can be implemented by configuring Relativity and ReadySuite to use OAuth2 authentication.

To create a new Relativity Server connection with username and password credentials

  1. In the Credential Source section, click .
  2. On the Manage Credentials dialog box, in the Credentials Source drop list, select New Connection.
  3. In the Connection Settings section, enter the URL of the Relativity Server connection path.

    4. Note: The path should end with the domain. Do not include any trailing slashes after that.

    Example

    Correct

    http://relativity.example.org

    Incorrect

    http://relativity.example.org/Relativity

  4. In the Credentials section, in the Provider drop list, do one of the following: enter the Username and Password.
  5. To bypass verifying credentials for connecting to Relativity in future sessions, select Remember Password.
  6. To verify the information on the Manage Credentials dialog box can connect to Relativity, click Test Connection.
  7. If connection test was successful, click Save.
    If these steps do not create a connection, contact your system administrator to complete the following:
    • In the Advanced Settings section, click the down arrow and enter the APIs manually for the services below.

      • Note: In typical environments and setups, you do NOT need to enter values for these settings.:

    • Import API
    • Services API
    • Rest API
    • Identity API

To modify the details of an existing connection

  1. In the Credential Source section, click and select the connection you want to update.
  2. Change the contents for the Connection Settings and Credential sections as required.
  3. Click Save.

To delete an existing connection

  1. In the Credential Source section, click and select the connection you want to delete.
  2. Click .
  3. On the Delete dialog box, click Delete.
  4. Click Save.

OAuth2 Authentication

ReadySuite supports two flow grant types, implicit and client credentials. Using the Implicit flow type is recommended. The client credentials flow grant type should be avoided when using ReadySuite on a machine with a shared user profile.

To set up OAuth2 authentication for ReadySuite in Relativity

Note: Requires Administrator credentials. For more information, see OAuth2 clients.

  1. Log in to Relativity
  2. In the sidebar, click Authentication > OAuth2. (If the Authentication tab is not displayed in the sidebar, click More > Authentication > OAuth2.)
  3. On the Authentication > OAuth2 page, click New OAuth2 Client.
  4. In the OAuth2 Client Information section, enter the Name of the client application (example: ReadySuite).
  5. In the Flow Grant Type, select Implicit (recommended) or Client Credentials.
    • If you selected Implicit, in the Redirect URLs, enter http://relativityimplicit/
    • If you selected Client Credentials, set the Context User by choosing the user account to connect to Relativity:
    • To choose the person running the import, click Select and from the Select Item - Context User list, then click Set. and or
    • To choose the user account currently logged in to Relativity, click Me
  6. In the Access Token Lifetime, enter 600.
  7. Click Save and Back.
  8. On the OAuth2 page, click the OAuth2 client you created (example: ReadySuite).
  9. In the OAuth2 Client Information page, do the following:
    • If you are setting up an Implicit flow grant type, select and copy the Client Id.
    • if you are setting up a Client Credentials grant type, select and copy the Client Id and Client Secret.

To setup the RelativityOne or Relativity Server connection configured for OAuth2 authentication

  1. On the Manage Credentials dialog box, in the Credentials Source drop list, select New Connection.
  2. In the Connection Settings section, enter the URL of the Relativity connection path configured for OAuth2 authentication.

    3. Note: The path should end with the domain. Do not include any directories past that.

    Example

    Correct

    http://relativity.example.org

    Incorrect

    http://relativity.example.org/Relativity

    Note: To create a new connection for Relativity One, follow the same procedures listed above with the following modifications.

    Connection Settings section

    URL: Enter the URL of the Relativity One connection path.

    Example

    https://examplefirm.relativity.one

  3. In the Credentials section, in the Provider drop list, select OAuth2 Client.
  4. Enter the Client Id (generated and copied in step 9 of To set up OAuth2 authentication for ReadySuite in Relativity).
  5. If you are using a client credentials grant flow type, enter the Client Secret (generated and copied in step 9 of To set up OAuth2 authentication for ReadySuite in Relativity).
    If you are using an implicit grant flow type, the Client Secret is not required for Relativity with OAuth2 provider. (Contact your System Administrator to confirm.)
  6. Click Test Connection.
  7. If you are using an implicit grant flow type, on the Relativity Login dialog box, enter your Username and Password and click Login.
  8. On the Connection Test dialog box, click OK.
  9. Click Save.