As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Integração do Amazon SNS à configuração de autenticação do Firebase Cloud Messaging
<a name="sns-fcm-authentication-methods"></a>

Este tópico descreve como obter as credenciais necessárias da API do FCM (HTTP v1) do Google para usar com a AWS API e a. AWS CLI Console de gerenciamento da AWS

**Importante**  
26 de março de 2024: o Amazon SNS oferece suporte à API HTTP v1 do FCM para dispositivos Apple e destinos Webpush. Recomendamos que você migre suas aplicações móveis por push existentes para a API mais recente do FCM HTTP v1 até 1º de junho de 2024 para evitar interrupções nas aplicações.  
18 de janeiro de 2024: o Amazon SNS introduziu o suporte à API HTTP v1 do FCM para entrega de notificações push móveis para dispositivos Android.  
20 de junho de 2023: Google descontinuou a API HTTP legada do Firebase Cloud Messaging (FCM). O Amazon SNS agora oferece suporte à entrega para todos os tipos de dispositivos usando a API HTTP v1 do FCM. Recomendamos que você migre suas aplicações móveis por push existentes para a API mais recente do FCM HTTP v1 até 1º de junho de 2024 para evitar interrupções nas aplicações.

É possível autorizar o Amazon SNS a enviar notificações por push para suas aplicações fornecendo informações que identifiquem você como desenvolvedor da aplicação. Para autenticar, forneça uma **chave de API** ou um **token** [ao criar uma aplicação de plataforma](https://docs.aws.amazon.com/sns/latest/api/API_SetPlatformApplicationAttributes.html). É possível consultar as informações a seguir no [console da aplicação do Firebase](https://firebase.google.com/?gad=1&gclid=CjwKCAiA0syqBhBxEiwAeNx9N27M7zxHjlS74_gp4mAS4QTMQH5J35sTO29od-yauuq259zzX_I2DRoCrbsQAvD_BwE&gclsrc=aw.ds):

**Chave de API**  
A chave de API é uma credencial usada ao chamar a API legada do Firebase. O FCM Legacy APIs será removido pelo Google em 20 de junho de 2024. Se você estiver usando uma chave de API como credencial da plataforma, atualize a credencial da plataforma selecionando **Token** como opção e fazendo upload do arquivo JSON associado à aplicação Firebase.

**Token**  
Um token de acesso de curta duração é usado ao chamar a API HTTP v1. Essa é a API sugerida pelo Firebase para enviar notificações por push. Para gerar tokens de acesso, o Firebase fornece aos desenvolvedores um conjunto de credenciais na forma de um arquivo de chave privada (também conhecido como arquivo service.json).

## Pré-requisito
<a name="sns-fcm-authentication-prerequisite"></a>

Você deve obter as credenciais service.json do FCM antes de começar a gerenciar as configurações do FCM no Amazon SNS. Para obter suas credenciais service.json, consulte [Migrar do FCM legado APIs para o HTTP v1 na documentação do](https://firebase.google.com/docs/cloud-messaging/migrate-v1) Google Firebase.

## Gerenciar configurações do FCM usando o CLI
<a name="sns-fcm-authentication-api"></a>

Você pode criar notificações push do FCM usando a AWS API. O número e o tamanho dos recursos do Amazon SNS em uma AWS conta são limitados. Para obter mais informações, consulte [Endpoints e cotas do Amazon Simple Notification Service](https://docs.aws.amazon.com/general/latest/gr/sns.html) no *Guia do Referência geral da AWS *.

**Para criar uma notificação push do FCM junto com um tópico AWS (API) do Amazon SNS**  
Ao usar as credenciais de **chave**, `PlatformCredential` é `API key`. Ao usar credenciais de **token**, `PlatformCredential` é um arquivo de chave privada formatado em JSON:
+ [https://docs.aws.amazon.com/sns/latest/api/API_CreatePlatformApplication.html](https://docs.aws.amazon.com/sns/latest/api/API_CreatePlatformApplication.html)

**Para recuperar um tipo de credencial do FCM para um tópico existente do Amazon SNS (API)AWS**  
Recupera o tipo de credencial `"AuthenticationMethod": "Token"` ou ` "AuthenticationMethod": "Key"`:
+ [GetPlatformApplicationAttributes](https://docs.aws.amazon.com/sns/latest/api/API_GetPlatformApplicationAttributes.html)

**Para definir um atributo do FCM para um tópico AWS existente do Amazon SNS (API)**  
Define o atributo do FCM:
+ [SetPlatformApplicationAttributes](https://docs.aws.amazon.com/sns/latest/api/API_SetPlatformApplicationAttributes.html)

## Gerenciar configurações do FCM usando o console
<a name="sns-fcm-authentication-cli"></a>

Você pode criar notificações push do FCM usando a AWS Command Line Interface (CLI). O número e o tamanho dos recursos do Amazon SNS em uma AWS conta são limitados. Para obter mais informações, consulte [Amazon Simple Notification Service endpoints and quotas](https://docs.aws.amazon.com/general/latest/gr/sns.html) (Endpoints e cotas do Amazon Simple Notification Service). 

**Como criar uma notificação por push do FCM junto com um tópico do Amazon SNS (AWS CLI)**  
Ao usar as credenciais de **chave**, `PlatformCredential` é `API key`. Ao usar credenciais de **token**, `PlatformCredential` é um arquivo de chave privada formatado em JSON: Ao usar a AWS CLI, o arquivo deve estar no formato de string e os caracteres especiais devem ser ignorados. Para formatar o arquivo corretamente, o Amazon SNS recomenda usar o seguinte comando: `SERVICE_JSON=`jq @json <<< cat service.json``:
+ [create-platform-application](https://docs.aws.amazon.com/cli/latest/reference/sns/create-platform-application.html)

**Como recuperar um tipo de credencial do FCM para um tópico existente do Amazon SNS (AWS CLI)**  
Recupera o tipo de credencial `"AuthenticationMethod": "Token"` ou ` "AuthenticationMethod": "Key"`:
+ [get-platform-application-attributes](https://docs.aws.amazon.com/cli/latest/reference/sns/get-platform-application-attributes.html)

**Como definir um atributo do FCM para um tópico existente do Amazon SNS (AWS CLI)**  
Define o atributo do FCM:
+ [set-platform-application-attributes](https://docs.aws.amazon.com/cli/latest/reference/sns/set-platform-application-attributes.html)

## Gerenciar configurações do FCM (console)
<a name="sns-fcm-authentication-console"></a>

Use as etapas a seguir para inserir e gerenciar suas credenciais do Firebase Cloud Messaging (FCM) no Amazon SNS.

1. Faça login no console [do Amazon SNS](https://console.aws.amazon.com/sns/home).

1. No painel de navegação, selecione **Notificações por push**.

1. Na seção **Aplicações de plataforma**, selecione a **aplicação de plataforma FCM** cujas credenciais deseja editar e escolha **Editar**.

1. Na seção **Credenciais do Firebase Cloud Messaging**, escolha uma das seguintes opções:
   + **Autenticação baseada em token** (método recomendado): faça o upload do **arquivo de chave privada** (JSON) que você baixou do console do Firebase. Esse arquivo contém as credenciais necessárias para gerar tokens de acesso de curta duração para notificações do FCM. Para obter esse arquivo:

     1. Acesse o [console da aplicação Firebase](https://firebase.google.com/?gad=1&gclid=CjwKCAiA0syqBhBxEiwAeNx9N27M7zxHjlS74_gp4mAS4QTMQH5J35sTO29od-yauuq259zzX_I2DRoCrbsQAvD_BwE&gclsrc=aw.ds).

     1. Nas **Configurações do projeto**, selecione **Cloud Messaging**.

     1. Baixe o arquivo JSON da **chave privada** (para uso no método de autenticação baseado em token).
   + **Autenticação de chave de API**: se preferir usar o método de autenticação de chave de API mais antigo, insira a **chave de API do Google** no campo fornecido. Para obter esse arquivo:

     1. Acesse o [console da aplicação Firebase](https://firebase.google.com/?gad=1&gclid=CjwKCAiA0syqBhBxEiwAeNx9N27M7zxHjlS74_gp4mAS4QTMQH5J35sTO29od-yauuq259zzX_I2DRoCrbsQAvD_BwE&gclsrc=aw.ds).

     1. Em **Configurações do projeto**, selecione **Cloud Messaging**.

     1. Copie a **chave do servidor** (chave de API) a ser usada para enviar notificações.

1. Quando terminar, escolha **Salvar alterações**.

**Tópicos relacionados**
+ [Usar cargas úteis do Google Firebase Cloud Messaging v1 no Amazon SNS](sns-fcm-v1-payloads.md)