> 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

Utilisez ceci lorsque vous souhaitez 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 utilisateur. Puis revenez ici pour la configuration du fournisseur.

<figure><img src="/files/fe1e415d2b108e5a90200224ec90c9c597d519a2" 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 **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.

{% hint style="warning" %}
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.
{% endhint %}

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

### Configurer la connexion avec Apple

{% stepper %}
{% step %}

#### **Ouvrez 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. Accédez à `Certificats, identifiants et profils` → `les identifiants`.
   {% endstep %}

{% step %}

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

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

![Cliquez sur +](/files/045ebb2c6c09204b0735528fa1b04e52cdfe4534) ![Sélectionnez App ID](/files/c9bfb84a86450329f1bd51df006a9543c47b6b02)

> 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.

2. Sélectionnez le `App` type.
3. 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`

<div><figure><img src="/files/54bc06024230848f7242ec795db1c66f17f19454" alt="Description and Bundle ID" width="520"><figcaption></figcaption></figure> <figure><img src="/files/a74e1379a1f201c2d01881a02f95b5369532cb6d" alt="Capabilities" width="563"><figcaption></figcaption></figure></div>

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

<figure><img src="/files/249e5d82b0d5ab84d74768805b98283a4dee00fa" alt="Create (or reuse) an App ID"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### **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`.

<div><figure><img src="/files/045ebb2c6c09204b0735528fa1b04e52cdfe4534" alt="Click on +" width="420"><figcaption><p>Cliquez sur +</p></figcaption></figure> <figure><img src="/files/5332f1ba534dff0e78aa6e1f87005c3d4df90b37" alt="Service ID" width="563"><figcaption><p>Service ID</p></figcaption></figure></div>

3. 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`)

<figure><img src="/files/750505b3a397f5496d8fa39b64acda6eeefc16ae" alt="Identifier"><figcaption></figcaption></figure>

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

{% hint style="info" %}
L’ **identifiant Service ID** est la valeur que vous collerez dans l’administration de Wallet.
{% endhint %}
{% endstep %}

{% step %}

#### **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`.

<figure><img src="/files/1c2d2f462c484059e9b7d3ed8f43d2aaa1acf4c7" alt="Configure Sign in with Apple (domains + return URLs)"><figcaption></figcaption></figure>

3. 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

<figure><img src="/files/6b9afc06f87a31b47082d5a0508203c155d376c7" alt="Return URLs"><figcaption></figcaption></figure>

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

{% hint style="warning" %}
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.
{% endhint %}
{% endstep %}

{% step %}

#### 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 :

> <randomstring@privaterelay.appleid.com>

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.

{% hint style="info" %}
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.
{% endhint %}

**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**.

<figure><img src="/files/d7ebfcd25fc79db544405021c66de34d1a94eed4" alt="Configure"><figcaption></figcaption></figure>

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

<figure><img src="/files/09ceeefe98a14aa0a1bf9cedf528357e0168dc9f" alt="Email Sources"><figcaption></figcaption></figure>

**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 :

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

<figure><img src="/files/f85e422c591aafda4853e8a892d11b529179bcfa" alt="Fill the form with"><figcaption></figcaption></figure>

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

### Configurer Apple dans Wallet

1. Dans la console d’administration de Wallet, 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="/files/0f34f55ed00b0d4019cafcbaa95d26c49f92ab3a" alt="The Wallet Crew - Apple Social Sign In configuration" width="563"><figcaption><p>Configuration de la connexion sociale Apple de Wallet</p></figcaption></figure></div>

2. Remplissez 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 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 :

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

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

### FAQ

<details>

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

Ajoutez tous les domaines 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.

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

</details>

<details>

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

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

Lors des connexions suivantes, 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 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](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 Wallet : 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.