Configuration iOS

Sur iOS, les passkeys ne fonctionnent que si l'application est associée au même domaine de relying-party que le site web.

Ce que le plugin gère

Après avoir ajouté la configuration du plugin et exécuté bunx cap sync, le plugin patch le projet hôte iOS généré pour vous éviter de devoir le modifier manuellement :

• ajoute le webcredentials: les entrées Associated Domains pour les domaines configurés
• câble CODE_SIGN_ENTITLEMENTS lorsque la cible de l'application générée ne pointe pas déjà vers un fichier d'entitlements

Ce que vous devez encore héberger

Vous devez publier apple-app-site-association sur le domaine de la partie de confiance :

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

Exemple :

{
  "webcredentials": {
    "apps": ["ABCDE12345.app.capgo.passkey.example"]
  }
}

Checklist

1. Définissez origin et domains dans plugins.CapacitorPasskey dans capacitor.config.*.
2. Exécutez bunx cap sync.
3. Confirmez votre Apple Team ID et votre app bundle ID, puis compilez le TEAMID.bundleId pour le fichier d'association.
4. Hébergez apple-app-site-association avec HTTP 200 et sans .json extension.
5. Assurez-vous que le relying-party ID utilisé par votre backend correspond au domaine associé.

Notes

• Le fichier du site web doit être servi depuis le domaine passkey exact utilisé comme ID de la relying-party.
• Sur iOS 17.4 et versions ultérieures, le plugin utilise le client-data API de type navigateur afin que l'origine HTTPS configurée soit reflétée dans clientDataJSON.
• Le plugin peut patcher les fichiers du projet natif lors de la synchronisation, mais il ne peut pas créer ni héberger le fichier d'association sur votre domaine.

Continuer depuis la configuration iOS

Si vous utilisez Configuration iOS pour planifier les flux d'authentification et de compte, le connecter à Utilisation de @capgo/capacitor-passkey pour la fonctionnalité native dans Utilisation de @capgo/capacitor-passkey, @capgo/capacitor-social-login pour les détails d'implémentation dans @capgo/capacitor-social-login @capgo/capacitor-passkey pour les détails d'implémentation dans @capgo/capacitor-passkey @capgo/capacitor-native-biometric pour les détails d'implémentation dans @capgo/capacitor-native-biometric, et Authentification à deux facteurs pour les détails d'implémentation de l'authentification à deux facteurs.