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

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

Amazon SNS 与 Firebase Cloud Messaging 身份验证设置集成

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

重要

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

2024 年 1 月 18 日 – Amazon SNS 推出了对 FCM HTTP v1 API 的支持,用于向 Android 设备发送移动推送通知。

2023 年 6 月 20 日 - Google 弃用了其 Firebase Cloud Messaging(FCM)旧版 HTTP API。Amazon SNS 现在支持使用 FCM HTTP v1 API 向所有设备类型传送。我们建议您在 2024 年 6 月 1 日或之前将现有的移动推送应用程序迁移到最新的 FCM HTTP v1 API,以避免中断。

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

API 密钥

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

令牌

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

先决条件

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

使用 CLI 管理 FCM 设置

您可以使用 Amazon API 创建 FCM 推送通知。一个 Amazon 账户中 Amazon SNS 资源的数量和大小是有限的。有关更多信息,请参阅《Amazon Web Services 一般参考 Guide》中的 Amazon Simple Notification Service endpoints and quotas

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

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

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

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

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

设置 FCM 属性:

使用控制台管理 FCM 设置

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

与 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 设置(控制台)

使用以下步骤在亚马逊 SNS 中输入和管理您的 Firebase 云消息 (FCM) 凭证。

  1. 登录 Amazon SNS 控制台

  2. 在导航窗格中,选择推送通知

  3. 平台应用程序部分,选择要编辑其凭据的 FCM 平台应用程序,然后选择编辑

  4. Firebase 云端消息传递凭据部分,选择以下选项之一:

    • 基于令牌的身份验证(推荐方法)-上传您从 Firebase 控制台下载的私钥文件 (JSON)。此文件包含为 FCM 通知生成短期访问令牌所需的凭据。要获取此文件,请执行以下操作:

      1. 前往您的 Firebase 应用程序控制台

      2. “项目设置” 中,选择 “云消息”。

      3. 下载私钥 JSON 文件(用于基于令牌的身份验证方法)。

    • API 密钥身份验证 — 如果您更喜欢使用较旧的 API 密钥身份验证方法,请在提供的字段中输入 Google API 密钥。要获取此文件,请执行以下操作:

      1. 前往您的 Firebase 应用程序控制台

      2. “项目设置” 中,选择 “云消息”。

      3. 复制用于发送通知的服务器密钥(API 密钥)。

  5. 完成后,选择保存更改

相关主题