Metodi di autenticazione di Firebase Cloud Messaging (FCM)

Questo argomento descrive come ottenere le credenziali API FCM (HTTP v1) richieste da Google da utilizzare con l' AWS API e il. AWS CLI AWS Management Console

Importante

20 giugno 2023 — Google ha reso obsoleta la propria API HTTP legacy di Firebase Cloud Messaging (FCM). Amazon SNS ora supporta la distribuzione a tutti i tipi di dispositivi utilizzando l'API HTTP v1 di FCM. Ti consigliamo di migrare le tue applicazioni push mobili esistenti all'ultima API HTTP v1 di FCM entro il 1° giugno 2024 per evitare interruzioni.

18 gennaio 2024 — Amazon SNS ha introdotto il supporto per l'API HTTP v1 di FCM per la consegna di notifiche push mobili ai dispositivi Android.

26 marzo 2024 — Amazon SNS supporta l'API HTTP v1 FCM per dispositivi Apple e destinazioni Webpush. Ti consigliamo di migrare le tue applicazioni push mobili esistenti all'ultima API HTTP v1 di FCM entro il 1° giugno 2024 per evitare interruzioni delle applicazioni.

Puoi autorizzare Amazon SNS a inviare notifiche push alle applicazioni fornendo informazioni che ti identificano come sviluppatore dell'app. Per l'autenticazione, fornisci una chiave API o un token durante la creazione di un'applicazione di piattaforma. Puoi ottenere le seguenti informazioni dalla console dell'applicazione Firebase:

Chiave API

La chiave API rappresenta le credenziali utilizzate per chiamare l'API Legacy di Firebase. Le API FCM legacy verranno rimosse da Google il 20 giugno 2024. Se attualmente utilizzi una chiave API come credenziali della piattaforma, puoi aggiornare le credenziali della piattaforma selezionando Token come opzione e caricando il file JSON associato all'applicazione Firebase.

Token

Quando si chiama l'API HTTP v1, viene utilizzato un token di accesso di breve durata. Questa è l'API consigliata da Firebase per l'invio di notifiche push. Per generare token di accesso, Firebase fornisce agli sviluppatori un set di credenziali sotto forma di file di chiave privata (noto anche come file service.json).

Prerequisito

Prima di poter iniziare a gestire le impostazioni FCM in Amazon SNS, devi ottenere le credenziali FCM service.json. Per ottenere le credenziali service.json, consulta Migrazione dalle API FCM legacy a HTTP v1 nella documentazione di Google Firebase.

Gestione delle impostazioni FCM (API)

Puoi creare notifiche push FCM utilizzando l'API. AWS Il numero e le dimensioni delle risorse Amazon SNS in un AWS account sono limitati. Per ulteriori informazioni, consulta gli endpoint e le quote di Amazon Simple Notification Service nella Riferimenti generali di AWS Guida.

Per creare una notifica push FCM insieme a un argomento AWS (API) di Amazon SNS

Quando utilizzi le credenziali chiave, PlatformCredential è API key. Quando utilizzi le credenziali token, PlatformCredential è un file di chiavi private in formato JSON:

• CreatePlatformApplication

Per recuperare un tipo di credenziale FCM per un argomento (API) di Amazon SNS esistente AWS

Recupera il tipo di credenziali, "AuthenticationMethod": "Token" o "AuthenticationMethod": "Key":

• GetPlatformApplicationAttributes

Configurazione di un attributo FCM per un argomento Amazon SNS esistente (API AWS )

Configura l'attributo FCM:

• SetPlatformApplicationAttributes

Gestione elle impostazioni FCM (CLI)

È possibile creare notifiche push FCM utilizzando AWS Command Line Interface (CLI). Il numero e le dimensioni delle risorse Amazon SNS in un AWS account sono limitati. Per ulteriori informazioni, consulta Endpoint e quote di Amazon Simple Notification Service.

Creazione di una notifica push FCM insieme a un argomento SNS (AWS CLI)

Quando utilizzi le credenziali chiave, PlatformCredential è API key. Quando utilizzi le credenziali token, PlatformCredential è un file di chiavi private in formato JSON. Quando si utilizza la AWS CLI, il file deve essere in formato stringa e i caratteri speciali devono essere ignorati. Per formattare correttamente il file, Amazon SNS consiglia di utilizzare il seguente comando: SERVICE_JSON=`jq @json <<< cat service.json`

• create-platform-application

Recupero di un tipo di credenziali FCM per un argomento Amazon SNS esistente (AWS CLI)

Recupera il tipo di credenziali, "AuthenticationMethod": "Token" o "AuthenticationMethod": "Key":

• get-platform-application-attributes

Configurazione di un attributo FCM per un argomento Amazon SNS esistente (AWS CLI)

Configura l'attributo FCM:

• set-platform-application-attributes

Gestione delle impostazioni FCM (console)

Utilizza la procedura seguente per inserire le credenziali utilizzate dall'applicazione per connettersi a FCM.

1. Accedi alla console Amazon SNS.

2. In Mobile, scegli Push notification (Notifiche push).

3. Seleziona un'applicazione FCM esistente e scegli Modifica. Se non hai già creato un'applicazione di piattaforma, consulta Creazione di un'applicazione di piattaforma.

4. Nella pagina Modifica, per Credenziali Firebase Cloud Messaging, scegli Token o Chiave. Puoi ottenere le seguenti informazioni dalla console dell'applicazione Firebase.

   • Se scegli Token, carica un file della chiave privata valido. Il contenuto di questo file viene utilizzato per generare token di accesso di breve durata durante l'invio di notifiche.

   • Se scegli Chiave, inserisci la chiave API di Google.

5. Al termine, scegliere Save changes (Salva modifiche).

Argomenti correlati

• Utilizzo dei payload Google Firebase Cloud Messaging (FCM) v1 in Amazon SNS