Uwierzytelnianie
Logowanie, odnawianie tokenu, resetowanie hasła, finalizacja SSO – oraz dostęp do API za pomocą kluczy API.
Ta grupa obejmuje logowanie użytkowników: logowanie za pomocą adresu e-mail lub nazwy użytkownika i hasła, odnawianie sesji za pomocą tokenu odświeżania, resetowanie zapomnianego hasła oraz zakończenie logowania przez jednokrotne logowanie (SAML/OIDC). Endpointy zwracają token dostępu (JWT), wysyłany w nagłówku `Authorization: Bearer <token>`, oraz token odświeżania, który przy każdym użyciu zastępowany jest nowym.
Do maszynowego dostępu własnych programów do Państwa danych należy użyć klucza API do REST API pod adresem `https://zentor-app.de/api/v1` zamiast logowania użytkownika. Zentor na życzenie aktywuje dostęp do API; następnie administratorzy tworzą w panelu w sekcji „Klucze API” klucze z określonymi uprawnieniami (scope). Klucz przesyła się w nagłówku `Authorization: Bearer <klucz API>` lub `X-API-Key`. Scope, kody błędów i wskazówki dotyczące bezpiecznego przechowywania znajdują się w przeglądzie dokumentacji API.
Endpointy logowania są chronione przed powtarzanymi nieudanymi próbami: po kilku błędnych próbach serwer opóźnia kolejne próby i tymczasowo blokuje je kodem 429 `RATE_LIMIT_EXCEEDED`.