Docs/ Backend as a Service/ Authentification (Logto)

Authentification (Logto)

Authentification gérée conforme à OIDC, avec connexion sociale, jetons JWT et console d'administration complète.

Créer un serveur d'authentification

Pour créer une nouvelle instance d'authentification :

Ouvrez la section Serveurs d'authentification du tableau de bord sh0.
Cliquez sur Créer un serveur auth.
Saisissez un nom pour votre instance d'authentification (par exemple « my-app-auth »).
Sélectionnez le serveur de bases de données PostgreSQL auquel la connecter.
Cliquez sur Créer. sh0 déploie une instance Logto avec SSL automatique.

Tip

Le nom du serveur d'authentification devient une partie du domaine (par exemple my-app-auth.sh0.app). Choisissez un nom descriptif.

Connexion à PostgreSQL

Chaque instance Logto requiert un serveur de bases de données PostgreSQL pour stocker les données utilisateur, les sessions et la configuration. sh0 effectue automatiquement les opérations suivantes :

Il crée une base de données dédiée dans votre serveur PostgreSQL.
Il configure la chaîne de connexion de Logto.
Il exécute les migrations initiales de Logto.

Les données de vos utilisateurs ne quittent jamais votre serveur. Elles sont stockées dans la même instance PostgreSQL, que vous contrôlez.

Console d'administration

Chaque instance Logto comprend une console d'administration complète, accessible à l'adresse de votre domaine d'authentification. Depuis la console, vous pouvez :

Gérer les utilisateurs (création, modification, suppression, réinitialisation des mots de passe).
Configurer l'expérience de connexion (image de marque, couleurs, logo).
Configurer les applications et leurs URI de redirection.
Ajouter des connecteurs de connexion sociale (Google, GitHub, etc.).
Consulter les journaux d'audit et l'activité des sessions.
Activer l'authentification multifacteur (MFA, fondée sur TOTP).

Logto prend en charge plusieurs méthodes de connexion dès l'installation :

Méthode	Description
E-mail + mot de passe	E-mail et mot de passe classiques, avec vérification de l'adresse e-mail
Sans mot de passe (e-mail)	Lien magique ou code de vérification par e-mail
Connexion sociale	Google, GitHub, Apple, Discord et d'autres
Téléphone + SMS	Code de vérification par SMS (nécessite un connecteur SMS)

Pour ajouter un fournisseur de connexion sociale, ouvrez la console d'administration Logto, allez dans Connecteurs et ajoutez un nouveau connecteur social. Vous aurez besoin de l'identifiant client et du secret OAuth fournis par le fournisseur (par exemple Google Cloud Console, GitHub Developer Settings).

Intégration des SDK

Logto fournit des SDK officiels pour les frameworks les plus courants :

Plateforme	Paquet
Navigateur (SPA)	@logto/browser
React	@logto/react
Next.js	@logto/next
Vue	@logto/vue
Node.js (Express)	@logto/express
Python	logto-sdk-python

L'intégration de base requiert deux valeurs de configuration : l'endpoint (votre domaine d'authentification) et l'appId (fourni par la console d'administration Logto).

Vérification des JWT

Logto émet des jetons OIDC standard (jeton d'accès, jeton d'identité, jeton de rafraîchissement). Pour vérifier les jetons dans votre API :

Récupérez le JWKS depuis https://<your-auth>.sh0.app/oidc/.well-known/openid-configuration.
Vérifiez la signature du jeton à l'aide de la clé publique.
Vérifiez les claims iss, aud et exp.

Tip

Si vous utilisez PostgREST, configurez-le avec le même secret JWT ou la même URL JWKS. Les jetons Logto fonctionnent alors directement avec la vérification JWT de PostgREST.

API PostgREST

Temps réel (Centrifugo)