Configuración de Android
Copie un prompt de configuración con los pasos de instalación y la guía de markdown completa para este plugin.
En Android, los claves de acceso funcionan con su sitio web cuando la aplicación y el dominio de la parte que confía están conectados a través de los enlaces de activos digitales.
¿Qué maneja el complemento?
Sección titulada “¿Qué maneja el complemento?”Después de agregar la configuración del complemento y ejecutar bunx cap syncel complemento parchea el proyecto de host de Android generado:
- injecta el
asset_statementsmetadatos de manifest - escribe la cadena de recursos generada referenciada por esa metadata
Lo que todavía necesitas alojar
Sección titulada “Lo que todavía necesitas alojar”Debes publicar assetlinks.json en el dominio de la parte que confía:
https://signin.example.com/.well-known/assetlinks.jsonEjemplo:
[ { "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" ] } }]Lista de verificación
Sección titulada “Lista de verificación”- Establecer
originydomainsInplugins.CapacitorPasskeyIncapacitor.config.*. - Ejecutar
bunx cap sync. - Utiliza tu nombre de paquete Android real en
assetlinks.json. - Agrega cada huella de certificado de firma que necesites, incluyendo claves de firma de depuración o internas si pruebas esas compilaciones.
- Alquila el archivo en el mismo dominio que usas como ID de la parte que confía.
Diferencia importante de comportamiento con respecto a un navegador
Sección titulada “Diferencia importante de comportamiento con respecto a un navegador”Con Digital Asset Links configurados, Android puede utilizar la misma parte que confía y claves de acceso como tu sitio web. La diferencia restante es el origen literal informado en nativo clientDataJSON.
- Una aplicación Android normal no se comporta como un navegador privilegiado.
- El origen de la afirmación se puede vincular a la firma de la aplicación Android en lugar del origen de tu sitio web.
- Si tu backend valida estrictamente
clientDataJSON.originacepta el origen de la aplicación Android junto con el origen del sitio web.
Sigue desde Configuración de Android
Sección titulada “Sigue desde Configuración de Android”Si estás utilizando Configuración de Android para planificar flujos de autenticación y cuentas, conecta con Usando @capgo/capacitor-passkey para la capacidad nativa en Usando @capgo/capacitor-passkey, @capgo/capacitor-social-login para el detalle de implementación en @capgo/capacitor-social-login, @capgo/capacitor-passkey para el detalle de implementación en @capgo/capacitor-passkey, @capgo/capacitor-autenticación-biográfica nativa para el detalle de implementación en @capgo/capacitor-autenticación-biográfica nativa, y Autenticación de dos factores para el detalle de implementación en Autenticación de dos factores.