Workspace ONE – Okta Integration Part 1: Core Setup and Configuration

The release of Workspace ONE 19.03 brought in a very seamless integration of Okta Applications.

If you have integrated the two solutions previously you will recall the number of steps required to create and entitle new applications in Workspace from Okta. This integrations you to create and entitle applications in Okta and have them seamless appear in Workspace ONE along with your Native and Virtual Applications.

Lets walk through the steps to integrate the two solutions.

In this blog we are going to assume that you have existing connectors for Workspace ONE UEM and Workspace ONE Identity. We are also assuming you have your Workspace ONE Identity access policies already configured for Mobile SSO, Certificate or Password (Cloud Deployment).

Part 1: Core Setup and Configuration

The objective of this section to configure Okta to delegate authentication to Workspace ONE Identity where Mobile SSO and Device Compliance are configured.

Step 1:  Exporting the Workspace ONE IdP Metadata

  1. Log into Workspace ONE Identity Console -> Catalog -> Settings
  2. Click on “Identity Provider (IdP) metadata” and save the file locally.
  3. Scroll down to the Signing Certificate Section and Download.

Step 2: Add Identity Provider to Okta

  1. Log into your Okta Admin Console
  2. Click on Security -> Identity Providers -> SAML 2.0 Identity Provider
  3. Click on Add Identity Provider
  4. Provider a name: ie. Workspace ONE
  5. For IdP Username, select “idpuser.subjectNameId”
  6. For “If no match is found”, select “Redirect to Okta sign-in page”
  7. For your “IdP Issuer URI”, retrieve and paste this value from your SAML Metadata you downloaded in step one.
  8. For your “IdP Single Sign-On URL”,retrieve and paste this value from your SAML Metadata you downloaded in step one.
  9. For the “IdP Signature Certificate, upload the signing certificate you downloaded in Step 1.
  10. Expand the newly created Identity Provider and download the metadata

Step 3: Create Okta Application Source in Workspace ONE Identity

  1. In Workspace ONE Identity Console, click on Catalog -> Settings
  2. Click on Application Sources
  3. Click on Okta
  1. On the Okta Application Source page, click next
  2. Select “URL/XML” and paste the contents of the Okta metdata we downloaded in the previous step.

If you chose manual, the mappings should be follow as below:

  1. On the Access Policies page, click next (see note below):
  1. Click Save on the summary page.

Step 4: Create Okta Routing Rules

  1. Log into the Okta console.
  2. Go to Security -> Identity Providers
  3. Click on Routing Rules
  1. Click Add Routing Rule
  2. Provide a Rule Name
  3. Select the platforms that you want to using Workspace ONE Identity (ie. IOS/Android)
  4. Select the applications that you want to use Workspace ONE Identity
  5. Select the Identity Provider we created previously
  1. Click Create Rule

Step 5: Testing

  1. Access your Salesforce development tenant
  2. Select to Authenticate with Okta
  3. Based on your Okta Rules, you should be redirected to Workspace ONE Identity.
  4. Authenticate within WS1
  5. You should return back to Okta and be redirected and successfully authenticated into SalesForce

Troubleshooting Tips

  1. Ensure your user is entitled to Salesforce within Okta.
  2. Verify the IdP Issuer in Okta is correct:
  1. Verify the username values we are sending from Workspace ONE to Okta will match:

2 thoughts on “Workspace ONE – Okta Integration Part 1: Core Setup and Configuration

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s