Citrix Endpoint Management

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 Citrix 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 Citrix 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 the legacy Android Enterprise, click legacy Android Enterprise in the Android Enterprise page in Citrix Endpoint Management Settings.

Legacy Android Enterprise option

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.

    Account setup page

  2. Type your administrator user information.

    Administrator user information

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

    Company information screen

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

    Verification 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.

    The Verify button

    The Verify confirmation

  3. Google verifies your domain ownership.

    Domain ownership verification

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

    Success confirmation page

  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.

    Binding token

  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 Citrix 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 Citrix 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.

    The Create Project option

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

    The Project name option

  4. On the Dashboard, click Use Google APIs.

    The Use Google APIs option

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

    The EMM search option

  6. On the Overview page, click Enable.

    The Enable option

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

    The Go to Credentials option

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

    The service account option

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

    The Create Service Account option

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

    The Create service account options

    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.

    The confirmation page

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

    The View Client ID option

  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.

    The account authorization details

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

    The Admin SDK search

  15. On the Overview page, click Enable.

    The Enable button

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

    The Security option

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

    The Advanced settings

    Advanced settings

  18. Click Manage API client access.

    The Manage API client access option

  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.

    The Client name options

Binding to EMM

Before you can use Citrix 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 Citrix 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 Citrix Endpoint Management console to manage your Android devices. Import the P12 certificate that 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.

    The Manage EMM provide for Android options

Import the P12 certificate

Follow these steps to import your Android Enterprise P12 certificate:

  1. In the Citrix 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.

    The Certificates page

  2. Click Import. The Import dialog box appears.

    The Import dialog box

    Configure the following settings:

    • Import: Click Keystore in the drop-down list.
    • Keystore type: Click PKCS#12 in the drop-down list.
    • Use as: Click Server in the drop-down list.
    • Keystore file: Click Browse and navigate to the P12 certificate.
    • Password: Type the certificate password. This password is the private key password that 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 Citrix 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.

    The Android Enterprise page

    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 the 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 Citrix Endpoint Management console, click the gear icon in the upper-right corner. The Settings page appears.

  2. Click Certificates. The Certificates page appears.

    The Certificates page

  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 the Google Admin portal.

  6. Click Security.

    The Security option

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

    The SSO 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 isn’t available.
    • Verification certificate: Click CHOOSE FILE and then navigate to the SAML certificate exported from Citrix 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 Passcode policy page

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

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

  2. Click Add.

  3. On the Add a New Policy dialog box, select the policy you want to add. In this example, you click Passcode.

  4. Complete the Policy Information page.

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

  6. 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 Citrix Endpoint Management. First, complete the Android Enterprise setup tasks on Google to set up a domain administrator and to get a service account ID and a binding token.

  1. In the Citrix 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.

The Android Enterprise configuration page

  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 Citrix Endpoint Management

Some Citrix Endpoint Management features for Chrome use Google partner APIs to communicate between Citrix Endpoint Management and your Google Workspace domain. For example, Citrix 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 Citrix Endpoint Management console and then configure your Google Workspace account.

Set up your Google Workspace domain in Citrix Endpoint Management

To enable Citrix 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 Citrix 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.

    Google administrator console

  3. Click Chrome management.

    Google administrator console

  4. Click User settings.

    Google administrator console

  5. Search for Chrome Management - Partner Access.

    Google administrator console

  6. Select the Enable Chrome Management - Partner Access checkbox.

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

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

    Google administrator console

  9. Search for Chrome Management - Partner Access.

    Google administrator console

  10. Select the Enable Chrome Management - Partner Access checkbox.

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

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

    Google administrator console

  13. Click Manage API client Access.

  14. In the Citrix 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

    Google administrator console

  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 Citrix Endpoint Management server is configured to search for users by User Principal Name (UPN) or SAM account name.

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

  • username@domain

If the Citrix 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 Citrix Endpoint Management server is configured for:

  1. In the Citrix 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, the Citrix Endpoint Management server is set for UPN.
    • If it is set to sAMAccountName, the Citrix Endpoint Management server is set for SAM.

Unenrolling an Android Enterprise enterprise

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

When you do this task, the Citrix Endpoint Management server opens a popup window for Citrix Endpoint Management Tools. Before you begin, make sure that the Citrix 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 Citrix 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 are no longer managed by Google. Re-enrolling them in an Android Enterprise enterprise might 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 Citrix Endpoint Management, but are unmanaged from the 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 try to enroll devices in Android Enterprise, they’re enrolled as Android devices, not Android Enterprise devices.

To unenroll an Android Enterprise enterprise:

  1. In the Citrix 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.

    The Remove Enterprise option

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

    The Unenroll option

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

    The password field

  6. Click Unenroll.

    The Unenroll option

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.

Citrix 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 Citrix Endpoint Management and downloads Citrix 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 Citrix Secure Hub. Users then follow the Citrix Secure Hub set-up prompts to complete the enrollment.

This enrollment method is recommended for most customers because the latest version of Citrix Secure Hub is downloaded from the Google Play store. Unlike with other enrollment methods, you do not provide Citrix Secure Hub for download from the Citrix 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:

A typical JSON

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 a fully managed device.

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 Citrix 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 Citrix Secure Hub from the download location in the QR code, validate the signing certificate signature, install Citrix 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 Citrix Endpoint Management Provisioning Tool.

Prerequisites:

  • Supported Android devices
  • Citrix 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 Citrix 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 Citrix Endpoint Management, Citrix Secure Hub is the EMM app. Only one profile is allowed on each device. Trying 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 the Android Enterprise:

  • Package name of the EMM provider app that acts as device owner (in this case, Citrix 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 Citrix 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 Citrix 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.

The Provisioning Tool configuration

You can type data into the required fields or populate them via a text file. The steps in the next procedure describe how to configure the text file and have 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 have 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 get 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 Citrix 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 Citrix Secure Hub is a constant value: qn7oZUtheu3JBAinzZRrrjCQv6LOO6Ll1OjcxT3-yKM. To download an APK file for Citrix 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-->
    

    The command returns a valid checksum.

  3. To generate the QR code, enter the checksum in the PROVISIONING_DEVICE_ADMIN_SIGNATURE_CHECKSUM field. For example:
{
  "android.app.extra.PROVISIONING_DEVICE_ADMIN_COMPONENT_NAME": "com.zenprise/com.zenprise.configuration.AdminFunction",
  "android.app.extra.PROVISIONING_DEVICE_ADMIN_SIGNATURE_CHECKSUM":"qn7oZUtheu3JBAinzZRrrjCQv6LOO6Ll1OjcxT3-yKM",
  "android.app.extra.PROVISIONING_DEVICE_ADMIN_PACKAGE_DOWNLOAD_LOCATION": "https://play.google.com/managed/downloadManagingApp?identifier=xenmobile",
  "android.app.extra.PROVISIONING_ADMIN_EXTRAS_BUNDLE": {
      "serverURL": "https://supportablility.xm.cloud.com"
   }
}
<!--NeedCopy-->

Libraries used

The Provisioning Tool uses the following libraries in its source code:

  • v7 appcompat library, Design Support library, and v7 palette support library

    For information, look for the Support Library Features Guide in the Android developers documentation.

  • Butter Knife by Jake Wharton under Apache license 2.0

Provision work profile devices in Android Enterprise

On work profile devices in Android Enterprises, you securely separate the corporate and personal areas on a device. For example, BYOD devices can be work profile devices. The enrollment experience for work profile devices is similar to Android enrollment in Citrix Endpoint Management. Users download Citrix Secure Hub from Google Play and enroll their devices.

By default, the USB Debugging and Unknown Sources settings are disabled on a device when it is enrolled in Android Enterprise as a work profile device.

Tip:

When enrolling devices in Android Enterprise as work profile devices, always go to Google Play. From there, enable Citrix Secure Hub to appear in the user’s personal profile.