Validateur AASA / iOS Universal Links
Remarque : les navigateurs sont limités par le CORS, ce qui fait que cet outil récupère l’AASA via un proxy public. N’entrez pas d’adresses internes sensibles ; l’AASA doit être accessible publiquement.
Résultats
Source AASA pour validation/correspondance
Coller le JSON AASA
Test de correspondance Universal Links
AASA valide non sélectionnée
Remarque : ce test ne vérifie que la correspondance au niveau des règles AASA ; iOS réel est affecté par le cache, l’état d’installation, la version iOS et la source d’ouverture.
Tutoriel (dépannage rapide)
1) Déployer l’AASA (serveur)
- Placez le fichier à `https://<domain>/.well-known/apple-app-site-association` (recommandé) ou `https://<domain>/apple-app-site-association`.
- Aucune extension (pas de `.json`), accessible en HTTPS, et retour 200.
- `Content-Type: application/json` est recommandé (l’AASA signée peut être `application/pkcs7-mime`).
- Structure typique : `applinks.apps` vaut `[]` ; `applinks.details` contient `appID` et `paths`/`components`.
2) Configurer iOS (client)
- Dans Xcode > Associated Domains, ajoutez `applinks:your-domain.com` (incluez les sous-domaines si nécessaire).
- Vérifiez que `appID` est correct : `<TeamID>.<BundleID>` et correspond à votre signature.
- Installez l’app puis testez en ouvrant les liens depuis Safari/Notes/Messages.
3) Causes fréquentes d’échec
- Mauvais chemin/nom de fichier (absence de `.well-known` ou ajout de `.json`).
- Redirection/auth/WAF renvoie du HTML.
- JSON AASA invalide : `applinks.details[].appID` manquant ou absence de `paths/components`.
- Cache iOS : les mises à jour peuvent mettre du temps à s’appliquer.
- Cache du CDN Apple : `app-site-association.cdn-apple.com` peut ne pas être en temps réel.
4) Vérifications locales rapides (optionnel)
curl -i https://your-domain.com/.well-known/apple-app-site-association
xcrun simctl openurl booted https://your-domain.com/your/path
Remarque : les commandes peuvent varier selon les versions macOS/iOS ; les réseaux d’entreprise/proxys peuvent affecter la récupération.
Mode d’emploi
- Saisissez votre domaine associé (par ex. example.com) dans « Domaine / URL du site ».
- Choisissez la source de l’AASA (par défaut .well-known) puis cliquez sur « Récupérer et valider ».
- Dans « Résultats », vérifiez le statut HTTP, le Content-Type et la validité du JSON.
- Dans « Test de correspondance Universal Links », saisissez une URL pour vérifier la correspondance aux règles AASA.
Conseils
Cet outil utilise un proxy public pour contourner le CORS du navigateur.
Le fichier AASA doit être accessible en HTTPS et ne doit pas avoir l’extension .json.
iOS privilégie `/.well-known/apple-app-site-association` pour la validation des Universal Links.
Utilisez le mode « Coller manuellement » pour valider des règles avant déploiement.
