Saltar al contenido

Configuración de iOS

GitHub

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 syncla extensión parchea el proyecto de host de iOS generado para que no debas editar manualmente:

  • agrega las 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. Configurar origin y domains en plugins.CapacitorPasskey en capacitor.config.*.
  2. Ejecutar bunx cap sync.
  3. Confirmar su ID de equipo de Apple y su ID de paquete de aplicación, luego construya el TEAMID.bundleId valor para el archivo de asociación.
  4. Huésped 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 servidor de backend coincida con el dominio asociado.
  • El archivo de sitio web debe ser servido desde el dominio de passkey exacto que utiliza como ID de la parte que confía.
  • En iOS 17.4 y posteriores, el plugin utiliza el cliente de datos de navegador estilo API por lo que el origen HTTPS configurado se refleja en clientDataJSON.
  • El plugin puede parchear archivos de proyecto nativos durante la sincronización, pero no puede crear ni alojar el archivo de asociación de sitio web en su dominio.

Si está utilizando Configuración de iOS 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-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-native-biometric 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.