Retour au blog

Fonctionnement des notifications push : APNs et FCM expliqués

Fonctionnement des notifications push : APNs et FCM expliqués

Une notification push paraît simple de l’extérieur : quelque chose se produit sur un serveur, et une seconde plus tard, un téléphone s’allume. Entre les deux, il y a deux réseaux de diffusion exploités par Apple et Google, et aucune notification n’atteint un téléphone sans passer par l’un d’eux.

  • APNs, le service de notifications push d’Apple, diffuse chaque notification push vers iPhone, iPad, Mac et Apple Watch.
  • FCM, Firebase Cloud Messaging, diffuse vers les appareils Android équipés des services Google Play, et peut aussi envoyer vers iOS en transmettant les messages à APNs.

Ce guide suit une notification, de votre serveur jusqu’à l’écran verrouillé, sur les deux plateformes, avec les détails qui n’apparaissent qu’en production. Nous faisons tourner les deux circuits derrière Pocket Alert, donc les exemples viennent de ce que nous déployons réellement.

Les quatre acteurs

  1. Votre serveur, que Apple appelle le fournisseur. Il décide qu’une notification doit être envoyée.
  2. Le service push, APNs ou FCM. Il accepte la requête et l’achemine.
  3. L’appareil. Le système d’exploitation maintient une connexion chiffrée et durable vers Apple ou Google, et reçoit les notifications de toutes les applications par ce canal.
  4. L’application. Elle s’est inscrite aux notifications et possède le jeton auquel la notification est adressée.

Le troisième point explique pourquoi le push consomme peu de batterie. Le téléphone n’interroge jamais votre serveur. Une seule connexion, partagée par toutes les applications, reste ouverte, et le service push y envoie une notification dès qu’il y en a une à livrer.

Étape 1 : l’appareil obtient un jeton

Lorsqu’une application s’inscrit aux notifications distantes, le système lui remet un jeton : une adresse opaque qui désigne « cette application sur cet appareil ». L’application envoie le jeton à votre serveur, qui le stocke.

  • Un jeton d’appareil APNs est propre à l’application et à l’appareil. Apple recommande de ne pas le mettre en cache dans l’application : il change lorsqu’un utilisateur restaure une sauvegarde, passe sur un nouvel appareil ou réinstalle le système.
  • Un jeton d’enregistrement FCM joue le même rôle sur Android, et FCM le renouvelle selon son propre calendrier.

Les jetons deviennent obsolètes en permanence. Garder vos jetons stockés à jour fait partie intégrante de l’exploitation des notifications push.

Étape 2 : votre serveur prouve son identité

APNs

APNs fonctionne en HTTP/2 sur TLS 1.2 ou supérieur, à l’adresse api.push.apple.com en production et api.sandbox.push.apple.com pour les builds de développement, sur le port 443 ou 2197. Il existe deux méthodes d’authentification :

  • Basée sur un jeton. Vous créez une clé de signature .p8 dans votre compte développeur Apple, et vous signez un JWT court avec ES256, contenant votre Team ID et l’identifiant de la clé. Apple demande de renouveler ce JWT au plus une fois toutes les 20 minutes et au moins une fois toutes les 60 minutes. Si vous envoyez un JWT trop ancien, vous obtenez 403 ExpiredProviderToken ; si vous le renouvelez trop souvent, vous obtenez 429 TooManyProviderTokenUpdates.
  • Basée sur un certificat. Un certificat client TLS par application, valable un an, qu’il faut ensuite renouveler.

L’authentification par jeton est celle à privilégier. Une seule clé couvre toutes vos applications et n’expire pas chaque année.

FCM

L’API HTTP v1 de FCM accepte un jeton d’accès OAuth 2.0 à courte durée de vie, obtenu depuis un compte de service Google, avec le périmètre firebase.messaging. L’ancienne API « legacy », qui utilisait une clé serveur statique, a été dépréciée en 2023 et arrêtée à partir de juillet 2024 : un code qui envoie encore Authorization: key=... ne fonctionne plus.

Étape 3 : la requête

Envoi vers APNs

Chaque notification est une requête HTTP/2 POST vers /3/device/<device token>, accompagnée de quelques en-têtes qui modifient son traitement :

curl --http2 \
  -H "authorization: bearer $APNS_JWT" \
  -H "apns-topic: com.example.alerts" \
  -H "apns-push-type: alert" \
  -H "apns-priority: 10" \
  -d '{"aps": {"alert": {"title": "Backup failed", "body": "db-01: pg_dump exited with code 1"}, "sound": "default", "interruption-level": "time-sensitive"}}' \
  "https://api.push.apple.com/3/device/$DEVICE_TOKEN"
  • apns-topic est l’identifiant de bundle de votre application.
  • apns-push-type indique le type de notification : alert pour une notification visible, background pour une notification silencieuse de données, et quelques autres.
  • apns-priority vaut 10 pour une livraison immédiate, 5 pour laisser l’état d’énergie de l’appareil décider, ou 1 pour privilégier l’économie d’énergie et ne pas réveiller l’appareil.
  • apns-expiration définit la durée pendant laquelle APNs doit continuer à essayer. 0 signifie une seule tentative, sans stockage.
  • apns-collapse-id permet à une notification plus récente de remplacer une notification plus ancienne portant le même identifiant.

La charge utile est un JSON avec un dictionnaire aps, et elle est limitée à 4 Ko (5 Ko pour VoIP).

Envoi vers FCM

FCM accepte un seul message JSON par requête :

curl -X POST "https://fcm.googleapis.com/v1/projects/$PROJECT_ID/messages:send" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "message": {
      "token": "DEVICE_REGISTRATION_TOKEN",
      "notification": { "title": "Backup failed", "body": "db-01: pg_dump exited with code 1" },
      "android": { "priority": "high", "notification": { "channel_id": "alerts_high" } }
    }
  }'

Un message notification est affiché par le système lorsque l’application est en arrière-plan. Un message data est transmis à l’application pour qu’elle le traite. Dans les deux cas, la limite de la charge utile est de 4 096 octets.

Étape 4 : la livraison, ou l’attente

Si le téléphone est en ligne, la notification emprunte la connexion ouverte et apparaît en quelques instants. Sinon :

  • APNs conserve la notification jusqu’à 30 jours, selon apns-expiration, mais ne garde qu’une seule notification par application et par appareil. Si vous en envoyez cinq pendant que le téléphone est en mode avion, il recevra en général la dernière. Apple ne garantit même pas qu’il s’agira de la plus récente.
  • FCM conserve les messages pendant leur durée de vie (time to live), quatre semaines par défaut et 28 jours au maximum. Les messages regroupables se remplacent mutuellement, avec jusqu’à quatre clés de regroupement par appareil.

La priorité influence aussi le timing. Sur iOS, les notifications de priorité 5 et 1 peuvent être regroupées, ralenties ou abandonnées. Sur Android, les messages de priorité normal peuvent attendre que l’appareil sorte du mode Doze, tandis que ceux de priorité high sont livrés immédiatement. FCM surveille aussi l’usage de ce privilège : les messages à priorité élevée qui ne donnent lieu à aucune notification visible peuvent être silencieusement rétrogradés en priorité normale au fil du temps.

Le niveau sonore : niveaux d’interruption et canaux

La livraison est une chose. Savoir si le téléphone émet un son en est une autre, et les deux plateformes la gèrent différemment.

iOS (15 et supérieur) attribue à chaque notification un niveau d’interruption :

  • passive l’ajoute à la liste sans allumer l’écran ni jouer de son.
  • active est la valeur par défaut.
  • time-sensitive peut percer la Concentration et le résumé des notifications. Les utilisateurs peuvent le désactiver application par application.
  • critical joue toujours un son, même en mode Ne pas déranger et avec le commutateur silencieux activé. Il nécessite un droit (entitlement) qu’Apple accorde sur demande, après examen.

Android (8 et supérieur) range chaque notification dans un canal, et c’est le canal qui détermine l’importance : son, vibration, affichage flottant (heads-up), comportement en mode Ne pas déranger. L’application crée les canaux, mais une fois qu’un canal existe, son comportement appartient à l’utilisateur. L’application ne peut pas le modifier ensuite.

Cette dernière règle a des conséquences concrètes. Lorsque nous avons voulu que les alertes critiques de Pocket Alert sonnent en mode silencieux, le canal critique existant ne pouvait pas être basculé après coup vers un son d’alarme. La solution a été un second canal, avec un nouvel identifiant, que le serveur ne sélectionne que pour les versions de l’application qui le créent, car envoyer vers un canal que l’application n’a jamais créé signifie que la notification n’est pas affichée du tout.

Sur Android 13 et supérieur, il existe une étape supplémentaire : l’application a besoin de la permission d’exécution POST_NOTIFICATIONS, et sur une installation fraîche, les notifications restent désactivées tant que l’utilisateur ne l’a pas accordée.

Ce qui casse en production

  • Jetons obsolètes. APNs répond 410 Unregistered pour un jeton qui n’est plus valide. Arrêtez de l’utiliser et supprimez-le.
  • Mauvais environnement. Le jeton d’un build de développement envoyé à l’hôte de production échoue avec 400 BadDeviceToken.
  • Charges utiles trop volumineuses. 413 PayloadTooLarge dès que vous dépassez 4 Ko. Les longues lignes de journal dans le corps d’une alerte en sont la cause habituelle.
  • Priorité rétrogradée. Les messages Android à priorité élevée qui n’affichent jamais rien perdent leur priorité.
  • Notifications désactivées. La notification est livrée, mais l’utilisateur ne la voit jamais, parce que la permission a été refusée ou que le canal est muet.

Le raccourci

Tout cela vaut la peine d’être construit lorsque l’application est votre produit et que vous envoyez des notifications à ses utilisateurs. Pour des alertes destinées à vous-même ou à votre équipe, c’est beaucoup d’infrastructure : un compte développeur sur chaque plateforme, des clés de signature, le stockage des jetons, deux formats de requête et deux modèles de priorité.

Un service de notifications push fait tourner les deux circuits à votre place. Avec Pocket Alert, vous envoyez une seule requête, sans jetons ni certificats à gérer :

curl -X POST https://api.pocketalert.app/v1/messages \
  -H "Token: $PA_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"title": "Backup failed", "message": "db-01: pg_dump exited with code 1", "level": "high"}'

Le champ level est traduit pour chaque plateforme :

  • silent correspond à une notification passive sans son sur iPhone, et part dans un canal silencieux sur Android.
  • low est passive sur iPhone et d’importance faible sur Android.
  • default est une notification normale sur les deux plateformes.
  • high est time-sensitive sur iPhone et de priorité élevée sur Android.
  • critical passe outre le mode Ne pas déranger sur Android. Sur iPhone, elle arrive en time-sensitive, et le son complet des alertes critiques se déploie au fur et à mesure qu’Apple accorde le droit.

Pour aller plus loin, consultez alertes critiques, et pour l’API elle-même, ce qu’est une API de notifications push.

FAQ

APNs garantit-il la livraison ?

Non. APNs et FCM fonctionnent tous deux au mieux (best-effort). APNs ne conserve que la dernière notification pour un appareil hors ligne, et aucun des deux services ne garantit le moment d’arrivée d’un message. La documentation de Google va plus loin et indique que FCM ne doit pas être utilisé pour des alertes d’urgence vitales. Pour la astreinte, considérez le push comme le canal le plus rapide, pas comme le seul.

Pourquoi ai-je besoin à la fois d’APNs et de FCM ?

Les iPhones n’acceptent les notifications push que via APNs. Les appareils Android équipés des services Google Play les reçoivent via FCM. Si vos utilisateurs sont sur les deux plateformes, votre serveur communique avec les deux, directement ou via FCM, qui peut transmettre à APNs à votre place.

FCM peut-il envoyer des notifications à un iPhone ?

Oui. Vous importez votre clé d’authentification APNs dans Firebase, et FCM livre vers iOS en transmettant le message à APNs. Les messages de données destinés aux appareils Apple doivent être envoyés en priorité normale.

Quelle est la taille maximale d’une notification push ?

4 Ko pour une charge utile APNs (5 Ko pour les notifications VoIP), et 4 096 octets pour un message FCM. Les textes longs doivent figurer dans votre application ou dans un lien, pas dans la notification push.

Qu’est-ce qu’un jeton d’appareil ?

Une adresse pour une application sur un appareil, délivrée par Apple ou Google. Votre serveur y envoie les notifications. Il peut changer à tout moment : les serveurs doivent donc accepter les jetons mis à jour et supprimer ceux que APNs ou FCM signalent comme invalides.

Créez un compte Pocket Alert gratuit pour vous passer des clés et des jetons, ou comparez d’autres services dans les alternatives.

Partager cet article