Legacy Android Enterprise for Google Workspace (formerly G Suite) customers 编辑

Google Workspace customers must use the legacy Android Enterprise settings to configure legacy Android Enterprise. Google recently renamed G Suite to Google Workspace.

If your organization already uses Google Workspace to provide users access to Google apps, you can use Google Workspace to register Citrix as your EMM. If your organization uses Google Workspace, it has an existing enterprise ID and existing Google Accounts for users. To use Endpoint Management with Google Workspace, you sync with your LDAP directory and retrieve Google Account information from Google using the Google Directory API. Because this type of enterprise is tied to an existing domain, each domain can only create one enterprise. To enroll a device in Endpoint Management, each user must manually sign in with their existing Google Account. The account gives them access to managed Google Play in addition to any other Google services provided by your Google Workspace plan.

Requirements for legacy Android Enterprise:

• A publicly accessible domain
• A Google administrator account
• Android devices that have managed profile support
• A Google account that has Google Play installed
• A Work profile set up on the device

To start configuring legacy Android Enterprise, click legacy Android Enterprise in the Android Enterprise page in Endpoint Management Settings.

Create an Android Enterprise Account

Before you can set up an Android Enterprise account, you must verify your domain name with Google.

If you have already verified your domain name with Google, you can skip to this step: Set up an Android Enterprise service account and download an Android Enterprise certificate.

1. Navigate to https://gsuite.google.com/signup/basic/welcome.

   The following page displays where you type your administrator and company information.

   

2. Type your administrator user information.

   

3. Type your company information, in addition to your administrator account information.

   

   The first step in the process is complete and you see the following page.

   

Verify domain ownership

Allow Google to verify your domain in one of the following ways:

• Add a TXT or CNAME record to the website of your domain host.
• Upload an HTML file to the web server of your domain.
• Add a <meta> tag to your home page. Google recommends the first method. This article does not cover the steps to verify your domain ownership, but you can find the information you need here: https://support.google.com/a/answer/6248925.

1. Click Start to begin the verification of your domain.

   The Verify domain ownership page appears. Follow the instructions on the page to verify your domain.

2. Click Verify.

   

   

3. Google verifies your domain ownership.

   

4. After successful verification, the following page appears. Click Continue.

   

5. Google creates an EMM binding token that you provide to Citrix and use when you configure Android Enterprise settings. Copy and save the token; you need it later in the setup procedure.

   

6. Click Finish to complete setting up Android Enterprise. A page appears, indicating that you’ve successfully verified your domain.

After you create an Android Enterprise service account, you can sign in to the Google Admin console to manage your mobility management settings.

Set up an Android Enterprise service account and download an Android Enterprise certificate

To allow Endpoint Management to contact Google Play and Directory services, you must create a service account using the Google Project portal for developers. This service account is used for server-to-server communication between Endpoint Management and Google services for Android. For more information about the authentication protocol being used, go to https://developers.google.com/identity/protocols/OAuth2ServiceAccount.

1. In a web browser, go to https://console.cloud.google.com/project and sign in with your Google administrator credentials

2. In the Projects list, click Create Project.

   

3. In Project name, type a name for the project.

   

4. On the Dashboard, click Use Google APIs.

   

5. Click Library, in Search, type EMM and then click the search result.

   

6. On the Overview page, click Enable.

   

7. Next to Google Play EMM API, click Go to Credentials.

   

8. In the Add credentials to our project list, in step 1, click service account.

   

9. On the Service Accounts page, click Create Service Account.

   

10. In Create service account, name the account, and select the Furnish a new private key check box. Click P12, select the Enable Google Apps Domain-wide Delegation check box and then click Create.

    

    The certificate (P12 file) is downloaded to your computer. Be sure to save the certificate in a secure location.

11. On the Service account created confirmation page, click Close.

    

12. In Permissions, click Service accounts and then under Options for your service account, click View Client ID.

    

13. The details required for account authorization on the Google admin console display. Copy the Client ID and Service account ID to a location where you can retrieve the information later. You need this information, along with the domain name to send to Citrix support to add to an allow list.

    

14. On the Library page, search for Admin SDK and then click the search result.

    

15. On the Overview page, click Enable.

    

16. Open the Google admin console for your domain and then click Security.

    

17. On the Settings page, click Show more and then click Advanced settings.

    

    

18. Click Manage API client access.

    

19. In Client Name, type the client ID that you saved earlier, in One or More API Scopes, type https://www.googleapis.com/auth/admin.directory.user and then click Authorize.

    

Binding to EMM

Before you can use Endpoint Management to manage your Android devices, you must contact Citrix Technical Support and provide your domain name, service account, and binding token. Citrix binds the token to Endpoint Management as your enterprise mobility management (EMM) provider. For contact information for Citrix Technical Support, see Citrix Technical Support.

1. To confirm the binding, sign in to the Google Admin portal and then click Security.

2. Click Manage EMM provider for Android.

   You see that your Google Android Enterprise account is bound to Citrix as your EMM provider.

   After you confirm the token binding, you can start using the Endpoint Management console to manage your Android devices. Import the P12 certificate you generated in step 14. Set up Android Enterprise server settings, enable SAML-based single-sign-on (SSO), and define at least one Android Enterprise device policy.

   

Import the P12 certificate

Follow these steps to import your Android Enterprise P12 certificate:

1. In the Endpoint Management console, click the gear icon in the upper-right corner of the console to open the Settings page and then click Certificates. The Certificates page appears.

   

2. Click Import. The Import dialog box appears.

   

   Configure the following settings:

   • Import: In the list, click Keystore.
   • Keystore type: In the list, click PKCS#12.
   • Use as: In the list, click Server.
   • Keystore file: Click Browse and navigate to the P12 certificate.
   • Password: Type the certificate password. This is the private key password you created when setting up your Android Enterprise account.
   • Description: Optionally, type a description of the certificate.

3. Click Import.

Set up Android Enterprise server settings

1. In the Endpoint Management console, click the gear icon in the upper-right corner of the console. The Settings page appears.

2. Under Platforms, click Android Enterprise. The Android Enterprise page appears.

   

   Configure the following settings and then click Save.

   • Domain name: Type your Android Enterprise domain name; for example, domain.com.
   • Domain Admin Account: Type your domain administrator user name; for example, the email account used for Google Developer Portal.
   • Service Account ID: Type your service account ID; for example, the email associated in the Google Service Account (serviceaccountemail@xxxxxxxxx.iam.gserviceaccount.com).
   • Client ID: Type the numerical client ID of your Google service account.
   • Enable Android Enterprise: Select to enable or disable Android Enterprise.

Enable SAML-based single-sign-on

1. In the Endpoint Management console, click the gear icon in the upper-right corner. The Settings page appears.

2. Click Certificates. The Certificates page appears.

   

3. In the list of certificates, click the SAML certificate.

4. Click Export and save the certificate to your computer.

5. Sign in to the Google Admin portal by using your Android Enterprise administrator credentials. For access to the portal, see Google Admin portal.

6. Click Security.

   

7. Under Security, click Set up single sign-on (SSO) and then configure the following settings.

   

   • Sign-in page URL: Type the URL for users signing in to your system and Google Apps. For example: https://<Xenmobile-FQDN>/aw/saml/signin.
   • Sign out page URL: Type the URL to which users are redirected when they sign out. For example: https://<Xenmobile-FQDN>/aw/saml/signout.
   • Change password URL: Type the URL to let users change their password in your system. For example: https://<Xenmobile-FQDN>/aw/saml/changepassword. If this field is defined, users see this prompt even when SSO is not available.
   • Verification certificate: Click CHOOSE FILE and then navigate to the SAML certificate exported from Endpoint Management.

8. Click SAVE CHANGES.

Set up an Android Enterprise device policy

Set up a Passcode policy so that users must establish a passcode on their devices when they first enroll.

The basic steps to setting up any device policy are as follows.

1. In the Endpoint Management console, click Configure, and then click Device Policies.

2. Click Add and then on the Add a New Policy dialog box, select the policy you want to add. In this example, you click Passcode.

3. Complete the Policy Information page.

4. Click Android Enterprise and then configure the settings for the policy.

5. Assign the policy to a Delivery Group.

Configure Android Enterprise account settings

Before you can start managing Android apps and policies on devices, you must set up an Android Enterprise domain and account information in Endpoint Management. First, complete Android Enterprise setup tasks on Google to set up a domain administrator and to obtain a service account ID and a binding token.

1. In the Endpoint Management web console, click the gear icon in the upper-right corner. The Settings page displays.

2. Under Platforms, click Android Enterprise. The Android Enterprise configuration page appears.

1. On the Android Enterprise page, configure the following settings:

   • Domain Name: Type your domain name.
   • Domain Admin Account: Type your domain administrator user name.
   • Service Account ID: Type your Google Service Account ID.
   • Client ID: Type the client ID of your Google service account.
   • Enable Android Enterprise: Select whether to enable Android Enterprise or not.

2. Click Save.

Set up Google Workspace partner access for Endpoint Management

Some Endpoint Management features for Chrome use Google partner APIs to communicate between Endpoint Management and your Google Workspace domain. For example, Endpoint Management requires the APIs for device policies that manage Chrome features such as Incognito mode and Guest mode.

To enable the partner APIs, you set up your Google Workspace domain in the Endpoint Management console and then configure your Google Workspace account.

Set up your Google Workspace domain in Endpoint Management

To enable Endpoint Management to communicate with the APIs in your Google Workspace domain, go to Settings > Google Chrome Configuration and configure the settings.

• Google Workspace domain: The Google Workspace domain that hosts the APIs needed by Endpoint Management.
• Google Workspace admin account: The administrator account for your Google Workspace domain.
• Google Workspace client ID: The client ID for Citrix. Use this value to configure partner access for your Google Workspace domain.
• Google Workspace enterprise ID: The enterprise ID for your account, filled in from your Google enterprise account.

Enable partner access for devices and users in your Google Workspace domain

1. Log in into the Google admin console: https://admin.google.com

2. Click Device Management.

   

3. Click Chrome management.

   

4. Click User settings.

   

5. Search for Chrome Management - Partner Access.

   

6. Select the Enable Chrome Management - Partner Access check box.

7. Agree that you understand and want to enable partner access. Click Save.

8. In the Chrome management page, click Device Settings.

   

9. Search for Chrome Management - Partner Access.

   

10. Select the Enable Chrome Management - Partner Access check box.

11. Agree that you understand and want to enable partner access. Click Save.

12. Go to the Security page and then click Advanced Settings.

    

13. Click Manage API client Access.

14. In the Endpoint Management console, go to Settings > Google Chrome Configuration and copy the value of G Suite Client ID. Then, return to the Manage API client Access page and paste the copied value to the Client Name field.

15. In One or More API Scopes, add the URL: https://www.googleapis.com/auth/chromedevicemanagementapi

    

16. Click Authorize.

    The message “Your settings have been saved” appears.

Enrolling Android Enterprise devices

If your device enrollment process requires users to enter a user name or user ID, the format accepted depends on how the Endpoint Management server is configured to search for users by User Principal Name (UPN) or SAM account name.

If the Endpoint Management server is configured to search for users by UPN, users must enter a UPN in the format:

• username@domain

If the Endpoint Management server is configured to search for users by SAM users must enter a SAM in one of these formats:

• username@domain
• domain\username

To determine which type of user name your Endpoint Management server is configured for:

1. In the Endpoint Management server console click the gear icon in the upper-right corner. The Settings page appears.
2. Click LDAP to view the configuration of the LDAP connection.

3. Near the bottom of the page, view the User search by field:

   • If it is set to userPrincipalName, Endpoint Management server is set for UPN.
   • If it is set to sAMAccountName, Endpoint Management server is set for SAM.

Unenrolling an Android Enterprise enterprise

You can unenroll an Android Enterprise enterprise using the Endpoint Management server console and Endpoint Management Tools.

When you perform this task, the Endpoint Management server opens a popup window for Endpoint Management Tools. Before you begin, ensure that the Endpoint Management server has permission to open popup windows in the browser you are using. Some browsers, such as Google Chrome, require you to disable popup blocking and add the address of the Endpoint Management site to the popup allow list.

Warning:

After an enterprise is unenrolled, Android Enterprise apps on devices already enrolled through it are reset to their default states. The devices will no longer be managed by Google. Re-enrolling them in an Android Enterprise enterprise may not restore previous functionality without further configuration.

After the Android Enterprise enterprise is unenrolled:

• Devices and users enrolled through the enterprise have the Android Enterprise apps reset to their default state. App permissions and Managed configurations policies previously applied no longer have an effect.
• Devices enrolled through the enterprise are managed by Endpoint Management, but are unmanaged from Google perspective. No new Android Enterprise apps can be added. No App permissions or Managed configurations policies can be applied. Other policies, such as Scheduling, Password, and Restrictions can still be applied to these devices.
• If you attempt to enroll devices in Android Enterprise, they are enrolled as Android devices, not Android Enterprise devices.

To unenroll an Android Enterprise enterprise:

1. In the Endpoint Management console, click the gear icon in the upper-right corner. The Settings page appears.

2. On the Settings page, click Android Enterprise.

3. Click Remove Enterprise.

   

4. Specify a password. You’ll need this for the next step to complete the unenrollment. Then click Unenroll.

   

5. When the Endpoint Management Tools page opens, enter the password you created in the previous step.

   

6. Click Unenroll.

   

Provisioning fully managed devices in Android Enterprise

Only company-owned devices can be fully managed devices in Android Enterprise. On fully managed devices the entire device, not just the work profile, is controlled by the company or organization. Fully managed devices are also known as work-managed devices.

Endpoint Management supports these methods of enrollment for fully managed devices:

• afw#xenmobile: With this enrollment method, the user enters the characters afw#xenmobile when setting up the device. This token identifies the device as managed by Endpoint Management and downloads Secure Hub.
• QR code: QR code provisioning is an easy way to provision a distributed fleet of devices that do not support NFC, such as tablets. The QR code enrollment method can be used on fleet devices that have been reset to their factory settings. The QR code enrollment method sets up and configures fully managed devices by scanning a QR code from the setup wizard.
• Near field communication (NFC) bump: The NFC bump enrollment method can be used on fleet devices that have been reset to their factory settings. An NFC bump transfers data through between two devices using near-field communication. Bluetooth, Wi-Fi, and other communication modes are disabled on a factory-reset device. NFC is the only communication protocol that the device can use in this state.

afw#xenmobile

The enrollment method is used after powering on a new or factory reset devices for initial setup. Users enter afw#xenmobile when prompted to enter a Google account. This action downloads and installs Secure Hub. Users then follow the Secure Hub set-up prompts to complete the enrollment.

This enrollment method is recommended for most customers because the latest version of Secure Hub is downloaded from the Google Play store. Unlike with other enrollment methods, you do not provide Secure Hub for download from the Endpoint Management server.

Prerequisites:

• Supported on all Android devices running Android OS.

QR code

To enroll a device in device mode using a QR code, you generate a QR code by creating a JSON and converting the JSON to a QR code. Device cameras scan the QR code to enroll the device.

Prerequisites:

• Supported on all Android devices running Android 7.0 and above.

Create a QR code from a JSON

Create a JSON with the following fields.

These fields are required:

Key: android.app.extra.PROVISIONING_DEVICE_ADMIN_COMPONENT_NAME

Value: com.zenprise/com.zenprise.configuration.AdminFunction

Key: android.app.extra.PROVISIONING_DEVICE_ADMIN_SIGNATURE_CHECKSUM

Value: qn7oZUtheu3JBAinzZRrrjCQv6LOO6Ll1OjcxT3-yKM

Key: android.app.extra.PROVISIONING_DEVICE_ADMIN_PACKAGE_DOWNLOAD_LOCATION

Value: https://play.google.com/managed/downloadManagingApp?identifier=xenmobile

These fields are optional:

• android.app.extra.PROVISIONING_LOCALE: Enter language and country codes.

  The language codes are two-letter lowercase ISO language codes (such as en) as defined by ISO 639-1. The country codes are two-letter uppercase ISO country codes (such as US) as defined by ISO 3166-1. For example, enter en_US for English as spoken in the United States.

• android.app.extra.PROVISIONING_TIME_ZONE: The time zone in which the device is running.

  Type the database name of the area/location. For example, type America/Los_Angeles for Pacific time. If you don’t type a name, the time zone automatically populates.

• android.app.extra.PROVISIONING_LOCAL_TIME: Time in milliseconds since the Epoch.

  The Unix epoch (or Unix time, POSIX time, or Unix timestamp) is the number of seconds that have elapsed since January 1, 1970 (midnight UTC/GMT). The time doesn’t include leap seconds (in ISO 8601: 1970-01-01T00:00:00Z).

• android.app.extra.PROVISIONING_SKIP_ENCRYPTION: Set to true to skip encryption during profile creation. Set to false to force encryption during profile creation.

A typical JSON looks like the following:

Validate the JSON that is created using any JSON validation tool, such as https://jsonlint.com. Convert that JSON string to a QR code using any online QR code generator.

This QR code gets scanned by a factory-reset device to enroll the device as fully managed devices.

To enroll the device

To enroll a device as a fully managed device, the device must be in factory reset state.

1. Tap the screen six times on the welcome screen to launch the QR code enrollment flow.

2. When prompted, connect to Wi-Fi. The download location for Secure Hub in the QR code (encoded in the JSON) is accessible over this Wi-Fi network.

   Once the device successfully connects to Wi-Fi, it downloads a QR code reader from Google and launches the camera.

3. Point the camera to the QR code to scan the code.

   Android downloads Secure Hub from the download location in the QR code, validate the signing certificate signature, install Secure Hub and sets it as device owner.

For more information about provisioning devices using the QR code method, see the Google API documentation for Android EMM developers.

NFC bump

To enroll a device as a fully managed device using NFC bumps requires two devices: One that is reset to its factory settings and one running the Endpoint Management Provisioning Tool.

Prerequisites:

• Supported Android devices
• Endpoint Management enabled for Android Enterprise
• A new or factory-reset device, provisioned for Android Enterprise as a fully managed device. You can find steps to complete this prerequisite later in this article.
• Another device with NFC capability, running the configured Provisioning Tool. The Provisioning Tool is available in Secure Hub or on the Citrix downloads page.

Each device can have only one Android Enterprise profile, managed by an enterprise mobility management (EMM) app. In Endpoint Management, Secure Hub is the EMM app. Only one profile is allowed on each device. Attempting to add a second EMM app removes the first EMM app.

Data transferred through the NFC bump

Provisioning a factory-reset device requires you to send the following data through an NFC bump to initialize Android Enterprise:

• Package name of the EMM provider app that acts as device owner (in this case, Secure Hub).
• Intranet/Internet location from which the device can download the EMM provider app.
• SHA-256 hash of EMM provider app to verify if the download is successful.
• Wi-Fi connection details so that a factory-reset device can connect and download the EMM provider app. Note: Android now does not support 802.1x Wi-Fi for this step.
• Time zone for the device (optional).
• Geographic location for the device (optional).

When the two devices are bumped, the data from the Provisioning Tool is sent to the factory-reset device. That data is then used to download Secure Hub with administrator settings. If you don’t enter time zone and location values, Android automatically configures the values on the new device.

Configuring the Endpoint Management Provisioning Tool

Before doing an NFC bump, you must configure the Provisioning Tool. This configuration is then transferred to the factory-reset device during the NFC bump.

You can type data into the required fields or populate them via text file. The steps in the next procedure describe how to configure the text file and contain descriptions for each field. The app doesn’t save information after you type it, so you might want to create a text file to keep the information for future use.

To configure the Provisioning Tool by using a text file

Name the file nfcprovisioning.txt and place the file in the /sdcard/ folder on the SD card of the device. The app can then read the text file and populate the values.

The text file must contain the following data:

android.app.extra.PROVISIONING_DEVICE_ADMIN_PACKAGE_DOWNLOAD_LOCATION=<download_location>

This line is the intranet/internet location of the EMM provider app. After the factory-reset device connects to Wi-Fi following the NFC bump, the device must have access to this location for downloading. The URL is a regular URL, with no special formatting required.

android.app.extra.PROVISIONING_DEVICE_ADMIN_PACKAGE_CHECKSUM=<SHA-256 hash>

This line is the checksum of the EMM provider app. This checksum is used to verify that the download is successful. Steps to obtain the checksum are discussed later in this article.

android.app.extra.PROVISIONING_WIFI_SSID=<wifi ssid>

This line is the connected Wi-Fi SSID of the device on which the Provisioning Tool is running.

android.app.extra.PROVISIONING_WIFI_SECURITY_TYPE=<wifi security type>

Supported values are WEP and WPA2. If the Wi-Fi is unprotected, this field must be empty.

android.app.extra.PROVISIONING_WIFI_PASSWORD=<wifi password>

If the Wi-Fi is unprotected, this field must be empty.

android.app.extra.PROVISIONING_LOCALE=<locale>

Enter language and country codes. The language codes are two-letter lowercase ISO language codes (such as en) as defined by ISO 639-1. The country codes are two-letter uppercase ISO country codes (such as US) as defined by ISO 3166-1. For example, type en_US for English as spoken in the United States. If you don’t type any codes, the country and language are automatically populated.

android.app.extra.PROVISIONING_TIME_ZONE=<timezone>

The time zone in which the device is running. Type the database name of the area/location. For example, type America/Los_Angeles for Pacific time. If you don’t type a name, the time zone automatically populates.

android.app.extra.PROVISIONING_DEVICE_ADMIN_PACKAGE_NAME=<package name>

This data isn’t required, because the value is hardcoded into the app as Secure Hub. It’s mentioned here only for the sake of completion.

If there is a Wi-Fi protected by using WPA2, a completed nfcprovisioning.txt file might look like the following:

android.app.extra.PROVISIONING_DEVICE_ADMIN_PACKAGE_DOWNLOAD_LOCATION=https://www.somepublicurlhere.com/path/to/securehub.apk

android.app.extra.PROVISIONING_DEVICE_ADMIN_PACKAGE_CHECKSUM=ga50TwdCmfdJ72LGRFkke4CrbAk\u003d

android.app.extra.PROVISIONING_WIFI_SSID=Protected_WiFi_Name

android.app.extra.PROVISIONING_WIFI_SECURITY_TYPE=WPA2

android.app.extra.PROVISIONING_WIFI_PASSWORD=wifiPasswordHere

android.app.extra.PROVISIONING_LOCALE=en_US

android.app.extra.PROVISIONING_TIME_ZONE=America/Los_Angeles

If there is an unprotected Wi-Fi, a completed nfcprovisioning.txt file might look like the following:

android.app.extra.PROVISIONING_DEVICE_ADMIN_PACKAGE_DOWNLOAD_LOCATION=https://www.somepublicurlhere.com/path/to/securehub.apk

android.app.extra.PROVISIONING_DEVICE_ADMIN_PACKAGE_CHECKSUM=ga50TwdCmfdJ72LGRFkke4CrbAk\u003d

android.app.extra.PROVISIONING_WIFI_SSID=Unprotected_WiFi_Name

android.app.extra.PROVISIONING_LOCALE=en_US

android.app.extra.PROVISIONING_TIME_ZONE=America/Los_Angeles

To get the checksum of Citrix Secure Hub

The checksum of Secure Hub is a constant value: qn7oZUtheu3JBAinzZRrrjCQv6LOO6Ll1OjcxT3-yKM. To download an APK file for Secure Hub, use the following Google Play store link: https://play.google.com/managed/downloadManagingApp?identifier=xenmobile.

To get an app checksum

Prerequisites:

• The apksigner tool from the Android SDK Build Tools
• OpenSSL command line

To get the checksum of any app, follow these steps:

1. Download the app’s APK file from the Google Play store.

2. In the OpenSSL command line, navigate to the apksigner tool: android-sdk/build-tools/<version>/apksigner and type the following:

   apksigner verify -print-certs <apk_path> | perl -nle 'print $& if m{(?<=SHA-256 digest:) .*}'  | xxd -r -p | openssl base64 | tr -d '=' | tr -- '+/=' '-_'
   <!--NeedCopy-->