Passer au contenu principal
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, 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.
2

Enregistrez votre URL de rappel et votre origine

Ouvrez Authentication > Security and sessions > Redirect URLs and allowed origins et ajoutez :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

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

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

auth.ts
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

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 :
server.ts
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 ou n’importe quelle bibliothèque JWT, comme le montre tokens et JWKS.
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

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 à auth.signup et auth.login. Voir événements et webhooks.

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.

Étapes suivantes

Guide d'intégration

Écrans hébergés ou vos propres écrans, stockage des tokens, sessions, authentification renforcée et résolution des problèmes.

React et Next.js

Composants, hooks, cookies HttpOnly et auth() côté serveur.

iOS, Android, React Native et Flutter

Connexion native avec le navigateur système, clés d’accès et stockage protégé.

Protection contre les bots

Activez les politiques qui bloquent les bots et la prise de contrôle de compte.
Dernière modification le 22 novembre 2026