Configurez les identifiants du compte de service Firebase Cloud Messaging (FCM) dans OneSignal pour activer les notifications push Android pour les applications du Google Play Store.
Pour envoyer des notifications push aux utilisateurs qui téléchargent votre application Android depuis le Google Play Store, vous devez créer et téléverser une clé privée de compte de service Firebase Cloud Messaging (FCM) vers OneSignal.
Ces instructions ne s’appliquent pas à :
Web Push. Les appareils Android peuvent s’abonner à votre site web ou PWA sans compte de service FCM. Voir Configuration du push web.
Applications Huawei distribuées via la Huawei App Gallery. Voir Autorisation Huawei.
Créer une clé privée de compte de service Firebase \
1
Créer ou ouvrir votre projet Firebase
Accédez à votre console Firebase et créez ou sélectionnez un projet.
Page des projets dans Firebase
2
Activer l'API Firebase Cloud Messaging V1
Dans Project settings, sélectionnez l’onglet Cloud Messaging.
Onglet Cloud Messaging dans les paramètres du projet Firebase
Vérifiez le statut de l’API Firebase Cloud Messaging (V1) :
S’il affiche Enabled (coche verte), passez à l’étape suivante.
S’il affiche Disabled, cliquez sur le menu à 3 points > Manage API in Google Cloud Console. Dans la Google Cloud Console, cliquez sur Enable et attendez que la coche verte apparaisse avec « API Enabled ».
API Firebase Cloud Messaging activée dans la Google Cloud Console
C’est un bon moment pour vérifier si votre compte de service Firebase possède les autorisations requises :
cloudmessaging.messages.create
firebase.projects.get
Les projets Firebase nouvellement créés ont généralement ces autorisations sur le compte de service par défaut. Vérifiez avant de continuer si vous n’êtes pas sûr ou si vous travaillez avec un projet plus ancien. Consultez Comment vérifier les autorisations de mon compte de service ? pour plus de détails.
3
Générer une nouvelle clé privée
De retour dans Project settings, sélectionnez l’onglet Service accounts et cliquez sur Generate new private key.
Section des comptes de service dans Firebase
Confirmez en cliquant sur Generate key dans la fenêtre contextuelle.
Générer la clé privée pour le compte de service.
La clé privée téléchargée contient des identifiants sensibles. Ne la partagez pas et ne la versionnez pas.
Enregistrez le fichier .json dans un emplacement sécurisé. Vous en aurez besoin dans la section suivante.
Téléverser la clé privée du compte de service vers OneSignal
Dans votre tableau de bord OneSignal :
1
Ouvrir les paramètres Android
Accédez à Settings > Push & In-App > Platforms > Google Android (FCM).Cliquez sur Activate (configuration initiale) ou Settings (si Android est déjà configuré).
Écran des plateformes dans les paramètres de l'application OneSignal
2
Téléverser votre clé privée de compte de service
Cliquez sur Select file et choisissez la clé privée .json que vous avez enregistrée dans la section précédente.
Écran de configuration FCM
3
Enregistrer et continuer
Cliquez sur Save & Continue. OneSignal valide la clé privée et vous fait passer à l’étape suivante du flux de configuration, où vous sélectionnez votre SDK.
Votre application OneSignal est désormais connectée à Firebase Cloud Messaging (V1). Ensuite, suivez la Configuration du SDK mobile pour le SDK que vous utilisez afin d’installer et d’initialiser OneSignal dans votre application.
Comment vérifier les autorisations de mon compte de service ? \
Les autorisations du compte de service sont gérées dans la Google Cloud Console, pas dans la console Firebase. Le compte de service dont vous téléversez la clé privée vers OneSignal doit posséder les deux :
cloudmessaging.messages.create — accordé par Firebase Cloud Messaging API Admin (roles/firebasecloudmessaging.admin).
firebase.projects.get — accordé par Firebase Viewer (roles/firebase.viewer).
Des rôles plus larges comme Firebase Admin (roles/firebase.admin), Editor ou Owner incluent également les deux autorisations et remplissent l’exigence. Pour les comptes de service dédiés uniquement à OneSignal, préférez la paire restreinte ci-dessus pour limiter l’impact si la clé privée venait à être exposée.Si le tableau de bord OneSignal affiche Invalid request après le téléversement de votre clé privée de compte de service, les rôles manquants en sont la cause la plus courante.
1
Ouvrir IAM dans la Google Cloud Console
Connectez-vous à Google Cloud Console, sélectionnez le projet lié à votre application Firebase et accédez à IAM & Admin > IAM.
2
Trouver votre compte de service
Faites correspondre l’e-mail du principal au champ client_email de votre clé privée téléversée.
3
Ajouter les rôles manquants
Cliquez sur l’icône en forme de crayon (modifier), puis sur Add another role pour ajouter l’un des rôles s’il n’est pas déjà attribué.
4
Enregistrer
Cliquez sur Save. Les modifications IAM peuvent prendre une minute pour être appliquées.
Pourquoi est-ce que je vois « This configuration is for a different Firebase Project » ?
Cette erreur se produit lorsque la clé privée téléversée appartient à un projet Firebase différent (un Sender ID différent).Solution : Utilisez la clé privée du projet Firebase d’origine. Si elle n’est pas disponible, contactez support@onesignal.com avec votre App ID. Changer de projet réinitialise les jetons push. Vos utilisateurs doivent rouvrir l’application pour recevoir à nouveau des notifications push.
Oui, mais cela aura un impact sur vos utilisateurs existants.Les jetons d’appareil sont liés au Sender ID d’origine. Le changer invalidera les jetons existants.
Les utilisateurs cesseront de recevoir des notifications push jusqu’à ce qu’ils rouvrent l’application et génèrent de nouveaux jetons.
Si vous avez besoin d’aide, contactez support@onesignal.com avec votre App ID.
Pourquoi ne vois-je pas de Sender ID dans OneSignal ?
Si votre clé de serveur Firebase ressemble à AIz..., vous utilisez probablement une configuration Google Cloud Messaging (GCM) obsolète. Créez un nouveau projet Firebase et téléversez une clé privée de compte de service.
Les API FCM héritées de Google sont désormais entièrement obsolètes. Si vous utilisez toujours les API héritées, vous devez migrer vers FCM V1 immédiatement.
Comment puis-je vérifier quelles applications utilisent encore l’API héritée ?
Appelez l’API View an app pour chaque application et vérifiez le champ fcm_v1_service_account_json dans la réponse :
Présent et non vide : l’application utilise FCM V1.
Manquant ou vide : l’application n’est pas configurée pour FCM V1. Si l’application envoie du push Android, elle utilise toujours l’API héritée et doit être migrée.
Pour lister d’abord vos applications et leurs App IDs, utilisez l’API View apps.
Qu’est-ce que Firebase Cloud Messaging et pourquoi OneSignal a-t-il besoin d’une clé privée de compte de service ? \
Firebase Cloud Messaging (FCM) est le service de Google pour la livraison de notifications push aux appareils Android. Un compte de service est une identité Google que OneSignal utilise pour s’authentifier auprès de votre projet Firebase, et sa clé privée est un fichier JSON qui prouve cette identité. Téléverser la clé privée autorise OneSignal à envoyer des notifications push via Firebase en votre nom. Pour plus de détails, consultez la documentation du compte de service de Google.
