Skip navigation

Duo Security is now a part of Cisco

About Cisco

Documentation

Trusted Endpoints - Google G Suite Managed Device Deployment

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.

Before enabling the Trusted Endpoints policy on your applications, you'll need to configure your managed mobile devices. This guide walks you through Google G Suite configuration for Android mobile devices.

Note that this G Suite management integration and the Duo Mobile management integration for verifying endpoints are mutually exclusive. You won't be able to use G Suite for verification if a management integration for Duo Mobile exists.

Prerequisites

  • Access to the Duo Admin Panel as an administrator with the Owner, Administrator, or Application Manager administrative roles.
  • Access to the Google Cloud Platform console as an administrator with the right to create IAM service accounts.
  • Access to the Google G Suite console as an administrator with the rights to manage API client access.

Create the G Suite Integration

  1. Log in to the Duo Admin Panel and navigate to Trusted Endpoints Configuration.
  2. If this is your first management integration, click the Configure Management Tools Integration button at the bottom of the page. If you're adding another management integration, click the Add Integration button you see instead.
  3. On the "Select Management Tools Integration" page, locate G Suite in the listed integrations and click the Select this integration link to the right.

The new G Suite 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 G Suite management integration page to complete the configuration steps.

Create a Google IAM Service Account for Duo

  1. Log on to the Google Cloud Platform console as an administrator and use the menu on the left to navigate to IAM & adminService Accounts.

  2. Select a project. If you don't have any current Cloud Platform projects you'll need to click the Create Project prompt to proceed. Give your new Google Cloud Platform project a descriptive name, like "Duo Auth". If you do already have a Google Cloud Platform project created for another use you can create a new project for Duo.

  3. Click Create service account on the "Service account management" permissions prompt. Enter a Service account name

  4. Click Create service account, then give it a name. You do not need to select a Role. Select both Furnish a new private key (leave the default JSON selection) and Enable G Suite Domain-wide Delegation.

    When you click Create, it automatically downloads the new service account's JSON key file. Close the pop-up once the file downloads.

  5. Click the View Client ID link on the far right for the service account you just created, and note the Client ID (typically a string of numbers). You'll need this to complete configuration.

Enable the Admin SDK

  1. While still logged in to the Google Cloud Platform console as an administrator, navigate to APIs & servicesLibrary.

  2. Search for Admin SDK on the "API Library" page. Click on it to view.

  3. Click the Enable button for Admin SDK.

Grant API Client Access in G Suite

  1. To complete this part of your G Suite configuration you'll need to copy information from Duo to G Suite. Log in to the Duo Admin Panel and view your G Suite management integration's properties page before the next steps.

  2. Log on to the G Suite Admin console as an administrator and click on Security.

  3. Click Advanced Settings and then click the Manage API client access link.

  4. Copy the Duo Cloud Platform service account client ID and paste it in as the authorized API Client Name.

  5. Copy the scope url from step 3 of the G Suite management integration setup page (e.g. https://www.googleapis.com/auth/admin.directory.device.mobile.readonly) and paste it in to the authorized API One or More API Scopes field.

  6. Click the Authorize button.

Enter Google G Suite Info in Duo

  1. Return to your Google G Suite management integration page in the Duo Admin Panel.

  2. Enter the following information into the blank fields under step 3 of the Google G Suite "Enter API Details" section:

    Admin Email Enter the email address of the G Suite administrator.
    API User Email Enter the client_email from the private key file downloaded from the Google Cloud Platform console earlier when you created the service account.
    Private Key Enter the private_key from the private key file downloaded from the Google Cloud Platform console earlier when you created the service account.
  3. Click the Test Configuration button to verify Duo's API access to your Google G Suite instance. You'll receive a "Configuration Succesful!" message if everything's correct. If the test fails, verify that you completed the Google G Suite configuration steps and entered the right information in the Duo Admin Panel.

  4. After you successfully test your configuration, click the Save & Configure Android Devices button.

Finish Trusted Endpoints Deployment

Once your G Suite 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 G Suite trusted endpoint management integration in the Admin Panel and enable it by clicking the Change link at the top of the page next to "Integration is disabled". You can choose to either activate this management integration for just members of a specified test group or groups, or activate for all users.

Enable Trusted Endpoints Management Integration

The Device Insight and Endpoints pages in the Duo Admin Panel show which access devices are trusted/managed.

Removing the Google G Suite Management Integration

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 Google G Suite integration from "Trusted Endpoints Configuration". You should also disable your Duo admin user in Google G Suite.

Leaving the policy settings in place after deleting a management tools integration may inadvertently block user access to applications.

Troubleshooting

Need some help? Take a look at our Trusted Endpoints Knowledge Base articles or Community discussions. For further assistance, contact Support.

Ready to Get Started?

Sign Up Free