Autenticazione

Login, rinnovo del token, reimpostazione della password, completamento SSO – e accesso API tramite chiavi API.

Questo gruppo comprende l'accesso degli utenti: login con indirizzo e-mail o nome utente e password, rinnovo della sessione tramite token di refresh, reimpostazione di una password smarrita e completamento di un login Single Sign-On (SAML/OIDC). Gli endpoint restituiscono un token di accesso (JWT), inviato nell'header `Authorization: Bearer <token>`, e un token di refresh che viene sostituito con uno nuovo ad ogni utilizzo.

Per l'accesso automatizzato dei vostri programmi ai vostri dati, utilizzate una chiave API per l'API REST all'indirizzo `https://zentor-app.de/api/v1` invece di un login utente. Zentor attiva l'accesso API su richiesta; successivamente gli amministratori creano nella dashboard, in «Chiavi API», chiavi con autorizzazioni definite (scope). La chiave viene trasmessa nell'header `Authorization: Bearer <chiave API>` oppure in `X-API-Key`. Scope, codici di errore e indicazioni sulla conservazione sicura sono descritti nella panoramica del riferimento API.

Gli endpoint di login sono protetti da tentativi ripetuti falliti: dopo diversi inserimenti errati, il server ritarda i tentativi successivi e li blocca temporaneamente con 429 `RATE_LIMIT_EXCEEDED`.

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