> For the complete documentation index, see [llms.txt](https://docs.thewalletcrew.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thewalletcrew.io/guides-enrolment/fr/inscription/enrolment-form/social-sign-in/apple-sign-in.md).

# Configuration de la connexion Apple

Configurez Se connecter avec Apple et associez-le à la connexion sociale de The Wallet Crew.

Utilisez cette page pour activer le **Apple** bouton dans un formulaire d’inscription.

Commencez par [Connexion sociale](/guides-enrolment/fr/inscription/enrolment-form/social-sign-in.md) pour comprendre le parcours client. Revenez ensuite ici pour la configuration du fournisseur.

<figure><img src="https://831874859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlFokgwgJiwLXu7G8MVSJ%2Fuploads%2FBP9fhwq1Tpq6pxxvW29G%2FApple-Social-Sign-In.png?alt=media&#x26;token=24b7931d-1046-4f99-aff1-b6c4a37d2aab" alt="Apple-Social-Sign-In-Example" width="375"><figcaption><p>Exemple de connexion avec Apple dans un formulaire d’inscription</p></figcaption></figure>

### Vue d’ensemble

Utilisez cette page pour configurer **Se connecter avec Apple** (connexion avec l’identifiant Apple) pour **The Wallet Crew** les formulaires d’inscription.

Apple se configure à deux endroits :

1. **Apple Developer**: App ID + Service ID + domaines + URL de retour.
2. **l’administration de The Wallet Crew**: collez le **Service ID**.

#### Terminologie (Apple)

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

* **App ID**: identifie l’application. Utilise un **Bundle ID** comme `com.brand.app`.
* **Service ID**: identifie une intégration de connexion web. C’est la valeur à coller dans The Wallet Crew.
* **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 la marque **Apple Developer** .
* Autorisation de gérer **Identifiants** et **Service IDs**.
* La liste des domaines où les formulaires d’inscription seront exécutés (prod + staging + dev + personnalisé).

#### Remarques sur le comportement d’Apple

Se connecter avec Apple présente quelques comportements qui ont un impact sur le parcours d’inscription et les 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 **l’e-mail uniquement**. Concevez les formulaires comme si seul l’e-mail serait disponible à long terme.

{% hint style="warning" %}
Les utilisateurs Apple peuvent activer **Hide My Email**. Dans ce cas, Apple renvoie une adresse de relais au lieu de l’e-mail réel du client.

Cet e-mail de relais peut créer des doublons si le CRM attend un autre identifiant. Lorsque les clients reçoivent des e-mails, l’envoi vers les adresses de relais Apple peut également devoir être pris en charge.
{% endhint %}

Référence d’Apple : [Communiquer à l’aide du service de relais privé de messagerie](https://developer.apple.com/documentation/signinwithapple/communicating-using-the-private-email-relay-service/).

### Configurer Se connecter avec Apple

{% stepper %}
{% step %}

#### **Ouvrir les identifiants**

1. Connectez-vous au compte Apple Developer.

<p align="center"><a href="https://developer.apple.com/account" class="button secondary" data-icon="chevrons-right">Compte développeur</a></p>

2. Allez dans `Certificats, IDs et profils` → `Identifiants`.
   {% endstep %}

{% step %}

#### **Créez (ou réutilisez) un App ID**

1. Cliquez sur `+` et sélectionnez `App IDs`.

<div><figure><img src="https://831874859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlFokgwgJiwLXu7G8MVSJ%2Fuploads%2FcYzPs1fAjRKczs5TLDTs%2Fenroll-apple-sign-click.png?alt=media&#x26;token=a49d5bb5-438e-4002-8347-e14c7caa3f3c" alt="Click on +"><figcaption><p>Cliquez sur le bouton + dans la liste des identifiants.</p></figcaption></figure> <figure><img src="https://831874859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlFokgwgJiwLXu7G8MVSJ%2Fuploads%2FJdEyrLcxNs6vf0469trW%2Fenroll-apple-sign-select-app-id.png?alt=media&#x26;token=ef126398-73e9-459d-81fe-09ae0649559c" alt="Select App ID"><figcaption><p>Vérifiez que App IDs est le type d’identifiant sélectionné.</p></figcaption></figure></div>

> Un App ID existant pour le même domaine ou la même application peut parfois être réutilisé. Cela peut débloquer des cas avancés. En cas de doute, demandez à l’équipe The Wallet Crew.

2. Sélectionnez le `App` type.
3. Remplissez le formulaire avec :
   1. **Description**: un nom explicite pour le projet
   2. **Bundle ID**: utilisez la valeur fournie par The Wallet Crew (exemple : `cloud.neostore.molia.app`)
   3. **Fonctionnalités**: activez `Se connecter avec Apple`

<div><figure><img src="https://831874859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlFokgwgJiwLXu7G8MVSJ%2Fuploads%2FJFBA0Xs6gWKpFTCky66i%2Fenroll-apple-sign-description-bundle-id.png?alt=media&#x26;token=6e9265e7-da90-4b7e-8699-b12123a02a7f" alt="Description and Bundle ID" width="520"><figcaption><p>Vérifiez le Bundle ID par rapport à la valeur fournie par The Wallet Crew.</p></figcaption></figure> <figure><img src="https://831874859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlFokgwgJiwLXu7G8MVSJ%2Fuploads%2FNrV4vfbTBze7JhFZRSzO%2Fenroll-apple-sign-capabilities.png?alt=media&#x26;token=e2ccbac7-637a-4ac5-9e38-577bdb4ca88f" alt="Capabilities" width="563"><figcaption><p>Vérifiez que Se connecter avec Apple est activé dans la liste des fonctionnalités.</p></figcaption></figure></div>

4. Validez le formulaire et cliquez sur `Enregistrer`.

<figure><img src="https://831874859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlFokgwgJiwLXu7G8MVSJ%2Fuploads%2FB2dEdk2bdq36K9FLmgjB%2Fenroll-apple-sign-create-or-reuse-app-id.png?alt=media&#x26;token=cdfbf4e5-8014-43b7-8470-844ffb048b07" alt="Create (or reuse) an App ID"><figcaption><p>Vérifiez que l’App ID enregistré apparaît dans la liste des identifiants.</p></figcaption></figure>
{% endstep %}

{% step %}

#### **Créez (ou réutilisez) un Service ID**

Un **Service ID** est requis pour Se connecter avec Apple sur le web.

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

<div><figure><img src="https://831874859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlFokgwgJiwLXu7G8MVSJ%2Fuploads%2FcYzPs1fAjRKczs5TLDTs%2Fenroll-apple-sign-click.png?alt=media&#x26;token=a49d5bb5-438e-4002-8347-e14c7caa3f3c" alt="Click on +" width="420"><figcaption><p>Cliquez sur +</p></figcaption></figure> <figure><img src="https://831874859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlFokgwgJiwLXu7G8MVSJ%2Fuploads%2FW5S81oHDz821XRBtA0X1%2Fenroll-apple-sign-service-id.png?alt=media&#x26;token=9090bd74-0f39-43ce-9c06-a5d7a0de0a20" alt="Service ID" width="563"><figcaption><p>Service ID</p></figcaption></figure></div>

3. Remplissez le formulaire avec :
   1. **Description**: un nom explicite pour le service
   2. **Identifiant**: utilisez la valeur fournie par The Wallet Crew (exemple : `cloud.neostore.molia.service`)

<figure><img src="https://831874859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlFokgwgJiwLXu7G8MVSJ%2Fuploads%2FLAtXxqNpviwmZBp0ZWVz%2Fenroll-apple-sign-identifier.png?alt=media&#x26;token=0a0feeb1-4639-420b-8094-61bf2c65f518" alt="Identifier"><figcaption><p>Vérifiez l’identifiant du Service ID par rapport à la valeur fournie par The Wallet Crew.</p></figcaption></figure>

4. Validez le formulaire et cliquez sur `Enregistrer`.

{% hint style="info" %}
L’ **identifiant du Service ID** est la valeur à coller dans l’administration de The Wallet Crew.
{% endhint %}
{% endstep %}

{% step %}

#### **Configurer Se connecter avec Apple (domaines + URL de retour)**

1. Dans la liste des identifiants, sélectionnez le Service ID tout juste créé.
2. Activez `Se connecter avec Apple` et cliquez sur `Configurer`.

<figure><img src="https://831874859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlFokgwgJiwLXu7G8MVSJ%2Fuploads%2FfOqYBv3X5QBlsbI1ZQXt%2Fenroll-apple-sign-configure-sign-apple-domains-return-urls.png?alt=media&#x26;token=63e553c4-401a-4159-bf79-b87ec14669b8" alt="Configure Sign in with Apple (domains + return URLs)"><figcaption><p>Vérifiez que Se connecter avec Apple est activé avant d’ouvrir Configurer.</p></figcaption></figure>

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

<figure><img src="https://831874859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlFokgwgJiwLXu7G8MVSJ%2Fuploads%2F7H0WPRVsriaX38ErKopd%2Fenroll-apple-sign-return-urls.png?alt=media&#x26;token=f4e0aba1-7fc3-4a2e-ae0a-3447cf77890b" alt="Return URLs"><figcaption><p>Vérifiez chaque URL de retour pour une correspondance exacte, y compris le schéma et le slash final.</p></figcaption></figure>

4. Validez le formulaire et cliquez sur **Continuer**.

{% hint style="warning" %}
Apple est strict à ce sujet. Utilisez les valeurs exactes.

Si le format de l’URL de rappel n’est pas clair, demandez à l’équipe The Wallet Crew.
{% endhint %}
{% endstep %}

{% step %}

#### Configurer les domaines de communication e-mail

Cette étape est requise lorsque l’application de la marque envoie des e-mails aux clients qui ont choisi **Hide My Email** lors de la connexion avec Apple.

Apple génère une adresse de relais comme :

> <randomstring@privaterelay.appleid.com>

Le domaine d’envoi doit être enregistré, sinon Apple rejettera ces e-mails. Traitez les adresses de relais comme des adresses e-mail normales dans le backend.

{% hint style="info" %}
Cette étape est requise lorsque des e-mails sont envoyés aux clients qui ont choisi **Hide My Email**.

Apple renvoie une **adresse e-mail de relais**. Traitez-la comme une vraie boîte aux lettres.
{% endhint %}

**Ouvrez la section Services**

* Dans **Certificates, Identifiers & Profiles**, cliquez sur **Services** dans le menu de gauche.
* Cliquez sur **Se connecter avec Apple pour la communication par e-mail**.
* Cliquez sur **Configurer**.

<figure><img src="https://831874859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlFokgwgJiwLXu7G8MVSJ%2Fuploads%2FepEkquqXE1fI7pCSDQBP%2Fenroll-apple-sign-configure.png?alt=media&#x26;token=0b3eb4c9-0cfc-4386-81af-96e5be6b8434" alt="Configure"><figcaption><p>Vérifiez que Se connecter avec Apple pour la communication par e-mail est bien la section en cours de configuration.</p></figcaption></figure>

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

<figure><img src="https://831874859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlFokgwgJiwLXu7G8MVSJ%2Fuploads%2FFksR9cMQ8DGx1UlLeD2u%2Fenroll-apple-sign-email-sources.png?alt=media&#x26;token=a8002154-7709-4575-a975-095331137cf3" alt="Email Sources"><figcaption><p>Vérifiez que chaque domaine d’envoi et chaque adresse apparaît sous Sources d’e-mail.</p></figcaption></figure>

**Remplissez le formulaire avec :**

* **Domaines et sous-domaines**:\
  Ajoutez le(s) domaine(s) utilisé(s) pour envoyer des e-mails.\
  Exemple :

  ```
  myapp.com
  mail.myapp.com
  ```
* **Adresses e-mail**:\
  Ajoutez la ou les adresses e-mail d’expéditeur utilisées par l’application.\
  Exemple :

```
noreply@myapp.com
support@myapp.com
```

<figure><img src="https://831874859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlFokgwgJiwLXu7G8MVSJ%2Fuploads%2FBxNTARJf4jAQDqSmxwRw%2Fenroll-apple-sign-fill-form.png?alt=media&#x26;token=5372fa81-7198-40db-914b-5f2fea735d6a" alt="Fill the form with"><figcaption><p>Vérifiez les domaines et les adresses d’expéditeur avant de soumettre le formulaire.</p></figcaption></figure>

* Cliquez sur **Suivant** et terminez la validation (vérification SPF/DKIM si nécessaire).
  {% endstep %}
  {% endstepper %}

### Configurez Apple dans The Wallet Crew

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

<p align="center"><a href="https://admin.thewalletcrew.io/tenant/~/settings/social/apple" class="button secondary" data-icon="chevrons-right">Connexion sociale → Apple</a></p>

<div data-with-frame="true"><figure><img src="https://831874859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlFokgwgJiwLXu7G8MVSJ%2Fuploads%2FfXNatUPmOfIY0BlVRHmj%2Fimage.png?alt=media&#x26;token=282cd58a-081b-4a7b-8b9a-109ffde50307" alt="The Wallet Crew - Apple Social Sign In configuration" width="563"><figcaption><p>Configuration de la connexion sociale Apple de The Wallet Crew</p></figcaption></figure></div>

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

{% hint style="info" %}
Collez l’ **Service ID** identifiant.

Ne collez pas le nom de l’App ID ni le Bundle ID.
{% endhint %}

### Activez Apple sur le 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 où la connexion sociale doit être activée et ajoutez ces lignes :

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

Pour plus d’informations, consultez [Formulaire d’inscription](/guides-enrolment/fr/inscription/enrolment-form.md).

### FAQ

<details>

<summary>Quels domaines dois-je ajouter dans Apple Developer ?</summary>

Ajoutez chaque domaine pouvant héberger le formulaire d’inscription.

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

</details>

<details>

<summary>Que dois-je mettre dans « Return URLs » ?</summary>

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

Soyez exact. Le schéma, le chemin et le slash final doivent correspondre.

</details>

<details>

<summary>Pourquoi seul l’e-mail du client est-il renvoyé après la première connexion ?</summary>

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

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

</details>

<details>

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

Apple peut renvoyer un e-mail de relais à la place de l’e-mail réel du client.

Cela peut créer des doublons lorsque les clients sont rapprochés uniquement par e-mail.

Référence d’Apple : [Communiquer à l’aide du service de relais privé de messagerie](https://developer.apple.com/documentation/signinwithapple/communicating-using-the-private-email-relay-service/){target="\_blank"}.

</details>

<details>

<summary>Quelle valeur dois-je coller dans l’administration de The Wallet Crew : Bundle ID, App ID ou Service ID ?</summary>

Collez l’ **Service ID**.

Exemple : `cloud.thewalletcrew.molia.service`.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.thewalletcrew.io/guides-enrolment/fr/inscription/enrolment-form/social-sign-in/apple-sign-in.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.