> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Connexion iOS p8 basée sur un jeton vers APNs
> Configurez une clé d'authentification .p8 pour connecter votre application iOS ou macOS au service de notification push Apple (APNs) via OneSignal.
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)](./ios-p12-generate-certificates)** — 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 :
* Une application mobile iOS.
* Un [**compte Apple Developer payant**](https://developer.apple.com/) avec un accès [**Administrateur**](https://appstoreconnect.apple.com/access/users).
* Un [**compte OneSignal**](https://onesignal.com).
* Un Mac avec Xcode 14+.
* Un projet Xcode avec **la capacité de notification push activée**.
***
## 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](https://developer.apple.com/help/account/keys/create-a-private-key/).
1. Connectez-vous à votre [compte Apple Developer](https://developer.apple.com/).
2. Accédez à **Certificates, Identifiers & Profiles > [Keys](https://developer.apple.com/account/resources/authkeys)**.
3. Cliquez sur l'icône **bleue plus (+)**.
* Si vous ne la voyez pas, contactez votre administrateur pour obtenir l'accès.
4. Sélectionnez **Apple Push Notifications service (APNs)**.
5. Lors de la configuration de la clé, assurez-vous que **Sandbox & Production** est sélectionné :
6. Entrez un nom pour la clé et cliquez sur **Continue**, puis sur **Register**.
7. **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.
2. Choisissez **.p8 Auth Key (Recommended)** comme méthode d'authentification.
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](https://developer.apple.com/account/resources/authkeys) 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](https://developer.apple.com/account/). 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](https://developer.apple.com/account/resources/identifiers/list) 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.
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
* Ouvrez le fichier `.p8` dans un éditeur de texte.
* Il devrait ressembler à ceci :
```text theme={null}
-----BEGIN PRIVATE KEY-----
64 character line
64 character line
64 character line
8 character line
-----END PRIVATE KEY-----
```
* 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.
* Accédez à la [section Keys de votre compte Apple Developer](https://developer.apple.com/account/resources/authkeys).
* 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.
* 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](https://developer.apple.com/account/).
* 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.
* 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.
* 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
Installez le SDK OneSignal, initialisez-le dans votre application et envoyez une notification de test.
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](./ios-p12-generate-certificates) 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.
Sinon, consultez [la documentation Apple sur les profils de provisionnement](https://developer.apple.com/help/account/provisioning-profiles/provisioning-profile-updates) pour plus de détails.
***