产品文档
XenMobile® Server
查看 PDF

Firebase Cloud Messaging

April 16, 2026
投稿者: 
C

注意：

Firebase Cloud Messaging (FCM) 以前称为 Google Cloud Messaging (GCM)。某些 XenMobile® 控制台标签和消息使用 GCM 术语。

Citrix® 建议您使用 Firebase Cloud Messaging (FCM) 来控制 Android 设备连接到 XenMobile 的方式和时间。XenMobile 在配置为使用 FCM 时，会向已启用 FCM 的 Android 设备发送连接通知。任何安全操作或部署命令都会触发推送通知，以提示用户重新连接到 XenMobile Server。

完成本文中的配置步骤并且设备签入后，设备将在 XenMobile Server 中注册 FCM 服务。该连接通过使用 FCM 实现了从 XenMobile Service 到设备的近实时通信。FCM 注册适用于新设备注册和以前注册的设备。

当 XenMobile 需要启动与设备的连接时，它会连接到 FCM 服务。然后，FCM 服务会通知设备进行连接。这种连接类型类似于 Apple 用于其推送通知服务的方式。

先决条件

  • 最新 Secure Hub 客户端
  • Google 开发者帐户凭据
  • 已在启用 FCM 的 Android 设备上安装 Google Play 服务

防火墙端口

  • 在 XenMobile 上打开端口 443 以连接到 fcm.googleapis.com 和 Google.com。
  • 为设备 Wi-Fi 打开端口 5228、5229 和 5230 上的出站 Internet 通信。
  • 为了允许出站连接，FCM 建议允许端口 5228 到 5230，不带任何 IP 限制。但是，如果需要 IP 限制，FCM 建议允许 IPv4 和 IPv6 块中的所有 IP 地址。这些块列在 Google ASN 15169 中。每月更新该列表。有关 FCM 端口的更多信息，请参阅 Google 文档中的 FCM 端口。

有关详细信息，请参阅端口要求。

体系结构

此图显示了 FCM 在外部和内部网络中的通信流。

FCM 体系结构

为 FCM 配置您的 Google 帐户

  1. 使用您的 Google 开发者帐户凭据登录以下 URL：

    https://console.firebase.google.com/

  2. 单击添加项目。

    创建项目选项

  3. 创建项目后，单击项目设置。

    项目设置选项

    注意：

    Google 将弃用当前在我们的 FCM 实施中使用的 HTTP 版 FCM 旧版 API。迁移截止日期为 2024 年 6 月 21 日。我们需要将 FCM 从旧版 FCM API 迁移到 HTTP v1 API。有关详细信息，请参阅从旧版 FCM API 迁移到 HTTP v1。

  4. 单击云消息传递选项卡。验证是否已启用 Firebase Cloud Messaging API，然后单击管理服务帐户。

    1. 迁移之前，您可以使用旧版 API，确保已启用 Cloud Messaging API (旧版)。从密钥和发送方 ID 字段复制值。

      启用 Cloud Messaging API

      如果未列出密钥，请单击操作下的省略号以添加密钥。

      操作

    2. 迁移后，Google 将弃用旧版 API。您必须启用 Firebase Cloud Messaging API (V1)。有关详细信息，请参阅从旧版 FCM API 迁移到 HTTP v1。

      启用 FCI

      从项目设置下的服务帐户下载服务帐户 JSON 文件。请参阅手动提供凭据部分，为您的服务帐户生成私钥文件。单击生成新私钥以下载服务帐户密钥 JSON 文件。

      项目设置

有关在 Android 上设置 FCM 客户端应用程序的步骤，请参阅此 Google Developers Cloud Messaging 文章：https://firebase.google.com/docs/cloud-messaging/android/client。

为 FCM 配置 XenMobile

在 XenMobile 控制台中，转至设置 > Firebase Cloud Messaging。

对于 Cloud Messaging API (旧版)

  1. 在 API 密钥字段中输入 Firebase Cloud Messaging 配置的最后一步中的 Firebase Cloud Messaging 密钥。

  2. 输入上一个过程中的发送方 ID 值。

发送方 ID 值条目

对于 Firebase Cloud Messaging API (V1)

注意：

  • 要为 XenMobile Server 10.15 滚动修补程序 7 及更高版本启用 FCM API V1，请参阅知识中心文章 CTX677031。
  • 如果您是新的 FCM 用户，请跳过步骤 1 并从步骤 2 开始。

  1. 如果您已在使用 FCM，您会注意到发送方 ID 会自动填充您当前的 FCM 项目，并且会出现一个新选项用于上传服务帐户密钥文件。

    现有用户的 FCM

  2. 如果您是新的 FCM 用户，请输入发送方 ID 并上传上一个过程中的服务帐户密钥文件。

    新 FCM 用户

  3. 上传的文件将被解析，并且相应的字段将自动生成。

    已解析的服务帐户

  4. 验证信息并单击保存。

测试您的配置

  1. 注册 Android 设备。

  2. 让设备闲置一段时间，使其与 XenMobile 断开连接。

  3. 登录 XenMobile 控制台，单击管理，选择 Android 设备，然后单击保护。

    保护 Android 设备选项

  4. 在设备操作下，单击选择性擦除。

    选择性擦除选项

如果配置成功，设备上将执行选择性擦除。

Firebase Cloud Messaging
April 16, 2026
投稿者: 
C
April 16, 2026
投稿者: 
C

在本文中

站点反馈 | Your privacy choices footer link您的隐私选择 | 隐私和法律条款 | Cookie 首选项 | 同意设置 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.