Installazione di Android
Copia un prompt 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
Sottosezione intitolata “Cosa il plugin gestisce”Dopo aver aggiunto la configurazione del plugin e aver eseguito bunx cap sync, il plugin patcha il progetto host Android generato:
- inietta i
asset_statementsmetadati del manifesto - scrive la risorsa di stringa generata riferita a quel metadato
Cosa ancora devi ospitare
Sezione intitolata “Cosa ancora devi ospitare”Devi pubblicare assetlinks.json sulla dominio 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
originedomainsinplugins.CapacitorPasskeyincapacitor.config.*. - Esegui
bunx cap sync. - Utilizza il tuo nome del pacchetto Android reale in
assetlinks.json. - Aggiungi ogni impronta della chiave di firma necessaria, compresi i chiavi di firma di debug o di interna se testi quei build.
- Hosta il file sullo stesso dominio che utilizzi come ID del partner di fiducia.
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 lo stesso partner di fiducia e le chiavi passkey come il tuo sito web. La differenza rimanente è l'origine letterale riportata nativa clientDataJSON.
- A 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 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 le autenticazioni 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 i dettagli di implementazione in @capgo/capacitor-login-social @capgo/capacitor-passkey per i dettagli di implementazione in @capgo/capacitor-passkey @capgo/capacitor-biometric-nativo per i dettagli di implementazione in @capgo/capacitor-biometric-nativo, e Autenticazione a due fattori per i dettagli di implementazione in Autenticazione a due fattori.