Page tree

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space DEV and version r0822

D toc


This section describes the steps to configure the

D s webapp
to integrate with your Salesforce deployment using OAuth 2.0 to authenticate.


OAuth 2.0 authentication must be enabled in the

D s platform
. For more information, see Enable OAuth 2.0 Authentication.

Create OAuth 2.0 Client App in Salesforce

In Salesforce, you must create the connected app through which the

D s webapp
 uses OAuth 2.0 to access and connect to your Salesforce data.


  1. Login: Log in to the Salesforce account in which you want the OAuth 2.0 app to be created. 
  2. In the top bar, click Setup.
  3. In the left nav bar, search for: apps. Then, navigate to Create > Apps.
  4. Create connected app: In the Connected Apps section, click New.
    1. To create a connected app, please complete the listed fields with the appropriate information. Some specifics:

      Connected App NameDisplay name of the app. Suggested: Trifacta application
      API NamePlease add the value for Connected App Name here.
      Contact Email

      Add a valid contact email address.

      Logo image URL(optional) Upload an app logo as needed.
      Enable OAuth SettingsSelect this option.
      Callback URL

      Please provide a URL in the following format:

      Code Block


      <platform_login_url> = the URL that is accessed to log in to

      D s platform
      . This value may or may not include a port number.

      Selected OAuth ScopesPlease select the following scopes:1. api2. refresh_token
      Require secret for web server flowSelect this option.
    2. At the bottom of the screen, click Save to save the connected app. 
  5. Configure policies: In the left nav bar, select Manage > Connected apps.
    1. Then, click the Edit Policies button.
    2. In the Edit Policies screen, click the Manage button.
    3. Under Session Policies, select the TImeout Value. Set this value to 24 hours.
    4. Click Save to save your connected app.
  6. Retain values: Your Salesforce connected app configuration is complete. Please acquire the following information from the app listing in Salesforce. These parameter values are needed for creating the OAuth 2.0 client in the 

    D s webapp

    Consumer Key

    This value is used as the Client Id in

    D s webapp
    . Select Click to reveal to display.

    Consumer Secret

    This value is used as the Client Secret in

    D s webapp
    . Select Click to reveal to display.

    Selected OAuth ScopesAcquire this values. Unless otherwise specified, these values should include:1. api2. refresh_token
    Access token expires inNavigate to Manage > Edit Policies. Typically, this value in milliseconds is set to 1 hour (3600000 milliseconds).For more information, see
  7. Save any changes to the connected app.

Scopes for Salesforce

The following scopes are required in the connected app for the 

D s webapp
 to access Salesforce:

api(required) Provides REST API access to Salesforce.
refresh_token(required) This token allows the OAuth 2.0 client to refresh the connection with Salesforce without user interaction.

Create OAuth 2.0 Client for Salesforce

After the Salesforce connected app is created, you must create an OAuth 2.0 client in the 

D s webapp
, which is used to integrate with the OAuth 2.0 connected app that you created above.


NOTE: You must create one OAuth 2.0 client in the

D s webapp
for each Salesforce connected app that you wish to use.


  1. Login to the 
    D s webapp
     as a workspace administrator.
  2. In the lefthand menu, select User menu > Admin console > OAuth2.0 Clients
  3. In the OAuth2.0 Clients page, click Register OAuth2.0 Client.
  4. Specify the new client. Apply the following values:

    TypeSet to salesforce.

    Display name for the OAuth 2.0 client in the

    D s webapp

    Client IDSet this value to the Consumer Key value in your Salesforce connected app.
    Client SecretSet this value to the Consumer Secret value in your Salesforce connected app.
    Authorization URL

    Set this value to the following:

    Code Block
    Token URL

    Set this value to the following:

    Code Block
    ScopesInsert the scopes you specified as a space-separated list.
    Access Token Expires InSet this value to the corresponding value in your Salesforce connected app. See above.
    Refresh Token Expires In

    Set this value to the number of milliseconds after which the refresh token expires.

    Set the value to 0 (does not expire).

  5. To save your OAuth 2.0 client, click Save.

For more information, see Create OAuth2 Client.

Create Salesforce Connection

After you have created the two OAuth 2.0 client references, you can create a connection to your Salesforce data.


NOTE: You must create a separate connection for each OAuth 2.0 client that is available in the

D s webapp

For more information, see Create Salesforce Connections.