iOS Setup

En iOS, las passkeys solo funcionan si la app está asociada al mismo dominio de la relying-party que el sitio web.

Lo que gestiona el plugin

Tras añadir la configuración del plugin y ejecutar bunx cap sync, el plugin parchea el proyecto host de iOS generado para que no tengas que editarlo manualmente:

• añade el webcredentials: entradas de dominios asociados para los dominios configurados
• cables CODE_SIGN_ENTITLEMENTS cuando el target de la app generada no apunta ya a un archivo de entitlements

Lo que aún debes alojar

Debes publicar apple-app-site-association en el dominio de la parte confiable:

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

Ejemplo:

{
  "webcredentials": {
    "apps": ["ABCDE12345.app.capgo.passkey.example"]
  }
}

Checklist

1. Configurar origin y domains en plugins.CapacitorPasskey en capacitor.config.*.
2. Ejecuta bunx cap sync.
3. Confirma tu Apple Team ID y el bundle ID de la app, luego genera el TEAMID.bundleId valor para el archivo de asociación.
4. Aloja apple-app-site-association con HTTP 200 y sin .json extensión.
5. Asegúrate de que el relying-party ID de tu backend coincida con el dominio asociado.

Notas

• El archivo del sitio web debe servirse desde el dominio exacto de passkey que uses como relying-party ID.
• En iOS 17.4 y versiones posteriores, el plugin utiliza el client-data API estilo navegador para que el origen HTTPS configurado se refleje en clientDataJSON.
• El plugin puede parchear archivos del proyecto nativo durante el sync, pero no puede crear ni alojar el archivo de asociación del sitio web en tu dominio.

Continúa desde iOS Setup

Si estás usando iOS Setup para planificar los flujos de autenticación y de cuenta, conéctalo con Uso de @capgo/capacitor-passkey para la capacidad nativa en Uso de @capgo/capacitor-passkey, @capgo/capacitor-social-login para los detalles 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 Autenticación de dos factores para el detalle de implementación en la autenticación de dos factores.