Android-Setup

Unter Android funktionieren Passkeys mit deiner Website, wenn die App und die Relying-Party-Domain über Digital Asset Links verknüpft sind.

Was das Plugin übernimmt

After you add the plugin config and run bunx cap sync, patcht das Plugin das generierte Android-Host-Projekt:

• injiziert den asset_statements Manifest-Metadaten
• schreibt die referenzierte String-Resource aus den Metadaten

Was du noch selbst hosten musst

Sie müssen veröffentlichen assetlinks.json auf der Relying-Party-Domain:

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

Beispiel:

[
  {
    "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. Setzen Sie origin und domains in plugins.CapacitorPasskey in capacitor.config.*.
2. Ausführen bunx cap sync.
3. Verwende deinen echten Android-Package-Namen in assetlinks.json.
4. Füge alle benötigten Signing-Certificate-Fingerprints hinzu, einschließlich Debug- oder internen Signing-Keys, falls du diese Builds testest.
5. Hoste die Datei auf derselben Domain, die du als Relying-Party-ID verwendest.

Wichtiger Verhaltensunterschied zu Browsern

Wenn Digital Asset Links konfiguriert sind, kann Android dieselbe Relying Party und dieselben Passkeys wie deine Website nutzen. Der verbleibende Unterschied ist die exakte Origin, die nativ gemeldet wird. clientDataJSON.

• Eine normale Android-App verhält sich nicht wie ein privilegierter Browser.
• Die Assertion-Origin kann an die Android-App-Signatur statt an deine Website-Origin gebunden werden.
• Wenn dein Backend strikte Validierungen nutzt, clientDataJSON.originakzeptiere die Android-App-Origin zusätzlich zur Website-Origin.

Weiter mit dem Android-Setup

Wenn du es nutzt Android-Setup Um Authentifizierungs- und Account-Flows zu planen, verbinde es mit @capgo/capacitor-passkey verwenden für die native Funktion in „@capgo/capacitor-passkey verwenden“, @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-biometric für die Implementierungsdetails in @capgo/capacitor-native-biometric, und Zwei-Faktor-Authentifizierung für die Implementierungsdetails zur Zwei-Faktor-Authentifizierung.