iOS-Einrichtung

Auf iOS funktionieren Passkeys nur, wenn die App mit demselben Relying-Party-Domänen als die Website verbunden ist.

Was das Plugin handhabt

After you add the plugin config and run bunx cap sync, wird das Plugin die generierte iOS-Host-Projekt so anpasst, dass Sie es nicht mehr manuell bearbeiten müssen:

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

Was Sie noch zum Hosting benötigen

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

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. 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 ohne .json Erweiterung.
5. Stellen Sie sicher, dass der von Ihrem Backend verwendete Relying-Party-Id der zugehörigen Domain entspricht.

Hinweise

• Die Website-Datei muss von dem genauen Passkey-Domain ausgespielt werden, die Sie als Relying-Party-Id verwenden.
• Auf iOS 17.4 und neuer verwendet das Plugin den browser-stiligen Client-Daten API , sodass der konfigurierte HTTPS- Ursprung im clientDataJSON.
• Der Plugin kann native Projektdateien während der Synchronisation anpassen, kann jedoch keine Website-Verbindung-Datei erstellen oder auf Ihrer Domain hosten.

Fortsetzen von iOS Setup

Wenn Sie Capgo verwenden iOS-Einrichtung um die Authentifizierung und die Kontenflüsse zu planen, verbinden Sie es mit Mit @capgo/capacitor-Passkey für die native Fähigkeit in Mit @capgo/capacitor-Passkey, @capgo/capacitor-Social-Login für die Implementierungsdetail in @capgo/capacitor-Passkey @capgo/capacitor-Passkey für die Implementierungsdetail in @capgo/capacitor-Native-Biometrik, und @capgo/capacitor-native-biometrisch für die Implementierungsdetails in @capgo/capacitor-native-biometrisch, und @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-Passkey für die native Fähigkeit in @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-Passkey,