适用于 Google Workspace（以前称为 G Suite）客户的旧版 Android Enterprise

Last published : Oct 21, 2026
Google Workspace 客户必须使用旧版 Android Enterprise 设置来配置旧版 Android Enterprise。Google 最近将 G Suite 更名为 Google Workspace。
如果您的组织已使用 Google Workspace 为用户提供 Google 应用访问权限，则可以使用 Google Workspace 将 Citrix 注册为您的 EMM。如果您的组织使用 Google Workspace，则它具有现有的企业 ID 和现有用户 Google 帐户。要将 Citrix Endpoint Management 与 Google Workspace 结合使用，您需要与 LDAP 目录同步，并使用 Google Directory API 从 Google 检索 Google 帐户信息。由于此类企业与现有域绑定，因此每个域只能创建一个企业。要在 Citrix Endpoint Management 中注册设备，每个用户都必须使用其现有的 Google 帐户手动登录。该帐户除了提供您的 Google Workspace 计划提供的任何其他 Google 服务外，还授予他们对托管 Google Play 的访问权限。
旧版 Android Enterprise 的要求：
  • 可公开访问的域
  • Google 管理员帐户
  • 支持托管配置文件的 Android 设备
  • 已安装 Google Play 的 Google 帐户
  • 设备上设置的工作配置文件
要开始配置旧版 Android Enterprise，请在 Citrix Endpoint Management 设置的“Android Enterprise”页面中单击“旧版 Android Enterprise”。
旧版 Android Enterprise 选项
Related information
设备管理

创建 Android Enterprise 帐户

在设置 Android Enterprise 帐户之前，您必须向 Google 验证您的域名。
如果您已向 Google 验证您的域名，则可以跳到此步骤：设置 Android Enterprise 服务帐户并下载 Android Enterprise 证书。
  1. 导航到 <https://gsuite.google.com/signup/basic/welcome>。
    下一页显示您输入管理员和公司信息的位置。
    帐户设置页面(/en-us/citrix-endpoint-management/media/afw-account-setup-redirect.png)
  2. 输入您的管理员用户信息。
    管理员用户信息(/en-us/citrix-endpoint-management/media/afw-enter-admin-user-info.png)
  3. 除了管理员帐户信息之外，还要输入您的公司信息。
    公司信息屏幕(/en-us/citrix-endpoint-management/media/afw-enter-company-info.png)
    流程的第一步已完成，您将看到以下页面。
    验证页面(/en-us/citrix-endpoint-management/media/afw-dns-verification-1.png)

验证域所有权

允许 Google 通过以下任一方式验证您的域：
  • 将 TXT 或 CNAME 记录添加到您的域主机的网站。
  • 将 HTML 文件上传到您的域的 Web 服务器。
  • 将 <meta> 标记添加到您的主页。Google 建议使用第一种方法。本文不介绍验证域所有权的步骤，但您可以在此处找到所需信息：https://support.google.com/a/answer/6248925。
  1. 单击 Start 开始验证您的域。
    出现“验证域所有权”页面。按照页面上的说明验证您的域。
  2. 点击验证。
    验证按钮(/en-us/citrix-endpoint-management/media/afw-verify-domain-ownership.png)
    验证确认(/en-us/citrix-endpoint-management/media/afw-domain-verified.png)
  3. Google 验证您的域所有权。
    域所有权验证(/en-us/citrix-endpoint-management/media/afw-google-verification.png)
  4. 成功验证后，将显示以下页面。点击继续。
    成功确认页面(/en-us/citrix-endpoint-management/media/afw-dns-verification-9.png)
  5. Google 创建一个 EMM 绑定令牌，您需要将此令牌提供给 Citrix® 并在配置 Android Enterprise 设置时使用。复制并保存此令牌；您在后续设置过程中需要它。
    绑定令牌(/en-us/citrix-endpoint-management/media/afw-obtain-token.png)
  6. 点击完成以完成 Android Enterprise 的设置。此时将显示一个页面，指示您已成功验证域。
创建 Android Enterprise 服务帐户后，您可以登录 Google 管理控制台以管理您的移动性管理设置。

设置 Android Enterprise 服务帐户并下载 Android Enterprise 证书

要允许 Citrix Endpoint Management 联系 Google Play 和目录服务，您必须使用面向开发人员的 Google Project 门户创建服务帐户。此服务帐户用于 Citrix Endpoint Management 与 Google Android 服务之间的服务器到服务器通信。有关所用身份验证协议的详细信息，请访问 <https://developers.google.com/identity/protocols/OAuth2ServiceAccount>。
  1. 在 Web 浏览器中，访问 <https://console.cloud.google.com/project> 并使用您的 Google 管理员凭据登录
  2. 在项目列表中，点击创建项目。
    创建项目选项(/en-us/citrix-endpoint-management/media/google-config-api-1.png)
  3. 在 项目名称 中，键入项目的名称。
    项目名称选项(/en-us/citrix-endpoint-management/media/google-config-api-2.png)
  4. 在控制面板上，单击 使用 Google API。
    使用 Google API 选项(/en-us/citrix-endpoint-management/media/google-config-api-6.png)
  5. 单击 库，在 搜索 中键入 EMM，然后单击搜索结果。
    EMM 搜索选项(/en-us/citrix-endpoint-management/media/afw-emm-search.png)
  6. 在 概览 页面上，单击 启用。
    启用选项(/en-us/citrix-endpoint-management/media/afw-emm-enable.png)
  7. 在 Google Play EMM API 旁边，单击 转到凭据。
    转到凭据选项(/en-us/citrix-endpoint-management/media/google-config-api-13.png)
  8. 在 将凭据添加到我们的项目 列表中，在步骤 1 中，单击 服务帐户。
    服务帐户选项(/en-us/citrix-endpoint-management/media/google-config-api-1b.png)
  9. 在 服务帐户 页面上，单击 创建服务帐户。
    创建服务帐户选项(/en-us/citrix-endpoint-management/media/google-config-api-1e.png)
  10. 在创建服务帐号中，命名该帐号，然后选中提供新的私钥复选框。单击 P12，选中启用 Google Apps 域范围授权复选框，然后单击创建。
    创建服务帐号选项
    证书 (P12 文件) 已下载到您的计算机。请务必将证书保存在安全位置。
  11. 在服务帐号已创建确认页面上，单击关闭。
    确认页面
  12. 在权限中，单击服务帐号，然后在您的服务帐号的选项下，单击查看客户端 ID。
    查看客户端 ID 选项
  13. Google 管理控制台上显示帐号授权所需的详细信息。将客户端 ID 和服务帐号 ID 复制到以后可以检索信息的位置。您需要此信息以及域名，以便发送给 Citrix 支持人员以添加到允许列表。
    帐号授权详细信息
  14. 在库页面上，搜索 Admin SDK，然后单击搜索结果。
    Admin SDK 搜索
  15. 在概览页面上，单击启用。
    启用按钮
  16. 打开您的域的 Google 管理控制台，然后单击安全。
    安全选项
  17. 在“设置”页面上，单击“显示更多”，然后单击“高级设置”。
    高级设置高级设置
  18. 单击“管理 API 客户端访问”。
    管理 API 客户端访问选项
  19. 在“客户端名称”中，键入您之前保存的客户端 ID；在“一个或多个 API 范围”中，键入 https://www.googleapis.com/auth/admin.directory.user，然后单击“授权”。
    客户端名称选项

绑定到 EMM

在使用 Citrix Endpoint Management 管理 Android 设备之前，您必须联系 Citrix 技术支持并提供您的域名、服务帐户和绑定令牌。Citrix 会将该令牌绑定到 Citrix Endpoint Management，作为您的企业移动性管理 (EMM) 提供商。有关 Citrix 技术支持的联系信息，请参阅Citrix 技术支持。
  1. 要确认绑定，请登录 Google 管理门户，然后单击“安全性”。
  2. 单击“管理 Android 的 EMM 提供商”。
    您会看到您的 Google Android Enterprise 帐户已绑定到 Citrix 作为您的 EMM 提供商。
    确认令牌绑定后，您可以开始使用 Citrix Endpoint Management 控制台管理 Android 设备。导入您在步骤 14 中生成的 P12 证书。设置 Android Enterprise 服务器设置，启用基于 SAML 的单点登录 (SSO)，并定义至少一个 Android Enterprise 设备策略。
    管理 Android 的 EMM 提供商选项

导入 P12 证书

请按照以下步骤导入您的 Android Enterprise P12 证书：
  1. 在 Citrix Endpoint Management 控制台中，单击控制台右上角的齿轮图标以打开“设置”页面，然后单击“证书”。“证书”页面随即显示。
    证书页面(/en-us/citrix-endpoint-management/media/android-enterprise-certs-import.png)
  2. 单击“导入”。“导入”对话框随即显示。
    导入对话框(/en-us/citrix-endpoint-management/media/afw-import-certificate-detail.png)
    配置以下设置：
    • 导入： 在下拉列表中单击“密钥库”。
    • 密钥库类型： 在下拉列表中单击“PKCS#12”。
    • 用作： 在下拉列表中单击“服务器”。
    • 密钥库文件： 单击“浏览”并导航到 P12 证书。
    • 密码： 键入证书密码。此密码是您在设置 Android Enterprise 帐户时创建的私钥密码。
    • 描述： （可选）键入证书的描述。
  3. 单击 Import。

设置 Android Enterprise 服务器设置

  1. 在 Citrix Endpoint Management 控制台中，单击控制台右上角的齿轮图标。“设置”页面随即显示。
  2. 在“平台”下，单击“Android Enterprise”。“Android Enterprise”页面随即显示。
    Android Enterprise 的页面
    配置以下设置，然后单击“保存”。
    • **域名：**键入您的 Android Enterprise 域名；例如，domain.com。
    • **域管理员帐户：**键入您的域管理员用户名；例如，用于 Google Developer Portal 的电子邮件帐户。
    • **服务帐户 ID：**键入您的服务帐户 ID；例如，Google 服务帐户中关联的电子邮件 (serviceaccountemail@xxxxxxxxx.iam.gserviceaccount.com)。
    • **客户端 ID：**键入您的 Google 服务帐户的数字客户端 ID。
    • **启用 Android Enterprise：**选择启用或禁用 Android Enterprise。

启用基于 SAML 的单点登录

  1. 在 Citrix Endpoint Management 控制台中，单击右上角的齿轮图标。此时将显示“设置”页面。
  2. 单击“证书”。此时将显示“证书”页面。
    证书页面(/en-us/citrix-endpoint-management/media/android-enterprise-certs-export.png)
  3. 在证书列表中，单击 SAML 证书。
  4. 单击“导出”，并将证书保存到您的计算机。
  5. 使用您的 Android Enterprise 管理员凭据登录 Google 管理门户。有关访问门户的信息，请参阅 Google 管理门户。
  6. 单击“安全性”。
    安全选项
  7. 在安全下，单击设置单点登录 (SSO)，然后配置以下设置。
    SSO 设置
    • 登录页面 URL： 键入用户登录到您的系统和 Google Apps 的 URL。例如：https://<Xenmobile-FQDN>/aw/saml/signin。
    • 注销页面 URL： 键入用户注销时重定向到的 URL。例如：https://<Xenmobile-FQDN>/aw/saml/signout。
    • 更改密码 URL： 键入允许用户在您的系统中更改其密码的 URL。例如：https://<Xenmobile-FQDN>/aw/saml/changepassword。如果定义了此字段，即使 SSO 不可用，用户也会看到此提示。
    • 验证证书： 单击选择文件，然后导航到从 Citrix Endpoint Management 导出的 SAML 证书。
  8. 单击保存更改。

设置 Android Enterprise 设备策略

设置密码策略，以便用户在首次注册时必须在其设备上设置密码。
密码策略页面
设置任何设备策略的基本步骤如下。
  1. 在 Citrix Endpoint Management 控制台中，单击配置，然后单击设备策略。
  2. 单击 添加。
  3. 在添加新策略对话框中，选择要添加的策略。在此示例中，单击密码。
  4. 完成策略信息页面。
  5. 点击 Android Enterprise，然后配置策略设置。
  6. 将策略分配给交付组。

配置 Android Enterprise 帐户设置

在开始管理设备上的 Android 应用程序和策略之前，您必须在 Citrix Endpoint Management 中设置 Android Enterprise 域和帐户信息。首先，在 Google 上完成 Android Enterprise 设置任务，以设置域管理员并获取服务帐户 ID 和绑定令牌。
  1. 在 Citrix Endpoint Management Web 控制台中，单击右上角的齿轮图标。此时将显示“设置”页面。
  2. 在“平台”下，单击“Android Enterprise”。此时将显示“Android Enterprise”配置页面。
Android Enterprise 配置页面
  1. 在“Android Enterprise”页面上，配置以下设置：
    • 域名： 键入您的域名。
    • 域管理员帐户： 键入您的域管理员用户名。
    • 服务帐户 ID： 键入您的 Google 服务帐户 ID。
    • 客户端 ID： 键入您的 Google 服务帐户的客户端 ID。
    • 启用 Android Enterprise： 选择是否启用 Android Enterprise。
  2. 点击 保存。

为 Citrix Endpoint Management 设置 Google Workspace 合作伙伴访问权限

Citrix Endpoint Management 的某些 Chrome 功能使用 Google 合作伙伴 API 在 Citrix Endpoint Management 和您的 Google Workspace 域之间进行通信。例如，Citrix Endpoint Management 需要用于设备策略的 API，这些策略管理 Chrome 功能，例如无痕模式和访客模式。
要启用合作伙伴 API，您需要在 Citrix Endpoint Management 控制台中设置您的 Google Workspace 域，然后配置您的 Google Workspace 帐户。

在 Citrix Endpoint Management 中设置您的 Google Workspace 域

要使 Citrix Endpoint Management 能够与您的 Google Workspace 域中的 API 通信，请转到 设置 > Google Chrome 配置 并配置相关设置。
  • Google Workspace 域： 托管 Citrix Endpoint Management 所需 API 的 Google Workspace 域。
  • Google Workspace 管理员帐户： 您的 Google Workspace 域的管理员帐户。
  • Google Workspace 客户端 ID： Citrix 的客户端 ID。使用此值配置您的 Google Workspace 域的合作伙伴访问权限。
  • Google Workspace 企业 ID： 您的帐户的企业 ID，从您的 Google 企业帐户中填写。

为您的 Google Workspace 域中的设备和用户启用合作伙伴访问权限

  1. 登录 Google 管理控制台：<https://admin.google.com>
  2. 单击 设备管理。
    Google 管理员控制台
  3. 单击 Chrome 管理。
    Google 管理员控制台
  4. 单击 用户设置。
    Google 管理员控制台
  5. 搜索 Chrome 管理 - 合作伙伴访问。
    Google 管理员控制台(/en-us/citrix-endpoint-management/media/google-admin-partner-access4.png)
  6. 选择 启用 Chrome 管理 - 合作伙伴访问 复选框。
  7. 同意您理解并希望启用合作伙伴访问。单击保存。
  8. 在 Chrome 管理页面中，单击设备设置。
    Google 管理员控制台(/en-us/citrix-endpoint-management/media/google-admin-partner-access5.png)
  9. 搜索 Chrome 管理 - 合作伙伴访问。
    Google 管理员控制台(/en-us/citrix-endpoint-management/media/google-admin-partner-access6.png)
  10. 选择 启用 Chrome 管理 - 合作伙伴访问 复选框。
  11. 同意您理解并希望启用合作伙伴访问。单击保存。
  12. 转到安全性页面，然后单击高级设置。
    Google 管理员控制台(/en-us/citrix-endpoint-management/media/google-admin-partner-access7.png)
  13. 单击管理 API 客户端访问。
  14. 在 Citrix Endpoint Management 控制台中，转到设置 > Google Chrome 配置并复制 G Suite 客户端 ID 的值。然后，返回到管理 API 客户端访问页面并将复制的值粘贴到客户端名称字段中。
  15. 在一个或多个 API 范围中，添加 URL: https://www.googleapis.com/auth/chromedevicemanagementapi
    Google 管理员控制台
  16. 单击 Authorize。
    出现消息“您的设置已保存”。

注册 Android Enterprise 设备

如果您的设备注册过程要求用户输入用户名或用户 ID，则接受的格式取决于 Citrix Endpoint Management 服务器配置为按用户主体名称 (UPN) 或 SAM 帐户名搜索用户的方式。
如果 Citrix Endpoint Management 服务器配置为按 UPN 搜索用户，则用户必须按以下格式输入 UPN：
  • 用户名@域名
如果 Citrix Endpoint Management 服务器配置为按 SAM 搜索用户，则用户必须按以下格式之一输入 SAM：
  • 用户名@域名
  • domain\username
要确定您的 Citrix Endpoint Management 服务器配置为哪种类型的用户名，请执行以下操作：
  1. 在 Citrix Endpoint Management 服务器控制台中，单击右上角的齿轮图标。此时将显示“设置”页面。
  2. 单击 LDAP 以查看 LDAP 连接的配置。
  3. 在页面底部，查看“用户搜索依据”字段：
    • 如果设置为 userPrincipalName，则 Citrix Endpoint Management 服务器已设置为 UPN。
    • 如果设置为 sAMAccountName，则 Citrix Endpoint Management 服务器将设置为 SAM。

取消注册 Android Enterprise 企业

您可以使用 Citrix Endpoint Management 服务器控制台和 Citrix Endpoint Management Tools 取消注册 Android Enterprise 企业。
执行此任务时，Citrix Endpoint Management 服务器会为 Citrix Endpoint Management Tools 打开一个弹出窗口。开始之前，请确保 Citrix Endpoint Management 服务器有权在您使用的浏览器中打开弹出窗口。某些浏览器（例如 Google Chrome）要求您禁用弹出窗口阻止功能，并将 Citrix Endpoint Management 站点的地址添加到弹出窗口允许列表中。
警告：
企业取消注册后，通过该企业注册的设备上的 Android Enterprise 应用程序将重置为默认状态。这些设备不再由 Google 管理。在 Android Enterprise 企业中重新注册它们可能无法在没有进一步配置的情况下恢复以前的功能。
Android Enterprise 企业取消注册后：
  • 通过该企业注册的设备和用户，其 Android Enterprise 应用程序将重置为默认状态。以前应用的应用程序权限和托管配置策略不再生效。
  • 通过该企业注册的设备由 Citrix Endpoint Management 管理，但从 Google 的角度来看是未受管理的。无法添加新的 Android Enterprise 应用程序。无法应用应用程序权限或托管配置策略。其他策略（例如计划、密码和限制）仍可应用于这些设备。
  • 如果您尝试在 Android Enterprise 中注册设备，它们将注册为 Android 设备，而不是 Android Enterprise 设备。
要取消注册 Android Enterprise 企业：
  1. 在 Citrix Endpoint Management 控制台中，单击右上角的齿轮图标。“设置”页面随即显示。
  2. 在“设置”页面上，单击 Android Enterprise。
  3. 单击 删除企业。
  4. 指定密码。下一步完成取消注册时需要此密码。然后单击 Unenroll。
    注销选项
  5. Citrix Endpoint Management Tools 页面打开后，输入您在上一步中创建的密码。
    密码字段
  6. 单击 注销。
    注销选项

在 Android Enterprise 中预配完全托管设备

只有公司拥有的设备才能成为 Android Enterprise 中的完全托管设备。在完全托管设备上，整个设备（而不仅仅是工作配置文件）由公司或组织控制。完全托管设备也称为工作托管设备。
Citrix Endpoint Management 支持以下用于完全托管设备的注册方法：
  • afw#xenmobile: 使用此注册方法，用户在设置设备时输入字符 afw#xenmobile。此令牌将设备标识为由 Citrix Endpoint Management 管理，并下载 Citrix Secure Hub。
  • QR code: QR 码预配是一种简单的方法，可用于预配不支持 NFC 的分布式设备群（例如平板电脑）。QR 码注册方法可用于已恢复出厂设置的设备群。QR 码注册方法通过从设置向导扫描 QR 码来设置和配置完全托管设备。
  • Near field communication (NFC) bump: NFC 碰撞注册方法可用于已恢复出厂设置的设备群。NFC 碰撞通过近场通信在两台设备之间传输数据。在恢复出厂设置的设备上，蓝牙、Wi-Fi 和其他通信模式均已禁用。NFC 是设备在此状态下可以使用的唯一通信协议。

afw#xenmobile

此注册方法用于在新设备或恢复出厂设置的设备开机后进行初始设置。当系统提示用户输入 Google 帐户时，用户输入 afw#xenmobile。此操作将下载并安装 Citrix Secure Hub。然后，用户按照 Citrix Secure Hub 设置提示完成注册。
此注册方法推荐给大多数客户，因为最新版本的 Citrix Secure Hub 是从 Google Play 商店下载的。与其他注册方法不同，您无需提供 Citrix Secure Hub 以便从 Citrix Endpoint Management 服务器下载。
先决条件：
  • 支持所有运行 Android 操作系统的 Android 设备。

QR 码

要使用二维码在设备模式下注册设备，您需要通过创建 JSON 并将其转换为二维码来生成二维码。设备摄像头扫描二维码以注册设备。
先决条件：
  • 支持所有运行 Android 7.0 及更高版本的 Android 设备。

从 JSON 创建二维码

使用以下字段创建 JSON。
以下字段是必需的：
键：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_LOCALE： 输入语言和国家/地区代码。
    语言代码是 ISO 639-1 定义的两位小写 ISO 语言代码（例如 en）。国家/地区代码是 ISO 3166-1 定义的两位大写 ISO 国家/地区代码（例如 US）。例如，输入 en_US 表示在美国使用的英语。
  • android.app.extra.PROVISIONING_TIME_ZONE： 设备运行所在的时区。
    键入 区域/位置的数据库名称。例如，键入 America/Los_Angeles 表示太平洋时间。如果您不键入名称，时区将自动填充。
  • android.app.extra.PROVISIONING_LOCAL_TIME: 自纪元以来的毫秒数。
    Unix 纪元（或 Unix 时间、POSIX 时间或 Unix 时间戳）是自 January 1, 1970（UTC/GMT 午夜）以来经过的秒数。该时间不包括闰秒（在 ISO 8601 中：1970-01-01T00:00:00Z）。
  • android.app.extra.PROVISIONING_SKIP_ENCRYPTION: 设置为 true 可在配置文件创建期间跳过加密。设置为 false 可在配置文件创建期间强制加密。
典型的 JSON 如下所示：
典型的 JSON
使用任何 JSON 验证工具（例如 https://jsonlint.com）验证创建的 JSON。使用任何在线 QR 码生成器将该 JSON 字符串转换为 QR 码。
此 QR 码由恢复出厂设置的设备扫描，以将设备注册为完全托管设备。

注册设备

要将设备注册为完全托管设备，设备必须处于恢复出厂设置状态。
  1. 在欢迎屏幕上轻按六次以启动 QR 码注册流程。
  2. 出现提示时，连接到 Wi-Fi。QR 码中（在 JSON 中编码）Citrix Secure Hub 的下载位置可通过此 Wi-Fi 网络访问。
    设备成功连接到 Wi-Fi 后，它会从 Google 下载一个 QR 码阅读器并启动相机。
  3. 将相机对准 QR 码以扫描该码。
    Android 从 QR 码中的下载位置下载 Citrix Secure Hub，验证签名证书签名，安装 Citrix Secure Hub，并将其设置为设备所有者。
有关使用 QR 码方法预配设备的更多信息，请参阅 适用于 Android EMM 开发人员的 Google API 文档。

NFC 碰触

使用 NFC 碰触将设备注册为完全托管设备需要两台设备：一台已恢复出厂设置的设备，以及一台运行 Citrix Endpoint Management 预配工具的设备。
先决条件：
  • 支持的 Android 设备
  • 已启用 Android Enterprise 的 Citrix 端点管理
  • 一台新设备或已恢复出厂设置的设备，已为 Android Enterprise 预配为完全托管设备。您可以在本文后面找到完成此先决条件的步骤。
  • 另一台具有 NFC 功能的设备，运行已配置的预配工具。预配工具可在 Citrix Secure Hub 中或 Citrix 下载页面 上获取。
每台设备只能有一个由企业移动性管理 (EMM) 应用程序管理的 Android Enterprise 配置文件。在 Citrix Endpoint Management 中，Citrix Secure Hub 是 EMM 应用程序。每台设备只允许一个配置文件。尝试添加第二个 EMM 应用程序会删除第一个 EMM 应用程序。

通过 NFC 碰触传输的数据

预配已恢复出厂设置的设备需要您通过 NFC 碰触发送以下数据以初始化 Android Enterprise：
  • 作为设备所有者的 EMM 提供程序应用程序的包名称（在本例中为 Citrix Secure Hub）。
  • 设备可从中下载 EMM 提供程序应用程序的内网/互联网位置。
  • EMM 提供程序应用程序的 SHA-256 哈希值，以验证下载是否成功。
  • Wi-Fi 连接详细信息，以便已恢复出厂设置的设备可以连接并下载 EMM 提供程序应用程序。注意：Android 现在不支持此步骤的 802.1x Wi-Fi。
  • 设备的时区（可选）。
  • 设备的地理位置（可选）。
当两台设备碰撞时，预配工具中的数据将发送到恢复出厂设置的设备。然后，该数据用于下载具有管理员设置的 Citrix Secure Hub。如果您不输入时区和位置值，Android 会自动在新设备上配置这些值。

配置 Citrix Endpoint Management 预配工具

在进行 NFC 碰撞之前，您必须配置预配工具。此配置随后会在 NFC 碰撞期间传输到恢复出厂设置的设备。
预配工具配置
您可以将数据键入必填字段，也可以通过文本文件填充这些字段。以下过程中的步骤介绍了如何配置文本文件以及每个字段的说明。应用程序在您键入信息后不会保存信息，因此您可能需要创建一个文本文件来保留信息以备将来使用。
要使用文本文件配置预配工具
将文件命名为 nfcprovisioning.txt，并将文件放置在设备 SD 卡上的 /sdcard/ 文件夹中。然后，应用程序可以读取文本文件并填充值。
文本文件必须包含以下数据：
android.app.extra.PROVISIONING_DEVICE_ADMIN_PACKAGE_DOWNLOAD_LOCATION=<download_location>
此行是 EMM 提供商应用程序的内网/互联网位置。恢复出厂设置的设备在 NFC 碰撞后连接到 Wi-Fi 后，必须能够访问此位置以下载。URL 是常规 URL，无需特殊格式。
android.app.extra.PROVISIONING_DEVICE_ADMIN_PACKAGE_CHECKSUM=<SHA-256 hash>
此行是 EMM 提供商应用程序的校验和。此校验和用于验证下载是否成功。获取校验和的步骤将在本文稍后讨论。
android.app.extra.PROVISIONING_WIFI_SSID=<wifi ssid>
此行是运行预配工具的设备上已连接的 Wi-Fi SSID。
android.app.extra.PROVISIONING_WIFI_SECURITY_TYPE=<wifi security type>
支持的值为 WEP 和 WPA2。如果 Wi-Fi 未受保护，则此字段必须为空。
android.app.extra.PROVISIONING_WIFI_PASSWORD=<wifi password>
如果 Wi-Fi 未受保护，则此字段必须为空。
android.app.extra.PROVISIONING_LOCALE=<locale>
输入语言和国家/地区代码。语言代码是 ISO 639-1 定义的两位小写 ISO 语言代码（例如 en）。国家/地区代码是 ISO 3166-1 定义的两位大写 ISO 国家/地区代码（例如 US）。例如，输入 en_US 表示在美国使用的英语。如果您不输入任何代码，国家/地区和语言将自动填充。
android.app.extra.PROVISIONING_TIME_ZONE=<timezone>
设备运行所在的时区。键入区域/位置的数据库名称。例如，输入 America/Los_Angeles 表示太平洋时间。如果您不键入名称，时区将自动填充。
android.app.extra.PROVISIONING_DEVICE_ADMIN_PACKAGE_NAME=<package name>
此数据不是必需的，因为该值已作为 Citrix Secure Hub 硬编码到应用程序中。此处提及仅为完整性考虑。
如果存在使用 WPA2 保护的 Wi-Fi，则已完成的 nfcprovisioning.txt 文件可能如下所示：
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
如果存在未受保护的 Wi-Fi，则已完成的 nfcprovisioning.txt 文件可能如下所示：
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

获取 Citrix Secure Hub 的校验和

Citrix Secure Hub 的校验和是一个常量值：qn7oZUtheu3JBAinzZRrrjCQv6LOO6Ll1OjcxT3-yKM。要下载 Citrix Secure Hub 的 APK 文件，请使用以下 Google Play 商店链接：https://play.google.com/managed/downloadManagingApp?identifier=xenmobile。

获取应用程序校验和

先决条件：
  • 来自 Android SDK Build Tools 的 apksigner 工具
  • OpenSSL 命令行
要获取任何应用程序的校验和，请按照以下步骤操作：
  1. 从 Google Play 商店下载应用程序的 APK 文件。
  2. 在 OpenSSL 命令行中，导航到 apksigner 工具：android-sdk/build-tools/<version>/apksigner 并键入以下内容：
    apksigner verify -print-certs <apk_path> | perl -nle 'print $& if m{(?<=SHA-256 digest:) .*}'  | xxd -r -p | openssl base64 | tr -d '=' | tr -- '+/=' '-_'
    该命令返回有效的校验和。
  3. 要生成 QR 码，请在 PROVISIONING_DEVICE_ADMIN_SIGNATURE_CHECKSUM 字段中输入校验和。例如：
{
  "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"
   }
}

使用的库

预配工具在其源代码中使用了以下库：
  • v7 appcompat 库、设计支持库和 v7 调色板支持库
    有关信息，请在 Android 开发者文档 中查找“支持库功能指南”。
  • Jake Wharton 的 Butter Knife，根据 Apache 2.0 许可证发布

在 Android Enterprise 中配置工作配置文件设备

在 Android Enterprise 的工作配置文件设备上，您可以安全地将设备上的公司区域和个人区域分开。例如，BYOD 设备可以是工作配置文件设备。工作配置文件设备的注册体验与 Citrix Endpoint Management 中的 Android 注册类似。用户从 Google Play 下载 Citrix Secure Hub 并注册其设备。
默认情况下，当设备作为工作配置文件设备注册到 Android Enterprise 时，设备上的 USB 调试和未知来源设置处于禁用状态。
提示：
将设备作为工作配置文件设备注册到 Android Enterprise 时，请务必前往 Google Play。在那里，启用 Citrix Secure Hub 以显示在用户的个人配置文件中。