> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Inicio rápido de autenticación: primer inicio de sesión en 10 minutos

> Activa la autenticación de Didit en una aplicación sandbox, inicia sesión con la página alojada y verifica el token de acceso en tu servidor.

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](https://business.didit.me), 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](https://docs.didit.me/es/authentication/overview.md#prepara-tu-aplicación).

**2. Registra tu callback y tu origen**

Abre **Authentication > Security and sessions > Redirect URLs and allowed origins** y añade:

| Qué | Valor |
| - | - |
| Redirect URL | `http://localhost:3000/auth/callback` |
| Allowed origin | `http://localhost:3000` |

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](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-redirect-urls.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=8bf9cdacf97580097f4e8c6bd242af6f)

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](https://docs.didit.me/es/authentication/sign-in-methods.md).

![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](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-sign-in-methods.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=4f71ad0125f22dd8184ad837854ec8db)

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**

```bash theme={null}
npm install @didit-protocol/auth
```

```ts auth.ts theme={null}
import { createDiditAuth } from "@didit-protocol/auth";

export const auth = createDiditAuth({
  publishableKey: "pk_test_...",
  redirectUri: "http://localhost:3000/auth/callback",
});

// Your sign-in button
export async function onSignInClick() {
  await auth.signIn({ returnTo: "/dashboard" });
}

// Run once on http://localhost:3000/auth/callback
export async function onCallbackPage() {
  const { session, returnTo } = await auth.handleRedirectCallback();
  console.log(session.email, session.vendorData);
  window.location.replace(returnTo ?? "/");
}
```

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](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/hosted-sign-in-phone.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=842077ff63a6dcffc50b0f0542ab07e4)

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:

```ts server.ts theme={null}
import { verifyToken } from "@didit-protocol/auth/server";

export async function authenticate(request: Request) {
  const header = request.headers.get("authorization") ?? "";
  const token = header.startsWith("Bearer ") ? header.slice(7) : "";
  try {
    const claims = await verifyToken(token, { publishableKey: process.env.DIDIT_PUBLISHABLE_KEY });
    return { personId: claims.sub, vendorData: claims.vendor_data };
  } catch {
    return null;
  }
}
```

`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](https://docs.didit.me/es/integration/server-sdks/overview.md) o con cualquier biblioteca JWT, como se muestra en [tokens y JWKS](https://docs.didit.me/es/authentication/tokens-and-jwks.md#verificar-un-token-en-tu-servidor).

**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](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-sign-ins.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=3c79b4e120c911b732d738e52d1687c8)

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](https://docs.didit.me/es/integration/webhooks.md) a `auth.signup` y `auth.login`. Consulta [eventos y webhooks](https://docs.didit.me/es/authentication/events-and-webhooks.md).

## 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](https://docs.didit.me/es/authentication/integration-guide.md#lista-de-verificación-para-el-paso-a-producción).

## Próximos pasos

> [card] [Guía de integración](https://docs.didit.me/es/authentication/integration-guide.md)
>
> Pantallas alojadas o propias, almacenamiento de tokens, sesiones, autenticación escalonada y solución de problemas.

> [card] [React y Next.js](https://docs.didit.me/es/authentication/quickstarts/nextjs.md)
>
> Componentes, hooks, cookies HttpOnly y `auth()` en el servidor.

> [card] [iOS, Android, React Native y Flutter](https://docs.didit.me/es/authentication/quickstarts/ios.md)
>
> Inicio de sesión nativo con el navegador del sistema, claves de acceso y almacenamiento protegido.

> [card] [Protección contra bots](https://docs.didit.me/es/authentication/bot-protection.md)
>
> Activa las políticas que detienen a los bots y la toma de control de cuentas.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.