Salesforce Integration

1. Create a Salesforce Developer Account

Navigate to the Salesforce Developers Enrollment Page
  1. Click + to open a new tab in Firefox
  2. Enter the URL https://developer.salesforce.com/signup

1.2. Create a Developers account

Create a Developers account

Complete the fields on the registration page.   The registration must use a valid email address as you will be required to validate the account and create a password by responding to an email.

Navigate to Salesforce Login Page

After validating your email and creating a password navigate to the Salesforce login page by entering https://login.salesforce.com into the browser

1.4. Login to Salesforce

Login to Salesforce
  1. Enter your username
  2. Enter your password
  3. Click Login

You may be prompted to enter a security code because you are logging in from an unknown browser.   You will receive an email to your registered email account with the Verification Code.

1.5. Switch to VMware Identity Manager Console

Switch to VMware Identity Manager Console

Click on the "VMware Workspace ONE" tab in the browser.

Navigate to Catalog Settings
  1. Click Catalog
  2. Click Settings

1.7. Export the SAML Metadata

Export the SAML Metadata
  1. Click SAML Metadata
  2. Click Identity Provider (IdP) metadata
  3. Click Save Line As...

1.8. Save the SAML Metadata

Save the SAML Metadata

Click Save

1.9. Switch to Salesforce

Switch to Salesforce

Click on the Salesforce Firefox tab

Navigate to the Single Sign-On Settings
  1. In the Quick Search field enter single
  2. Click on Single Sign-On Settings

1.11. Edit the Single Sign-On Settings

Edit the Single Sign-On Settings

Click Edit

1.12. Enable Single Sign-On

Enable Single Sign-On

1.13. Import the Metadata file

Import the Metadata file

Click New from Metadata File

1.14. Browse to the Metadata File

Browse to the Metadata File

Click Browse...

1.15. Select the Metadata file

Select the Metadata file
  1. Click Downloads
  2. Select idp.xml
  3. Click Open

1.16. Finalize the Import of the Metadata

Finalize the Import of the Metadata

Click Create

1.17. Update the SAML Settings

Update the SAML Settings
  1. Select Assertion contains the Federation ID from the User object in the "SAML Identity Type" section
  2. Click Save

1.18. Download the Salesforce Metadata

Download the Salesforce Metadata

Click Download Metadata

1.19. Save the Metadata file

Save the Metadata file
  1. Select Save File
  2. Click OK

1.20. Search for My Domain

Search for My Domain
  1. In the quick search field enter my
  2. Click My Domain

1.21. Register your new domain

Register your new domain
  1. Enter you admin account from Identity Manger in the domain field which should be first name last name and 4 numbers.
  2. Check the "Terms and Conditions" check box
  3. Click Register Domain

After registering your domain it may take a few minutes for Salesforce to complete the process.   Return to the "My Domain" screen by performing the previous step.

1.22. Edit the Authentication Configuration

Edit the Authentication Configuration

Click Edit

1.23. Select the Authentication Service

Select the Authentication Service
  1. Un-check the box next to "Login Page"
  2. Check the box next to your username
  3. Click Save

1.24. Search for Users

Search for Users

In the quick search field enter Users

Click Users

1.25. Edit the User

Edit the User

Click Edit next to the System Administrator user

1.26. Enter the Federation ID

Enter the Federation ID
  1. Enter [email protected] in the "Federation ID" field
  2. Click Save

2. Configure the Salesforce1 App for Single Sign-On

2.1. Switch to VMware Identity Manager Console

Switch to VMware Identity Manager Console

Click on the "VMware Workspace ONE" tab in the browser.

Navigate to the Catalog App Catalog
  1. Click Catalog
  2. Click Application Catalog

2.3. Add a Cloud application

Add a Cloud application
  1. Click Add Application
  2. Click ...from the cloud application catalog

2.4. Select Salesforce

Select Salesforce

Click on the Salesforce icon

2.5. Configure the App Metadata

Configure the App Metadata
  1. Click Configuration
  2. Click Meta-data XML

2.6. Open Notepad++

Open Notepad++
  1. Click the Start button
  2. Click Notepad++

2.7. Open the Metadate file

Open the Metadate file
  1. Click File
  2. Click Open

2.8. Select the Metadata file

Select the Metadata file
  1. Click Downloads
  2. Select the Metadata XML file
  3. Click Open

2.9. Copy the meta data

Copy the meta data

Type Ctrl-C to copy the data to the clip board

2.10. Paste the meta data into Identity Manager

Paste the meta data into Identity Manager
  1. Paste the data into Identity Manager by typing Ctrl-V
  2. Click Save

2.11. Import Confirmation

Import Confirmation

Confirm that the "Assertion Consumer Service", the "Recipient Name" and the "Audience" fields were set correctly.

2.12. Add User Entitlement

Add User Entitlement
  1. Click Entitlements
  2. Click Add user entitlement

2.13. Select the user

Select the user

Click browse

2.14. Configure the User Entitlement

Configure the User Entitlement
  1. Check the checkbox next to the
  2. Select Automatic from the Deployment dropdown
  3. Click Save

2.15. Finalize the Entitlement

Finalize the Entitlement

Click Done

2.16. Add a new Salesforce Policy

Add a new Salesforce Policy
  1. Click Identity & Access Management
  2. Click Policies
  3. Click Add Policy

2.17. Name the policy

Name the policy
  1. Enter Salesforce in the "Policy Name" field
  2. Click Select from the "Applies To" section

2.18. Select Salesforce

Select Salesforce
  1. Check the box next to Salesforce
  2. Click Save

2.19. Create a new Policy Rule

Create a new Policy Rule

Click the "+" sign

2.20. Configure the Rule

Configure the Rule
  1. Select ALL RANGES
  2. Select iOS
  3. Select Mobile SSO (for iOS)
  4. Click OK

2.21. Save the new policy

Save the new policy

3. Add the Salesforce1 App to the App Catalog

3.1. Switch to the AirWatch Console

Switch to the AirWatch Console

Click on the AirWatch tab in Firefox

3.2. Add the Salesforce1 Application

Add the Salesforce1 Application
  1. Click Apps & Books
  2. Click List View under Applications
  3. Click Public
  4. Click Add Application

3.3. Search for the Application

Search for the Application
  1. Select Apple iOS
  2. Enter salesforce1
  3. Click Next

3.4. Select the Application

Select the Application

Click + Select on the "Salesforce1" Application

3.5. Configure the Assignment of the Application

Configure the Assignment of the Application

Click Assignment

Click in the "Assigned Groups" field and select All Devices ([email protected])

3.6. Configure the Deployment of the Application

Configure the Deployment of the Application
  1. Click Deployment
  2. Select Auto
  3. Confirm that the check box for "Device must be MDM Managed to install this App (Workspace ONE only)" check box is checked

3.7. Configure Application Configuration Values

Configure Application Configuration Values
  1. Scroll down in the "Deployment" options
  2. Check "Send Application Configuration"
  3. Value 1 Settings
    - Configuration Key = AppServiceHosts
    - Value Type = String
    - Configuration Value = yourname1234-dev-ed.my.salesforce.com
  4. Click + Add
  5. Value 2 Settings
    - Configuration Key = ClearClipboardOnBackground
    -
    Value Type = Boolean
    -
    Configuration Value = TRUE
  6. Click Save & Publish

3.8. Publish the Application

Publish the Application

Click Publish

4. Add the Workspace ONE App to the App Catalog

4.1. Add Workspace ONE

Add Workspace ONE

Click Add Application

4.2. Search for Workspace ONE

Search for Workspace ONE
  1. Select Apple iOS
  2. Enter Workspace ONE
  3. Click Next

4.3. Select Workspace ONE

Select Workspace ONE

Click + Select

4.4. Application Assignment Settings

Application Assignment Settings
  1. Click Assignment
  2. Click in the "Assigned Groups" field
  3. Select All Devicces ([email protected])

4.5. Application Deployment Settings

Application Deployment Settings
  1. Click Deployment
  2. Select Auto
  3. Un-check the check box for "Device must be MDM Managed to install this App (Workspace ONE only)"
  4. Check the "Send Application Configuration" checkbox
  5. Value 1 Settings
    - Configuration Key = AppServiceHost
    - Value Type = String
    - Configuration Value = https://yourname1234.vmwareidentity.com
  6. Click + Add
  7. Value 2 Settings
    - Configuration Key = deviceUDID
    -
    Value Type = String
    -
    Configuration Value = {DeviceUid}
  8. Click Save & Publish

4.6. Publish the Application

Publish the Application

Click Publish

5. Validate the Salesforce1 App Single Sign-On

5.1. Launch the App on the device

Launch the App on the device

Click on the Salesforce1 app on your enrolled iOS device

5.2. Confirm re-direction to Workspace ONE

Confirm re-direction to Workspace ONE

If the AppConfig parameters were configured correctly you should see the Workspace ONE Authentication page display.

5.3. Validate Single Sign-On

Validate Single Sign-On

Authentication should complete and the application should launch without requiring the user to enter their username and password.

0 Comments

Add your comment

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.