iOS Setup

Bei iOS funktionieren Passwörter nur, wenn die App mit demselben Relying-Party-Domänenbereich wie die Website verbunden ist.

Was der Plugin-Plugin handhabt

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

• fügt die webcredentials: zugehörigen Domänen-Einträge für die konfigurierten Domänen hinzu
• Drähte CODE_SIGN_ENTITLEMENTS Wenn die generierte App-Zieladresse nicht bereits auf eine Berechtigungsdatei verweist

Was Sie noch zum Hosten benötigen

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. Konfigurieren origin und domains im plugins.CapacitorPasskey im capacitor.config.*.
2. Starten bunx cap sync.
3. Bestätigen Sie Ihre Apple-Team-ID und App-Bundle-ID, dann bauen Sie das TEAMID.bundleId Wert für die Verbindungsdosierdatei.
4. Host apple-app-site-association mit HTTP 200 und kein .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 Passwort-Domain abgerufen werden, die Sie als Relying-Party-ID verwenden.
• Bei iOS 17.4 und neuer verwendet der Plugin den browser-stiligen Client-Daten API so das die konfigurierte HTTPS-Origin in clientDataJSON.
• Das Plugin kann native Projektdateien während der Synchronisierung anpassen, kann jedoch keine Website-Verknüpfungsdatei erstellen oder auf Ihrer Domain hosten.

Fortsetzen von iOS-Einrichtung

Wenn Sie " iOS-Einrichtung " zur Planung der Authentifizierung und Kontoflows verwenden, verbinden Sie es mit " Mit @capgo/capacitor-Passwort " für die native Fähigkeit in "Mit @capgo/capacitor-Passwort", @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 Zweifaktor-Authentifizierung für die Implementierungsdetails in Zweifaktor-Authentifizierung.