iOS Setup

On iOS, passkeys 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?

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:

• 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

¿Qué todavía debes alojar?

Debes publicar apple-app-site-association en el dominio del partido confiable:

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

Ejemplo:

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

Checklist

1. Establecer 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 construya el TEAMID.bundleId valor para el archivo de asociación.
4. Host apple-app-site-association con HTTP 200 y sin .json extensión.
5. Asegúrate de que el ID de la parte que confía utilizado por tu backend coincida con el dominio asociado.

Notas

• El archivo del sitio web debe ser servido desde el dominio de passkey exacto que se utiliza como ID de parte que confía.
• En iOS 17.4 y versiones posteriores, el plugin utiliza el cliente de datos estilo navegador 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.

Sigue adelante desde Configuración de iOS

Si estás utilizando iOS Setup para planificar la autenticación y los flujos de cuenta, conecta con Usando @capgo/capacitor-passkey para la capacidad nativa en Usando @capgo/capacitor-passkey @capgo/capacitor-iniciodeiniciodeiniciodeautenticación 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 Autenticación de dos factores para los detalles de implementación de Autenticación de dos factores.