SSD Nodes Learn Hosting plans →
Przewodniki Matt ConnorAutor: Matt Connor · Zaktualizowano 2026-10-15

Ataki na łańcuch dostaw npm: jak zabezpieczyć serwer

Analiza mechanizmów infekcji przez skrypty postinstall, typosquatting oraz złośliwe aktualizacje pakietów. Dowiedz się, jak wdrożyć bezpieczny proces instalacji npm na VPS.

Czym jest atak na łańcuch dostaw npm na serwerze

Atak na łańcuch dostaw npm dociera do serwera za pośrednictwem pakietu wybranego do instalacji. Nie jest do tego potrzebny otwarty port ani etap wykorzystania luki. npm instaluje kod, a instalacja kodu powoduje jego uruchomienie. Dlatego niewielka aplikacja Node pobiera kilkaset pakietów, których zawartości nigdy nie sprawdzano. Każdy z tych pakietów może godzinę później opublikować nową wersję.

Wdrożenie pobiera złośliwą wersję, ponieważ polecenie instalacji zażądało najnowszej wersji spełniającej określone wymagania. Ten kod jest następnie uruchamiany z uprawnieniami użytkownika, który wykonał instalację. Wszystkie opisane poniżej przypadki wynikają z tych dwóch zdań.

Przypadki uporządkowano według częstotliwości, z jaką dotykają jednej osoby wdrażającej jedną aplikację Node na jednym VPS. Duża firma zastosowałaby inną kolejność, ponieważ ma wewnętrzny rejestr, zespół przeprowadzający przeglądy oraz mirror publicznego rejestru. W tym przypadku dostępny jest skrypt wdrożeniowy.

Scenariusz 1: konto opiekuna pakietu zostaje przejęte i publikuje poprawkę

Rejestr npm nie pozwala na zmianę zawartości wersji, która już istnieje. Atakujący, który przejmie konto opiekuna poprzez phishing lub kradzież tokena publikacji, nie może nadpisać 4.18.2. Publikuje on natomiast 4.18.3.

Należy sprawdzić plik package.json. Linia taka jak "express": "^4.18.2" nie oznacza wersji 4.18.2. Znak karetki oznacza „dowolną wersję 4.x równą lub wyższą od tej”, a ~4.18.2 oznacza „dowolną wersję 4.18.x”. Polecenie npm install rozwiązuje ten zakres w momencie uruchomienia, więc ten sam commit w git, wdrożony dwukrotnie tego samego popołudnia, może zainstalować dwa różne zestawy kodu. Ta luka stanowi powierzchnię ataku. Aby ją wykorzystać, nie trzeba przejmować żadnego elementu na lokalnej maszynie.

Złośliwe wydania są zazwyczaj zgłaszane i usuwane, ale usunięcie następuje dopiero po tym, jak użytkownicy zdążą je zainstalować. Każdy, kto przeprowadził wdrożenie w tym oknie czasowym, posiada ten kod na dysku. Potok CI/CD, który rozwiązuje zakresy przy każdym uruchomieniu, wchodzi w to okno automatycznie, kilka razy w tygodniu, bez świadomej decyzji użytkownika.

Wariant 2: skrypt instalacyjny uruchamiany jako użytkownik wykonujący wdrożenie

Plik package.json pakietu może deklarować preinstall, install, postinstall oraz prepare w swoim bloku scripts. npm uruchamia je podczas instalacji. Nie są one izolowane w piaskownicy i nikt ich nie weryfikuje. Są to polecenia powłoki wykonywane z uprawnieniami użytkownika, który wydał polecenie instalacji, w jego katalogu domowym, z jego dostępem do sieci oraz pełnym środowiskiem tej powłoki.

npm 12, wydany 8 lipca 2026, zmienia to domyślne zachowanie: blokuje skrypty instalacyjne zależności, chyba że pole allowScripts w package.json projektu je zatwierdza. Na dzień 12 października 2026 żadne wydanie Node.js nie zawiera npm 12 (Node.js 26.11.1 dostarczany jest z npm 11.20.0), więc jeśli npm nie został zaktualizowany samodzielnie, używana na serwerze wersja npm nadal uruchamia wszystkie te skrypty.

Zatem istotne pytanie nie dotyczy tego, co może zrobić pakiet. Dotyczy tego, co może odczytać dany użytkownik. Na typowym serwerze wdrożeniowym odpowiedź obejmuje ~/.npmrc zawierający token rejestru, ~/.ssh/id_ed25519 używany jako klucz wdrożeniowy dla SSH (secure shell), ~/.aws/credentials, ~/.docker/config.json oraz każdą zmienną wyeksportowaną w powłoce, gdzie zazwyczaj znajduje się DATABASE_URL.

Ładunek typu payload nie wymaga trwałości ani eskalacji uprawnień. Odczytuje kilka plików, wysyła je do hosta przez HTTPS i kończy działanie ze statusem 0. Użytkownik niczego nie zauważa, ponieważ npm domyślnie ukrywa wyjście skryptów instalacyjnych. Należy to wyłączyć, aby monitorować faktycznie wykonywane operacje:

npm ci --foreground-scripts

foreground-scripts współdzieli standardowe wejście, wyjście i błąd z procesem npm, dzięki czemu skrypty budowania wypisują komunikaty bezpośrednio w terminalu, zamiast do bufora, który npm odrzuca po pomyślnej instalacji.

Wariant 3: typosquatting i nazwa, której nie wpisano poprawnie

Typosquatting to publikacja pakietu pod nazwą zbliżoną do popularnego odpowiednika, w oczekiwaniu na błędnie wpisaną lub wklejoną komendę instalacji. Mechanizm ataku opiera się na komendzie, a nie na kodzie, więc plik blokady (lockfile) nie zapewnia ochrony: po jednorazowym dodaniu błędnej nazwy, plik blokady będzie ją wiernie utrzymywał.

Wariantem, który dotyka zespoły zamiast pojedynczych użytkowników, jest dependency confusion. Wewnętrzny pakiet nosi nazwę billing-utils i znajduje się w prywatnym rejestrze. Jeśli w publicznym rejestrze nie istnieje nic o nazwie billing-utils, każdy może taki pakiet opublikować. npm rozwiązuje nazwy bez zakresu (unscoped) względem domyślnego publicznego rejestru, więc publiczna kopia może zostać wybrana. Rozwiązaniem jest własny zakres (scope) oraz mapowanie rejestru dla tego zakresu w pliku .npmrc:

@yourorg:registry=https://npm.yourorg.example/
//npm.yourorg.example/:_authToken=${NPM_TOKEN}

Teraz pakiet @yourorg/billing-utils jest zawsze pobierany wyłącznie z tego hosta, ponieważ mapowanie zakresu do rejestru jest sprawdzane przed domyślnym rejestrem. Wewnętrzna nazwa bez zakresu nie posiada mapowania, więc nie podlega ochronie.

Przed dodaniem nowej zależności należy przyjrzeć się samemu pakietowi, zamiast polegać wyłącznie na liczbie pobrań:

npm view some-lib repository.url maintainers time.created time.modified

Pakiet utworzony w zeszłym miesiącu, opublikowany przez konto, którego nie można powiązać z publicznym repozytorium, stanowi inne ryzyko niż pakiet z sześcioletnią historią. Żaden z tych faktów nie jest dowodem bezpieczeństwa. Oba są jednak łatwe do zweryfikowania.

Wariant 4: zależność, której właściciel zmienił się bez rozgłosu

Opiekunowie przekazują pakiety innym osobom. Ktoś rezygnuje z pracy nad projektem, zgłasza się ochotnik, uprawnienia do publikacji zostają przeniesione, a projekty zależne nie otrzymują żadnego powiadomienia. Nie dochodzi do naruszenia bezpieczeństwa. Zaufanie, którym obdarzono pakiet w 2021 roku, znajduje się teraz w rękach innej osoby.

Jest to najwolniejszy wariant ataku i najtrudniejszy do wykrycia; żadne polecenie nie daje na niego bezpośredniej odpowiedzi. Dwa działania pozwalają ograniczyć to ryzyko. Przed przyjęciem pakietu sprawdź, kto ma uprawnienia do publikacji, korzystając z linii npm view powyżej. Następnie, gdy pakiet, od którego zależy Twój projekt, zmienia właściciela, przeanalizuj różnice w kodzie:

npm diff --diff-name-only --diff=some-lib@1.4.2 --diff=some-lib@1.4.3
npm diff --diff=some-lib@1.4.2 --diff=some-lib@1.4.3

Pierwsza forma wyświetla tylko nazwy zmienionych plików, co jest wystarczająco szybkie, aby wykonywać to przy każdej aktualizacji istotnego pakietu. Wydanie poprawkowe, które modyfikuje skrypt budowania, dodaje plik w katalogu głównym pakietu lub edytuje blok scripts, warto przeczytać w całości, zanim trafi ono na serwer.

Budowanie z zatwierdzonego pliku lockfile za pomocą npm ci

package-lock.json rejestruje dokładną wersję każdego pakietu w drzewie, adres URL, z którego pochodzi, skrót sha512 integralności każdego archiwum tarball oraz informację, który pakiet go wymagał. Należy go zatwierdzić w repozytorium. Jest to jedyny plik, który określa, co faktycznie zostało przetestowane.

Następnie należy przeprowadzić instalację za pomocą npm ci, nigdy npm install, na każdej maszynie, która nie jest laptopem programisty:

npm ci --omit=dev --ignore-scripts

npm ci różni się od npm install w sposób istotny w tym kontekście. Wymaga istnienia pliku lockfile. Usuwa istniejący katalog node_modules przed rozpoczęciem pracy, dzięki czemu pozostałości po wcześniejszym wdrożeniu nie przenikną do bieżącego. Nigdy nie zapisuje zmian w package.json ani w pliku lockfile, więc instalacja nie spowoduje cichej aktualizacji wersji. Jeśli plik lockfile i package.json są ze sobą sprzeczne, proces kończy się błędem zamiast próbować rozwiązać różnice.

Ten błąd jest funkcją, a nie niedogodnością. Oznacza to, że zmiana zależności musi zostać wprowadzona jako zatwierdzenie (commit), które ktoś sprawdził, a nie jako efekt uboczny wdrożenia o godzinie 02:00.

Skrót integralności jest sprawdzany przy każdym pobieraniu. Archiwum tarball, którego bajty nie zgadzają się z zapisanym skrótem, powoduje przerwanie instalacji z błędem code EINTEGRITY zamiast rozpakowania. Należy precyzyjnie określić, co to daje: potwierdza, że otrzymany plik jest tym samym plikiem, który został przypięty w lockfile, co stanowi tę samą gwarancję, którą daje weryfikacja pobrań za pomocą sum kontrolnych, i jest ograniczone w ten sam sposób. Nie mówi nic o tym, czy przypięta wersja była złośliwa w momencie publikacji.

Jeden szczegół dotyczący --omit=dev: pakiety te są nadal rozwiązywane i zapisywane w pliku lockfile. Nie są one jedynie umieszczane na dysku. Mniejsza liczba pakietów na dysku oznacza mniej skryptów instalacyjnych i mniej kodu ładowanego w czasie wykonywania, więc warto to robić. Nie usuwa to zależności z drzewa projektu.

Traktuj skrypty instalacyjne jak kod i wiedz, kiedy ich odmówić

Skrypty instalacyjne można wyłączyć. Umieść poniższą konfigurację w pliku .npmrc projektu i zatwierdź ją razem z plikiem blokady:

ignore-scripts=true
save-exact=true

ignore-scripts=true uniemożliwia narzędziu npm uruchamianie skryptów zadeklarowanych w zależnościach. save-exact=true powoduje, że npm install some-lib zapisuje 1.4.2 w pliku package.json zamiast w ^1.4.2, dzięki czemu zakres wersji nie trafia przypadkowo do manifestu.

Powoduje to problemy i przed włączeniem tej opcji należy wiedzieć, jak je rozwiązywać. Pakiety kompilujące natywny dodatek lub pobierające gotowy plik binarny wykonują te operacje w skrypcie instalacyjnym. Przy wyłączonych skryptach sama instalacja kończy się powodzeniem, a błąd pojawia się później, w czasie działania, jako moduł, który nie może załadować swojego pliku powiązania. Rozwiązaniem jest lista dozwolonych pakietów:

npm ci --ignore-scripts
npm rebuild better-sqlite3 --ignore-scripts=false

npm rebuild <package> uruchamia skrypty kompilacji dla tego jednego pakietu. Opcja --ignore-scripts=false jest wymagana: npm rebuild respektuje zapisany przed chwilą plik ignore-scripts=true w .npmrc, a bez tego nadpisania dołącza pliki binarne pakietu i nie uruchamia żadnego z jego skryptów. W ten sposób podejmowana jest decyzja dla każdego pakietu osobno, zamiast przyznawania ogólnych uprawnień wykonywania kilkuset nieznanym dostawcom.

W przypadku npm 12 ta lista dozwolonych pakietów jest wbudowana. npm approve-scripts better-sqlite3 zapisuje zgodę w polu allowScripts pliku package.json, skrypty niezatwierdzonych zależności są pomijane z ostrzeżeniem, a npm rebuild sprawdza tę samą listę, dlatego w npm 12 przedstawiona wyżej przebudowa również wymaga tej zgody. Zatwierdzony plik ignore-scripts=true całkowicie zastępuje zasady allowScripts.

Aby sprawdzić aktualny zakres przyznanych uprawnień, zapytaj npm:

npm query ":attr(scripts, [postinstall])"

Polecenie wyświetla każdy pakiet w zainstalowanym drzewie, który zawiera skrypt postinstall. W typowej aplikacji lista jest krótsza, niż można oczekiwać, co dokładnie sprawia, że lista dozwolonych pakietów jest praktyczna.

Oddziel budowanie od procesu obsługującego ruch

Użytkownik deploy musi mieć możliwość zapisu do node_modules. Proces obsługujący żądania HTTP nie potrzebuje takiego dostępu. Jeśli oba procesy używają tego samego konta, kod uruchamiany podczas instalacji może zmodyfikować kod obsługujący użytkowników. Kod działający w czasie wykonywania również może go zmodyfikować.

Należy je rozdzielić. Budowanie należy wykonywać jako jeden użytkownik, a obsługę żądań jako inny. Katalog udostępniany przez usługę powinien być tylko do odczytu dla konta usługi:

sudo useradd --system --home-dir /srv/nodeapp --shell /usr/sbin/nologin nodeapp
sudo chown -R deploy:nodeapp /srv/nodeapp
sudo chmod -R o-rwx /srv/nodeapp

Następnie należy wymusić te zasady za pomocą systemd. Należy utworzyć /etc/systemd/system/nodeapp.service:

[Unit]
Description=Node application
After=network-online.target

[Service]
User=nodeapp
Group=nodeapp
WorkingDirectory=/srv/nodeapp/current
EnvironmentFile=/etc/nodeapp/env
ExecStart=/usr/bin/node server.js
Restart=on-failure

NoNewPrivileges=yes
ProtectSystem=strict
ProtectHome=yes
PrivateTmp=yes
ReadWritePaths=/srv/nodeapp/shared
NoExecPaths=/srv/nodeapp/shared
RestrictAddressFamilies=AF_INET AF_INET6 AF_UNIX

[Install]
WantedBy=multi-user.target

ProtectSystem=strict montuje cały system plików w trybie tylko do odczytu dla tej usługi, z wyjątkiem /dev, /proc, /sys oraz elementów wymienionych w ReadWritePaths. Dlatego próba zapisu aplikacji do node_modules kończy się błędem EROFS: read-only file system. Można to odtworzyć we własnych logach w ciągu około minuty. NoExecPaths obejmuje zapisywalny katalog przesyłania plików. Usługa może zapisywać w nim pliki, ale kernel odmawia ich wykonania. Ta opcja wymaga systemd 248 lub nowszego. Ubuntu 24.04 zawiera wersję 255.

W tym pliku jednostki należy uważać na dwie kwestie. Po pierwsze, nie należy dodawać MemoryDenyWriteExecute=yes. Ta opcja występuje na większości list wzmacniania zabezpieczeń systemd i uniemożliwia uruchomienie Node, ponieważ V8 kompiluje JavaScript do kodu maszynowego w czasie wykonywania i wymaga stron jednocześnie zapisywalnych i wykonywalnych. Po drugie, ścieżkę ExecStart należy pobrać z command -v node. Jeśli Node zainstalowano za pomocą menedżera wersji, znajduje się on w katalogu domowym użytkownika deploy. ProtectHome=yes ukrywa ten katalog przed usługą, więc jednostka natychmiast kończy działanie z błędem status=203/EXEC, a w logu pojawia się informacja, że nie można było znaleźć pliku wykonywalnego.

Należy sprawdzić wynik zamiast bezkrytycznie ufać plikowi:

sudo systemctl daemon-reload
sudo systemctl enable --now nodeapp
sudo systemd-analyze security nodeapp.service
sudo -u nodeapp touch /srv/nodeapp/current/probe

systemd-analyze security wyświetla każde ustawienie wzmacniania zabezpieczeń wraz z informacją o jego ekspozycji. Dzięki temu można sprawdzić, które ustawienia nadal mają wartości domyślne. Polecenie touch powinno zakończyć się błędem Permission denied, ponieważ nodeapp nie jest właścicielem żadnego elementu w current. Jeśli polecenie zakończy się powodzeniem, własność plików jest nieprawidłowa, a ustawienia systemd maskują ten problem.

Jedna uwaga dotycząca EnvironmentFile: systemd odczytuje ten plik jako root, zanim przełączy się na User=nodeapp. Dlatego plik może mieć właściciela root:root i tryb 600. Aplikacja nadal otrzyma zmienne. Każdy, kto uzyska powłokę jako nodeapp, może odczytać je z /proc/<pid>/environ. Chroni to sekret zapisany na dysku, ale nie chroni działającego procesu.

Pozostaw dane uwierzytelniające wdrożenia poza środowiskiem kompilacji

Skrypty instalacyjne dziedziczą środowisko. Ten fakt powinien decydować o miejscu wykonywania kompilacji.

Najbezpieczniej jest wykonywać kompilację w miejscu innym niż serwer produkcyjny, a następnie kopiować na niego gotowy katalog. Na maszynie kompilacyjnej znajduje się wtedy wyłącznie token rejestru z uprawnieniami tylko do odczytu. Nie ma na niej klucza wdrożeniowego SSH, klucza dostępu do chmury, hasła do bazy danych ani danych logowania do rejestru kontenerów.

npm token create --name=build-readonly --packages-and-scopes-permission=read-only --packages-all --expires=30

Token z uprawnieniami tylko do odczytu może pobierać pakiety, ale nie może ich publikować. npm unieważnił wszystkie klasyczne tokeny 9 grudnia 2025, dlatego należy użyć tokenu z granularnymi uprawnieniami. To flaga uprawnień nadaje mu tryb tylko do odczytu: bieżący npm nadal akceptuje starą flagę --read-only, ale npm token create nie przekazuje jej do rejestru. Jeżeli token zostanie wykradziony ze środowiska kompilacji, skutkiem będzie dostęp tylko do odczytu do objętych nim pakietów.

Jeżeli kompilacja musi odbywać się na serwerze, należy wykonywać ją jako użytkownik deploy, przy celowo ograniczonym środowisku. Dane uwierzytelniające używane w czasie działania należy przechowywać w /etc/nodeapp/env, do którego deploy nie ma dostępu. Ta sama zasada dotyczy hostowanej samodzielnie automatyzacji kompilacji: samodzielnie hostowany runner GitHub Actions przechowuje tokeny i wykonuje dowolny opublikowany kod podczas każdego zadania, dlatego jest maszyną o najwyższej wartości w małym wdrożeniu. Każdy program, którego nie napisano samodzielnie i który otrzymuje całe środowisko procesu, należy traktować tak samo. Z tego powodu usuwanie danych uwierzytelniających ze środowiska agenta AI jest tym samym problemem, w którym pośredniczy inny program.

Przypinanie wersji lub dołączanie pakietu do repozytorium, gdy nie można go audytować

Przypięta zależność to taka, której wersja nie może się zmienić bez commita. Zacommitowany plik lock już zapewnia to dla całego drzewa. W dwóch przypadkach potrzebne są dodatkowe działania.

Pierwszym przypadkiem są zależności tranzytywne. Nie ma się kontroli nad tym, od czego zależą używane pakiety. overrides w package.json wymusza określoną wersję w dowolnym miejscu drzewa:

{
  "overrides": {
    "some-transitive-lib": "1.4.2"
  }
}

Po dodaniu tej konfiguracji należy raz uruchomić npm install, aby plik lock zapisał wynik. Następnie należy zacommitować oba pliki.

Drugim przypadkiem jest pakiet, którego nie można audytować ani usunąć. Należy dołączyć go do repozytorium. npm pack pobiera dokładne archiwum tar, które zostałoby udostępnione przez rejestr, a zależność file: instaluje pakiet z lokalnej kopii:

npm pack some-lib@1.4.2
mkdir -p vendor && mv some-lib-1.4.2.tgz vendor/
{
  "dependencies": {
    "some-lib": "file:vendor/some-lib-1.4.2.tgz"
  }
}

Archiwum tar znajduje się teraz w repozytorium i nie może się samoczynnie zmienić. Oznacza to jednak konieczność samodzielnego obsługiwania wszystkich jego aktualizacji. Należy stosować to rozwiązanie w przypadku małego, porzuconego pakietu, od którego nie można się uwolnić, a nie w przypadku frameworka webowego.

Dostępny jest również okres oczekiwania, który nic nie kosztuje:

npm install --before=2026-08-01

Opcja before przebudowuje drzewo, używając wyłącznie wersji opublikowanych w podanym dniu lub wcześniej. Podczas odświeżania zależności należy ustawić datę sprzed tygodnia lub dwóch. Pozwala to pominąć okres, w którym wadliwe wydanie jest już dostępne, ale nie zostało jeszcze zgłoszone. Jest to rozwiązanie mało precyzyjne, ponieważ wstrzymuje również rzeczywiste poprawki bezpieczeństwa. Należy użyć go do rozwiązania zakresów wersji, sprawdzić wprowadzone zmiany, a następnie zacommitować plik lock. Nowsze wydania npm akceptują również min-release-age, czyli kroczące okno wyrażone w dniach (min-release-age=7 w .npmrc). Zapewnia ono ten sam efekt bez konieczności aktualizowania daty. Takie samo podejście warto stosować w przypadku narzędzi wiersza poleceń instalowanych z npm, a nie dodawanych jako zależności. Nieprzypięte wywołanie npx pobiera wersję opublikowaną danego ranka, natomiast przypięcie konkretnej wersji dsh zapewnia uruchamianie tego samego kodu na obu maszynach.

Jak sprawdzić, która wersja została faktycznie wydana?

Plik blokady w git wskazuje, co powinno zostać zainstalowane. Stan dysku wskazuje, co jest zainstalowane. Tylko ten drugi jest dowodem.

npm ls some-lib
node -e "console.log(require('./node_modules/some-lib/package.json').version)"

npm ls odczytuje node_modules, więc raportuje stan faktyczny, a nie założenia pliku blokady. Linia node -e odczytuje zainstalowany manifest według ścieżki, co działa nawet dla pakietów, których pole exports blokuje importy podścieżek, i wypisuje jedną wersję bez rysowania drzewa zależności.

Aby wykonać drugą część porównania, należy odczytać git:

git log --oneline -- package-lock.json
git show <commit>:package-lock.json | grep -A3 '"node_modules/some-lib"'

Należy utrwalić powiązanie między tymi dwoma stanami, umieszczając commit w układzie wdrożeniowym. Wydanie należy umieścić w /srv/nodeapp/releases/<short commit sha> i wskazać na nie za pomocą dowiązania symbolicznego /srv/nodeapp/current. Odpowiedź na pytanie „co jest aktualnie uruchomione” staje się readlink /srv/nodeapp/current i jest dostępna o godzinie 03:00 dla osoby, która nie przeprowadzała wdrożenia.

Na koniec należy sprawdzić, co potwierdza rejestr:

npm audit signatures

Polecenie to weryfikuje podpisy rejestru dla pakietów w zainstalowanym drzewie oraz sprawdza atestacje pochodzenia (provenance) dla pakietów, które je posiadają. Atestacja pochodzenia wiąże opublikowane archiwum z publicznym procesem budowania w systemie ciągłej integracji (CI), który je wygenerował. Zweryfikowana atestacja oznacza możliwość prześledzenia kodu aż do konkretnego commita, zamiast do nieznanego urządzenia. Pokrycie atestacjami nie jest powszechne, dlatego brak atestacji należy interpretować jako „brak informacji”, a nie jako „wadliwy pakiet”.

Co zrobić, gdy na serwer trafi wadliwe wydanie

Należy wyjść od tego, co zostało uruchomione i na jakim koncie użytkownika.

Jeśli kod został wykonany podczas instalacji, należy założyć, że wszystko, co było dostępne do odczytu dla użytkownika budującego, zostało przejęte. Należy zrotować token rejestru, klucze SSH w tym katalogu domowym, poświadczenia chmurowe oraz każdy sekret wyeksportowany w tej powłoce. Rotacja jest jedynym uczciwym rozwiązaniem, ponieważ nie da się udowodnić, że plik nie został odczytany.

Jeśli kod został uruchomiony w czasie działania aplikacji na koncie usługi z ograniczonymi uprawnieniami, zakres dostępnych zasobów jest znacznie mniejszy: to tylko zmienne środowiskowe aplikacji oraz wszystko, do czego ma ona dostęp przez sieć. To główny argument za uruchamianiem usług jako użytkownicy bez uprawnień na VPS. Nie zapobiega to naruszeniu bezpieczeństwa. Decyduje natomiast o tym, jak dużą część maszyny obejmie naruszenie i czy przetrwa ono restart.

Następnie należy przeprowadzić przebudowę zamiast czyszczenia. Usuń node_modules, przypnij dotknięty pakiet poniżej wadliwej wersji w package.json, uruchom npm install raz, aby zaktualizować plik blokady, zatwierdź zmiany i wdróż za pomocą npm ci. Nie naprawiaj drzewa plików w miejscu. Nie da się wyliczyć wszystkich elementów, których dotknął skrypt instalacyjny.

Zapisz również przedział czasowy: pierwsze wdrożenie, które mogło pobrać tę wersję, oraz wdrożenie, które ją usunęło. Ten zakres wskazuje, które z własnych dzienników należy przejrzeć, a ustalenie go jest możliwe tylko wtedy, gdy wydania są nazywane na podstawie commitów.

Czego to wszystko nie naprawia

Lockfile nie sprawia, że zależność staje się bezpieczna. Zamienia moment zaakceptowania tej zależności w datowaną i zweryfikowaną decyzję, zamiast pozostawiać go jako skutek uboczny wdrożenia. Każda z opisanych praktyk wykonuje tę samą zamianę: przekształca przypadek w świadomy wybór.

npm audit nie zapewnia tu ochrony. Porównuje drzewo zależności z bazą zgłoszonych podatności, więc wykrywa problemy, które zostały już opublikowane i nazwane. Atak na łańcuch dostaw pozostaje nienazwany przez cały okres, w którym jest użyteczny dla atakującego. Uruchamianie npm audit służy do wykrywania starych, znanych błędów. Nie należy oczekiwać, że narzędzie wykryje problem w wydaniu opublikowanym cztery godziny temu.

Zmniejszenie liczby zależności pomaga bardziej niż dowolne narzędzie opisane w tym przewodniku, ale jest to najmniej popularna rada. Każdy pakiet, którego się nie doda, oznacza kolejnego wydawcę, którego nie można wyłudzić w celu zaatakowania środowiska, oraz kolejny skrypt instalacyjny, który nigdy nie zostanie uruchomiony z uprawnieniami użytkownika wdrażającego.

Nie dotyczy to wyłącznie npm. Te same cztery schematy dotyczą PyPI, RubyGems, obrazów kontenerów oraz menedżera pakietów dystrybucji. Problem jest najbardziej widoczny w npm, ponieważ drzewa zależności są tam najgłębsze, a npm uruchamiany na większości serwerów nadal domyślnie wykonuje skrypty instalacyjne. Każde rozszerzenie używanego już narzędzia dziedziczy ten sam problem. Dlatego ustalenie, do czego plugin dsh może uzyskać dostęp przed jego instalacją jest takim samym działaniem jak odczytanie skryptu postinstall, z uprawnieniami agenta zamiast uprawnień użytkownika wdrażającego. Zakres maszyny, który należy zabezpieczyć, zależy od miejsca uruchomienia. Jest to część szerszego pytania, czy hosting VPS jest bezpieczny.

FAQ

Czy npm ci chroni przed przejętym pakietem npm?

Chroni przed zmianą wersji bez wiedzy administratora. npm ci instaluje dokładnie to, co rejestruje package-lock.json, sprawdza każdy archiwum tarball względem jego skrótu integralności sha512 i kończy działanie błędem, jeśli package.json nie jest zgodny z plikiem blokady, zamiast samodzielnie rozwiązywać rozbieżność. Nie oznacza to, że przypięta wersja jest bezpieczna. Jeśli w repozytorium zostanie zatwierdzony plik blokady przypinający złośliwą wersję, npm ci wiernie zainstaluje tę wersję na każdym serwerze, do którego administrator ma dostęp, przy każdym wdrożeniu.

Czy należy ustawić ignore-scripts=true dla wszystkich pakietów?

Należy je ustawić, a następnie dodać wyjątki do allowlisty. ignore-scripts=true w projekcie .npmrc blokuje uruchamianie skryptów instalacyjnych zależności, co usuwa najbardziej bezpośrednią drogę od złośliwego pakietu do poświadczeń użytkownika wdrożeniowego. Pakiety kompilujące natywny addon lub pobierające gotowy plik binarny rzeczywiście wymagają tych skryptów. Przy ich wyłączeniu takie pakiety zakończą działanie błędem dopiero podczas uruchamiania z powodu brakującego pliku binding, a nie podczas instalacji. Należy uruchomić npm ci --ignore-scripts, a następnie npm rebuild <package> --ignore-scripts=false dla kilku pakietów, którym zdecydowano się zaufać, ponieważ npm rebuild w przeciwnym razie respektuje ustawienie .npmrc i nie uruchamia żadnych skryptów. npm query ":attr(scripts, [postinstall])" pokazuje ich rzeczywistą liczbę.

Jak sprawdzić, którą wersję pakietu faktycznie zainstalowano na serwerze?

Należy sprawdzić zawartość dysku, a nie plik blokady. npm ls <package> zgłasza, co znajduje się w node_modules, a node -e "console.log(require('./node_modules/<package>/package.json').version)" wyświetla tylko ciąg wersji. Plik blokady w git odpowiada na inne pytanie: co powinno zostać zainstalowane. Porównanie obu wartości jest właśnie celem tego sprawdzenia. Wdrażanie do katalogu nazwanego zgodnie z identyfikatorem commitu git pozwala zachować obie informacje także po kilku miesiącach, gdy będą potrzebne.

Czy npm audit wykrywa ataki na łańcuch dostaw?

Nie. npm audit porównuje drzewo zależności z bazą zgłoszonych luk, dlatego wykrywa tylko problemy, które zostały już opublikowane i otrzymały identyfikator. Złośliwe wydanie pozostaje niezgłoszone przez godziny lub dni, gdy jego instalacja ma znaczenie. npm audit signatures jest bardziej użytecznym poleceniem: weryfikuje podpisy rejestru w całym zainstalowanym drzewie i sprawdza poświadczenia pochodzenia, jeśli wydawca je udostępnił. Pozwala to ustalić, czy archiwum tarball pochodzi z publicznego procesu budowania, a nie z nieznanej maszyny.

Dlaczego uruchamianie aplikacji jako użytkownik nieuprzywilejowany ma znaczenie, jeśli atak następuje podczas instalacji?

Ponieważ oba rodzaje naruszenia mają inny zasięg i należy zabezpieczyć się przed każdym z nich. Kod uruchamiany podczas instalacji działa jako użytkownik wdrożeniowy i może odczytać jego klucze SSH, tokeny rejestru oraz poświadczenia chmurowe. Kod uruchamiany w czasie działania działa jako konto usługi. Przy użyciu User=nodeapp, ProtectSystem=strict i bez poświadczeń zapisanych na dysku jego zasięg ogranicza się do środowiska aplikacji oraz jej bazy danych. Rozdzielenie kont oznacza również, że proces obsługujący ruch nie może nadpisać node_modules. Dzięki temu naruszenie podczas działania znika przy następnym restarcie, zamiast stać się trwałe.

Czy ten artykuł był przydatny?