Setup Connected App Access for Blue Yonder

Overview

The Blue Yonder integration allows Blue Yonder customers to create, rate, and tender loads in the TMS. Creation and tendering of loads are initiated by Blue Yonder and handled by a Connected App and REST based classes within the TMS. Returning of rates to Blue Yonder is handled by an outbound API call from the TMS to Blue Yonder.  

Setup Connected App Access

Step 1: Create the Blue Yonder user

1. Create a new user with the following values.

   1. First Name: Blue

   2. Last Name: Yonder

   3. Email: Set to the system admin's email

   4. Username: Change if necessary

   5. User License: Salesforce

   6. Profile: Standard User

2. Add the Permission Set, TMS Blue Yonder API, to the user.

Step 2: Allow Authorization Code and Credentials Flows

1. From Setup → search and select OAuth and OpenID Connect Settings.

2. Enable Allow Authorization Code and Credentials Flows.

Step 3: Create New Connected App

Create a Connected app by following the steps below. Skip these steps if the Blue Yonder App already exists.

1. Create the Connected App.

   1. Navigate to Setup and search for External Client Apps and select the Settings link.

   2. From the Connected Apps section, choose On for Allow creation of connected apps.

      1. Click the Enable button on the modal to create Connected Apps.

   3. Click the New Connected App button.

      

2. Enter the following information.

   1. Connected App Name: Blue Yonder.

   2. Contact Email: System Admin's email.

   3. Enabled OAuth Setting: Checked (true).

   4. Callback URL: https://login.salesforce.com/.

   5. Selected OAuth Scopes: Add Manage user data via APIs (api).

   6. Enable Client Credentials Flow: Checked.

3. Click Save.

Step 4: Add Trusted IP Range for OAuth Web Server Flow

1. If you navigated away from the newly created App, go to Setup → Manage Connected Apps.

2. Click View on the Blue Yonder app.

3. Go to the Trusted IP Range for OAuth Web Server Flow section, click New.

4. Add the following IP ranges ( repeat step 3 for each IP range):

   1. Start IP Address, End IP Address: 20.122.40.48.

   2. Start IP Address, End IP Address: 52.177.14.131.

   3. Start IP Address, End IP Address: 52.247.78.106.

Step 5: Access the Consumer Key and Consumer Secret

1. From the Blue Yonder connected app, click the Manage Consumer Details button.

2. Salesforce will send a verification email to the system admin's email address, enter this code in the Verify Your Identity page. 

3. Copy the Consumer Key and Consumer Secret to provide to Blue Yonder.  

Step 6: Set Client Credentials Flow Run As user

1. From the Blue Yonder connected app, click the Manage button at the top of the page.

2. Click the Edit Policies button.

3. In the Client Credentials Flow section, set the Run As user to the Blue Yonder user you created in Step 1 .

The following endpoints will need to be provided to Blue Yonder. Note that “{domain}” can be found under Setup → My Domain Settings → Current My Domain URL.

1. OAuth authorization endpoint: https://{domain}/services/oauth2/token

2. Quote request endpoint: https://{domain}/services/apexrest/rtms/blueyonderloadservice

3. Tender request endpoint: https://{domain}/services/apexrest/rtms/blueyondertenderservice