Authentification

Connexion, renouvellement de jeton, réinitialisation de mot de passe, finalisation SSO – et accès API par clé API.

Ce groupe couvre la connexion des utilisateurs : connexion par adresse e-mail ou nom d'utilisateur et mot de passe, renouvellement de la session via un jeton de rafraîchissement, réinitialisation d'un mot de passe oublié et finalisation d'une connexion par authentification unique (SAML/OIDC). Les points de terminaison renvoient un jeton d'accès (JWT), envoyé dans l'en-tête `Authorization: Bearer <token>`, ainsi qu'un jeton de rafraîchissement qui est remplacé par un nouveau à chaque utilisation.

Pour l'accès machine de vos propres programmes à vos données, utilisez une clé API pour l'API REST à l'adresse `https://zentor-app.de/api/v1` plutôt qu'une connexion utilisateur. Zentor active l'accès API sur demande ; les administrateurs créent ensuite des clés avec des autorisations définies (scopes) dans le tableau de bord sous « Clés API ». La clé est transmise dans l'en-tête `Authorization: Bearer <clé API>` ou `X-API-Key`. Vous trouverez les scopes, les codes d'erreur et des conseils sur la conservation sécurisée des clés dans la vue d'ensemble de la référence API.

Les points de terminaison de connexion sont protégés contre les tentatives répétées échouées : après plusieurs saisies incorrectes, le serveur retarde les tentatives suivantes et les bloque temporairement avec 429 `RATE_LIMIT_EXCEEDED`.

POST/api/auth/loginPOST/api/auth/refreshPOST/api/auth/forgot-passwordPOST/api/auth/reset-passwordPOST/api/auth/sso/exchange
← Référence API