> ## 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.

# Inici ràpid d'autenticació: primer inici de sessió en 10 minuts

> Activa Didit Authentication en una aplicació sandbox, fes iniciar sessió una persona amb la pàgina allotjada i verifica el seu token al servidor.

Aquesta guia ràpida fa que Didit Authentication funcioni de principi a fi en uns 10 minuts.

Registres un callback en una aplicació sandbox, actives un mètode d'inici de sessió, fas que una persona iniciï sessió amb la pàgina d'inici de sessió allotjada, verifiques el seu token d'accés al teu servidor i veus l'inici de sessió a la consola.

## Requisits previs

* Un compte de Didit amb una aplicació sandbox. Crear un compte és gratuït, i totes les aplicacions sandbox tenen l'Autenticació activada.
* Node.js 20 o posterior, i una aplicació web que puguis executar a `http://localhost:3000`.

## Passos

**1. Obre la teva aplicació sandbox**

Al [Business Console](https://business.didit.me), fes servir el selector d'aplicacions per seleccionar la teva aplicació **Sandbox** i, després, obre **Authentication**.

Una aplicació Sandbox accepta URL de callback amb `http://localhost` i les credencials de prova de Didit per a l'inici de sessió amb xarxes socials, i mai no es factura.
Una aplicació Live activa Authentication des de la pàgina **Products**: consulta [prepara la teva aplicació](https://docs.didit.me/ca/authentication/overview.md#prepara-la-teva-aplicació).

**2. Registra el teu callback i l'origen**

Obre **Authentication > Security and sessions > Redirect URLs and allowed origins** i afegeix:

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

Didit només retorna una persona a una URL de redirecció que hagis registrat, caràcter per caràcter.
L'origen permès permet que el navegador intercanviï el codi amb l'origen de Didit de la teva aplicació.

![La targeta Redirect URLs and allowed origins de la Didit Business Console, al costat de la llista de permesos, la llista de bloqueig i la URL d'inici de sessió](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-redirect-urls.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=8bf9cdacf97580097f4e8c6bd242af6f)

Redirect URLs and allowed origins, sota Authentication > Security and sessions.

**3. Activa un mètode d'inici de sessió**

Obre **Authentication > Sign-in methods** i activa **Email code**.
Una aplicació nova comença amb tots els mètodes desactivats, i la pàgina allotjada només ofereix els mètodes que activis.

Afegeix també **Passkeys** si vols, o bé un mètode d'inici de sessió amb xarxes socials amb **credencials de prova de Didit**, que funcionen en Sandbox sense una aplicació pròpia.
Tots els mètodes es descriuen a [mètodes d'inici de sessió](https://docs.didit.me/ca/authentication/sign-in-methods.md).

![La pàgina Sign-in methods de la Didit Business Console, amb la targeta de la pàgina d'inici de sessió allotjada, els mètodes sense contrasenya i amb contrasenya, i una previsualització en directe de la pàgina allotjada](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, amb una previsualització en directe de la pàgina allotjada.

**4. Copia la teva clau publicable**

Obre **Authentication > Developers** i copia la **Publishable key**.
En una aplicació Sandbox comença amb `pk_test_`.

La clau publicable és pública i identifica l'origen d'inici de sessió de Didit de la teva aplicació.
No posis mai la **Secret key** en codi de navegador ni de mòbil.

**5. Instal·la el SDK i inicia sessió**

```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 ?? "/");
}
```

Fes clic al botó: la pàgina allotjada demana una adreça de correu electrònic i envia un codi de sis dígits.
Introdueix el codi, i Didit et retorna a la teva URL de callback, que intercanvia el codi d'un sol ús pels tokens de la sessió.
Un primer inici de sessió amb una adreça que no té compte en crea un, perquè la política de registre predeterminada permet que qualsevol es registri.

![La pàgina d'inici de sessió allotjada en un telèfon, amb un botó de clau d'accés i els camps de correu electrònic i contrasenya](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 d'inici de sessió allotjada en un telèfon. Només mostra els mètodes que has activat.

**6. Verifica el token al teu servidor**

Envia el token d'accés de `auth.getToken()` al teu backend a la capçalera `Authorization`, i verifica'l allà a cada sol·licitud 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` comprova la signatura ES256 amb les claus publicades del teu emissor, i comprova l'emissor i la data de caducitat.
Els tokens d'accés duren com a màxim 5 minuts, i `auth.getToken()` els renova per tu.
En altres llenguatges, pots verificar el mateix token amb els [SDK de servidor](https://docs.didit.me/ca/integration/server-sdks/overview.md) o amb qualsevol biblioteca JWT, tal com s'explica a [tokens i JWKS](https://docs.didit.me/ca/authentication/tokens-and-jwks.md#verifica-un-token-al-teu-servidor).

**7. Consulta l'inici de sessió a la consola**

Obre **Authentication > Sign-ins**.
El teu inici de sessió apareix amb el seu resultat, mètode, dispositiu, ubicació i risc, al costat dels inicis de sessió d'exemple amb què comença cada sandbox.
La persona apareix a **Users**.

![La pàgina Sign-ins de la Didit Business Console, amb la llista d'intents d'inici de sessió amb el seu estat, persona, mètode, dispositiu, ubicació, risc i 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: cada intent, amb filtres per estat, mètode i risc.

Per rebre l'activitat d'inici de sessió al teu servidor, subscriu una [destinació del webhook](https://docs.didit.me/ca/integration/webhooks.md) a `auth.signup` i `auth.login`. Consulta [esdeveniments i webhooks](https://docs.didit.me/ca/authentication/events-and-webhooks.md).

## Abans de passar a producció

1. Activa l'autenticació per a la teva aplicació Live a la pàgina **Products**.
2. Registra-hi les URL de redirecció i els orígens de producció amb `https://`: una aplicació Live només accepta `https://`.
3. Substitueix les credencials de prova de Didit per a l'inici de sessió amb xarxes socials pel client ID i el secret de la teva pròpia aplicació.
4. Copia la clau publicable Live (`pk_live_`) a la configuració de producció.
5. Repassa la [llista de verificació per a la sortida en producció](https://docs.didit.me/ca/authentication/integration-guide.md#llista-de-verificació-per-a-la-posada-en-producció).

## Passos següents

> [card] [Guia d'integració](https://docs.didit.me/ca/authentication/integration-guide.md)
>
> Pantalles allotjades o pròpies, emmagatzematge de tokens, sessions, autenticació reforçada i resolució de problemes.

> [card] [React i Next.js](https://docs.didit.me/ca/authentication/quickstarts/nextjs.md)
>
> Components, hooks, cookies HttpOnly i `auth()` al servidor.

> [card] [iOS, Android, React Native i Flutter](https://docs.didit.me/ca/authentication/quickstarts/ios.md)
>
> Inici de sessió natiu amb el navegador del sistema, passkeys i emmagatzematge protegit.

> [card] [Protecció contra bots](https://docs.didit.me/ca/authentication/bot-protection.md)
>
> Activa les polítiques que aturen els bots i la presa de control de comptes.


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