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

# Démarrage rapide authentification : première connexion en 10 minutes

> Activez l'authentification Didit en sandbox, connectez un utilisateur via la page hébergée et vérifiez son access token côté serveur.

Ce guide de démarrage rapide vous permet de mettre en place Didit Authentication de bout en bout en environ 10 minutes.
Vous enregistrez une URL de rappel dans une application sandbox, activez une méthode de connexion, connectez une personne via la page de connexion hébergée, vérifiez son token d'accès sur votre serveur, puis consultez la connexion dans la console.

## Prérequis

* Un compte Didit avec une application sandbox. La création d'un compte est gratuite, et chaque application sandbox a l'option Authentication activée.
* Node.js 20 ou version ultérieure, et une application web que vous pouvez exécuter sur `http://localhost:3000`.

## Étapes

**1. Ouvrez votre application sandbox**

Dans la [Business Console](https://business.didit.me), utilisez le sélecteur d'application pour choisir votre application **Sandbox**, puis ouvrez **Authentication**.

Une application Sandbox accepte les URL de rappel `http://localhost` et les identifiants de test de Didit pour la connexion via les réseaux sociaux, et elle n'est jamais facturée.
Une application Live active Authentication depuis la page **Products** : voir [préparer votre application](https://docs.didit.me/fr/authentication/overview.md#préparer-votre-application).

**2. Enregistrez votre URL de rappel et votre origine**

Ouvrez **Authentication > Security and sessions > Redirect URLs and allowed origins** et ajoutez :

| Élément | Valeur |
| - | - |
| URL de redirection | `http://localhost:3000/auth/callback` |
| Origine autorisée | `http://localhost:3000` |

Didit ne renvoie une personne que vers une URL de redirection que vous avez enregistrée, caractère par caractère.
L'origine autorisée permet au navigateur d'échanger le code avec l'origine Didit de votre application.

![La carte Redirect URLs and allowed origins dans la Didit Business Console, à côté de la liste d'autorisation et de la liste de blocage et de l'URL de connexion](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-redirect-urls.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=8bf9cdacf97580097f4e8c6bd242af6f)

URL de redirection et origines autorisées, sous Authentication > Security and sessions.

**3. Activez une méthode de connexion**

Ouvrez **Authentication > Sign-in methods** et activez **Email code**.
Une nouvelle application démarre avec toutes les méthodes désactivées, et la page hébergée ne propose que les méthodes que vous activez.

Ajoutez aussi **Passkeys** si vous le souhaitez, ou une méthode de connexion via un réseau social avec les **identifiants de test de Didit**, qui fonctionnent en Sandbox sans application propre.
Chaque méthode est décrite dans [méthodes de connexion](https://docs.didit.me/fr/authentication/sign-in-methods.md).

![La page Sign-in methods dans la Didit Business Console, avec la carte de la page de connexion hébergée, les méthodes sans mot de passe et avec mot de passe, et un aperçu en direct de la page hébergée](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, avec un aperçu en direct de la page hébergée.

**4. Copiez votre clé publiable**

Ouvrez **Authentication > Developers** et copiez la **Publishable key**.
Dans une application Sandbox, elle commence par `pk_test_`.

La clé publiable est publique : elle identifie l'origine de connexion Didit de votre application.
Ne placez jamais la **Secret key** dans le code du navigateur ou de l'application mobile.

**5. Installez le SDK et connectez-vous**

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

Cliquez sur votre bouton : la page hébergée demande une adresse e-mail et envoie un code à six chiffres.
Saisissez le code, puis Didit vous renvoie vers votre URL de rappel, qui échange le code à usage unique contre les tokens de la session.
Une première connexion avec une adresse sans compte en crée un, car la politique d'inscription par défaut permet à chacun de s'inscrire.

![La page de connexion hébergée sur un téléphone, avec un bouton passkey et des champs e-mail et mot de passe](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/hosted-sign-in-phone.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=842077ff63a6dcffc50b0f0542ab07e4)

La page de connexion hébergée sur un téléphone. Elle n'affiche que les méthodes que vous avez activées.

**6. Vérifiez le token sur votre serveur**

Envoyez le token d'accès renvoyé par `auth.getToken()` à votre backend dans l'en-tête `Authorization`, et vérifiez-le côté serveur à chaque requête protégée :

```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` contrôle la signature ES256 avec les clés publiées de votre émetteur, l'émetteur et la date d'expiration.
Les tokens d'accès ont une durée de vie de 5 minutes au maximum, et `auth.getToken()` les renouvelle pour vous.
Dans les autres langages, vérifiez le même token avec les [SDK serveur](https://docs.didit.me/fr/integration/server-sdks/overview.md) ou n'importe quelle bibliothèque JWT, comme le montre [tokens et JWKS](https://docs.didit.me/fr/authentication/tokens-and-jwks.md#vérifier-un-jeton-sur-votre-serveur).

**7. Consultez la connexion dans la console**

Ouvrez **Authentication > Sign-ins**.
Votre connexion apparaît avec son résultat, sa méthode, son appareil, sa localisation et son niveau de risque, à côté des exemples de connexions que chaque sandbox crée au départ.
La personne apparaît sous **Users**.

![La page Sign-ins dans la Didit Business Console, qui liste les tentatives de connexion avec leur état, la personne, la méthode, l'appareil, la localisation, le risque et l'heure](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 : chaque tentative, avec des filtres par état, méthode et risque.

Pour recevoir l'activité de connexion sur votre serveur, abonnez une [destination de webhook](https://docs.didit.me/fr/integration/webhooks.md) à `auth.signup` et `auth.login`. Voir [événements et webhooks](https://docs.didit.me/fr/authentication/events-and-webhooks.md).

## Avant la mise en production

1. Activez Authentication pour votre application Live sur la page **Products**.
2. Enregistrez-y vos URL de redirection et origines de production en `https://` : une application Live n'accepte que `https://`.
3. Remplacez les identifiants de test de Didit pour la connexion via les réseaux sociaux par l’ID client et le secret de votre propre application.
4. Copiez la clé publiable Live (`pk_live_`) dans votre configuration de production.
5. Parcourez la [liste de contrôle de mise en production](https://docs.didit.me/fr/authentication/integration-guide.md#liste-de-contrôle-avant-la-mise-en-production).

## Étapes suivantes

> [card] [Guide d'intégration](https://docs.didit.me/fr/authentication/integration-guide.md)
>
> Écrans hébergés ou vos propres écrans, stockage des tokens, sessions, authentification renforcée et résolution des problèmes.

> [card] [React et Next.js](https://docs.didit.me/fr/authentication/quickstarts/nextjs.md)
>
> Composants, hooks, cookies HttpOnly et `auth()` côté serveur.

> [card] [iOS, Android, React Native et Flutter](https://docs.didit.me/fr/authentication/quickstarts/ios.md)
>
> Connexion native avec le navigateur système, clés d'accès et stockage protégé.

> [card] [Protection contre les bots](https://docs.didit.me/fr/authentication/bot-protection.md)
>
> Activez les politiques qui bloquent les bots et la prise de contrôle de compte.


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