> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configurer Apple OAuth

> Configurez Connexion avec Apple pour l'authentification de votre application

Ce guide vous explique comment créer l'App ID Apple, le Services ID et la clé privée requis pour Connexion avec Apple. Vous collecterez un **Team ID**, un **Services ID**, un **Key ID** et une **clé privée** à saisir dans le **volet Auth**.

<Note>
  Cette page couvre uniquement la configuration côté fournisseur dans le portail développeur Apple. Pour le flux global de Clerk Auth — y compris l'activation d'Apple et la saisie des identifiants dans le **volet Auth** — consultez [Configurer les identifiants OAuth pour un fournisseur SSO](/references/auth-and-identity/clerk-auth#configuring-oauth-credentials-for-an-sso-provider) dans la documentation Clerk Auth.
</Note>

## Prérequis

* Un [compte développeur Apple](https://developer.apple.com/account) (nécessite une inscription au Programme développeur Apple)
* Une [application Replit publiée](/learn/projects-and-artifacts/replit-deployments) — les identifiants OAuth personnalisés sont uniquement disponibles dans l'environnement **Production**
* Le panneau de modification du fournisseur **Apple** ouvert dans : **volet Auth** → onglet **Configurer** → section **Fournisseurs SSO** → sélectionnez l'environnement **Production** → sélectionnez **Modifier** à côté de **Apple**

## Étape 1 : Créer un App ID Apple

1. Accédez au [portail développeur Apple](https://developer.apple.com/account)
2. Allez dans **Certificats, ID et profils** puis **Identifiants**
3. Sélectionnez **App IDs** dans le menu déroulant
4. Sélectionnez l'icône **+** pour enregistrer un nouvel identifiant
5. Sélectionnez **App IDs**, puis **Continuer**
6. Choisissez **App**, puis **Continuer**
7. Renseignez :
   * **Description** : Nom pour votre App ID
   * **Bundle ID** : Votre identifiant unique
8. Activez **Connexion avec Apple** sous Fonctionnalités
9. Sélectionnez **Continuer**, puis **S'inscrire**
10. **Enregistrez votre préfixe d'App ID** (affiché en haut) — c'est votre **Team ID**

## Étape 2 : Créer un Services ID Apple

1. Sur la page des identifiants, sélectionnez **Services IDs** dans le menu déroulant
2. Sélectionnez **+** pour enregistrer un nouvel identifiant
3. Sélectionnez **Services IDs**, puis **Continuer**
4. Renseignez :
   * **Description** : Nom pour votre Services ID
   * **Identifiant** : Votre identifiant unique (enregistrez-le — c'est votre **Services ID**)
5. Sélectionnez **Continuer**, puis **S'inscrire**

### Configurer le Services ID

1. Sélectionnez votre Services ID nouvellement créé
2. Activez **Connexion avec Apple**
3. Sélectionnez **Configurer**
4. Définissez :

   * **App ID principal** : Sélectionnez votre App ID de l'étape 1
   * **Domaines et sous-domaines** : Copiez la valeur affichée sous **Configuration du fournisseur** dans le **volet Auth** (sans le préfixe de protocole `https://`)
   * **URL de retour** : Copiez la valeur affichée sous **Configuration du fournisseur** dans le **volet Auth**

   Consultez [Configurer les identifiants OAuth pour un fournisseur SSO](/references/auth-and-identity/clerk-auth#configuring-oauth-credentials-for-an-sso-provider) pour savoir comment trouver ces valeurs.
5. Sélectionnez **Suivant**, puis **Terminer**, puis **Continuer**, puis **Enregistrer**

## Étape 3 : Créer une clé privée Apple

1. Dans la barre latérale du portail développeur Apple, sélectionnez **Clés**
2. Sélectionnez **+** pour enregistrer une nouvelle clé
3. Saisissez un **Nom de clé**
4. Activez **Connexion avec Apple**
5. Sélectionnez **Configurer**, puis sélectionnez votre App ID de l'étape 1
6. Sélectionnez **Enregistrer**, puis **Continuer**, puis **S'inscrire**
7. **Enregistrez le Key ID**
8. **Téléchargez** le fichier de clé privée (.p8)

<Warning>
  Vous ne pouvez télécharger la clé privée qu'une seule fois. Stockez-la en lieu sûr — vous ne pouvez pas la télécharger à nouveau.
</Warning>

## Étape 4 : Configurer le relais d'e-mail privé Apple

La fonctionnalité Masquer mon e-mail d'Apple permet aux utilisateurs de se connecter sans révéler leur véritable adresse e-mail. Pour envoyer des e-mails à ces utilisateurs, enregistrez votre source d'e-mail.

1. Dans la barre latérale du portail développeur Apple, sélectionnez **Services**
2. Sous **Connexion avec Apple pour les communications par e-mail**, sélectionnez **Configurer**
3. Sélectionnez **+** pour ajouter une source d'e-mail
4. Saisissez la valeur de source d'e-mail affichée sous **Configuration du fournisseur** dans le **volet Auth**
5. Sélectionnez **Suivant**, puis **S'inscrire**, puis **Terminer**
6. Attendez la vérification DNS (icône de coche verte)

<Info>
  Dans certaines régions (Chine, Inde), les identifiants Apple peuvent être liés à des numéros de téléphone plutôt qu'à des adresses e-mail. Si votre application exige une adresse e-mail pour tous les utilisateurs, Connexion avec Apple peut échouer pour les utilisateurs dans ces régions.
</Info>

## Dépannage

### Client invalide

* Vérifiez que tous les identifiants sont saisis correctement
* Assurez-vous que la clé privée inclut les lignes BEGIN et END
* Vérifiez que votre Services ID est correctement configuré

### URI de redirection invalide

* Vérifiez que l'URL de retour dans la configuration du Services ID Apple correspond exactement à la valeur affichée sous **Configuration du fournisseur** dans le **volet Auth**
* Vérifiez que le domaine dans Domaines et sous-domaines correspond à votre domaine publié (sans `https://`)

### Le relais d'e-mail ne fonctionne pas

* Vérifiez que la source d'e-mail affiche une coche verte dans le portail développeur Apple
* Attendez la propagation DNS si elle a été récemment ajoutée

### Ne fonctionne pas sur un domaine personnalisé

* Ajoutez les entrées de domaine personnalisé affichées sous **Configuration du fournisseur** dans le **volet Auth** dans Domaines et sous-domaines (sans `https://`) et dans les URL de retour

## Ressources supplémentaires

* [Documentation Apple Connexion avec Apple](https://developer.apple.com/sign-in-with-apple/)
* [Guide du service de relais d'e-mail privé](https://developer.apple.com/help/account/configure-app-capabilities/configure-private-email-relay-service)