Saltar al contenido principal
Esta guía de inicio rápido te permite tener Didit Authentication funcionando de extremo a extremo en unos 10 minutos. Registras un callback en una aplicación sandbox, activas un método de inicio de sesión, haces que una persona inicie sesión con la página de inicio de sesión alojada, verificas su token de acceso en tu servidor y ves el inicio de sesión en la consola.

Requisitos previos

  • Una cuenta de Didit con una aplicación sandbox. Crear una cuenta es gratis, y todas las aplicaciones sandbox tienen Autenticación activada.
  • Node.js 20 o posterior, y una aplicación web que puedas ejecutar en http://localhost:3000.

Pasos

1

Abre tu aplicación Sandbox

En la Business Console, usa el selector de aplicaciones para elegir tu aplicación Sandbox y, después, abre Authentication.Una aplicación Sandbox acepta callbacks de http://localhost y las credenciales de prueba de Didit para el inicio de sesión social, y nunca se factura. En una aplicación Live, en cambio, activas Authentication desde la página Products: consulta preparar tu aplicación.
2

Registra tu callback y tu origen

Abre Authentication > Security and sessions > Redirect URLs and allowed origins y añade:Didit solo devuelve a una persona a una URL de redirección que hayas registrado, carácter por carácter. El origen permitido permite que el navegador intercambie el código con el origen de Didit de tu aplicación.
La tarjeta Redirect URLs and allowed origins en la Business Console de Didit, junto a la lista de permitidos, la lista de bloqueo y la URL de inicio de sesión

URL de redirección y orígenes permitidos, en Authentication > Security and sessions.

3

Activa un método de inicio de sesión

Abre Authentication > Sign-in methods y activa Email code. Una aplicación nueva empieza con todos los métodos desactivados, y la página alojada solo ofrece los métodos que actives.Si quieres, añade también Passkeys, o un método de inicio de sesión social con Didit test credentials, que funcionan en Sandbox sin una aplicación propia. Cada método se describe en métodos de inicio de sesión.
La página Sign-in methods de la Business Console de Didit, con la tarjeta de la página de inicio de sesión alojada, los métodos sin contraseña y con contraseña, y una vista previa en directo de la página alojada

Authentication > Sign-in methods, con una vista previa en directo de la página alojada.

4

Copia tu clave publicable

Abre Authentication > Developers y copia la Publishable key. En una aplicación Sandbox empieza por pk_test_.La clave publicable es pública e identifica el origen de inicio de sesión de Didit de tu aplicación. Nunca pongas la Secret key en el código del navegador ni de aplicaciones móviles.
5

Instala el SDK e inicia sesión

auth.ts
Haz clic en tu botón: la página alojada pide una dirección de correo electrónico y envía un código de seis dígitos. Introduce el código, y Didit te devuelve a tu callback, que intercambia el código de un solo uso por los tokens de la sesión. El primer inicio de sesión con una dirección que no tiene cuenta crea una, porque la política de registro predeterminada permite que cualquiera se registre.
La página alojada de inicio de sesión en un móvil, con un botón de clave de acceso y campos de correo electrónico y contraseña

La página alojada de inicio de sesión en un móvil. Solo muestra los métodos que activaste.

6

Verifica el token en tu servidor

Envía el token de acceso de auth.getToken() a tu backend en el encabezado Authorization, y verifícalo allí en cada solicitud protegida:
server.ts
verifyToken comprueba la firma ES256 con las claves publicadas por tu emisor, así como el emisor y la caducidad. Los tokens de acceso duran como máximo 5 minutos, y auth.getToken() los renueva por ti. En otros lenguajes, el mismo token se verifica con los SDK de servidor o con cualquier biblioteca JWT, como se muestra en tokens y JWKS.
7

Consulta el inicio de sesión en la consola

Abre Authentication > Sign-ins. Tu inicio de sesión aparece con su resultado, método, dispositivo, ubicación y riesgo, junto a los inicios de sesión de ejemplo con los que empieza cada sandbox. La persona aparece en Users.
La página Sign-ins de la Business Console de Didit, con los intentos de inicio de sesión y su estado, persona, método, dispositivo, ubicación, riesgo y hora

Authentication > Sign-ins: todos los intentos, con filtros por estado, método y riesgo.

Para recibir la actividad de inicio de sesión en tu servidor, suscribe un destino de webhook a auth.signup y auth.login. Consulta eventos y webhooks.

Antes de pasar a producción

  1. Activa la autenticación para tu aplicación Live en la página Products.
  2. Registra tus URL de redirección y orígenes de producción que usen https:// en esa página: una aplicación Live solo acepta https://.
  3. Reemplaza las credenciales de prueba de Didit para el inicio de sesión social por el ID de cliente y el secreto de tu propia aplicación.
  4. Copia la clave publicable Live (pk_live_) en tu configuración de producción.
  5. Revisa la lista de verificación para pasar a producción.

Próximos pasos

Guía de integración

Pantallas alojadas o propias, almacenamiento de tokens, sesiones, autenticación escalonada y solución de problemas.

React y Next.js

Componentes, hooks, cookies HttpOnly y auth() en el servidor.

iOS, Android, React Native y Flutter

Inicio de sesión nativo con el navegador del sistema, claves de acceso y almacenamiento protegido.

Protección contra bots

Activa las políticas que detienen a los bots y la toma de control de cuentas.
Última modificación el 22 de noviembre de 2026