Saltar al contenido principal
Esta guía explica cómo funciona una integración de Didit Authentication en producción, desde la primera redirección hasta la lista de verificación para el paso a producción. Si todavía no has autenticado a ninguna persona, empieza por la guía de inicio rápido, y usa las guías de inicio rápido de cada plataforma para ver el código de cada SDK.

Arquitectura

Intervienen cuatro partes: Nunca debe haber una clave de API de Didit ni ningún secreto en tu aplicación: la clave publicable es pública, y el intercambio de código está protegido por PKCE en lugar de por un secreto de cliente.

Páginas alojadas o tus propias pantallas

Elige dónde las personas escriben su correo electrónico, contraseña o código. La configuración es sign_in_ui (hosted por defecto, u own), y puedes cambiarla más adelante. Las passkeys pertenecen al origen de inicio de sesión de tu aplicación. Los métodos de passkeys de los SDK solo funcionan en páginas servidas desde ese origen, así que en tus propias pantallas, si están en otro dominio, envía a las personas a la página alojada para usar passkeys.

Elige tu SDK

Si no usas un SDK, implementa tú mismo el flujo de código de autorización con PKCE: la guía de inicio rápido de JavaScript muestra el contrato completo.

Protege tu backend

Una comprobación de sesión en el frontend solo controla lo que muestras. Tu backend toma cada decisión a partir de un token verificado.
  1. Verifica el token de acceso en cada solicitud. Comprueba la firma ES256 con el JWKS de tu emisor y, después, iss, aud, exp y typ: at+jwt. Rechaza un token cuyo act no sea null, salvo que la ruta acepte agentes de IA. Consulta cómo verificar un token en tu servidor.
  2. Comprueba la sesión activa antes de una acción sensible. Un token de acceso sigue siendo válido hasta que expira, como máximo 5 minutos. GET /session/ falla de inmediato cuando la sesión fue revocada, quedó inactiva o expiró, cuando la persona fue bloqueada o cuando la sesión ya no cumple tu política de MFA. Consulta cómo comprobar la sesión.
  3. Solicita una verificación adicional cuando la acción sea arriesgada. Antes de un pago, de una nueva cuenta bancaria o de un cambio de correo electrónico o de teléfono, pregunta a Didit si la persona tiene que volver a verificarse, y actúa solo con una verificación adicional approved que tu backend haya leído por sí mismo. Consulta verificación adicional antes de acciones sensibles.
  4. Toma vendor_data del token verificado, nunca de un campo que haya enviado el navegador, y úsalo para las verificaciones y las transacciones de la persona.

Sesiones

Cambia las duraciones en Authentication > Security and sessions, o por API en la configuración de la aplicación.
La vista Active sessions de Didit Business Console, con las sesiones iniciadas, su dispositivo, ubicación, inicio, última actividad, fin y un botón Revoke

Authentication > Sign-ins > Active sessions, con Revoke en cada sesión.

Aplicaciones nativas

Didit devuelve a las personas a una aplicación nativa solo mediante una redirección HTTPS: no acepta esquemas de URL personalizados.
  • iOS: haz que la redirección sea un dominio asociado, con webcredentials en tu apple-app-site-association.
  • Android: haz que la redirección sea un App Link, con tu assetlinks.json.
  • Registra cada URL de redirección en Authentication > Security and sessions, como una URL de callback web.
Para usar claves de acceso en tu app, registra las apps que comparten las claves de acceso de tu aplicación con PUT native-apps/ en la API de gestión de autenticación. Didit las incluye después en el apple-app-site-association y en el assetlinks.json que Didit publica en tu origen de inicio de sesión. MANAGEMENT_BASE es la dirección de la API de gestión de tu aplicación, y una clave de API con el ámbito authentication y permisos de escritura puede hacer la llamada. La llamada reemplaza ambas listas, así que envía las dos:
Las guías de inicio rápido de iOS y Android muestran la parte de la aplicación.

Conecta la verificación de identidad y la monitorización de transacciones

Cada persona tiene un único valor de vendor_data, en sus tokens y en su sesión. Úsalo como vendor_data al crear una sesión de verificación o al enviar una transacción, y la consola muestra los inicios de sesión, las verificaciones y las transacciones de la misma persona.
  • Para verificar a las personas al registrarse o volver a verificarlas antes de un pago, sin crear un flujo de verificación propio, usa identidad verificada.
  • Los eventos de inicio de sesión llegan automáticamente a las reglas de eventos y a las vistas de fraude. No envíes tus propios eventos auth.login para los mismos inicios de sesión.
  • Un inicio de sesión correcto nunca aprueba una verificación ni una transacción: gestiona por separado la decisión de cada producto.
Consulta mantener a una misma persona en todos los productos.

Recibir eventos de inicio de sesión

Suscribe un destino de webhook a los tipos auth.* que necesites, como auth.new_device o auth.account_locked. Deduplica por auth_event.event_id y verifica la firma igual que con cualquier webhook de Didit. Consulta eventos y webhooks para ver todos los tipos y sus payloads.

Mover usuarios existentes

Si tus usuarios ya tienen cuentas en otra plataforma de identidad o en tu propia base de datos, impórtalos antes de cambiar el inicio de sesión. Importa sus hashes de contraseña cuando la fuente los proporcione, conserva sus vínculos sociales y mantén tus propios IDs de usuario como external_id, que se convierte en su vendor_data. Nada cambia para ellos hasta que cambies tu aplicación a Didit.

Lista de verificación para el paso a producción

  1. La autenticación está activada en tu aplicación de producción, en la página Products.
  2. Las URL de redirección https:// de producción y los orígenes permitidos están registrados en la aplicación de producción. Una aplicación de producción no acepta direcciones http://.
  3. Cada método de inicio de sesión social usa el ID de cliente y el secreto de tu propia aplicación. Las credenciales de prueba de Didit solo funcionan en Sandbox.
  4. Tu configuración de producción tiene la clave publicable de producción (pk_live_) y tu emisor de producción.
  5. Tu política de MFA, la duración de la sesión, el tiempo de inactividad, la longitud de la contraseña y la política de registro son las que quieres. Consulta configuración de la aplicación.
  6. La protección contra bots está activada, con la comprobación de contraseñas filtradas.
  7. Tu backend verifica cada token de acceso y llama a GET /session/ antes de las acciones sensibles.
  8. Tu marca, los textos de la página y los enlaces a los términos y a la privacidad están configurados. Si piensas usar un dominio personalizado, actívalo antes de que los usuarios empiecen a añadir claves de acceso.
  9. Tu destino de webhook está suscrito a los tipos auth.* que gestionas.
  10. Has probado en la aplicación de producción el registro, el inicio de sesión de quien ya tiene cuenta, la cancelación, la recuperación de contraseña, MFA, la caducidad de la sesión, el cierre de sesión y una sesión revocada.

Resolución de problemas

Última modificación el 22 de noviembre de 2026