iOS-Einrichtung

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

Was das Plugin handhabt

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

• fütgt das webcredentials: fütgt die zugehörigen Domänen-Einträge für die konfigurierten Domänen
• schaltet CODE_SIGN_ENTITLEMENTS wenn das generierte App-Ziel nicht bereits auf eine Berechtigungsdatei verweist

Was Sie noch hosten müssen

Sie müssen veröffentlichen apple-app-site-association auf dem vertrauenswördigen Domänenname:

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

Beispiel:

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

Checkliste

1. Einstellung origin und domains auf plugins.CapacitorPasskey auf 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. Host apple-app-site-association mit HTTP 200 und keine .json Erweiterung.
5. Stellen Sie sicher, dass die von Ihrem Backend verwendete Relying-Party-ID mit der zugehörigen Domain übereinstimmt.

Hinweise

• Die Website-Datei muss von dem genauen Passkey-Domain abgerufen werden, die Sie als Relying-Party-ID verwenden.
• Bei iOS 17.4 und neuer verwendet das Plugin den Browser-Client-Daten-Typ API so dass die konfigurierte HTTPS-Origin in clientDataJSON.
• Das Plugin kann native Projektdateien während des Synchronisierungsprozesses bearbeiten, kann jedoch keine Website-Verknüpfungsdatei erstellen oder hosten.

Weiter zum iOS Setup

Wenn Sie iOS Setup zur Planung von Authentifizierungs- und Kontoflüssen verwenden, verbinden Sie es mit Mit @capgo/capacitor-passkey für die native Fähigkeit in Verwendung von @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.