Automatyczne logowanie to funkcja Fakturowni, która pozwala zalogować użytkownika przez specjalny link z tokenem API - bez konieczności ręcznego wpisywania hasła. Korzystają z niej integratorzy łączący Fakturownie z zewnętrznymi systemami.
Jak włączyć automatyczne logowanie w UI?
Opcję włączysz w ustawieniach konta:
- przejdź do zakładki Ustawienia > Ustawienia konta > Integracja,
- w sekcji Logowanie zaznacz pole przy opcji Automatyczne logowanie po przekazaniu kodu API,
- kliknij Zapisz, aby potwierdzić zmiany.
Funkcja działa dla wszystkich ról użytkowników w koncie - zarówno właściciela, jak i pracowników z ograniczonymi uprawnieniami.
Jak włączyć automatyczne logowanie przez API?
Jeśli tworzysz lub aktualizujesz konto przez API, przekaż dodatkowy parametr w account: integration_fast_login: true.
Jak działa logowanie przez link?
Po włączeniu funkcji wywołaj link w formacie https://twojPrefix.fakturownia.pl?api_token=API_TOKEN&fast_login=yes.
Token API każdego użytkownika znajdziesz po zalogowaniu wybranym adresem e-mail w zakładce Ustawienia > Ustawienia konta > Integracja > Kod autoryzacji API.
Parametr fast_login=yes możesz dołączyć do dowolnego adresu URL w Fakturowni - użytkownik zostanie zalogowany i od razu przeniesiony pod wskazany adres.
Co warto wiedzieć przed wdrożeniem?
Nieprawidłowy lub nieaktywny token. Jeśli token API nie istnieje lub został dezaktywowany, użytkownik nie zostanie zalogowany. System wyświetli standardową stronę logowania - bez komunikatu o błędzie.
Czas ważności linku. Token API jest ważny bezterminowo, dopóki właściciel go nie usunie lub dezaktywuje - linku możesz użyć wielokrotnie. Jeśli token ma ustawioną datę wygaśnięcia, link przestanie działać po jej przekroczeniu.
Użytkownik już zalogowany. Jeśli użytkownik kliknie link będąc zalogowanym w tej samej przeglądarce, jego bieżąca sesja zostanie zastąpiona nową - powiązaną z tokenem przekazanym w linku.
Jak ustawić przekierowanie po wylogowaniu?
W tej samej sekcji Ustawienia > Ustawienia konta > Integracja > Logowanie znajdziesz opcję Na jaką stronę przekierowywać po wylogowaniu użytkownika.
To niezależna funkcja – nie jest wymagana do działania automatycznego logowania, ale warto ją skonfigurować przy integracji z zewnętrznym systemem. Po wylogowaniu użytkownik trafi pod wskazany adres, np. z powrotem do aplikacji integrującej. Szczegóły odnośnie tej funkcji znajdziesz w artykule zmiana strony, na jaką zostanie przekierowany użytkownik po wylogowaniu.