Configuration iOS
Copiez une commande de configuration avec les étapes d'installation et le guide markdown complet pour ce plugin.
Sur iOS, les passkeys 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 »After you add the plugin config and run bunx cap syncles modifications apportées par le plugin au projet de hôte iOS généré vous permettent de ne plus le modifier manuellement :
- ajoute les
webcredentials:entrées de domaines associés pour les domaines configurés - connecte
CODE_SIGN_ENTITLEMENTSlorsque le projet cible généré n'indique pas déjà un fichier d'autorisations
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 de partie de confiance :
https://signin.example.com/.well-known/apple-app-site-associationExemple :
{ "webcredentials": { "apps": ["ABCDE12345.app.capgo.passkey.example"] }}- Définir
originetdomainsdansplugins.CapacitorPasskeydanscapacitor.config.*. - Exécuter
bunx cap sync. - Confirmer votre ID 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 non.jsonextension. - Assurez-vous que l'ID de la partie dépendante utilisé par votre serveur backend correspond au domaine associé.
Remarques
Section intitulée « Remarques »- Le fichier du site doit être servi depuis le domaine de 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 corriger les fichiers de projet natifs pendant 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 la configuration iOS »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 Deux facteurs d'authentification pour le détail d'implémentation dans Deux facteurs d'authentification.