Configuration de la connexion avec Apple

Configurez Connexion avec Apple et reliez-la à la connexion sociale The Wallet Crew.

Utilisez ceci lorsque vous souhaitez activer le Apple bouton dans un formulaire d’inscription.

Commencez par Connexion sociale pour comprendre le parcours utilisateur. Puis revenez ici pour la configuration du fournisseur.

Exemple de connexion avec Apple dans un formulaire d’inscription

Vue d’ensemble

Utilisez cette page pour configurer Connexion avec Apple (connexion avec Apple ID) pour L’équipe Wallet les formulaires d’inscription.

Vous configurerez Apple à deux endroits :

1. Apple Developer: App ID + Service ID + domaines + URL de retour.
2. l’administration de Wallet: collez votre Apple Service ID.

Terminologie (Apple)

Ces termes sont utilisés dans Apple Developer et dans les configurations OAuth.

• App ID: identifie votre application. Utilise un Bundle ID comme com.brand.app.
• Service ID: identifie une intégration de connexion web. C’est ce que vous collez dans l’administration de Wallet.
• Domaines et sous-domaines: où le formulaire d’inscription est hébergé.
• URL de retour: URL de rappel OAuth / OpenID Connect utilisées après la connexion Apple.

Prérequis

• Accès au compte de votre marque. Apple Developer compte.
• Autorisation de gérer les identifiants et les Service IDs.
• La liste des domaines sur lesquels vos formulaires d’inscription seront déployés (prod + staging + dev + personnalisés).

Remarques sur le comportement d’Apple

La connexion avec Apple présente quelques comportements qui ont un impact sur votre parcours d’inscription et vos règles de correspondance.

Lors de la première connexion avec un compte Apple donné, Apple peut fournir le prénom, le nom, et l’e-mail. Lors des connexions suivantes, Apple renvoie généralement uniquement l’e-mail. Concevez vos formulaires comme si vous ne disposiez à long terme que de l’e-mail.

Les utilisateurs Apple peuvent activer Hide My Email. Dans ce cas, Apple renvoie une adresse relais au lieu de l’e-mail réel de l’utilisateur.

Cet e-mail relais peut créer des doublons si votre CRM attend un autre identifiant. Si vous envoyez des e-mails aux clients, vous devrez peut-être aussi prendre en charge la livraison aux adresses relais Apple.

Référence Apple : Communiquer à l’aide du service de relais de messagerie privée.

Configurer la connexion avec Apple

1

Ouvrez Identifiants

1. Connectez-vous au compte Apple Developer.

Compte développeur

1. Accédez à Certificats, identifiants et profils → les identifiants.

2

Créer (ou réutiliser) un App ID

1. Cliquez + et sélectionnez App IDs.

Cliquez sur +

Sélectionnez App ID

Si vous avez déjà un App ID pour le même domaine ou la même application, vous pouvez peut-être le réutiliser. Cela peut débloquer des scénarios avancés. En cas de doute, demandez à l’équipe Wallet.

1. Sélectionnez le App type.
2. Remplissez le formulaire avec :

   1. Description: un nom explicite pour votre projet
   2. Bundle ID: utilisez la valeur fournie par l’équipe Wallet (exemple : cloud.neostore.molia.app)
   3. Fonctionnalités: activez Connexion avec Apple

1. Validez le formulaire et cliquez sur Enregistrer.

3

Créer (ou réutiliser) un Service ID

Vous avez besoin d’un Service ID pour la connexion avec Apple sur le web.

1. Dans la liste des identifiants, changez le filtre sur les Service IDs.
2. Cliquez + et sélectionnez les Service IDs.

Cliquez sur +

Service ID

1. Remplissez le formulaire avec :

   1. Description: un nom explicite pour votre service
   2. Identifiant: utilisez la valeur fournie par l’équipe Wallet (exemple : cloud.neostore.molia.service)

1. Validez le formulaire et cliquez sur Enregistrer.

L’ identifiant Service ID est la valeur que vous collerez dans l’administration de Wallet.

4

Configurer la connexion avec Apple (domaines + URL de retour)

1. Dans la liste des identifiants, sélectionnez le Service ID que vous venez de créer.
2. Activer Connexion avec Apple et cliquez sur Configurer.

1. Remplissez le formulaire avec :

   1. App ID principal: l’App ID que vous avez créé précédemment (exemple : cloud.neostore.molia.app)
   2. Domaines et sous-domaines: ajoutez tous les domaines qui hébergeront vos formulaires d’inscription (prod + staging + dev + personnalisés)
   3. URL de retour: ajoutez les URL de rappel OAuth pour chaque environnement

1. Validez le formulaire et cliquez sur Continuer.

Apple est très strict ici. Utilisez les valeurs exactes.

Si vous n’êtes pas sûr du format de l’URL de rappel, demandez à l’équipe Wallet.

5

Configurer les domaines de communication par e-mail

Cette étape est requise si votre application envoie des e-mails aux utilisateurs qui ont choisi Hide My Email lors de la connexion avec Apple.

Apple génère une adresse relais comme :

[email protected]

Vous devez enregistrer votre domaine d’envoi, sinon Apple rejettera ces e-mails. Traitez les adresses relais comme des adresses e-mail normales dans votre backend.

Cette étape est requise si vous envoyez des e-mails aux utilisateurs qui ont choisi Hide My Email.

Apple renvoie une adresse e-mail relais. Traitez-la comme une vraie boîte aux lettres.

Ouvrez la section Services

• Dans Certificats, identifiants et profils, cliquez sur Services dans le menu de gauche.
• Cliquez Connexion avec Apple pour la communication par e-mail.
• Cliquez Configurer.

• Sous Sources d’e-mail, cliquez sur le + bouton pour ajouter une nouvelle source d’e-mail.

Remplissez le formulaire avec :

• Domaines et sous-domaines : Ajoutez le ou les domaines depuis lesquels vous envoyez des e-mails. Exemple :

  myapp.com
  mail.myapp.com

• Adresses e-mail : Ajoutez la ou les adresses e-mail d’envoi utilisées par votre application. Exemple :

[email protected]
[email protected]

• Cliquez Suivant et terminez la validation (vérification SPF/DKIM si nécessaire).

Configurer Apple dans Wallet

1. Dans la console d’administration de Wallet, ouvrez :

Connexion sociale → Apple

Configuration de la connexion sociale Apple de Wallet

1. Remplissez le Service ID avec l’identifiant utilisé lors de la création du Service ID (exemple : cloud.neostore.molia.service).
2. Enregistrez.

Collez l’ Service ID identifiant.

Ne collez pas le nom de l’App ID ni le Bundle ID.

Activez Apple sur votre formulaire d’inscription

Activez le fournisseur dans les paramètres du formulaire d’inscription.

Allez dans configuration avancée -> Layout. Ouvrez la mise en page pour activer la connexion sociale et ajoutez ces lignes :

signinOptions:
  providers:
    - type: apple
      displayProps:
        isMobile: true
        isIOS: true

Pour plus d’informations, voir Formulaire d’inscription.

FAQ

Quels domaines dois-je ajouter dans Apple Developer ?

Ajoutez tous les domaines pouvant héberger le formulaire d’inscription.

Incluez prod, staging, dev et tout domaine personnalisé.

Que dois-je mettre dans « Return URLs » ?

Ajoutez l’URL de rappel pour chaque environnement et chaque domaine de formulaire.

Conservez-les exactement. Le schéma, le chemin et le slash final doivent correspondre.

Pourquoi n’obtiens-je l’e-mail de l’utilisateur qu’après la première connexion ?

Apple ne renvoie les champs de nom qu’au premier consentement.

Lors des connexions suivantes, Apple renvoie généralement uniquement l’e-mail.

Qu’est-ce que « Hide My Email » et qu’est-ce que cela change ?

Apple peut renvoyer une adresse e-mail relais au lieu de l’e-mail réel de l’utilisateur.

Cela peut créer des doublons si vous associez les utilisateurs uniquement par e-mail.

Référence Apple : Communiquer à l’aide du service de relais de messagerie privée{target="_blank"}.

Quelle valeur dois-je coller dans l’administration de Wallet : Bundle ID, App ID ou Service ID ?

Collez l’ Service ID.

Exemple : cloud.thewalletcrew.molia.service.