iOS-Einrichtung
Eine Einrichtungsvorlage mit den Installationsanweisungen und der vollständigen Markdown-Anleitung für diesen Plugin kopieren.
Bei iOS funktionieren Passkeys nur, wenn die App mit demselben Relying-Party-Domain verbunden ist wie die Website.
Was das Plugin handhabt
Abschnitt mit dem Titel „Was das Plugin handhabt“Nachdem Sie die Plugin-Konfiguration hinzugefügt und ausgeführt haben bunx cap sync, der Plugin passt den generierten iOS-Host-Projekt an, sodass Sie es nicht mehr manuell bearbeiten müssen:
- fütgt hinzu:
webcredentials:zugehörige Domains-Einträge für die konfigurierten Domains - schaltet
CODE_SIGN_ENTITLEMENTSwenn das generierte Appziel noch nicht auf eine Berechtigungsdatei verweist
Was Sie noch zum Hosting brauchen
Abschnitt mit dem Titel "Was Sie noch zum Hosting brauchen"Sie müssen veröffentlichen apple-app-site-association auf dem Relying-Party-Domain:
https://signin.example.com/.well-known/apple-app-site-associationBeispiel:
{ "webcredentials": { "apps": ["ABCDE12345.app.capgo.passkey.example"] }}Übersicht
Abschnitt mit Titel „Übersicht“- Einstellung
originunddomainsinplugins.CapacitorPasskeyincapacitor.config.*. - Ausführen
bunx cap sync. - Bestätigen Sie Ihre Apple-Team-ID und Ihre App-Bundle-ID, bevor Sie die App erstellen.
TEAMID.bundleIdHost - mit HTTP
apple-app-site-associationund kein200nein.jsonErweiterung. - Stellen Sie sicher, dass die von Ihrem Backend verwendete Relying-Party-ID mit der zugehörigen Domain übereinstimmt.
- Die Website-Datei muss von dem genauen Passkey-Domain ausgespielt werden, die Sie als Relying-Party-ID verwenden.
- Bei iOS 17.4 und neuer verwendet das Plugin den browserartigen Client-Daten API , sodass die konfigurierte HTTPS-Origin in
clientDataJSON. - Das Plugin kann native Projektdateien während des Synchronisierens bearbeiten, kann jedoch keine Website-Verknüpfungsdatei erstellen oder auf Ihrer Domain hosten.
Fortsetzen Sie mit iOS Setup
Abschnitt mit dem Titel “Fortsetzen Sie mit iOS Setup”Wenn Sie iOS Setup zur Planung von Authentifizierungs- und Konto-Flüssen verwenden, 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 Implementierungsdetails in @capgo/capacitor-Social-Login @capgo/capacitor-Passkey für die Implementierungsdetails in @capgo/capacitor-Passkey @capgo/capacitor-Native-Biometrik für die Implementierungsdetails in @capgo/capacitor-Native-Biometrik und Zwei-Faktor-Authentifizierung für die Implementierungsdetails in Zwei-Faktor-Authentifizierung.