NetSendo v2.3.2: Powitania i bezpieczniejsza rejestracja

Pierwsze wrażenie ma znaczenie. Wyobraź sobie klienta, który właśnie zamówił instancję NetSendo Cloud. Otwiera skrzynkę, a pierwszy e-mail brzmi: "We received a request to reset the password". Nie prosił o to, a wiadomość może nawet nie być w jego języku. Wygląda to na pomyłkę albo phishing i źle rozpoczyna relację z produktem, któremu klient ma powierzyć swoich odbiorców.

NetSendo v2.3.2 to naprawia. Dba też o to, by e-maile z hasłem prowadziły do Twojej instalacji, i usuwa link „Zarejestruj się”, gdy rejestracja nie jest już możliwa. To niewielkie zmiany, ale ułatwiają pierwsze kroki w każdej instalacji NetSendo, w chmurze i na własnym serwerze.

🚀 Co nowego w v2.3.2

E-maile powitalne dla nowych instancji Cloud

Podczas zakładania instancji NetSendo Cloud polecenie netsendo:bootstrap tworzy administratora i prosi przekaźnik haseł o wysłanie mu linku do ustawienia hasła. Przed tym wydaniem przekaźnik nie odróżniał nowego konta od zapomnianego hasła. Każdy nowy klient dostawał standardowy e-mail o resecie, po angielsku.

Teraz polecenie bootstrap informuje przekaźnik, że to powitanie (reason: welcome), i podaje język przez --locale, czyli język zamówienia. Klient, który zamówił po polsku, dostaje powitanie po polsku.

To tak, jakby hotel zamiast mówić nowemu gościowi „Słyszeliśmy, że zgubił Pan klucz”, po prostu go powitał i wręczył mu klucz.

Linki do hasła prowadzą do Twojej instalacji

Przy każdym zapytaniu przekaźnik haseł dostaje teraz także adres logowania tej instalacji (login_url, pobierany z APP_URL), a do tego język i imię administratora. Przekaźnik buduje z tego adresu link w e-mailu. Wcześniej link mógł prowadzić do hosta samego przekaźnika, co myliło użytkowników i sprawiało, że wiadomość budziła mniejsze zaufanie.

Poniżej uproszczony szkic informacji wysyłanych z każdym zapytaniem. Dokładny format danych może się różnić.

{
  "reason": "welcome",
  "locale": "pl",
  "name": "Anna Kowalska",
  "login_url": "https://mail.example.com/login"
}

Rejestracja dostępna tylko wtedy, gdy jest możliwa

W NetSendo rejestracja tworzy administratora. Dlatego link „Nie masz konta? Zarejestruj się” pojawia się teraz tylko, zanim powstanie pierwsze konto:

• Self-hosted: działa jak dotąd. Pierwsza osoba, która otworzy świeżą instalację, rejestruje się jako jej administrator. Potem rejestracja jest zamknięta.
• Cloud: rejestracja jest zamknięta zaraz po instalacji, bo bootstrap utworzył już administratora.

Później administrator dodaje kolejnych użytkowników w aplikacji. Komunikat „Rejestracja jest zamknięta”, wcześniej tylko po polsku, jest teraz dostępny w językach angielskim, polskim, niemieckim i hiszpańskim. Wyjaśnia też powód: instalacja ma już administratora.

ℹ️ Uwaga: To zachowanie sprawdzają testy tests/Feature/RegistrationClosedTest.php i tests/Feature/BootstrapCommandTest.php.

💼 Korzyści i przypadki użycia

• ✅ E-maile powitalne pasują do tego, co użytkownik faktycznie zrobił
• ✅ Wiadomości docierają w języku klienta
• ✅ Linki prowadzą do Twojej domeny, co buduje zaufanie i zachowuje spójny branding
• ✅ Brak martwych linków rejestracji w działających instalacjach

🛠️ Krok po kroku: aktualizacja do v2.3.2

1. Zrób kopię zapasową

   Przed każdą aktualizacją zabezpiecz bazę danych i plik .env. Przy self-hostingu dane są Twoje, a kopie zapasowe także.

2. Sprawdź APP_URL

   Link logowania w e-mailach z hasłem pochodzi z APP_URL. Upewnij się, że to publiczny adres HTTPS, który faktycznie odwiedzają użytkownicy.

   APP_URL=https://mail.example.com

3. Pobierz nowe wydanie

   Jeśli używasz Dockera, pobierz zaktualizowane obrazy i zrestartuj usługi. Dostosuj polecenia do swojej konfiguracji.

   docker compose pull
   docker compose up -d

4. Wyczyść zapisaną konfigurację

   Jeśli zmieniłeś APP_URL, wyczyść zapisaną w pamięci podręcznej konfigurację, aby nowa wartość zaczęła działać. Nazwa usługi zależy od Twojego pliku compose.

   docker compose exec app php artisan config:clear

5. Sprawdź stronę logowania

   Otwórz /login w oknie prywatnym. W instalacji, która ma już administratora, link „Zarejestruj się” nie powinien być widoczny.

6. Przetestuj „Nie pamiętasz hasła?”

   Poproś o reset dla testowego użytkownika i sprawdź, czy link w e-mailu prowadzi do Twojej domeny.

⚠️ Częsty błąd: Jeśli APP_URL to nadal http://localhost lub wewnętrzna nazwa hosta Dockera, e-maile z hasłem będą zawierać ten adres. Zawsze ustawiaj publiczny URL.

💡 Wskazówka: Na świeżym serwerze self-hosted zarejestruj konto administratora od razu po instalacji. Dopóki nie ma pierwszego konta, administratorem zostaje pierwsza osoba, która otworzy instalację.

php artisan test --filter=RegistrationClosedTest
php artisan test --filter=BootstrapCommandTest

🏁 Podsumowanie

v2.3.2 to niewielkie wydanie, które usprawnia pierwsze kroki użytkowników:

• Nowi administratorzy Cloud dostają e-mail powitalny w swoim języku, a nie e-mail o resecie hasła.
• E-maile z hasłem prowadzą do Twojej instalacji, na podstawie APP_URL.
• Strona logowania pokazuje rejestrację tylko wtedy, gdy jest możliwa, a komunikat „Rejestracja jest zamknięta” jest przetłumaczony na cztery języki i wyjaśnia powód.

Szczegóły konfiguracji znajdziesz w dokumentacji. Aby połączyć NetSendo z innymi narzędziami, przejrzyj integracje.