InnerWeb
Przejdź do treści

Link aktywacyjny: pułapki przycisku w e-mailu z zaproszeniem

Spersonalizowany link do aktywacji jest w e-mailu tylko w bloku szkolenia. Wyłączenie tego bloku zostawia przycisk prowadzący na zwykły ekran logowania, na którym osoba bez hasła nic nie zrobi. Opisujemy mechanikę linku, typowe pułapki wdrożeniowe i bezpieczny sposób dostosowania szablonu zaproszenia.

7 dni
ważność tokenu aktywacyjnego
Źródło: dokumentacja funkcji zaproszeń
1
link aktywacyjny w jednym e-mailu
Źródło: dokumentacja funkcji zaproszeń

Z czego składa się link aktywacyjny

Link aktywacyjny ma postać adresu instancji z fragmentem konto/start, identyfikatorem i tokenem. Zaproszenie tworzy konto nieaktywne z pustym hasłem i wysyła jeden e-mail z jednym takim linkiem. Link jest jedyną drogą, którą nowa osoba przechodzi od zaproszenia do działającego konta.

Token pozostaje ważny 7 dni, a samo otwarcie linku go nie zużywa. Jeśli na koncie czeka obowiązkowe szkolenie, link kieruje najpierw na szkolenie, a hasło ustawia się dopiero po nim. Bez szkolenia prowadzi od razu do ustawienia hasła.

Pułapka: link jest tylko w bloku szkolenia

W szablonie e-maila z zaproszeniem spersonalizowany link do aktywacji występuje wyłącznie w bloku szkolenia. To rozwiązanie jest zamierzone: szkolenie jest pierwszym krokiem ścieżki, więc przycisk prowadzący do niego niesie link.

Konsekwencja dotyka administratora szablonów. Wyłączenie bloku szkolenia, na przykład w celu skrócenia wiadomości, zostawia przycisk prowadzący na zwykły ekran logowania. Osoba, która nie ma jeszcze hasła, nie ma tam nic do zrobienia: nie ustawi hasła, nie rozpocznie szkolenia i nie zobaczy wyjaśnienia. Z jej perspektywy zaproszenie nie działa.

Dlaczego nie da się tego zrobić inaczej

Administrator może mieć wrażenie, że przycisk i blok to dwa niezależne elementy, a blok da się usunąć bez skutków ubocznych. Mechanika jest jednak taka, że blok nie jest ozdobą, tylko nośnikiem personalizacji: bez niego do przycisku nie trafia adres z tokenem.

Z tego powodu zalecamy traktować blok szkolenia jako element obowiązkowy szablonu zaproszenia. Dostosować można jego treść, nagłówek i podpis, ale nie jego obecność. Jeśli zakład nie prowadzi szkolenia wstępnego, trzeba uzgodnić inną ścieżkę zaproszenia, a nie usuwać blok z istniejącego szablonu.

Drugi ślad: ponowne kliknięcie po aktywacji

Osoba, która aktywowała konto, ale nie ustawiła hasła, przy kolejnym kliknięciu tego samego linku trafia na ekran logowania, na którym nie ma hasła. Objaw jest taki sam jak po usunięciu bloku szkolenia, ale przyczyna inna: stan konta, a nie szablon.

Dla wsparcia ma to znaczenie diagnostyczne. Gdy kilka osób zgłasza ekran logowania bez możliwości ustawienia hasła, najpierw sprawdza się szablon e-maila, a dopiero potem stan kont.

Co sprawdzić przed zmianą szablonu

Każdą zmianę szablonu zaproszenia warto przetestować na koncie testowym. Wysyła się zaproszenie, otwiera link i przechodzi ścieżkę do końca. Ponieważ otwarcie linku nie zużywa tokenu, test jest bezpieczny i nie wymaga zakładania kolejnego konta przy każdej próbie.

Dopiero po udanym teście szablon trafia do zaproszeń produkcyjnych. W dokumentacji wdrożenia zapisuje się datę testu i wersję szablonu, co ułatwia diagnozę, gdy po miesiącu ktoś zgłosi problem z zaproszeniem.

  • nie wyłączaj bloku szkolenia w szablonie zaproszenia
  • zmiany treści testuj na koncie testowym
  • przy zgłoszeniach „nie mogę ustawić hasła” sprawdź najpierw szablon
  • zapisz datę i wersję szablonu w dokumentacji wdrożenia

Materiał wideo

Często zadawane pytania

Czy administrator może wyłączyć blok szkolenia w e-mailu?

Technicznie tak, ale spersonalizowany link do aktywacji jest tylko w tym bloku. Po jego wyłączeniu przycisk prowadzi na zwykły ekran logowania, na którym osoba bez hasła nic nie zrobi.

Czy test linku zużywa token?

Nie. Samo otwarcie linku nie zużywa tokenu, a ten pozostaje ważny 7 dni, więc test jest bezpieczny.

Dlaczego ponowne kliknięcie nie pozwala ustawić hasła?

Po aktywacji konta bez ustawienia hasła ten sam link prowadzi na ekran logowania, na którym nie ma hasła. Objaw przypomina skutek wyłączonego bloku szkolenia, ale przyczyną jest stan konta.

Sprawdź szablon zaproszenia przed wdrożeniem

Przejdziemy wspólnie ścieżkę zaproszenia na koncie testowym i ustalimy, które elementy szablonu można bezpiecznie dostosować.

Porozmawiajmy