Configuración de iOS
Copia un prompt de configuración con los pasos de instalación y la guía de markdown completa para este plugin.
En iOS, las claves de acceso solo funcionan cuando la aplicación está asociada con el mismo dominio de la parte que confía como el sitio web.
¿Qué maneja el plugin?
Sección titulada “¿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 iOS generado para que no debas editar manualmente:
- añade las
webcredentials:entradas de dominios asociados para los dominios configurados - conecta
CODE_SIGN_ENTITLEMENTScuando el objetivo de aplicación generado no apunta ya a un archivo de permisos
Lo que todavía debes hospedar
Título de la sección “Lo que todavía debes hospedar”Debes publicar apple-app-site-association en el dominio de la parte que confía:
https://signin.example.com/.well-known/apple-app-site-associationEjemplo:
{ "webcredentials": { "apps": ["ABCDE12345.app.capgo.passkey.example"] }}Revisar lista de verificación
Sección titulada “Revisar lista de verificación”- Configuración
originydomainsenplugins.CapacitorPasskeyencapacitor.config.*. - Ejecutar
bunx cap sync. - Confirmar su ID de equipo de Apple y el ID de paquete de la aplicación, luego construya el
TEAMID.bundleIdvalor para el archivo de asociación. - Huésped
apple-app-site-associationcon HTTP200y no.jsonextensión. - Asegúrese de que el identificador 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 de passkey exacto que utiliza como identificador de la parte que confía.
- En iOS 17.4 y posteriores, el complemento utiliza el cliente de datos de 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.
Siga adelante desde Configuración de iOS
Sección titulada “Siga adelante desde Configuración de iOS”Si está utilizando Configuración de iOS para planificar flujos de autenticación y cuentas, conectéalo 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.