Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Méthodes d'authentification Firebase Cloud Messaging (FCM)
Cette rubrique explique comment obtenir les informations d'identification de l'API FCM (HTTP v1) requises auprès de Google pour les utiliser avec l' AWS API, AWS CLI et le AWS Management Console.
Rubriques
Important
20 juin 2023 — Google a déconseillé son ancienne API HTTP Firebase Cloud Messaging (FCM). Amazon SNS prend désormais en charge la livraison vers tous les types d'appareils à l'aide de l'API FCM HTTP v1. Nous vous recommandons de migrer vos applications push mobiles existantes vers la dernière API HTTP v1 de FCM au plus tard le 1er juin 2024 pour éviter toute interruption.
18 janvier 2024 — Amazon SNS a introduit la prise en charge de l'API FCM HTTP v1 pour l'envoi de notifications push mobiles aux appareils Android.
26 mars 2024 — Amazon SNS prend en charge l'API FCM HTTP v1 pour les appareils Apple et les destinations Webpush. Nous vous recommandons de migrer vos applications push mobiles existantes vers la dernière API HTTP v1 de FCM au plus tard le 1er juin 2024 afin d'éviter toute interruption des applications.
Vous pouvez autoriser Amazon SNS à envoyer des notifications push à vos applications en communiquant des informations qui vous identifient en tant que développeur de l’application. Pour vous authentifier, fournissez une clé d'API ou un jeton lors de la création d'une application de plateforme. Vous pouvez obtenir les informations suivantes depuis votre console d'application Firebase
- Clé d'API
-
La clé d'API est une information d'identification utilisée lors de l'appel de l'ancienne API de Firebase. Les anciennes API FCM seront supprimées par Google le 20 juin 2024. Si vous utilisez actuellement une clé d'API comme information d'dentification de plateforme, vous pouvez mettre à jour les informations d'identification de la plateforme en sélectionnant l'option Jeton et en téléchargeant le fichier JSON associé pour votre application Firebase.
- Jeton
-
Un jeton d'accès de courte durée est utilisé lors de l'appel de l'API HTTP v1. Il s'agit de l'API suggérée par Firebase pour envoyer des notifications push. Afin de générer des jetons d'accès, Firebase fournit aux développeurs un ensemble d'informations d'identification sous la forme d'un fichier de clé privée (également appelé fichier service.json).
Prérequis
Vous devez obtenir vos informations d'identification FCM service.json pour pouvoir gérer les paramètres FCM dans Amazon SNS. Pour obtenir vos informations d'identification service.json, consultez Migrate from legacy FCM APIs to HTTP v1
Gestion des paramètres FCM (API)
Vous pouvez créer des notifications push FCM à l'aide de l' AWS API. Le nombre et la taille des ressources Amazon SNS d'un AWS compte sont limités. Pour plus d'informations, consultez la section Points de terminaison et quotas Amazon Simple Notification Service dans le Références générales AWS Guide.
Pour créer une notification push FCM associée à une rubrique AWS Amazon SNS (API)
Lorsque vous utilisez des informations d'identification de type clé, les données PlatformCredential se présentent sous forme d'une API key. Lorsque vous utilisez des informations d'identification de type jeton, les données PlatformCredential se présentent sous forme d'un fichier de clé privée au format JSON :
Pour récupérer un type d'identifiant FCM pour une rubrique Amazon SNS (API) existante AWS
Récupère le type d'information d'identification "AuthenticationMethod": "Token" ou "AuthenticationMethod": "Key" :
Pour définir un attribut FCM pour une rubrique Amazon SNS existante (API AWS )
Définit l'attribut FCM :
Gestion des paramètres FCM (interface CLI)
Vous pouvez créer des notifications push FCM à l'aide de la AWS Command Line Interface (CLI). Le nombre et la taille des ressources Amazon SNS d'un AWS compte sont limités. Pour plus d'informations, consultez Points de terminaison et quotas Amazon Simple Notification Service.
Pour créer une notification push FCM avec une rubrique Amazon SNS (AWS CLI)
Lorsque vous utilisez des informations d'identification de type clé, les données PlatformCredential se présentent sous forme d'une API key. Lorsque vous utilisez des informations d'identification de type jeton, les données PlatformCredential se présentent sous forme d'un fichier de clé privée au format JSON. Lorsque vous utilisez la AWS CLI, le fichier doit être au format chaîne et les caractères spéciaux doivent être ignorés. Pour formater correctement le fichier, Amazon SNS recommande d'utiliser la commande suivante : SERVICE_JSON=`jq @json
<<< cat service.json`
Pour récupérer un type d'information d'identification FCM pour une rubrique Amazon SNS existante (AWS CLI)
Récupère le type d'information d'identification "AuthenticationMethod": "Token" ou "AuthenticationMethod": "Key" :
Pour définir un attribut FCM pour une rubrique Amazon SNS existante (AWS CLI)
Définit l'attribut FCM :
Gestion des paramètres FCM (console)
Suivez les étapes ci-dessous pour saisir les informations d'identification utilisées par votre application pour se connecter à FCM.
Connectez-vous à la console Amazon SNS
. -
Sous Mobile (Applications mobiles), choisissez Push notifications (Notifications push).
-
Sélectionnez une application FCM existante et choisissez Modifier. Si vous n'avez pas encore créé d'application de plateforme, consultez Création d'une application de plateforme.
-
Sur la page Modifier, pour Informations d'indentification Firebase Cloud Messaging, choisissez Jeton ou Clé. Vous pouvez obtenir les informations suivantes à partir de votre console d'application Firebase
. -
Si vous choisissez Jeton, téléchargez un fichier de clé privée valide. Le contenu de ce fichier est utilisé pour générer des jetons d'accès de courte durée lors de l'envoi de notifications.
-
Si vous choisissez Clé, entrez la clé d'API Google.
-
-
Lorsque vous avez terminé, choisissez Enregistrer les modifications.
Voir aussi
