iOS Einrichtung

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

Was der Plugin verarbeitet

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ügt die webcredentials: verbundene Domänen-Einträge für die konfigurierten Domains hinzu
• verbindet CODE_SIGN_ENTITLEMENTS wenn das generierte App-Target nicht bereits auf ein Entitlements-Datei 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. Setzen origin und domains in plugins.CapacitorPasskey in capacitor.config.*.
2. Run bunx cap sync.
3. Bestätigen Sie Ihren Apple-Team-IDs und App-Bundle-IDs, dann bauen Sie das TEAMID.bundleId __CAPGO_KEEP_0__
4. Host apple-app-site-association mit HTTP 200 und keine .json Erweiterung.
5. Stellen Sie sicher, dass der von Ihrem Backend verwendete Relying-Party-Id mit dem zugeordneten Domain übereinstimmt.

Hinweise

• Die Website-Datei muss von dem genauen Passwort-Domain abgeleitet werden, die Sie als Relying-Party-Id verwenden.
• Auf iOS 17.4 und neuer verwendet das Plugin den browserartigen Client-Daten-API so dass die konfigurierte HTTPS-Origin im clientDataJSON.
• Das Plugin kann native Projektdateien während der Synchronisierung anpassen, kann jedoch keine Website-Verknüpfungsdatei erstellen oder auf Ihrem Domain hosten.