iOS-Setup

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

Was das Plugin übernimmt

After you add the plugin config and run bunx cap syncdas Plugin patcht das generierte iOS-Hostprojekt automatisch, sodass du es nicht mehr manuell bearbeiten musst:

• fügt den webcredentials: Associated-Domains-Einträge für die konfigurierten Domains
• Verdrahtungen CODE_SIGN_ENTITLEMENTS wenn das generierte App-Target noch nicht auf eine Entitlements-Datei verweist

Was du noch selbst hosten musst

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

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

Beispiel:

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

Checkliste

1. Setzen Sie origin und domains in plugins.CapacitorPasskey in 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.

Notizen

• Die Website-Datei muss exakt von der Passkey-Domain bereitgestellt 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-Association-Datei nicht auf Ihrer Domain erstellen oder hosten.

Weiter mit dem iOS-Setup

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.