Autentisering
Inloggning, tokenförnyelse, återställning av lösenord, SSO-avslutning – och API-åtkomst med API-nyckel.
Denna grupp omfattar användarinloggning: inloggning med e-postadress eller användarnamn och lösenord, förlängning av sessionen via refresh-token, återställning av ett glömt lösenord och slutförande av en enkel inloggning (SAML/OIDC). Slutpunkterna returnerar en åtkomsttoken (JWT), som skickas i headern `Authorization: Bearer <token>`, samt en refresh-token som byts ut mot en ny vid varje användning.
För maskinell åtkomst från dina egna program till dina data använder du i stället för en användarinloggning en API-nyckel för REST-API:et på `https://zentor-app.de/api/v1`. Zentor aktiverar API-åtkomst på begäran; därefter skapar administratörer i kontrollpanelen under ”API-nycklar” nycklar med fastställda behörigheter (scope). Nyckeln skickas i headern `Authorization: Bearer <API-nyckel>` eller `X-API-Key`. Scopes, felkoder och råd om säker förvaring finns i översikten i API-referensen.
Inloggningsslutpunkterna är skyddade mot upprepade misslyckade försök: efter flera felaktiga inmatningar fördröjer servern ytterligare försök och blockerar dem tillfälligt med 429 `RATE_LIMIT_EXCEEDED`.