Ir al contenido

Configuración de iOS

En iOS, las claves de paso solo funcionan cuando la aplicación está asociada con el mismo dominio de la parte que confía como el sitio web.

Después de agregar la configuración del plugin y ejecutar bunx cap sync, el plugin parchea el proyecto de host iOS generado para que no debas editar manualmente:

  • añade los webcredentials: entradas de dominios asociados para los dominios configurados
  • conecta CODE_SIGN_ENTITLEMENTS cuando el objetivo de aplicación generado no apunta ya a un archivo de permisos

Debes publicar apple-app-site-association en el dominio de la parte que confía:

https://signin.example.com/.well-known/apple-app-site-association

Ejemplo:

{
"webcredentials": {
"apps": ["ABCDE12345.app.capgo.passkey.example"]
}
}
  1. Configuración origin y domains en plugins.CapacitorPasskey en capacitor.config.*.
  2. Ejecutar bunx cap sync.
  3. Confirme su ID de equipo de Apple y su ID de paquete de aplicación, luego genere el TEAMID.bundleId valor para el archivo de asociación.
  4. Servidor apple-app-site-association con HTTP 200 y sin .json extensión.
  5. Asegúrese de que el ID de la parte que confía utilizado por su backend coincida con el dominio asociado.
  • El archivo del sitio web debe ser servido desde el dominio exacto de la clave de paso que utiliza como ID de la parte que confía.
  • En iOS 17.4 y posteriores, el complemento utiliza el cliente de datos del navegador estilo API por lo que el origen HTTPS configurado se refleja en clientDataJSON.
  • El complemento puede parchear archivos de proyecto nativos durante la sincronización, pero no puede crear ni alojar el archivo de asociación del sitio web en su dominio.