Android-Einrichtung

Bei Android-Geräten funktionieren Passkeys mit Ihrer Website, wenn die App und der Relying-Party-Domain über digitale Asset-Links verbunden sind.

Was das Plugin bearbeitet

After you add the plugin config and run bunx cap sync, wird das Plugin den generierten Android-Host-Projekt bearbeitet:

• injectiert die asset_statements Manifest-Metadaten
• schreibt die generierte Zeichenfolgenressource, die durch diese Metadaten referenziert wird

Was Sie noch zum Hosting benötigen

Sie müssen veröffentlichen assetlinks.json Auf die Zwischenablage kopieren

https://signin.example.com/.well-known/assetlinks.json

Abschnitt

[
  {
    "relation": [
      "delegate_permission/common.handle_all_urls",
      "delegate_permission/common.get_login_creds"
    ],
    "target": {
      "namespace": "android_app",
      "package_name": "app.capgo.passkey.example",
      "sha256_cert_fingerprints": [
        "AA:BB:CC:DD:EE:FF:00:11:22:33:44:55:66:77:88:99:AA:BB:CC:DD:EE:FF:00:11:22:33:44:55:66:77:88:99"
      ]
    }
  }
]

Checkliste

1. Setze origin und domains in plugins.CapacitorPasskey in capacitor.config.*.
2. Ausführen bunx cap sync.
3. Verwende Ihren echten Android-Paketnamen assetlinks.json.
4. Füge alle erforderlichen Signaturzertifikatsfingerabdrücke hinzu, einschließlich von Debug- oder internen Signierungschlüsseln, wenn Sie diese Builds testen.
5. Hosten Sie das Datei auf demselben Domain, die Sie als Relying-Party-ID verwenden.

Wichtige Verhaltensunterschied zu einem Browser

Mit Digital Asset Links konfiguriert, kann Android denselben Relying-Party und Passkeys wie Ihre Website verwenden. Der verbleibende Unterschied ist die wörtliche Ursprungsmeldung in der native clientDataJSON.

• Ein normales Android-App verhält sich nicht wie ein privilegierter Browser.
• Die Behauptung des Ursprungs kann an die Signatur der Android-App anstatt an die Ursprungsmeldung Ihrer Website gebunden werden.
• Wenn Ihr Backend streng die Validierung clientDataJSON.origin, akzeptieren Sie die Android-App-Quelle neben der Website-Quelle.

Fortsetzen Sie mit Android Setup

Wenn Sie Android Setup Android-Einrichtung um Authentifizierung und Kontoflows zu planen, verbinden Sie es mit Verwendung von @capgo/capacitor-Passkey für die native Fähigkeit in Verwenden Sie @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-biometrisch für die Implementierungsdetails in @capgo/capacitor-native-biometric und Zwei-Faktor-Authentifizierung für die Implementierungsdetails in Zwei-Faktor-Authentifizierung