iOS Setup

Bei iOS funktionieren Passkeys nur, wenn die App mit demselben Relying-Party-Domain wie der Website verbunden ist.

Was das Plugin handhabt

Nachdem Sie die Plugin-Konfiguration hinzugefügt und ausgeführt haben bunx cap syncpatcht die generierte iOS-Host-Projekt so, dass Sie es nicht mehr manuell bearbeiten müssen:

• fügt die webcredentials: zugehörigen Domänen-Einträge für die konfigurierten Domains hinzu
• verbindet CODE_SIGN_ENTITLEMENTS wenn das generierte App-Ziel nicht bereits auf ein Berechtigungs-File verweist

Was Sie noch zum Hosting benötigen

Sie müssen veröffentlichen apple-app-site-association auf der Relying-Party-Domäne:

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

Beispiel:

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

Überprüfungsliste

1. Setzen origin und domains in plugins.CapacitorPasskey in capacitor.config.*.
2. Ausführen bunx cap sync.
3. Bestätigen Sie Ihre Apple-Team-ID und Ihre App-Bundle-ID, dann bauen Sie das TEAMID.bundleId Wert für die Verknüpfungsdatei.
4. Hosten apple-app-site-association mit HTTP 200 und kein .json Erweiterung.
5. Stellen Sie sicher, dass der von Ihrem Backend verwendete Relying-Party-Id mit dem zugehörigen Domain übereinstimmt.

Hinweise

• Die Website-Datei muss von dem genauen Passwort-Domain abgesendet werden, die Sie als Relying-Party-Id verwenden.
• Bei iOS 17.4 und neuer verwendet der Plugin den Browser-Style Client-Data API so das die konfigurierte HTTPS-Origin in clientDataJSON.
• Das Plugin kann native Projekt-Dateien während des Synchronisierens bearbeiten, kann jedoch keine oder die Website-Verbindung-Datei erstellen oder auf Ihrer Domain hosten.

Weiter von iOS Setup

Wenn Sie iOS Setup zur Planung der Authentifizierung und Account-Flows verwenden, verbinden Sie es mit Mit @capgo/capacitor-passkey für die native Fähigkeit in Mit @capgo/capacitor-passkey, @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 in Zwei-Faktor-Authentifizierung.