Zum Inhalt springen

iOS-Einrichtung

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

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 dem webcredentials: die zugehörigen Domains-Einträge für die konfigurierten Domains
  • wirkt CODE_SIGN_ENTITLEMENTS wenn die generierte App-Ziel nicht bereits auf ein Berechtigungsdatei verweist

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

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

Beispiel:

{
"webcredentials": {
"apps": ["ABCDE12345.app.capgo.passkey.example"]
}
}
  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 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 dem zugehörigen Domain entspricht.
  • Die Website-Datei muss von dem genauen Passwort-Domain, die Sie als Relying-Party-Id verwenden, ausgeserviert werden.
  • Bei iOS 17.4 und neuer verwendet das Plugin den browser-stiligen 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 Website-Verbindung-Datei erstellen oder auf Ihrer Domain hosten.