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, las 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 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:
- inyecta el
asset_statementsmetadatos del manifiesto - escribe la cadena de recursos de cadena generada que se referencia por ese metadato
¿Qué todavía necesita para alojar?
Sección titulada “Lo que todavía necesitas para 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
originydomainsenplugins.CapacitorPasskeyencapacitor.config.*. - Ejecutar
bunx cap sync. - Utiliza tu nombre de paquete de Android real en
assetlinks.json. - Agrega cada huella de firma de certificado que necesites, incluyendo claves de firma de depuración o internas si pruebas esos builds.
- Alquila el archivo en el mismo dominio que usas como ID de entidad de confianza.
Importante diferencia de comportamiento con respecto a un navegador
Sección titulada “Importante diferencia de comportamiento con respecto a un navegador”Con Digital Asset Links configurados, Android puede utilizar la misma entidad de confianza y claves de inicio de sesión como tu sitio web. La diferencia restante es el origen literal informado en nativo clientDataJSON.
- Una aplicación de Android normal no se comporta como un navegador privilegiado.
- El origen de la afirmación puede estar ligado a la firma de la aplicación de Android en lugar del origen del sitio web.
- Si tu back-end valida estrictamente
clientDataJSON.origin, acepta el origen de la aplicación de Android junto con el origen del sitio web.