Passer au contenu principal
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.
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 dans la documentation Clerk Auth.

​
Prérequis

  • Un compte développeur Apple (nécessite une inscription au Programme développeur Apple)
  • Une application Replit publiée — 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
  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 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)
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.

​
É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)
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.

​
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