Configurazione Android
Copia una richiesta di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.
Sui dispositivi Android, le chiavi passkey funzionano con il tuo sito web quando l'app e il dominio di riferimento sono collegati attraverso i Digital Asset Links.
Cosa il plugin gestisce
Sezione intitolata “Cosa il plugin gestisce”Dopo aver aggiunto la configurazione del plugin e aver eseguito bunx cap syncil plugin integra il progetto host Android generato:
- inserisce il
asset_statementsi metadati del manifesto - scrive la stringa di risorse generata riferita a quel metadato
Ciò che ancora devi ospitare
Sezione intitolata “Ciò che ancora devi ospitare”Devi pubblicare assetlinks.json sulla domain del partito di riferimento:
https://signin.example.com/.well-known/assetlinks.jsonEsempio:
[ { "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" ] } }]Checklist
Sezione intitolata “Checklist”- Configura
originedomainseplugins.CapacitorPasskeyEseguicapacitor.config.*. - Utilizza il tuo nome pacchetto Android reale in
bunx cap sync. - Aggiungi ogni impronta di certificato di firma che hai bisogno, compresi i chiavi di firma di debug o interna se testi quei build.
assetlinks.json. - 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 Digital Asset Links configurati, Android può utilizzare la stessa parte che si fida e le chiavi passkey come il tuo sito web. La differenza rimanente è l'origine letterale riportata in nativoUn'app Android normale non si comporta come un browser privilegiato. clientDataJSON.
- Set
- La origine dell'asserzione può essere legata alla firma dell'app Android al posto dell'origine del tuo sito web.
- Se il tuo backend verifica rigorosamente
clientDataJSON.originaccetta l'origine dell'app Android accanto all'origine del sito web.
Continua da Android Setup
Sottosezione intitolata “Continua da Android Setup”Se stai utilizzando Android Setup per pianificare l'autenticazione e le flussi di account, connettilo con Utilizza @capgo/capacitor-passkey per la capacità nativa in Utilizza @capgo/capacitor-passkey @capgo/capacitor-social-login per la dettaglio di implementazione in @capgo/capacitor-social-login @capgo/capacitor-passkey per i dettagli di implementazione in @capgo/capacitor-passkey @capgo/capacitor-native-biometric per i dettagli di implementazione in @capgo/capacitor-native-biometric, e Autenticazione a due fattori per i dettagli di implementazione in Autenticazione a due fattori