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 essign_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.- Verifica el token de acceso en cada solicitud. Comprueba la firma ES256 con el JWKS de tu emisor y, después,
iss,aud,expytyp: at+jwt. Rechaza un token cuyoactno seanull, salvo que la ruta acepte agentes de IA. Consulta cómo verificar un token en tu servidor. - 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. - 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
approvedque tu backend haya leído por sí mismo. Consulta verificación adicional antes de acciones sensibles. - Toma
vendor_datadel 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.

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
webcredentialsen tuapple-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.
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 devendor_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.loginpara 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.
Recibir eventos de inicio de sesión
Suscribe un destino de webhook a los tiposauth.* 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 comoexternal_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
- La autenticación está activada en tu aplicación de producción, en la página Products.
- 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 direccioneshttp://. - 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.
- Tu configuración de producción tiene la clave publicable de producción (
pk_live_) y tu emisor de producción. - 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.
- La protección contra bots está activada, con la comprobación de contraseñas filtradas.
- Tu backend verifica cada token de acceso y llama a
GET /session/antes de las acciones sensibles. - 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.
- Tu destino de webhook está suscrito a los tipos
auth.*que gestionas. - 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.