Firebase Cloud Messaging(FCM)身份验证方法 - Amazon Simple Notification Service
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

Firebase Cloud Messaging(FCM)身份验证方法

本主题介绍如何从 Google 获取用于该 API 所需的 FCM API (HTTP v1) 凭据, Amazon CLI 以及。 Amazon Amazon Web Services Management Console

重要

2023 年 6 月 20 日 — 谷歌弃用了 Firebase 云消息传递 (FCM) 的旧版 HTTP API。亚马逊 SNS 现在支持使用 FCM HTTP v1 API 向所有设备类型配送。我们建议您在 2024 年 6 月 1 日当天或之前将现有的移动推送应用程序迁移到最新的 FCM HTTP v1 API,以避免中断。

2024 年 1 月 18 日 — 亚马逊 SNS 推出了对 FCM HTTP v1 API 的支持,用于向安卓设备发送移动推送通知。

2024 年 3 月 26 日 — 亚马逊 SNS 支持适用于苹果设备和 Webpush 目的地的 FCM HTTP v1 API。我们建议您在 2024 年 6 月 1 日当天或之前将现有的移动推送应用程序迁移到最新的 FCM HTTP v1 API,以避免应用程序中断。

您可以通过提供将您识别为应用程序开发人员的信息,授权 Amazon SNS 将推送通知发送到您的应用程序。要进行身份验证,请在创建平台应用程序时提供 API 密钥令牌。您可以从 Firebase 应用程序控制台获取以下信息:

API 密钥

API 密钥是调用 Firebase 的旧版 API 时使用的凭证。Google 将于 2024 年 6 月 20 日移除 FCM 旧版 API。如果您当前使用 API 密钥作为平台凭证,则可以通过选择令牌作为选项并上传您的 Firebase 应用程序的关联 JSON 文件来更新平台凭证。

令牌

在调用 HTTP v1 API 时,会使用短暂的访问令牌。这是 Firebase 的建议用于发送推送通知的 API。为了生成访问令牌,Firebase 以私有密钥文件(也称为 service.json 文件)的形式为开发人员提供了一组凭证。

先决条件

您必须先获取 FCM service.json 凭证,然后才能开始在 Amazon SNS 中管理 FCM 设置。要获取您的 service.json 凭证,请参阅 Google Firebase 文档中的从旧版 FCM API 迁移到 HTTP v1

管理 FCM 设置(API)

您可以使用 Amazon API 创建 FCM 推送通知。一个 Amazon 账户中 Amazon SNS 资源的数量和大小是有限的。有关更多信息,请参阅Amazon Web Services 一般参考 指南中的 Amazon 简单通知服务终端节点和配额

创建 FCM 推送通知以及亚马逊 SNS 主题Amazon (API)

使用密钥凭证时,PlatformCredentialAPI key。使用令牌凭证时,PlatformCredential 为一个采用 JSON 格式的私有密钥文件:

检索现有亚马逊 SNS 主题 (API) 的 FCM 凭证类型Amazon

检索凭证类型 "AuthenticationMethod": "Token" "AuthenticationMethod": "Key"

为现有 Amazon SNS 主题设置 FCM 属性(Amazon API)

设置 FCM 属性:

管理 FCM 设置(CLI)

您可以使用 Amazon Command Line Interface (CLI) 创建 FCM 推送通知。一个 Amazon 账户中 Amazon SNS 资源的数量和大小是有限的。有关更多信息,请参阅 Amazon Simple Notification Service 端点和配额

与 Amazon SNS 主题一起创建 FCM 推送通知(Amazon CLI)

使用密钥凭证时,PlatformCredentialAPI key。使用令牌凭证时,PlatformCredential 为一个采用 JSON 格式的私有密钥文件。使用 Amazon CLI 时,文件必须为字符串格式,并且必须忽略特殊字符。为了正确格式化文件,Amazon SNS 建议使用以下命令:SERVICE_JSON=`jq @json <<< cat service.json`

检索现有 Amazon SNS 主题的 FCM 凭证类型(Amazon CLI)

检索凭证类型 "AuthenticationMethod": "Token" "AuthenticationMethod": "Key"

为现有 Amazon SNS 主题设置 FCM 属性(Amazon CLI)

设置 FCM 属性:

管理 FCM 设置(控制台)

使用以下步骤输入您的应用程序用于连接 FCM 的凭证。

  1. 登录 Amazon SNS 控制台

  2. Mobile(移动)下,选择 Push notifications(推送通知)。

  3. 选择现有 FCM 应用程序,然后选择编辑。如果您尚未创建平台应用程序,请参阅创建平台应用程序

  4. 编辑页面上,对于 Firebase Cloud Messaging 凭证,选择令牌密钥。您可以从 Firebase 应用程序控制台获取以下信息。

    • 如果您选择令牌,请上传有效的私有密钥文件。此文件的内容用于在发送通知时生成有效期很短的访问令牌。

    • 如果您选择密钥,请输入 Google API 密钥。

  5. 完成后,选择 Save changes (保存更改)

相关主题