Duo's Trusted Endpoints feature secures your sensitive applications by ensuring that only known devices can access Duo protected services. When a user authenticates via the Duo Prompt, we'll check for the access device's management status. You can monitor access to your applications from managed and unmanaged devices, and optionally block access from devices not managed by your organization.
Duo's Trusted Endpoints feature is part of the Duo Beyond plan.
Before enabling the Trusted Endpoints policy on your applications, you'll need to deploy the Duo device certificate or REST API access for Duo to your managed mobile devices. This guide walks you through Sophos Mobile configuration for Android and iOS mobile devices.
Please note that Duo supports Sophos Mobile version 8.0 and later.
The new Sophos Mobile integration is created in the "Disabled" state. You'll turn it on when you're ready to apply your Duo trusted endpoints policy.
Keep the Duo Admin Panel open in your browser. You'll need to refer back to the Sophos Mobile management integration page to complete the Android and/or iOS configuration steps.
Duo determines trusted device status on Android devices with Duo Mobile installed and activated for Duo Push using the Sophos Mobile API to verify device information. To enable this verification you'll need to grant Duo's service API access in Sophos Mobile.
If you did not previously set up Android enterprise you must complete it now to continue.
View Duo Mobile in the managed Google Play store and click Approve.
Log on to Sophos Mobile Admin and go to Configure → Apps → Android.
Once on the Android "Approved apps" page, click on the Retrieve app list from Google button. When prompted, click Yes to proceed with importing your approved apps (including Duo Mobile).
Click on Duo Mobile in the approved apps list to edit the app's properties, and then expand the "Managed Configuration" section.
Locate the "Trusted Endpoint Identifier" managed configuration field and enter %CLIENTPROP(ANDROID_ID)% as the value.
Return to your Sophos Mobile management integration page in the Duo Admin Panel.
Copy the "Trusted Endpoints Configuration Key" value from the Android Configuration Instructions tab of your Sophos Mobile management integration (it will look similar to DJPO0S0HLJD0ASDHTDD). Paste this in Sophos Mobile Admin as the Trusted Endpoints Configuration Key value.
Click Save to return to the "Approved apps" page.
Click the Send app settings to Google button, then click Yes when prompted to send your new Duo Mobile app configuration.
If using an on-premises installation of Sophos Mobile you may need to modify your firewall rules so that Sophos Mobile can communicate with Duo's service.
Use the IP ranges shown on the "Sophos Mobile - Android Configuration Instructions" management integration page in the Duo Admin Panel when updating your firewall rules and verifying connectivity.
While still logged into Sophos Mobile Admin, go to Settings Setup → Administrators.
Click on Create administrator.
Enter the following information:
| Username | Enter the desired Duo account username. |
| Role | Set to Duo API Administrator |
| First Name and Last Name | Enter a first and last name for the Duo admin user (e.g. "Duo" "Admin"). |
| Email Address | Enter an email address for your Duo admin user. |
| Password and Confirm Password | Enter and confirm a strong password for the Duo admin user. You will enter this password in the Duo Admin Panel in the next steps. |
Click Save.
Return to your Sophos Mobile management integration page in the Duo Admin Panel.
Enter the following information into the blank fields under step 3 of the Sophos Mobile "Android Configuration Instructions" section:
| Enter the Duo API Administrator username you created in Sophos Mobile. | |
| Password | Enter the password for the Duo API Administrator you created in Sophos Mobile. |
| Customer | Enter your organization's Sophos Mobile customer name, used when logging into Sophos Mobile Admin.. |
| Domain Name | Enter your organization's Sophos Mobile domain. For example, if you access the Sophos Mobile console at https://abc123.sophosmc.com then you'd enter abc123.sophosmc.com as the domain name. |
Click the Test Configuration button to verify Duo's API access to your Sophos Mobile instance. You'll receive a "Configuration Succesful!" message if everything's correct. If the test fails, verify that you completed the Sophos Mobile configuration steps and entered the right information in the Duo Admin Panel.
After you successfully test your configuration, click the Save & Configure Android Devices button.
Duo verifies the trusted status of iOS devices by checking for the presence of a Duo device certificate. You'll use Sophos Mobile to push the Duo CA information to your mobile devices so they can obtain a Duo certificate.
If using an on-premises installation of Sophos Mobile you may need to modify your firewall rules so that Sophos Mobile can communicate with Duo's service.
Use the IP ranges shown on the "Sophos Mobile - iOS Configuration Instructions" management integration page in the Duo Admin Panel when updating your firewall rules and verifying connectivity.
Log on to Sophos Mobile Admin and navigate to Setup → System Setup → Duo Security.
Enter the User and Password from the SCEP information on the Sophos Mobile management integration page in the Duo Admin Panel into Sophos Mobile. Do not modify the "SCEP server URL" or "Challenge URL" from the preconfigured values.
Navigate to Profiles, policies → iOS and click Create → Device profile in Sophos Mobile Admin.
Enter a Name, Organization, and Description for the new profile on the "Edit profile" page.
Click Add configuration and scroll down the page until you locate Duo device certificate. Select it, and then click Next.
Enter a CA name and click Apply. This returns you to the "Edit profile" page.
Click Save to finish and return to the
Navigate to Profiles, policies → iOS in Sophos Mobile Admin.
Locate the Duo device profile you created earlier in the list, click the down arrow next to the name to expose additional options, and click on Show.
Click Transfer on the "Show Profile" page.
Select the iOS devices or device groups to which you'd like to apply the Duo certificate profile and click Next.
Choose whether you want to execute the policy assignment now or at a future date or time, and then click Finish.
You can monitor the profile's installation status on the selected iOS devices under from the "Tasks" page.
Once your Sophos Mobile managed devices receive the Duo config you can set the Trusted Endpoints policy to start checking for managed device status as users authenticate to Duo-protected services and applications.
When your trusted endpoints policy is applied to your Duo applications, return to the Sophos Mobile trusted endpoint management integration in the Admin Panel and activate it either by changing the selection at the top of the page from "Off" to "On" (to immediately apply this to all your Duo users), or select "Test" and pick a target Duo group to verify your setup against a subset of users.
The Device Insight and Endpoints pages in the Duo Admin Panel show which access devices are trusted/managed.
Users on Android devices see a device trust dialog when authenticating to a protected resource via the Duo Prompt.
Duo uses the API access you granted in Sophos to perform a permissions check to verify device information.
If Duo successfully verifies the device information using the Sophos API access, and the user has Duo Mobile activated for Duo Push, then the user receives a login request on their phone. Approving the request grants access to the protected application. The "Second Factor" logged for these approvals is shown as "Duo Mobile Inline Auth" in the Duo authentication log.
If the user does not have Duo Mobile activated for push, or does not approve the Duo request before it times out, the user returns to the Duo Prompt, where they may select from the available factors to complete 2FA.
iOS users will see a prompt asking them to choose a certificate when authenticating to a protected resource via the Duo prompt. After selecting the Duo Device Authentication certificate and completing authentication, subsequent Duo authentications from the same device will automatically use that same certificate for verification.
Deleting a trusted endpoints management tool integration from the Duo Admin Panel immediately invalidates issued Duo device authentication certificates. Be sure to unassign your trusted endpoints policy from all applications or remove the "Trusted Endpoints" configuration item from your global policy before deleting an existing Sophos Mobile integration from "Trusted Endpoints Configuration". You should also disable your Duo admin user in Sophos Mobile.
Leaving the policy settings in place after deleting a management tools integration may inadvertently block user access to applications.
Need some help? Take a look at our Trusted Endpoints Knowledge Base articles or Community discussions. For further assistance, contact Support.