Configuración de Android

En Android, las claves de acceso funcionan con tu sitio web cuando la aplicación y el dominio de la parte que confía están conectados a través de Activos Digitales Enlazados.

Qué maneja el plugin

Después de agregar la configuración del plugin y ejecutar bunx cap sync, el plugin parchea el proyecto de host de Android generado:

• inyecta el asset_statements metadatos de la manifestación
• escribe la cadena de recursos de cadena generada referenciada por ese metadato

¿Qué todavía necesitas para hospedar?

Debes publicar assetlinks.json en el dominio del partido de confianza:

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

Ejemplo:

[
  {
    "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

1. Set origin y domains en plugins.CapacitorPasskey en capacitor.config.*.
2. Ejecutar bunx cap sync.
3. Utilice su nombre de paquete de Android real en assetlinks.json.
4. Agrega cada huella de certificado de firma que necesites, incluyendo claves de firma de depuración o interna si pruebas esas compilaciones.
5. Alcance el archivo en el mismo dominio que utiliza como ID de parte confiable.

Important behavior difference from a browser

Con Digital Asset Links configurados, Android puede utilizar el mismo partido de confianza y claves de acceso como su 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
• La afirmación de origen puede estar vinculada a la firma de la aplicación Android en lugar de tu origen de sitio web.
• Si su servidor de backend valida estrictamente clientDataJSON.origin, acepte el origen de la aplicación Android junto al origen del sitio web.

Siga adelante desde la configuración de Android

Si está utilizando Configuración de Android para planificar flujos de autenticación y cuentas, conecte con Usando @capgo/capacitor-passkey para la capacidad nativa en Usando @capgo/capacitor-passkey, @capgo/capacitor-login-social para el detalle de implementación en @capgo/capacitor-social-login, @capgo/capacitor-clave de acceso para el detalle de implementación en @capgo/capacitor-passkey, @capgo/capacitor-nativo-biometria para el detalle de implementación en @capgo/capacitor-native-biometric, y Dos factores de autenticación para el detalle de implementación en Dos factores de autenticación.