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.tszapisuje 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/verifyPasswordnależą 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 wREADME.mdw katalogu głównym repozytorium. - TOTP — również nie należy do tego modułu:
totp.tsmodułumfaopakowujeotpauth, a jego kody odzyskiwania to wiersze wmfa_enrolments. - Plugin Fastify —
plugin.tsodczytuje ciasteczko sesji i ustawiarequest.actor = { kind, id, ... }orazrequest.adminActor. - Zabezpieczenia tras —
requireAdmin(permission?),requireAdminAny(codes)irequireCustomer, 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.touchLastSeenzapisuje najwyżej raz na minutę dla jednej sesji: każde uwierzytelnione żądanie kosztuje jedno polecenie RedisSET 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)ilastSeenByAdminUser(ids, since)zwracają najnowszelastSeenAtkażdej osoby spośród sesji widzianych w chwilisincealbo 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-servicejest tworzony z(emFactory, redis); tu podłącza się alternatywną pamięć podręczną. - Własne rodzaje użytkowników — rozszerz unię rozłączną
request.actori zaktualizuj pre-handleryrequireX; istniejący kod nadal działa, bo trasy korzystają tylko z fabrykrequireX, których już używają.