Configuration iOS
Copiez une invite de commande avec les étapes d'installation et le guide markdown complet pour ce plugin.
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.
Ce que le plugin gère
Section intitulée “Ce que le plugin gère”Après avoir ajouté la configuration du plugin et avoir exécuté bunx cap sync, le plugin corrige le projet de 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_ENTITLEMENTSlorsque la cible de l'application générée ne pointe pas déjà vers un fichier de droits
Ce que vous devez encore héberger
Section intitulée “Ce que vous devez encore héberger”Vous devez publier apple-app-site-association sur le domaine du partenaire de confiance :
https://signin.example.com/.well-known/apple-app-site-associationExemple :
{ "webcredentials": { "apps": ["ABCDE12345.app.capgo.passkey.example"] }}Liste de vérification
Section intitulée « Liste de vérification »- Définir
originetdomainsdansplugins.CapacitorPasskeydanscapacitor.config.*. - Exécuter
bunx cap sync. - Vérifiez votre identifiant d'équipe Apple et votre ID de bundle d'application, puis construisez le
TEAMID.bundleIdvaleur pour le fichier d'association. - Hôte
apple-app-site-associationavec HTTP200et sans.jsonextension. - Assurez-vous 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 la clé de passe que vous utilisez comme ID de la partie dépendante.
- Sur iOS 17.4 et ultérieur, 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.
Continuez de la configuration iOS
Section intitulée « Continuez de l'installation iOS »Si vous utilisez l'installation iOS pour planifier l'authentification et les flux de compte, connectez-le avec Utilisez @capgo/capacitor-passkey pour la capacité native dans Utilisez @capgo/capacitor-passkey, @capgo/capacitor-social-login 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-biometric 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.