Saltare al contenuto

Configurazione Android

GitHub

I passkey funziona con il tuo sito web su Android quando l'app e il dominio di fiducia sono collegati attraverso i Digital Asset Links.

After you add the plugin config and run bunx cap sync, il plugin integra il progetto host Android generato:

  • inietta i asset_statements metadati del manifesto
  • scrive la risorsa di stringa generata riferita a quel metadato

Devi pubblicare assetlinks.json su il dominio del partito di riferimento:

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

Esempio:

[
{
"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"
]
}
}
]
  1. Configura origin e domains in plugins.CapacitorPasskey in capacitor.config.*.
  2. Esegui bunx cap sync.
  3. Utilizza il tuo nome del pacchetto Android reale in assetlinks.json.
  4. Aggiungi ogni impronta di certificato di firma necessaria, compresi i chiavi di firma di debug o interna se testi quei build.
  5. Ospita il file sullo stesso dominio che utilizzi come ID di parte che si fida.

Importante differenza di comportamento rispetto a un browser

Sezione intitolata “Importante differenza di comportamento rispetto a un browser”

Con le Digital Asset Links configurate, Android può utilizzare lo stesso partito di fiducia e le chiavi passkey come il tuo sito web. La differenza rimanente è l'origine letterale riportata in nativo clientDataJSON.

  • Un'app Android normale non si comporta come un browser privilegiato.
  • L'origine dell'asserzione può essere legata alla firma dell'app Android al posto dell'origine del sito web.
  • Se il tuo backend verifica rigorosamente clientDataJSON.originaccetta l'origine dell'app Android accanto all'origine del sito web.

Se stai utilizzando Configurazione Android per pianificare l'autenticazione e le flussi di account, connettilo con Utilizza @capgo/capacitor-passkey per la capacità nativa in Utilizza @capgo/capacitor-passkey, Social Login @capgo/capacitor per i dettagli di implementazione in Social Login @capgo/capacitor Passkey @capgo/capacitor per i dettagli di implementazione in Passkey @capgo/capacitor Autenticazione nativa @capgo/capacitor per i dettagli di implementazione in Autenticazione nativa @capgo/capacitor e Autenticazione a due fattori per i dettagli di implementazione in Autenticazione a due fattori.