Aller directement au contenu

Configuration iOS

Sur iOS, les clés de passe ne fonctionnent que lorsque l'application est associée au même domaine de partie de confiance que le site web.

Après avoir ajouté la configuration du plugin et avoir exécuté bunx cap syncle plugin corrige le projet hôte généré iOS, vous n'avez donc pas besoin de le modifier manuellement :

  • ajoute les webcredentials: entrées de domaines associés aux domaines configurés
  • wires CODE_SIGN_ENTITLEMENTS lorsque la cible d'application générée ne pointe pas déjà vers un fichier d'autorisations

Vous devez publier apple-app-site-association sur le domaine de la partie sur laquelle elle repose :

https://signin.example.com/.well-known/apple-app-site-association

Exemple :

{
"webcredentials": {
"apps": ["ABCDE12345.app.capgo.passkey.example"]
}
}
  1. Définir origin et domains dans plugins.CapacitorPasskey dans capacitor.config.*.
  2. Exécuter bunx cap sync.
  3. Vérifiez votre ID d'équipe Apple et votre ID de bundle d'application, puis construisez le TEAMID.bundleId valeur pour le fichier d'association.
  4. Hôte apple-app-site-association avec HTTP 200 et non .json extension.
  5. Vérifiez que l'ID de la partie dépendante utilisé par votre backend correspond au domaine associé.
  • Le fichier du site web doit être servi à partir du domaine exact de passkey que vous utilisez comme ID de la partie dépendante.
  • Sur iOS 17.4 et versions ultérieures, le plugin utilise le client-data de style navigateur API donc l'origine HTTPS configurée est reflétée dans clientDataJSON.
  • Le plugin peut corriger les fichiers de projet natifs lors de la synchronisation, mais il ne peut pas créer ou héberger le fichier d'association du site web sur votre domaine.