Przejdź do głównej zawartości

Uwierzytelnianie (auth)

Wspólne mechanizmy sesji i zabezpieczenia tras, z których korzystają zarówno customer_accounts, jak i admin_users. Według konwencji nazewnictwa to jeden z dwóch katalogów modułów, które mogą mieć nazwę w liczbie pojedynczej (obok example).

Za co odpowiada​

  • Sesje — session-service.ts zapisuje wiersze sesji w Postgresie, z warstwą pamięci podręcznej w Redis dla częstych odczytów; ciasteczka są podpisywane przez @fastify/cookie.
  • Hashowanie haseł — nie należy do tego modułu: hashPassword / verifyPassword należą do platformy (@endora-commerce/platform/kernel, packages/platform/src/kernel/crypto/password-hasher.ts), argon2id z parametrami OWASP (19 MiB, dwa przebiegi). Zobacz sekcję Hardware & system requirements w README.md w katalogu głównym repozytorium.
  • TOTP — również nie należy do tego modułu: totp.ts modułu mfa opakowuje otpauth, a jego kody odzyskiwania to wiersze w mfa_enrolments.
  • Plugin Fastify — plugin.ts odczytuje ciasteczko sesji i ustawia request.actor = { kind, id, ... } oraz request.adminActor.
  • Zabezpieczenia tras — requireAdmin(permission?), requireAdminAny(codes) i requireCustomer, udostępniane jako porty z kompozycji tego modułu (src/backend/index.ts) i pobierane przez każdy moduł, który chroni trasy. Kiedyś były dekoratorami Fastify w pluginie; zamieniono je na porty, aby produkcja i środowisko testowe korzystały z tej samej implementacji, a nie z dwóch różnych. Oba zabezpieczenia administracyjne odrzucają też, z kodem 401, sesję, której konto administratora nie jest już aktywne (dezaktywowane, usunięte albo nieistniejące), dzięki czemu sesja, która przetrwała swoje konto, przestaje działać; aktywne konto bez wymaganego uprawnienia otrzymuje 403. SessionService.destroyAllForAdmin(adminUserId, { exceptSessionId? }) unieważnia sesje administratora oraz rozpoczęte przez niego sesje logowania jako klient, opcjonalnie pozostawiając jedną.

Ostatnia aktywność​

Każdy wiersz sesji ma pole last_seen_at: kiedy ostatnio przyszło żądanie z ciasteczkiem tej sesji. Jest ono aktualizowane dla sesji klientów, a odkąd potrzebowały tego przypomnienia o wydarzeniach w CRM — także dla sesji administratorów; wcześniej wiersz administratora przechowywał czas zalogowania i nic poza nim.

  • Z ograniczeniem częstotliwości. SessionService.touchLastSeen zapisuje najwyżej raz na minutę dla jednej sesji: każde uwierzytelnione żądanie kosztuje jedno polecenie Redis SET NX EX 60, a wiersz aktualizuje tylko pierwsze żądanie w danej minucie. Zapis nie jest oczekiwany, więc nigdy nie opóźnia żądania ani nie powoduje jego błędu.
  • Odczyt przez port AuthSessionReadPort (nazwa w kontenerze: authSessionReadPort): lastSeenByCustomerAccount(ids, since) i lastSeenByAdminUser(ids, since) zwracają najnowsze lastSeenAt każdej osoby spośród sesji widzianych w chwili since albo później. Osoby, która nie ma takiej sesji, w odpowiedzi nie ma.
  • Sesja w imieniu klienta to obecność klienta. Sesja, w której administrator działa jako klient, liczy się temu klientowi, a nie administratorowi.
  • Co to mierzy. Otwarty Admin UI pyta o powiadomienia co 30 sekund, więc „widziany w ostatnich minutach” znaczy ma Admin UI otwarty w przeglądarce. Nie mówi, czy ktokolwiek na niego patrzy.

Brak własnych tras HTTP​

auth to moduł z podstawowymi mechanizmami. Endpointy logowania i wylogowania klienta obsługuje organizations (korzystając z usług customer_accounts), administratora — admin_users, a drugi krok logowania dwuetapowego — mfa.

Punkty rozszerzenia​

  • Przechowywanie sesji — session-service jest tworzony z (emFactory, redis); tu podłącza się alternatywną pamięć podręczną.
  • Własne rodzaje użytkowników — rozszerz unię rozłączną request.actor i zaktualizuj pre-handlery requireX; istniejący kod nadal działa, bo trasy korzystają tylko z fabryk requireX, których już używają.