Authenticatie

Inloggen, tokenverlenging, wachtwoord resetten, SSO-afronding – en API-toegang met API-sleutels.

Deze groep omvat het aanmelden van gebruikers: inloggen met e-mailadres of gebruikersnaam en wachtwoord, verlengen van de sessie met een refresh-token, resetten van een vergeten wachtwoord en afronden van een single-sign-on-aanmelding (SAML/OIDC). De endpoints leveren een toegangstoken (JWT), verzonden in de header `Authorization: Bearer <token>`, en een refresh-token dat bij elk gebruik door een nieuw token wordt vervangen.

Voor machinetoegang van uw eigen programma's tot uw gegevens gebruikt u in plaats van een gebruikersaanmelding een API-sleutel voor de REST-API op `https://zentor-app.de/api/v1`. Zentor schakelt de API-toegang op aanvraag vrij; daarna maken beheerders in het dashboard onder “API-sleutels” sleutels aan met vastgelegde rechten (scopes). De sleutel wordt verzonden in de header `Authorization: Bearer <API-sleutel>` of in `X-API-Key`. Scopes, foutcodes en adviezen over veilige opslag vindt u in het overzicht van de API-referentie.

De aanmeld-endpoints zijn beveiligd tegen herhaalde mislukte pogingen: na meerdere onjuiste invoeren vertraagt de server verdere pogingen en blokkeert ze tijdelijk met 429 `RATE_LIMIT_EXCEEDED`.

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