Auth

Auth

Les endpoints d’auth d’AM vous permettent de créer des parcours de connexion, d’inscription et de mot de passe sans gérer vous-même les jetons, les sessions ni la sécurité.

Ces endpoints tournent sur votre domaine d’auth et couvrent tout le cycle d’authentification, de l’inscription à la réinitialisation du mot de passe.

Vue d’ensemble

Endpoints

Endpoint	But
POST /auth/sign-up	Enregistrer un nouvel utilisateur avec e-mail/mot de passe
POST /auth/sign-in	Authentifier avec des identifiants
POST /auth/sign-in-with-token	Authentification sans mot de passe par jeton
GET /auth/me	Obtenir le profil de l’utilisateur courant
POST /auth/refresh	Rafraîchir le jeton d’accès
GET /auth/csrf-session	Initialiser le cookie de session CSRF
GET /auth/csrf-token	Générer un jeton CSRF
POST /auth/check-email	Vérifier l’e-mail et les méthodes de connexion disponibles
POST /auth/verify	Vérifier une adresse e-mail
POST /auth/send-magic-link	Envoyer un lien de connexion sans mot de passe
POST /auth/send-password-reset	Envoyer un e-mail de réinitialisation de mot de passe
POST /auth/reset-password	Définir un nouveau mot de passe avec un jeton de réinitialisation
POST /auth/accept-invite	Accepter une invitation de compte

Flux d’authentification

Ce que vous récupérez

Une authentification réussie renvoie :

• Access Token : JWT courte durée (1 heure par défaut) pour les requêtes API
• Refresh Token : jeton longue durée (14 jours par défaut) pour obtenir de nouveaux access tokens
• Profil utilisateur : e-mail, adhésions, données d’identité

Protection CSRF

Les requêtes qui modifient l’état nécessitent des jetons CSRF :

1. Initialiser la session : GET /auth/csrf-session (définit un cookie HttpOnly)
2. Obtenir le jeton : GET /auth/csrf-token (retourne le jeton dans l’en-tête X-CSRF-Token)
3. Inclure le jeton dans les requêtes via l’en-tête X-CSRF-Token ou le champ csrf_token dans le body

Liés

• Authentication - Méthodes d’authentification et sécurité
• OAuth - Autorisation tierce
• Utilisateurs - Gestion des utilisateurs