Dla kogo są te zalecenia
Zalecenia kierujemy do administratora IT lub OT zakładu, który odpowiada za instalację InnerWeb i jej integracje. Dotyczą trzech elementów: tokenu maszynowego chroniącego endpoint historii pracy, kluczy używanych do weryfikacji tożsamości oraz tokenu tożsamości z portalu przy logowaniu.
Każdy z elementów ma inną rolę. Token maszynowy otwiera odczyt historii pracy dla portalu. Zestaw kluczy publicznych wystawcy pozwala sprawdzić podpis. Token tożsamości dowodzi, że to portal potwierdził daną osobę. Pomylenie ich ról kończy się luką, której nie widać w teście funkcjonalnym.
Zalecenie 1: pusty token oznacza zamknięty endpoint
Endpoint historii pracy jest chroniony wyłącznie tokenem maszynowym w nagłówku. Pusty token po stronie serwera oznacza, że instalacja bez włączonej integracji niczego nie udostępnia. To dobra wiadomość dla zakładów, które jeszcze nie otwierają się na portal: brak konfiguracji jest stanem bezpiecznym.
Zalecamy więc nie wpisywać tokenu na zapas. Ustaw go dopiero w dniu uruchomienia integracji i zapisz datę, aby można było zaplanować rotację. Przed uruchomieniem sprawdź, że wywołanie bez tokenu jest odrzucane.
Zalecenie 2: token tylko w nagłówku, nigdy w adresie
Token maszynowy nie jest przyjmowany w adresie URL, ponieważ adresy trafiają do logów dostępowych serwera, proxy i narzędzi monitorujących. Token w logu to token wyciekły do każdego, kto ma dostęp do logów.
Przy konfiguracji po stronie portalu upewnij się, że wywołania wysyłają token w nagłówku. Dodaj do listy kontrolnej przegląd logów dostępowych po pierwszym tygodniu pracy: nie powinno być w nich żadnych parametrów z tokenem.
Zalecenie 3: weryfikacja tokenu tożsamości w całości
Token tożsamości z portalu jest weryfikowany podpisem RS256 z kluczem pobieranym wyłącznie z publicznego zestawu kluczy wystawcy oraz kontrolą wystawcy, odbiorcy, czasu ważności i jednorazowej wartości nonce. Żadnego z tych elementów nie wolno wyłączać dla wygody testów na produkcji.
Dla IT oznacza to dwie rzeczy. Zadbaj, aby serwer zakładu miał dostęp do publicznego zestawu kluczy wystawcy, oraz aby czas na serwerze był zsynchronizowany, bo kontrola ważności zależy od zegara. Rozjazd zegara o kilka minut potrafi odrzucać poprawne logowania i bywa mylony z awarią portalu.
- Podpis RS256 z kluczem z publicznego zestawu wystawcy.
- Kontrola wystawcy i odbiorcy.
- Kontrola czasu ważności.
- Jednorazowa wartość nonce.
Zalecenie 4: rotacja tokenu obejmuje rejestrację z plakatu
Przy włączonej rejestracji z plakatu token maszynowy portalu może zakładać konta, firmy i wydawać przepustki. To szerszy zakres niż sam odczyt historii pracy. Rotacja tokenu i ocena ryzyka muszą więc obejmować także ten zakres.
Zalecamy traktować token jak klucz o uprawnieniach administracyjnych w obszarze wykonawców: przechowywać w menedżerze sekretów, ograniczyć grono osób z dostępem i zaplanować cykliczną rotację wraz z procedurą awaryjną po podejrzeniu wycieku. Decyzję o terminach rotacji podejmuje właściciel bezpieczeństwa zakładu.
Zalecenie 5 i 6: logowanie przez standardową ścieżkę oraz dowód w logach
Logowanie przez portal przechodzi przez standardową ścieżkę zakładu, więc działa weryfikacja dwuskładnikowa, a konta zablokowane, wyłączone, usunięte lub wygasłe są odrzucane tak samo jak przy haśle. Nie twórz wyjątków dla wykonawców i nie omijaj tej ścieżki dla wygody.
Do audytu zachowuj dowody: datę ustawienia tokenu, datę ostatniej rotacji, wynik testu odrzucenia wywołania bez tokenu oraz zapis przeglądu logów. Panel integracji pokazuje błędy z 7 dni, co pomaga wychwycić anomalie, ale nie zastępuje przeglądu logów serwera.
Zalecenie 7: test przed otwarciem
Przed otwarciem zakładu na portal wykonaj krótki test końcowy: wywołanie bez tokenu, z błędnym tokenem i z poprawnym, logowanie osobą z kontem zablokowanym oraz logowanie z wygasłym tokenem tożsamości. Każdy z pięciu przypadków powinien dać oczekiwaną odmowę lub zgodę.
Wyniki zapisz w protokole wdrożenia. To ten sam dokument, który za rok pokaże audytorowi, że kontrola dostępu do integracji była sprawdzona, a nie tylko zadeklarowana.
Lista kontrolna
Materiał wideo
Często zadawane pytania
Czy mogę przekazać token w adresie, jeśli portal tak woli?
Nie. Token nie jest przyjmowany w adresie, bo adresy trafiają do logów dostępowych. Wysyłaj go w nagłówku.
Co sprawdza serwer przy tokenie tożsamości?
Podpis RS256 kluczem z publicznego zestawu wystawcy, wystawcę, odbiorcę, czas ważności i jednorazową wartość nonce.
Kto decyduje o terminie rotacji tokenu?
Właściciel bezpieczeństwa zakładu. Dokumentacja wskazuje zakres ryzyka, ale okres rotacji wynika z polityki zakładu.
Źródła
Porozmawiajmy o portalu wykonawców w Twoim zakładzie
Pokażemy na żywym przykładzie, jak wniosek wykonawcy trafia do operatora i jak zakład zachowuje pełną kontrolę nad wejściem na teren.
Porozmawiajmy