Installation iOS
Copiez un prompt de configuration avec les étapes d'installation et la guide Markdown complète 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 met à jour 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 domaine associées pour les domaines configurés - fils
CODE_SIGN_ENTITLEMENTSlorsque l'application générée cible ne pointe pas déjà vers un fichier d'entitlements
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 la partie qui s'appuie :
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 »- Configurer
originetdomainsdansplugins.CapacitorPasskeydanscapacitor.config.*. - Exécuter
bunx cap sync. - Vérifiez 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 l'entité de confiance utilisé par votre backend correspond au domaine associé.
Remarques
Section intitulée « Notes »- Le fichier du site web doit être servi à partir du domaine exact de passkey que vous utilisez comme ID de 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 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 les flux d'authentification et de compte, connectez-le avec En utilisant @capgo/capacitor-passkey pour la capacité native dans En utilisant @capgo/capacitor-passkey, @capgo/capacitor-social-login pour les détails d'implémentation dans @capgo/capacitor-login-social @capgo/capacitor-passkey pour les détails d'implémentation dans @capgo/capacitor-passkey @capgo/capacitor-biométrique-natif pour les détails d'implémentation dans @capgo/capacitor-biométrique-natif, et Authentification à deux facteurs pour les détails d'implémentation dans Authentification à deux facteurs