Handling Device Trust Failures with Okta

When you configure Device Trust with Workspace ONE Access, regardless of whether you are using the Original Device Trust or the new Factor-Based Device Trust, you will need to make a decision on the expected outcome when devices are not managed/trusted.

In the Original Device Trust flow, our documentation instructs you to send all failures back to Okta. When we send failures back to Okta, it allows your Okta Application Sign-on Policy to trigger a different authentication flow when a device is not managed by Workspace ONE. This can be anything from Okta Verify to some other authentication flow.

Lets take a quick look at what is happening under the covers. When Workspace ONE receives the SAML AuthN request from Okta, it contains an Assertion Consumer Service (ACS) URL. This is the URL that Okta wants to receive the response from Workspace ONE Access. Ultimately, Okta is expecting a SAML Response from Workspace ONE Access that contains a value in the Name ID attribute for the authenticated principal. However, since Mobile SSO has failed in this case, Okta will receive a failure to their ACS endpoint:

When the ACS endpoint receives a failure response, it will prompt the user to authenticate. This is a fairly common practice in the industry. Once the user authenticates, they may see a “This device must be secured by Workspace ONE” message or prompted for MFA based on your application sign-on policy.

This flow works great for native applications however it may not be a desirable user experience using the Okta Portal on a mobile browser if the user was already authenticated in Okta.

In Factor-Based Device Trust, the experience is very different because Workspace ONE Access will not send any failures back to Okta. The Integration is designed for Workspace ONE Access to display the error.

If you want to support this flow with the Original Device Trust (and you don’t have an application sign-on policy that requires MFA for unmanaged devices), you can also configure the original device trust to display a failure on Workspace ONE Access with a “Return to Okta” link that will send them back to the Okta Portal (This custom error can be configured for Factor-Based Device Trust as well). If the user was previously authenticated, they will be automatically logged into the Okta Portal. In this use case, the user will see an customized error similar to below:

In order to configure this failure notification you will need to modify your Okta Application Source in Workspace ONE Access:

  1. Log into the Workspace ONE Admin Console
  2. Go to Catalog -> Web Apps
  3. Click on Settings
  4. Click on Application Sources
  5. Click on Okta
  6. Click Next
  7. Expand Advanced Properties
  8. Disable “Enable Authentication Failure Notification”. This will prevent failures from being sent back to Okta.
  1. Go to Identity & Access Management -> Policies
  2. Edit your Okta Policy (or the policy that is being used by the Okta Application Source)
  1. Click Next
  2. Click on your platform policy (ie. IOS)
  1. Expand Advanced Properties
  2. Enter your Custom Error Message, Custom Error Link Text and Custom Error Link URL
  1. Click Save,
  2. Repeat this for all applicable platform policy rules.
  3. Next and Save

Leave a Reply

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

WordPress.com Logo

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

Google photo

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

Twitter picture

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

Facebook photo

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

Connecting to %s