Passer à la navigation

Configuration iOS

GitHub

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.

After you add the plugin config and run bunx cap sync, le plugin met à jour le projet de l'hôte iOS généré afin que vous n'ayez pas besoin de le modifier manuellement :

  • ajoute les webcredentials: entrées de domaines associés pour les domaines configurés
  • connecte CODE_SIGN_ENTITLEMENTS lorsque le projet cible généré ne pointe pas déjà vers un fichier de droits

Vous devez publier apple-app-site-association sur le domaine de la partie dépendante :

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

Exemple :

{
"webcredentials": {
"apps": ["ABCDE12345.app.capgo.passkey.example"]
}
}
  1. Configurer origin et domains dans plugins.CapacitorPasskey dans capacitor.config.*.
  2. Démarrez bunx cap sync.
  3. Confirmez 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 sans .json extension.
  5. Assurez-vous que l'ID de la partie dépendante utilisé par votre serveur backend correspond au domaine associé.
  • Le fichier du site web doit être servi depuis le domaine passkey exact que vous utilisez comme ID de partie de confiance.
  • 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 modifier les fichiers de projet natif pendant la synchronisation, mais il ne peut pas créer ou héberger le fichier d'association du site web sur votre domaine.

Si vous utilisez Configuration iOS pour planifier l'authentification et les flux de compte, connectez-l’avec En utilisant @capgo/capacitor-passkey pour la capacité native dans En utilisant @capgo/capacitor-passkey, @capgo/capacitor-connexion-social pour le détail d'implémentation dans @capgo/capacitor-social-login, @capgo/capacitor-passkey pour le détail d'implémentation dans @capgo/capacitor-passkey, @capgo/capacitor-native-biometrique pour le détail d'implémentation dans @capgo/capacitor-native-biometric, et Authentification à deux facteurs pour le détail d'implémentation dans Authentification à deux facteurs.