---
title: "Associated Domains: l’entitlement iOS expliqué · Appy"
description: "Associated Domains est l’entitlement iOS qui relie une app à ses domaines web pour les Universal Links, les mots de passe partagés, Handoff et les App Clips."
source: "https://appy.to/fr/glossary/associated-domains"
---

1.  [Accueil](https://appy.to/fr)
2.  [Glossaire](https://appy.to/fr/glossary)
3.  Associated Domains

Deep linking

# Qu’est-ce qu’Associated Domains ?

En bref

Associated Domains est une capacité et un entitlement d’Apple qui liste les domaines web auxquels une app est reliée. Chaque entrée associe un service à un domaine, par exemple applinks:example.com. Avec le fichier apple-app-site-association publié sur ce domaine, il active les Universal Links, le partage des identifiants web, Handoff et les App Clips.

Résumer avec[ChatGPT](https://chatgpt.com/?q=R%C3%A9sume%20cette%20page%20et%20liste%20ses%20points%20cl%C3%A9s%20%3A%20https%3A%2F%2Fappy.to%2Ffr%2Fglossary%2Fassociated-domains) [Claude](https://claude.ai/new?q=R%C3%A9sume%20cette%20page%20et%20liste%20ses%20points%20cl%C3%A9s%20%3A%20https%3A%2F%2Fappy.to%2Ffr%2Fglossary%2Fassociated-domains) [Perplexity](https://www.perplexity.ai/search?q=R%C3%A9sume%20cette%20page%20et%20liste%20ses%20points%20cl%C3%A9s%20%3A%20https%3A%2F%2Fappy.to%2Ffr%2Fglossary%2Fassociated-domains)

## Ce que contient l’entitlement

L’entitlement est une liste de chaînes de la forme service:domaine. Apple définit quatre services. applinks sert aux Universal Links. webcredentials permet à l’app d’utiliser les mots de passe enregistrés pour le site web. activitycontinuation sert à Handoff. appclips rattache un App Clip à un domaine.

Le domaine s’écrit nu : pas de https://, pas de chemin, pas de barre oblique finale et, d’après la note technique d’Apple, pas de numéro de port non plus. Chaque sous-domaine est une entrée à part. Pour tous les services sauf appclips, le préfixe \*. couvre tous les sous-domaines, comme dans applinks:\*.example.com.

## Comment il fonctionne avec le fichier du domaine

L’entitlement est la moitié d’une vérification dans les deux sens. L’app revendique un domaine, et le domaine confirme en listant l’identifiant de l’app dans son fichier apple-app-site-association (AASA). Si l’une des deux moitiés manque, le service reste inactif et iOS ne signale rien à l’utilisateur.

À l’installation de l’app, le système télécharge le fichier de chaque domaine listé. Depuis iOS 14, cette demande part vers un CDN géré par Apple et non vers votre serveur. D’après la documentation d’Apple, le CDN demande le fichier dans les 24 heures et les appareils vérifient les mises à jour environ une fois par semaine.

## Le configurer et le tester

Dans Xcode, ouvrez l’onglet Signing & Capabilities de la cible, ajoutez la capacité Associated Domains et saisissez une ligne par domaine. Cela active aussi la fonction pour l’App ID. Un App Clip a besoin de la même entrée à la fois sur la cible de l’app et sur celle de l’App Clip.

Pour un serveur inaccessible depuis l’internet public, ajoutez ?mode=developer à l’entrée. Les appareils en mode développeur récupèrent alors le fichier directement, et seules les versions signées avec un profil de développement peuvent s’en servir. Un second mode, managed, concerne les appareils inscrits dans une gestion des appareils mobiles (MDM). Retirez le suffixe avant de publier : une version de production doit passer par le CDN, comme le téléphone de tout le monde. La note technique d’Apple décrit aussi un contrôle rapide sur l’appareil : une fois Associated Domains Development activé dans les réglages Développeur, un écran Diagnostics vous dit si une adresse donnée est valide pour une app installée.

ExempleEntrées de l’entitlement

```
applinks:example.com, webcredentials:example.com
```

Essayez ici

## Générez le fichier de votre app

Saisissez votre Team ID et votre bundle ID, ou le nom du package et l’empreinte de signature. Vous obtenez un fichier apple-app-site-association ou assetlinks.json prêt à déposer sur votre serveur.

iOSapple-app-site-associationAndroidassetlinks.json

### Apps

Ajoutez chaque app qui doit ouvrir les liens de ce domaine. Chacune devient une entrée de `appIDs`.

1.  App 1

Team ID

10 caractères, dans votre compte Apple Developer, sous Membership details.

Bundle ID

Dans la cible de votre app sous Xcode, par exemple com.example.app.


Ajouter une autre app

### Chemins qui ouvrent l’app

Les règles sont lues de haut en bas et la première qui correspond l’emporte : placez donc les exclusions au-dessus des règles plus larges. `*` correspond à n’importe quel nombre de caractères, `?` à un seul.

Tous les cheminsExemple : les règles d’AppyLiens d’e-mail SendGridLiens d’e-mail Amazon SES

1.  Règle 1

Ouvrir dans l’appExclure

Chemin (/)

Requête (?)

paires nom=valeur reliées par &

Fragment (#)

Commentaire


Ajouter une règle

### Autres services

Ajouter webcredentialsLe remplissage automatique des mots de passe peut alors proposer dans votre app les mots de passe enregistrés pour ce site.

Ajouter appclipsPermet à ce domaine de lancer votre App Clip.

Votre fichier

apple-app-site-association

CopierTélécharger

Exemple. Saisissez vos informations pour le remplacer.

```
{
"applinks": {
"details": [
{
"appIDs": [
"ABCDE12345.com.example.app"
],
"components": [
{
"/": "/*"
}
]
}
]
}
}
```

Généré dans votre navigateur. Rien n’est envoyé nulle part.

## Où l’héberger

Où va le fichier

Votre site webSendGridBrazeKlaviyo

Votre domaine (facultatif)

1.  Déposez-le à l’adresse `https://votre-domaine/.well-known/apple-app-site-association`, sans extension `.json`.
2.  Servez-le en HTTPS avec un certificat valide et un 200 direct, sans redirection.
3.  Envoyez l’en-tête `Content-Type: application/json`.
4.  Répétez l’opération sur chaque host de vos liens : `example.com` et `www.example.com` ont chacun besoin du fichier et d’une entrée `applinks:`.
5.  Le CDN d’Apple récupère un nouveau fichier sous 24 heures. En attendant, testez avec `?mode=developer`.

[Vérifier un domaine avec le validateur](https://appy.to/fr/tools/universal-link-validator)

Vous préférez ne pas héberger ces fichiers ? Les smart links sont gratuits, et avec Enterprise Appy sert les deux fichiers sur le domaine de liens de votre app.

[Créer un lien gratuit](https://appy.to/fr/account/register)

[Pour aller plus loinGuide complet des Universal Links pour iOS et AndroidLa place de l’entrée Associated Domains dans une configuration complète des Universal Links et des App Links, étape par étape.](https://appy.to/fr/blog/complete-guide-universal-links)

## Questions fréquentes

### Quelle est la différence entre Associated Domains et les Universal Links ?

Associated Domains est le mécanisme. Les Universal Links sont l’une des fonctions qui reposent dessus. L’entitlement peut aussi activer le partage des identifiants web, Handoff et les App Clips. Pour les Universal Links en particulier, vous ajoutez une entrée applinks: et vous listez l’app sous applinks dans le fichier de votre domaine.

### Peut-on utiliser un caractère générique dans Associated Domains ?

Oui. Faites précéder le domaine de \*. pour couvrir tous ses sous-domaines, par exemple applinks:\*.example.com, et hébergez le fichier sur le domaine racine. Le caractère générique n’est pas autorisé pour le service appclips, et il ne couvre pas le domaine racine lui-même, qui a besoin de sa propre entrée.

### Pourquoi mon entrée Associated Domains ne fonctionne-t-elle pas ?

Vérifiez les trois suspects habituels. L’entrée contient un scheme, un chemin ou un port. Le domaine de l’entrée et l’hôte qui sert le fichier diffèrent, par exemple example.com face à www.example.com. Ou bien le fichier redirige ou est bloqué, si bien que le CDN d’Apple n’en obtient jamais de copie.

## Termes associés

-   [Universal Links](https://appy.to/fr/glossary/universal-links)

Les Universal Links (liens universels) sont les liens https d’Apple qui ouvrent directement une app iOS installée au lieu du site web. Ils existent depuis iOS 9. Ils demandent l’entitlement Associated Domains dans l’app, par exemple applinks:example.com, et un fichier apple-app-site-association sur le domaine. Sans l’app, le même lien ouvre simplement le site web.

-   [apple-app-site-association (AASA)](https://appy.to/fr/glossary/apple-app-site-association)

Le fichier apple-app-site-association, ou AASA, est un fichier JSON publié sur votre domaine, à l’adresse /.well-known/apple-app-site-association. Il indique à iOS quelles apps ont le droit d’ouvrir les liens de ce domaine, chacune identifiée par son Team ID et son bundle ID, et pour quels chemins. Sans lui, pas d’Universal Links.

-   [App Clip](https://appy.to/fr/glossary/app-clip)

Un App Clip est une version légère d’une app iOS que l’on peut utiliser sans installer l’app complète. Il se lance à partir d’une invocation, comme un App Clip Code, un QR code, un tag NFC, un lien dans Messages ou une bannière dans Safari, accomplit une tâche précise, puis peut proposer l’app complète.


[Tout le glossaire](https://appy.to/fr/glossary)

## Un seul lien pour l’App Store, Google Play et le web

Créez un smart link et son QR code : chaque téléphone arrive sur le bon store, chaque ordinateur sur votre site. Gratuit jusqu’à 4 liens, sans publicité.

[Commencer gratuitement](https://appy.to/fr/account/register)
