Automatyczne logowanie
Automatyczne logowanie pozwala UserJot przenieść sesję zalogowanego użytkownika z Twojego produktu na publiczną tablicę opinii, roadmapę, changelog, Centrum pomocy i osadzone elementy w treści — bez ponownego wyświetlania prośby o logowanie.
Widget może samodzielnie identyfikować użytkowników. Automatyczne logowanie to ustawienie obszaru roboczego, które pozwala używać tej tożsamości do logowania użytkowników na Twoich publicznych stronach, osadzonych elementach w treści i w Swift SDK.
Włącz automatyczne logowanie
Otwórz Ustawienia → Logowanie.
W sekcji Uwierzytelnianie włącz opcję Automatyczne logowanie.
Aby weryfikować sesje po stronie serwera, włącz również Wymagaj podpisanych tokenów (ta opcja pojawi się po włączeniu Automatycznego logowania).
Automatyczne logowanie wymaga planu Starter lub Professional. W planie Free przełącznik jest widoczny, ale zablokowany.
Jak działa opcja „Wymagaj podpisanych tokenów”
Zwykłe wywołanie uj.identify działa w przeglądarce i odwiedzający może je edytować. Po włączeniu opcji Wymagaj podpisanych tokenów UserJot odrzuca niepodpisane wywołania identify, wymaga umieszczenia członkostw w firmach w podpisanym tokenie (ignorując niepodpisane wartości companies po stronie klienta i wyświetlając ostrzeżenie UNSIGNED_COMPANY_IGNORED), a także akceptuje wyłącznie tożsamości podpisane na Twoim serwerze za pomocą JWT HS256 (lub podpisu HMAC-SHA256 w Swift SDK). Przykłady po stronie serwera znajdziesz w sekcji Podpisana tożsamość.
Jak to działa
Włącz Automatyczne logowanie w Ustawieniach → Logowaniu.
Zainstaluj widżet w swoim produkcie.
Wywołaj
uj.identify(...)po załadowaniu sesji użytkownika (przekazując podpisanytoken, jeśli jest wymagany). Przekazanieemailpowoduje powiązanie z istniejącym kontem UserJot tylko wtedy, gdy adres e-mail tego konta został potwierdzony.Umieść w swojej aplikacji link do publicznego adresu URL UserJot (adresu
userjot.comlub własnej domeny).
<a href="https://feedback.example.com/">Give feedback</a>
<a href="https://feedback.example.com/roadmap">Roadmap</a>
<a href="https://feedback.example.com/updates">Updates</a>SDK automatycznie dołącza sesję, gdy użytkownicy klikają linki do domeny Twojego projektu. Nie musisz samodzielnie dodawać tokenów do adresów URL. Osadzone elementy w treści korzystają z tej samej wymiany automatycznie po uruchomieniu uj.identify.
if (user) {
uj.identify({ token: user.userJotToken });
} else {
uj.logout();
}Ograniczenia
Nie dotyczy administratorów ani właścicieli obszaru roboczego na tablicach publicznych. Automatyczne logowanie nie loguje administratorów ani właścicieli obszaru roboczego na tablice publiczne (zawsze testuj automatyczne logowanie na tablicy na zwykłym koncie klienta; członkowie zespołu logują się na tablice publiczne bezpośrednio za pomocą konta UserJot lub przez przekierowanie SSO). W widgecie w aplikacji podpisany token
uj.identifydziała również w przypadku administratorów i właścicieli, synchronizująctraitsicompanies, a jednocześnie pozostawiając bez zmian imię i nazwisko, awatar oraz adres e-mail zarządzane z poziomu panelu.To coś innego niż logowanie jednokrotne. Automatyczne logowanie przenosi sesje widgetu do publicznych stron z poziomu Twojej aplikacji. Natomiast logowanie jednokrotne zastępuje przycisk Zaloguj się na tablicy przekierowaniem do Twojej własnej strony logowania.
W trybie ścisłym dostęp jest domyślnie blokowany. Gdy opcja Wymagaj podpisanych tokenów jest włączona, brakujący lub nieprawidłowy token powoduje odrzucenie wywołania
uj.identifyz błędemIDENTIFY_FAILEDi pozostawia odwiedzającego niezalogowanym.
Rozwiązywanie problemów
Użytkownik nadal widzi prośbę o zalogowanie
Sprawdź, czy Automatyczne logowanie jest włączone w Ustawieniach → Logowaniu.
Sprawdź, czy SDK widgetu jest załadowane na stronie zawierającej link i czy przed kliknięciem linku zostało uruchomione
uj.identify.Sprawdź, czy link prowadzi do dokładnej subdomeny
userjot.comlub Twojej własnej domeny.Upewnij się, że do testowania automatycznego logowania na tablicach publicznych nie używasz adresu e-mail administratora ani właściciela obszaru roboczego.
Podpisane tokeny są wymagane, ale logowanie nadal nie działa
Sprawdź, czy
uj.identifyotrzymujetokenpodpisany algorytmem HS256 przy użyciu aktualnego Project secret.Sprawdź, czy
issjest zgodny z Twoim Project ID,audma wartośćuserjot, a zarównoiat, jak iexpsą czasem uniksowym wyrażonym w sekundach, z wartościąexp - iat <= 3600(maksymalny czas ważności: 1 godzina).Sprawdź, jaki wynik zwraca obietnica zwrócona przez
uj.identify, pod kątemIDENTIFY_FAILED.
Następne kroki
Generuj tokeny JWT po stronie serwera zgodnie z artykułem Podpisana tożsamość.
Porównaj wszystkie opcje uwierzytelniania w artykule Identyfikowanie użytkowników.