Saltar al contenido principal
La autenticación es nueva: didit_auth varía según la versión. Aquí no se confirman las coordenadas de distribución, las versiones ni las firmas de las funciones invocables. No instales un paquete supuesto ni uses el SDK de verificación de identidad como SDK de Autenticación.

​
Prepara la aplicación

  1. Confirma que Autenticación está habilitada para tu aplicación de Didit y copia su origen de inicio de sesión (https://<slug>.auth.didit.me, o <slug>.sandbox.auth.didit.me para sandbox) desde la consola.
  2. Registra una URL de callback exacta que admitan tu aplicación y el entorno de ejecución. Valida la titularidad de los app links; no des por hecho que se aceptan esquemas de URL personalizados arbitrarios.
  3. Mantén separadas la configuración de sandbox y la de producción, incluidos el manejo de callbacks y las credenciales almacenadas.
  4. Define cómo asignarás de forma estable a cada persona antes de conectar la verificación o la monitorización.
Configura y prueba los enlaces de callback por separado en iOS y Android. El wrapper de Autenticación es independiente de didit_sdk, que se encarga de la verificación.

​
Implementa el flujo alojado

Abre el navegador de autenticación nativo del sistema con la URL {origin}/sign-in. Proporciona un state aleatorio nuevo, un desafío PKCE S256 y tu redirect_uri registrado. Conserva el verificador en tu app solo para ese intento. La guía rápida de JavaScript muestra el protocolo subyacente; en código nativo, usa la criptografía y el manejo de URL de la plataforma en lugar de objetos globales del navegador. Al recibir el callback, verifica el state, la vigencia de la transacción y el destino del callback antes de canjear el código de un solo uso en token/. Usa el verificador original y la URI de redirección exacta. Cancelar o cerrar el navegador no es un inicio de sesión exitoso. Guarda los refresh tokens en el almacenamiento protegido nativo de la plataforma; nunca en un archivo de preferencias no protegido, en analíticas ni en registros de fallos. Valida la sesión actual con GET session/ usando el token Bearer del usuario final. Serializa la renovación, reemplaza ambos tokens a la vez y borra el estado específico del usuario tras cerrar sesión. Consulta tokens y JWKS para ver el contrato de la solicitud y el comportamiento ante la reutilización del refresh token.

​
Vista previa del lanzamiento del SDK nativo

Está previsto que los módulos nativos de Autenticación ofrezcan inicio de sesión, acceso a la sesión actual, obtención de tokens, cierre de sesión y autenticación reforzada (step-up), con señales del dispositivo recopiladas automáticamente. Las passkeys nativas y el almacenamiento protegido de tokens forman parte de ese lanzamiento. Las API del wrapper seguirán los contratos publicados de cada plataforma; no copies argumentos de constructor ni firmas de métodos deducidos de un ejemplo de diseño. Hasta que se lance el módulo, mantén su adaptador desactivado o usa una implementación revisada del protocolo alojado para tu aplicación habilitada. No anuncies una guía de inicio rápido funcional de Autenticación nativa basada únicamente en la instalación del paquete.

​
Conecta la verificación y la monitorización

Tu backend deriva vendor_data de la persona autenticada. Crea sesiones de verificación o emite tokens de monitorización con alcance limitado para esa persona. Devuelve a tu app únicamente la credencial de la sesión o el token con alcance limitado; la clave de API permanece en el servidor. Usa el SDK de verificación para Flutter cuando necesites verificación de identidad. Sigue Envío de transacciones desde el SDK para el soporte de monitorización en tu plataforma. Trata por separado las decisiones de inicio de sesión, de verificación y de transacciones.

​
Verifica la integración

Prueba el regreso a la app tras un arranque en frío, las transiciones al segundo plano y al primer plano, la cancelación del navegador, un callback que no coincide, la reutilización del código, la expiración del token, la actualización concurrente, MFA, el cierre de sesión y el inicio de sesión como otro usuario. Prueba el registro de passkeys y el inicio de sesión en dispositivos compatibles cuando ese lanzamiento esté disponible. Una comprobación que solo se puede hacer en el dispositivo sigue sin verificarse hasta que se ejecuta en la plataforma de destino.
Última modificación el 1 de noviembre de 2026