Passer au contenu principal
Pour envoyer des notifications push aux applications iOS, une connexion authentifiée aux services de notification push Apple (APNs) est requise. Vous pouvez vous authentifier en utilisant une méthode basée sur un jeton (clé .p8) ou basée sur un certificat (fichier .p12) — mais une seule est nécessaire. Ce guide vous guidera à travers la configuration d’une clé .p8 basée sur un jeton, l’approche recommandée.

​
Exigences

Assurez-vous d’avoir ce qui suit avant de commencer :

​
Configurer l’authentification APNs

​
Générer votre clé .p8 dans votre compte Apple Developer

Pour les instructions complètes d’Apple, consultez Créer une clé privée pour accéder à un service.
  1. Connectez-vous à votre compte Apple Developer.
  2. Accédez à Certificates, Identifiers & Profiles > Keys.
  3. Cliquez sur l’icône bleue plus (+).
    • Si vous ne la voyez pas, contactez votre administrateur pour obtenir l’accès.
Page Keys de l'Apple Developer affichant l'icône bleue plus pour créer une nouvelle clé
  1. Sélectionnez Apple Push Notifications service (APNs).
  2. Lors de la configuration de la clé, assurez-vous que Sandbox & Production est sélectionné :
Configuration de la clé Apple Developer avec Sandbox et Production sélectionnés
  1. Entrez un nom pour la clé et cliquez sur Continue, puis sur Register.
Page d'enregistrement de la clé Apple Developer avec les boutons Continue et Register
  1. Téléchargez votre clé .p8 et conservez-la en lieu sûr. Vous ne pourrez pas la télécharger à nouveau.
Si vous devez créer une nouvelle clé .p8 et que vous en avez déjà deux, vous devez d’abord révoquer l’une des clés existantes — et elle ne sera plus utilisable.

​
Importer la clé .p8 dans OneSignal

  1. Accédez à Settings > Push & In-App > Apple iOS (APNs) Settings dans votre tableau de bord OneSignal.
Page Paramètres de OneSignal affichant la section Push et In-App avec les paramètres Apple iOS APNs
  1. Choisissez .p8 Auth Key (Recommended) comme méthode d’authentification.
Sélection de la méthode d'authentification APNs de OneSignal affichant l'option recommandée p8 Auth Key
Fournissez les informations suivantes :
  • .p8 File – Le fichier de clé privée que vous avez téléchargé depuis votre compte Apple Developer.
  • Key ID – Une chaîne alphanumérique de 10 caractères (par ex., ABC123DEFG) affichée à côté du nom de votre clé dans la section Keys de votre compte Apple Developer. Assurez-vous qu’elle correspond au fichier .p8 téléchargé.
  • Team ID – Une chaîne alphanumérique de 10 caractères (par ex., 9A1B2C3D4E) affichée à côté du nom de votre équipe dans le coin supérieur droit de votre compte Apple Developer. Il ne s’agit pas du même identifiant que le Key ID.
  • App Bundle ID – Une chaîne en domaine inversé (par ex., com.example.app) que vous pouvez trouver :
    • Dans la section Identifiers de votre compte Apple Developer, ou
    • Dans Xcode > Main App Target > Signing & Capabilities
Le Key ID et le Team ID sont tous deux des chaînes de 10 caractères présentes dans votre compte Apple Developer, mais à des emplacements différents. Vérifiez que vous ne les avez pas confondus — il s’agit de l’erreur de configuration la plus fréquente.
Compte Apple Developer affichant les emplacements du Key ID et du Team ID
Onglet Signing and Capabilities de Xcode affichant le champ Bundle Identifier
Cliquez sur Save & Continue lorsque vous avez terminé.
Vous avez correctement configuré l’authentification APNs à l’aide d’une clé .p8 dans OneSignal.Votre application iOS est maintenant prête à envoyer et recevoir des notifications push ! 🎉

​
Dépannage .p8

1

Vérifier le format du fichier .p8

  • Ouvrez le fichier .p8 dans un éditeur de texte.
  • Il devrait ressembler à ceci : 
    -----BEGIN PRIVATE KEY-----
64 character line
64 character line
64 character line
8 character line
-----END PRIVATE KEY-----
2

Vérifier que vous n'avez pas importé un fichier .p12 par erreur

  • Les clés .p8 proviennent de la section Keys de votre compte Apple Developer.
  • Les certificats .p12 proviennent de la section Certificates. Ils ne sont pas compatibles avec l’authentification .p8.
3

Confirmer que vous avez le bon Key ID

  • Accédez à la section Keys de votre compte Apple Developer.
  • Le Key ID est la chaîne de 10 caractères affichée à côté du nom de votre clé (par ex., ABC123DEFG).
  • Faites correspondre le Key ID que vous avez saisi dans OneSignal avec celui associé à la clé .p8 téléchargée.
  • Ne confondez pas avec votre Team ID — les deux sont des chaînes de 10 caractères, mais se trouvent à des endroits différents.
4

Vérifier le Team ID

  • Votre Team ID est la chaîne de 10 caractères affichée à côté du nom de votre équipe dans le coin supérieur droit de votre compte Apple Developer.
  • Assurez-vous qu’il est copié exactement et correspond au compte sous lequel la clé a été générée.
  • Ne confondez pas avec votre Key ID — le Team ID identifie votre compte développeur, pas une clé spécifique.
5

Vérifier que la clé a la capacité APNs

  • Lorsque vous consultez votre clé dans Apple Developer, la capacité Apple Push Notifications service (APNs) doit être répertoriée.
  • Si ce n’est pas le cas, révoquez la clé et créez-en une nouvelle.
6

Attendre quelques minutes

  • Les clés nouvellement créées peuvent prendre 10 à 15 minutes à se propager avant qu’Apple autorise l’authentification externe.
  • Si vous obtenez des erreurs de validation immédiatement après la création, attendez et réessayez.

​
Besoin d’aide ?

  • Révoquez la clé .p8 actuelle et créez-en une nouvelle depuis le début.
  • Vérifiez que vous utilisez un Bundle ID valide du même compte sous lequel la clé a été créée.
  • Contactez support@onesignal.com en joignant une capture d’écran de la configuration de votre clé Apple Developer ainsi que le Key ID, le Team ID et le Bundle ID.

​
Prochaines étapes

Configuration du SDK iOS

Installez le SDK OneSignal, initialisez-le dans votre application et envoyez une notification de test.

Configuration du SDK mobile

Choisissez votre plateforme et suivez le guide complet d’intégration du SDK pour Android, iOS ou les frameworks multiplateformes.

​
FAQ

​
Quelle est la différence entre .p8 et .p12 ?

Une clé .p8 est une clé d’authentification basée sur un jeton qui n’expire pas et fonctionne pour toutes les applications sous votre compte Apple Developer. Un certificat .p12 est spécifique à une application et expire après un an, nécessitant un renouvellement annuel. OneSignal recommande le .p8 pour sa simplicité et sa faible maintenance. Consultez le guide du certificat .p12 pour la méthode alternative.

​
Ma clé .p8 expire-t-elle ?

Non. Contrairement aux certificats .p12, les clés .p8 n’expirent pas. Une fois créée, une clé .p8 reste valide jusqu’à ce que vous la révoquiez dans votre compte Apple Developer.

​
Puis-je utiliser une seule clé .p8 pour plusieurs applications ?

Oui. Une seule clé .p8 fonctionne pour toutes les applications sous le même compte Apple Developer. Vous pouvez importer le même fichier .p8 dans plusieurs applications OneSignal — chaque application n’a besoin que de son propre Bundle ID unique.

​
Ai-je besoin d’un profil de provisionnement et comment en créer un ?

Oui, Apple exige différents types de profils pour le développement, les tests (Ad Hoc) et la distribution sur l’App Store. Dans Xcode, sélectionnez Automatically manage signing pour en créer un automatiquement.
Onglet Signing and Capabilities de Xcode avec la gestion automatique des signatures activée
Sinon, consultez la documentation Apple sur les profils de provisionnement pour plus de détails.