Automatyczne logowanie

Shayan TaslimZaktualizowano

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

  1. Otwórz Ustawienia → Logowanie.

  2. W sekcji Uwierzytelnianie włącz opcję Automatyczne logowanie.

  3. 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

  1. Włącz Automatyczne logowanie w Ustawieniach → Logowaniu.

  2. Zainstaluj widżet w swoim produkcie.

  3. Wywołaj uj.identify(...) po załadowaniu sesji użytkownika (przekazując podpisany token, jeśli jest wymagany). Przekazanie email powoduje powiązanie z istniejącym kontem UserJot tylko wtedy, gdy adres e-mail tego konta został potwierdzony.

  4. Umieść w swojej aplikacji link do publicznego adresu URL UserJot (adresu userjot.com lub własnej domeny).

HTML
<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.

JavaScript
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.identify działa również w przypadku administratorów i właścicieli, synchronizując traits i companies, 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.identify z błędem IDENTIFY_FAILED i 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.com lub 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.identify otrzymuje token podpisany algorytmem HS256 przy użyciu aktualnego Project secret.

  • Sprawdź, czy iss jest zgodny z Twoim Project ID, aud ma wartość userjot, a zarówno iat, jak i exp są 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ątem IDENTIFY_FAILED.

Następne kroki

Czy ten artykuł odpowiedział na Twoje pytanie?