Zum Inhalt springen

iOS-Setup

GitHub

Auf iOS funktionieren Passkeys nur, wenn die App mit derselben Relying-Party-Domain verknüpft ist wie die Website.

Nachdem du die Plugin-Konfiguration hinzugefügt und bunx cap syncausgeführt hast, patcht das Plugin das generierte iOS-Host-Projekt, sodass du es nicht mehr manuell bearbeiten musst:

  • fügt den webcredentials: associated domains-Einträge für die konfigurierten Domains
  • wires CODE_SIGN_ENTITLEMENTS wenn das generierte App-Target nicht bereits auf eine Entitlements-Datei verweist

Sie müssen veröffentlichen apple-app-site-association auf dem Relying-Party-Domain:

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

Beispiel:

{
"webcredentials": {
"apps": ["ABCDE12345.app.capgo.passkey.example"]
}
}
  1. Setzen Sie origin und domains in einem plugins.CapacitorPasskey in einem capacitor.config.*.
  2. Ausführen bunx cap sync.
  3. Bestätige deine Apple Team ID und App Bundle ID und erstelle dann den TEAMID.bundleId Wert für die Association-Datei.
  4. Hoste apple-app-site-association über HTTP 200 und ohne .json Dateiendung.
  5. Stelle sicher, dass die Relying-Party-ID, die dein Backend verwendet, mit der Associated Domain übereinstimmt.
  • Die Website-Datei muss von der exakten Passkey-Domain ausgeliefert werden, die Sie als Relying-Party-ID verwenden.
  • Unter iOS 17.4 und neuer nutzt das Plugin die clientseitigen API im Browser-Stil, sodass die konfigurierte HTTPS-Origin in clientDataJSON.
  • Das Plugin kann native Projektdateien während des Syncs patchen, kann aber die Website-Assoziationsdatei nicht auf Ihrer Domain erstellen oder hosten.

Wenn du es nutzt iOS-Setup Um Authentifizierungs- und Account-Flows zu planen, verbinde es mit @capgo/capacitor-passkey verwenden für die native Funktion in „@capgo/capacitor-passkey verwenden“, @capgo/capacitor-social-login für die Implementierungsdetails in @capgo/capacitor-social-login, @capgo/capacitor-passkey für die Implementierungsdetails in @capgo/capacitor-passkey, @capgo/capacitor-native-biometric für die Implementierungsdetails in @capgo/capacitor-native-biometric, und Zwei-Faktor-Authentifizierung für die Implementierungsdetails zur Zwei-Faktor-Authentifizierung.