Autentisering

Innlogging, token-fornyelse, nullstilling av passord, SSO-fullføring – og API-tilgang med API-nøkkel.

Denne gruppen omfatter brukerinnlogging: innlogging med e-postadresse eller brukernavn og passord, forlengelse av sesjonen via refresh-token, nullstilling av et glemt passord og fullføring av en enkel pålogging (SAML/OIDC). Endepunktene returnerer et tilgangstoken (JWT), som sendes i headeren `Authorization: Bearer <token>`, samt et refresh-token som byttes ut med et nytt ved hver bruk.

For maskinell tilgang fra egne programmer til dataene dine bruker du i stedet for brukerinnlogging en API-nøkkel for REST API-et på `https://zentor-app.de/api/v1`. Zentor aktiverer API-tilgang på forespørsel; deretter opprettes nøkler med definerte rettigheter (scope) av administratorer i dashbordet under «API-nøkler». Nøkkelen sendes i headeren `Authorization: Bearer <API-nøkkel>` eller `X-API-Key`. Scopes, feilkoder og råd om sikker lagring finner du i oversikten i API-referansen.

Innloggingsendepunktene er beskyttet mot gjentatte mislykkede forsøk: Etter flere feilaktige innlogginger forsinker serveren videre forsøk og blokkerer dem midlertidig med 429 `RATE_LIMIT_EXCEEDED`.

POST/api/auth/loginPOST/api/auth/refreshPOST/api/auth/forgot-passwordPOST/api/auth/reset-passwordPOST/api/auth/sso/exchange
← API-referanse