SSD Nodes Learn Hosting plans →
Rehberler Matt ConnorYazan Matt Connor · Güncellendi 2026-10-23

npm Tedarik Zinciri Saldırısı Nasıl Önlenir?

npm paketleri üzerinden sunucunuza sızan kötü niyetli kodları engelleyin. postinstall betikleri, typosquatting ve güvensiz dağıtım süreçlerine karşı teknik önlemleri öğrenin.

Sunucunuzda npm tedarik zinciri saldırısı nedir

Bir npm tedarik zinciri saldırısı, yüklemeyi seçtiğiniz bir paket aracılığıyla sunucunuza ulaşır. Bu süreçte açık bir port veya bir istismar adımı bulunmaz. npm kod yükler ve kod yüklemek, kodun çalıştırılması anlamına gelir; bu nedenle küçük bir Node uygulaması, daha önce hiç incelemediğiniz yüzlerce paketi içeri çeker ve bunlardan herhangi biri bir saat sonra yeni bir sürüm yayınlayabilir.

Dağıtım süreciniz kötü niyetli bir sürümü çeker çünkü yükleme komutunuz eşleşen en yeni sürümü talep etmiştir. Bu kod, yüklemeyi çalıştıran kişinin yetkileriyle yürütülür. Aşağıdaki her şey bu iki cümleden kaynaklanır.

Şekiller, tek bir Node uygulamasını tek bir VPS'e dağıtan bir kişiyi ne sıklıkla etkilediklerine göre sıralanmıştır. Bu sıralama, büyük bir şirketin kullanacağı sıralama değildir; çünkü büyük bir şirketin dahili bir kayıt defteri, bir inceleme ekibi ve genel kayıt defterinin bir yansıması bulunur. Sizin ise bir dağıtım betiğiniz vardır.

Senaryo 1: Bir sürdürücü hesabı ele geçirilir ve yamalı bir sürüm yayınlanır

npm kayıt defteri, halihazırda var olan bir sürümün içeriğinin değiştirilmesine izin vermez. Bir sürdürücüyü oltalama yöntemiyle kandıran veya yayınlama anahtarını çalan bir saldırgan, bu nedenle 4.18.2 içeriğini yeniden yazamaz. Bunun yerine 4.18.3 yayınlarlar.

package.json dosyanızı inceleyin. "express": "^4.18.2" gibi bir satır, 4.18.2 sürümü anlamına gelmez. Şapka işareti "bu sürüm veya üzerindeki herhangi bir 4.x sürümü", ~4.18.2 ise "herhangi bir 4.18.x sürümü" anlamına gelir. npm install, bu aralığı çalıştırıldığı anda çözümler; dolayısıyla aynı gün içinde iki kez dağıtılan aynı git commit'i, iki farklı kod kümesi yükleyebilir. Bu boşluk, saldırı yüzeyini oluşturur. Bu durumun gerçekleşmesi için makinenizdeki hiçbir şeyin ele geçirilmiş olması gerekmez.

Kötü niyetli sürümler genellikle rapor edilir ve kaldırılır, ancak kaldırma işlemi insanlar bunları yükledikten sonra gerçekleşir. O pencere aralığında dağıtım yapan herkes, ilgili kodu diskinde bulundurur. Her çalıştırmada aralıkları çözümleyen bir pipeline, kimse karar vermese bile haftada birkaç kez otomatik olarak bu pencereye girer.

Şekil 2: Bir kurulum betiği, dağıtımı yapan kullanıcı yetkileriyle çalışır

Bir paketin package.json kısmı, scripts bloğu içerisinde preinstall, install, postinstall ve prepare tanımlayabilir. npm bunları kurulum sırasında çalıştırır. Bu betikler korumalı bir alanda (sandbox) çalışmaz ve kimse tarafından denetlenmez. Bunlar, kurulum komutunu yazan kullanıcının yetkileriyle, o kullanıcının ev dizininde, o kullanıcının ağ erişimiyle ve o kabuğun (shell) tüm ortam değişkenleriyle çalışan kabuk komutlarıdır.

8 Temmuz 2026 tarihinde yayınlanan npm 12, bu varsayılan davranışı değiştirmiştir: Projenin package.json dosyasındaki allowScripts alanı tarafından onaylanmadıkça bağımlılık kurulum betiklerini engeller. 12 Ekim 2026 itibarıyla hiçbir Node.js sürümü npm 12 ile birlikte gelmemektedir (Node.js 26.11.1, npm 11.20.0 ile dağıtılmaktadır); bu nedenle npm sürümünüzü kendiniz yükseltmediyseniz, sunucunuzdaki npm bunların her birini çalıştırmaya devam eder.

Dolayısıyla sorulması gereken faydalı soru, paketin ne yapabileceği değil, o kullanıcının neleri okuyabileceğidir. Normal bir dağıtım sunucusunda bu cevap; kayıt defteri (registry) anahtarını tutan ~/.npmrc, SSH (secure shell) için dağıtım anahtarı olarak kullanılan ~/.ssh/id_ed25519, ~/.aws/credentials, ~/.docker/config.json ve kabukta dışa aktarılan (exported) tüm değişkenleri içerir; DATABASE_URL genellikle bu değişkenler arasında yer alır.

Bunun gibi bir yük (payload), kalıcılığa veya ayrıcalık yükseltmeye ihtiyaç duymaz. Birkaç dosyayı okur, bunları HTTPS üzerinden bir sunucuya gönderir ve 0 durum koduyla çıkar. npm, kurulum betiği çıktılarını varsayılan olarak gizlediği için hiçbir şey görmezsiniz. Bunu devre dışı bırakın ve gerçekte nelerin çalıştığını izleyin:

npm ci --foreground-scripts

foreground-scripts, standart girdiyi, çıktıyı ve hatayı npm süreciyle paylaşır; böylece derleme betikleri, kurulum başarılı olduğunda npm tarafından atılan bir arabelleğe değil, doğrudan terminalinize yazdırır.

Biçim 3: typosquat ve tam olarak yazmadığınız isim

Typosquat, popüler bir paketin ismine çok benzeyen bir isimle yayınlanan ve hatalı yazılmış ya da yanlış yapıştırılmış bir kurulum komutunu bekleyen pakettir. Mekanizma kod değil komut üzerine kuruludur, bu nedenle lockfile burada size yardımcı olmaz: yanlış ismi bir kez eklersiniz ve o andan itibaren lockfile bunu sadakatle sabitler.

Bireylerden ziyade ekipleri hedef alan varyant ise bağımlılık karmaşasıdır (dependency confusion). Dahili paketinizin adı billing-utils olsun ve özel bir kayıt defterinde (registry) barınsın. Eğer halka açık kayıt defterinde billing-utils adında hiçbir şey yoksa, herhangi biri bu isimle bir paket yayınlayabilir. npm, kapsamı belirtilmemiş (unscoped) isimleri varsayılan halka açık kayıt defterinde çözümler, bu yüzden halka açık kopya kazanabilir. Bunun çözümü, sahip olduğunuz bir kapsam (scope) ve bu kapsam için .npmrc dosyasında tanımlanan bir kayıt defteri eşleştirmesidir:

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

Artık @yourorg/billing-utils yalnızca o ana bilgisayardan getirilir, çünkü kapsamdan kayıt defterine eşleme, varsayılan kayıt defterinden önce kontrol edilir. Kapsamı belirtilmemiş dahili bir ismin eşlemesi yoktur, bu nedenle hiçbir koruması da yoktur.

Yeni bir bağımlılık eklemeden önce, indirme rozetine değil, paketin kendisine bakın:

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

Geçen ay oluşturulmuş ve halka açık bir depoyla ilişkilendiremediğiniz bir hesap tarafından yayınlanmış bir paket, altı yıllık geçmişi olan bir paketten farklı bir risk taşır. Her iki durum da tek başına kanıt değildir. Ancak her ikisini de kontrol etmenin maliyeti düşüktür.

Şekil 4: sahibi sessizce değişen bağımlılık

Bakımcılar paketleri devreder. Birisi yorulur, bir yabancı yardım teklif eder, yayınlama hakları el değiştirir ve buna bağımlı olan projelere hiçbir bildirim ulaşmaz. Hiçbir şey tehlikeye girmez. 2021 yılında verdiğiniz güven artık farklı bir kişinin elindedir.

Bu, en yavaş ilerleyen ve tespit edilmesi en zor şekildir; hiçbir komut buna doğrudan yanıt vermez. İki yöntem bu durumu daraltır. Bir paketi benimsemeden önce, yukarıdaki npm view satırı ile kimin yayın yapabileceğini kontrol edin. Ardından, gerçekten bağımlı olduğunuz bir paket taşındığında farkları (diff) okuyun:

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

İlk biçim yalnızca değişen dosya adlarını yazdırır; bu, önemsediğiniz bir paketin her yükseltmesinde yapılabilecek kadar hızlıdır. Bir derleme betiğine dokunan, paket köküne yeni bir dosya ekleyen veya scripts bloğunu düzenleyen bir yama sürümü, sunucunuza ulaşmadan önce bütünüyle okunmaya değerdir.

npm ci ile kilitli dosya üzerinden derleme

package-lock.json, ağaçtaki her paketin tam sürümünü, geldiği URL adresini, her bir tarball dosyasının sha512 bütünlük özetini ve hangi paketin buna ihtiyaç duyduğunu kaydeder. Bu dosyayı commit edin. Gerçekte neyi test ettiğinizi belirten tek dosya budur.

Ardından, geliştirici dizüstü bilgisayarı olmayan herhangi bir makinede npm install yerine mutlaka npm ci kullanarak kurulum yapın:

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

npm ci, npm install komutundan burada önem arz eden şekillerde ayrılır. Bir kilitli dosyanın (lockfile) mevcut olmasını gerektirir. Başlamadan önce mevcut node_modules dizinini siler; böylece önceki bir dağıtımdan kalan artıklar bu dağıtıma taşınmaz. package.json dosyasına veya kilitli dosyaya hiçbir zaman yazma yapmaz; bu sayede bir kurulum işlemi sizi sessizce bir üst sürüme taşıyamaz. Kilitli dosya ile package.json arasında uyumsuzluk varsa, farkı çözmeye çalışmak yerine bir hata vererek sonlanır.

Bu hata bir rahatsızlık değil, bir özelliktir. Bağımlılık değişikliğinin saat 02:00'deki bir dağıtımın yan etkisi olarak değil, birinin incelediği bir commit olarak gelmesi gerektiğini ifade eder.

Bütünlük özeti (integrity hash) her indirme işleminde kontrol edilir. Baytları kayıtlı özetle eşleşmeyen bir tarball, paketi açmak yerine code EINTEGRITY hatası vererek kurulumu başarısız kılar. Bunun size ne kazandırdığı konusunda net olun: Aldığınız dosyanın, kilitli dosyanın sabitlediği dosya olduğunu kanıtlar; bu, indirmeleri sağlama toplamı ile doğrulama işleminin size sunduğu garantinin aynısıdır ve aynı sınırlara sahiptir. Sabitlenen sürümün yayınlandığı sırada kötü niyetli olup olmadığı hakkında hiçbir şey söylemez.

--omit=dev hakkında bir detay: bu paketler yine çözümlenir ve yine kilitli dosyaya yazılır. Sadece diske yerleştirilmezler. Diskte daha az paket olması, daha az kurulum betiği ve çalışma zamanında daha az kod yüklenmesi anlamına gelir; bu nedenle yapmaya değerdir. Bu işlem, bağımlılığı ağacınızdan kaldırmaz.

Kurulum betiklerini kod olarak değerlendirin ve bunları nasıl reddedeceğinizi öğrenin

Kurulum betiklerini devre dışı bırakabilirsiniz. Bunu projenin .npmrc dosyasına ekleyin ve lockfile ile birlikte commit edin:

ignore-scripts=true
save-exact=true

ignore-scripts=true, npm'in bağımlılıklarda tanımlanan betikleri çalıştırmasını engeller. save-exact=true, npm install some-lib aracının 1.4.2 değerini ^1.4.2 yerine package.json içine yazmasını sağlar; böylece çözümlenen bir aralık yanlışlıkla manifest dosyanıza girmez.

Bu işlem bazı yapıları bozabilir; bu nedenle etkinleştirmeden önce nasıl çalıştığını bilmeniz gerekir. Yerel (native) bir eklentiyi derleyen veya önceden derlenmiş bir ikili dosyayı indiren paketler, bu işlemi bir kurulum betiği içinde gerçekleştirir. Betikler kapalıyken kurulumun kendisi başarılı olur ancak hata daha sonra, çalışma zamanında, bağlama dosyasını yükleyemeyen bir modül olarak ortaya çıkar. Bunun çözümü bir izin listesidir (allowlist):

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

npm rebuild <package>, yalnızca o paket için derleme betiklerini çalıştırır. --ignore-scripts=false seçeneği isteğe bağlı değildir: npm rebuild, .npmrc dosyasına yeni commit ettiğiniz ignore-scripts=true ayarını dikkate alır ve bu geçersiz kılma (override) olmadan paketin ikili dosyalarını bağlar ancak hiçbir betiğini çalıştırmaz. Artık hiç tanımadığınız yüzlerce kişiye genel bir yürütme izni vermek yerine, paket bazında bir karar vermiş olursunuz.

npm 12 kullanıyorsanız, bu izin listesi yerleşik olarak gelir. npm approve-scripts better-sqlite3, onayı package.json dosyasındaki allowScripts alanına kaydeder; onaylanmamış bağımlılık betikleri bir uyarı ile atlanır ve npm rebuild de aynı listeyi kontrol eder; bu nedenle npm 12 üzerinde yukarıdaki yeniden derleme işlemi de bu onayı gerektirir. Commit edilmiş bir ignore-scripts=true, allowScripts politikasını tamamen geçersiz kılar.

Mevcut iznin ne kadar geniş olduğunu görmek için npm'e şu komutu sorun:

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

Bu komut, yüklü ağaçta postinstall betiği içeren her paketi listeler. Tipik bir uygulamada bu liste insanların beklediğinden daha kısadır; izin listesini pratik kılan da tam olarak budur.

Derleme süreci ile trafiği karşılayan süreci birbirinden ayırın

Deploy kullanıcısının node_modules dizinine yazma yetkisi olmalıdır. HTTP isteklerini yanıtlayan sürecin ise buna ihtiyacı yoktur. Eğer her iki işlem aynı hesap üzerinden yürütülürse, kurulum sırasında çalışan kod, kullanıcılara hizmet veren kodu yeniden yazabilir; aynı şekilde çalışma zamanında çalışan kod da bu değişikliği yapabilir.

Bu süreçleri ayırın. Derleme işlemini bir kullanıcı, servis etme işlemini ise başka bir kullanıcı ile gerçekleştirin. Servis eden hesabın dizinini salt okunur (read-only) yapın:

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

Ardından bunu systemd ile zorunlu kılın. /etc/systemd/system/nodeapp.service dosyasını oluşturun:

[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, /dev, /proc, /sys ve ReadWritePaths içinde listelediğiniz dizinler haricinde, tüm dosya sistemini bu servis için salt okunur hale getirir. Bu nedenle uygulamanın node_modules dizinine yazma girişimi EROFS: read-only file system hatası ile sonuçlanır; bu hatayı yaklaşık bir dakika içinde kendi günlük kayıtlarınızda görebilirsiniz. NoExecPaths, yazılabilir yükleme dizinini kapsar: servis buraya dosya yazabilir ancak çekirdek (kernel) bu dosyaların çalıştırılmasına izin vermez. Bu seçenek systemd 248 veya daha yeni bir sürüm gerektirir; Ubuntu 24.04 ise 255 sürümü ile gelir.

Bu birim dosyasında iki tuzak bulunmaktadır. Birincisi, MemoryDenyWriteExecute=yes ayarını eklemeyin. Çoğu systemd sıkılaştırma listesinde yer alsa da, Node'un çalışmasını engeller. Bunun nedeni, V8 motorunun JavaScript'i çalışma zamanında makine koduna derlemesi ve hem yazılabilir hem de çalıştırılabilir sayfalara ihtiyaç duymasıdır. İkincisi, command -v node içindeki ExecStart yolunu kullanın. Eğer Node bir sürüm yöneticisi ile kurulduysa, deploy kullanıcısının ev dizini altında yer alır; ProtectHome=yes bu dizini servisten gizler ve birim dosyası derhal status=203/EXEC hatası ile başarısız olur; günlük kayıtlarında çalıştırılabilir dosyanın bulunamadığı belirtilir.

Dosyaya güvenmek yerine sonucu kontrol edin:

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, her bir sıkılaştırma ayarını ve maruziyet durumunu listeler; böylece hangilerinin varsayılan değerde kaldığını görebilirsiniz. touch komutu Permission denied hatası ile başarısız olmalıdır, çünkü nodeapp kullanıcısının current altında hiçbir dosya üzerinde sahipliği yoktur. Eğer komut başarılı olursa, dosya sahiplikleriniz hatalıdır ve systemd ayarları bu durumu sessizce maskeliyordur.

EnvironmentFile hakkında bir not: systemd, User=nodeapp kullanıcısına geçmeden önce bu dosyayı root yetkisiyle okur, bu nedenle dosya 600 izinleriyle root:root olarak kalabilir. Uygulama değişkenleri yine de alır. nodeapp kullanıcısı olarak kabuk (shell) erişimi olan herkes, /proc/<pid>/environ üzerinden bu değişkenleri okuyabilir; dolayısıyla bu yöntem sırları çalışma zamanında değil, diskte dururken korur.

Dağıtım kimlik bilgilerini derleme ortamının dışında tutun

Kurulum betikleri ortam değişkenlerini devralır. Derleme işlemini nerede yapacağınıza karar verirken bu temel gerçeği göz önünde bulundurmalısınız.

En güvenli yöntem, derlemeyi üretim sunucusu olmayan bir ortamda gerçekleştirip tamamlanmış dizini sunucuya kopyalamaktır. Bu durumda derleme makinesi yalnızca salt okunur bir kayıt defteri (registry) anahtarı barındırır; başka hiçbir yetkiye sahip olmaz. SSH dağıtım anahtarı, bulut erişim anahtarı, veritabanı parolası veya container kayıt defteri girişi gibi kritik veriler bu makinede bulunmaz.

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

Salt okunur bir anahtar, paketleri indirebilir ancak yayınlama yapamaz. npm, 9 Aralık 2025 tarihinde tüm klasik anahtarları geçersiz kıldı; bu nedenle artık parçalı erişim anahtarları kullanılmaktadır ve salt okunur olma özelliği yetki bayrağı ile belirlenir: güncel npm sürümleri hala eski --read-only bayrağını kabul etse de, npm token create bu bayrağı kayıt defterine göndermez. Anahtarın bir derleme ortamından çalınması durumunda, oluşacak zarar yalnızca ilgili paketlere salt okunur erişim ile sınırlı kalır.

Eğer derlemeyi mutlaka sunucu üzerinde yapmanız gerekiyorsa, işlemi kısıtlı bir ortama sahip deploy kullanıcısı ile gerçekleştirin ve çalışma zamanı sırlarını deploy tarafından okunamayan /etc/nodeapp/env dizininde tutun. Aynı mantık, kendi barındırdığınız otomasyon sistemleri için de geçerlidir: kendi barındırdığınız bir GitHub Actions runner, anahtarları elinde tutar ve her iş sürecinde rastgele yayınlanmış kodları çalıştırır; bu da onu küçük ölçekli dağıtımlardaki en değerli hedef haline getirir. Yazmadığınız ve tüm ortam değişkenlerinize erişebilen her program aynı risk kategorisindedir; sırları bir yapay zeka aracının ortamından uzak tutmak konusunun, farklı bir programın dahil olduğu aynı problem olmasının nedeni budur.

Denetleyemediğiniz paketleri sabitleyin veya vendor dizinine alın

Sabitlenmiş bir bağımlılık, sürümü bir commit olmadan değişemeyen bağımlılıktır. Commit edilmiş bir lock dosyası, tüm ağaç için zaten bunu sağlar. Ancak iki durum daha fazlasını gerektirir.

İlki geçişli (transitive) bağımlılıklardır. Bağımlılıklarınızın nelere bağımlı olduğunu kontrol edemezsiniz. overrides içindeki package.json, ağacın herhangi bir yerindeki sürümü zorunlu kılar:

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

Bunu ekledikten sonra lock dosyasının sonucu kaydetmesi için npm install komutunu bir kez çalıştırın ve ardından her iki dosyayı da commit edin.

İkinci durum ise denetleyemediğiniz ve bırakamadığınız bir pakettir. Bu paketi vendor dizinine alın. npm pack, kayıt defterinin sunacağı tarball dosyasını tam olarak indirir ve file: bağımlılığı, kopyanız üzerinden kurulum yapar:

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"
  }
}

Tarball artık deponuzda yaşar ve sizden habersiz değişemez. Ayrıca güncellemelerinin sorumluluğunu sonsuza dek üstlenmiş olursunuz; bu yüzden bu yöntemi web çerçeveniz için değil, takılı kaldığınız küçük ve terk edilmiş paketler için kullanın.

Ayrıca hiçbir maliyeti olmayan bir bekleme süresi (cooling-off period) uygulaması da mevcuttur:

npm install --before=2026-08-01

before seçeneği, ağacı yalnızca o tarihte veya öncesinde yayınlanmış sürümleri kullanarak yeniden oluşturur. Bağımlılıkları yenilerken bu tarihi bir veya iki hafta geriye ayarlayın; böylece hatalı bir sürümün yayında olduğu ancak henüz raporlanmadığı zaman aralığını atlamış olursunuz. Bu kaba bir araçtır çünkü gerçek güvenlik düzeltmelerini de engeller. Aralıkları çözümlemek, nelerin değiştiğini okumak ve ardından lock dosyasını commit etmek için kullanın. Güncel npm sürümleri, tarih belirtmeksizin aynı işi yapan ve sürekli ilerleyen bir pencere sunan min-release-age seçeneğini de kabul eder (min-release-age=7 içindeki .npmrc). Aynı içgüdü, bağımlılık olarak eklemek yerine doğrudan npm üzerinden yüklediğiniz komut satırı araçları için de geçerlidir; sabitlenmemiş bir npx çağrısı o sabah yayınlanan her şeyi çeker, oysa tam bir dsh sürümünü sabitlemek, iki makinenin aynı kodu çalıştırmasını sağlayan şeydir.

Hangi sürümü yayınladığımı nasıl anlarım?

Git içindeki lockfile, neyin kurulmuş olması gerektiğini belirtir. Disk ise neyin kurulu olduğunu gösterir. Yalnızca ikincisi kanıt niteliğindedir.

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

npm ls, node_modules dosyasını okur; bu nedenle lockfile'ın amaçladığı sürümü değil, fiziksel olarak mevcut olanı raporlar. node -e satırı, kurulu manifesti yol üzerinden okur. Bu yöntem, exports alanı alt yol içe aktarımlarını engelleyen paketler için bile çalışır ve herhangi bir ağaç çizimi olmaksızın tek bir sürüm yazdırır.

Karşılaştırmanın diğer yarısı için git kayıtlarını okuyun:

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

Commit bilgisini deploy düzenine ekleyerek ikisi arasındaki bağlantıyı kalıcı hale getirin. /srv/nodeapp/releases/<short commit sha> içine yayınlayın ve bir symlink ile /srv/nodeapp/current işaretçisini buraya yönlendirin. "Şu anda ne çalışıyor" sorusunun cevabı readlink /srv/nodeapp/current olur ve bu bilgi, dağıtımı yapan kişi dışında biri tarafından saat 03:00'te bile erişilebilir durumdadır.

Son olarak, registry'nin neyi onayladığını kontrol edin:

npm audit signatures

Bu işlem, kurulu ağacınızdaki paketlerin registry imzalarını doğrular ve varsa paketlerin köken (provenance) beyanlarını teyit eder. Köken beyanı, yayınlanmış bir tarball dosyasını onu üreten herkese açık continuous integration (CI) derlemesine bağlar. Doğrulanmış bir beyan, kodun kaynağını bilinmeyen bir dizüstü bilgisayara değil, bir commit kaydına kadar takip edebileceğiniz anlamına gelir. Kapsam evrensel değildir; bu nedenle eksik bir beyanı "kötü paket" olarak değil, "bilgi yok" şeklinde yorumlayın.

Hatalı bir sürüm sunucunuza ulaştığında yapılması gerekenler

Neyin ve hangi kullanıcı yetkisiyle çalıştığından yola çıkarak dışa doğru ilerleyin.

Kod kurulum sırasında çalıştıysa, derleme kullanıcısının okuyabildiği her şeyin ele geçirildiğini varsayın. Kayıt defteri belirtecini, ilgili ev dizinindeki SSH anahtarlarını, bulut kimlik bilgilerini ve o kabukta dışa aktarılan tüm gizli verileri döndürün (rotate). Bir dosyanın okunmadığını kanıtlayamayacağınız için tek dürüst yanıt döndürme işlemidir.

Kod, kısıtlanmış bir servis hesabı altında çalışma zamanında çalıştıysa, erişilebilir küme çok daha küçüktür: uygulamanın kendi ortam değişkenleri ve ağ erişiminin ulaşabildiği yerler. Servisleri bir VPS üzerinde ayrıcalıksız kullanıcılarla çalıştırmanın tüm mantığı budur. Bu, ele geçirilme durumunu engellemez. Sadece ele geçirme işleminin makinenin ne kadarına erişebileceğine ve yeniden başlatma sonrasında varlığını sürdürüp sürdüremeyeceğine karar verir.

Ardından temizlemek yerine yeniden oluşturun. node_modules dizinini silin, etkilenen paketi package.json içerisinde hatalı sürümün altında sabitleyin, kilit dosyasını güncellemek için npm install komutunu bir kez çalıştırın, commit edin ve npm ci ile dağıtımı gerçekleştirin. Bir dizin ağacını yerinde onarmaya çalışmayın. Bir kurulum betiğinin nerelere dokunduğunu tek tek listeleyemezsiniz.

Ayrıca zaman aralığını da not edin: sürümü çekmiş olabilecek ilk dağıtım ve onu kaldıran dağıtım. Bu aralık, hangi günlük kayıtlarınızı incelemeniz gerektiğini söyler ve bu ancak sürümleriniz commit isimleriyle adlandırılmışsa yanıtlanabilir.

Bunların çözemediği sorunlar

Bir lockfile, bir bağımlılığı güvenli hale getirmez. Bu dosya, o bağımlılığı kabul ettiğiniz anı, bir dağıtımın yan etkisi olmaktan çıkarıp tarihli ve gözden geçirilmiş bir karara dönüştürür. Yukarıdaki her uygulama, aynı dönüşümü gerçekleştirerek durumu kazadan tercihe çevirir.

npm audit burada bir savunma mekanizması değildir. Bağımlılık ağacınızı raporlanmış güvenlik açıkları içeren bir veritabanı ile karşılaştırır; dolayısıyla yalnızca daha önce yayınlanmış ve adlandırılmış sorunları bulur. Bir tedarik zinciri saldırısı, faydalı ömrü boyunca isimsiz kalır. Bilinen eski hatalar için npm audit çalıştırın ancak dört saat önce yayınlanmış bir sürüm hakkında bu araçtan bir sonuç beklemeyin.

Bağımlılık sayınızı azaltmak, bu kılavuzdaki herhangi bir araçtan daha fazla yardımcı olur; ancak bu, kimsenin duymak istemediği bir tavsiyedir. Eklemediğiniz her paket, sizin adınıza kimlik avına uğrayamayacak bir yayıncı ve dağıtım kullanıcınız olarak asla çalışmayacak bir kurulum betiği demektir.

Bunların hiçbiri sadece npm'e özgü değildir. Aynı dört temel durum PyPI, RubyGems, container imajları ve dağıtımınızın paket yöneticisi için de geçerlidir. npm'de daha belirgin olmasının nedeni, ağaçların çok daha derin olması ve çoğu sunucunun hala varsayılan olarak kurulum betiklerini çalıştıran npm sürümlerini kullanmasıdır. Hali hazırda kullandığınız bir aracı genişleten her şey, aynı sorunu miras alır. Bu yüzden bir dsh eklentisini yüklemeden önce nelere erişebileceğini çözmek, kendi yetkilerinizin yerine aracı yetkilerinizi koyarak bir postinstall betiğini okumakla aynı egzersizdir. Çevredeki makinenin ne kadarının savunmanız altında olduğu, nerede çalıştığına bağlıdır; bu da VPS barındırmanın güvenli olup olmadığına dair daha geniş sorunun bir parçasıdır.

FAQ

npm ci beni ele geçirilmiş bir npm paketinden korur mu?

Sürümün bilginiz dışında değişmesini engeller. npm ci, package-lock.json dosyasının kaydettiği sürümü tam olarak kurar, her tarball dosyasını sha512 bütünlük hash değeri ile kontrol eder ve package.json ile kilit dosyası (lockfile) arasında bir uyuşmazlık olması durumunda aradaki farkı çözmeye çalışmak yerine hata vererek durur. Sabitlenen sürümün güvenli olup olmadığı konusunda bir değerlendirme yapmaz. Eğer kötü amaçlı bir sürümü sabitleyen bir kilit dosyasını commit ederseniz, npm ci bu sürümü sahip olduğunuz her sunucuya her seferinde sadakatle kuracaktır.

Her şey için ignore-scripts=true ayarını yapmalı mıyım?

Önce bu ayarı yapın, ardından izin verilenler listesi (allowlist) oluşturun. Projenin .npmrc dosyasındaki ignore-scripts=true ayarı, bağımlılık kurulum betiklerinin çalışmasını durdurur; bu da kötü amaçlı bir paketten deploy kullanıcınızın kimlik bilgilerine giden en doğrudan yolu kapatır. Yerel bir eklenti derleyen veya önceden oluşturulmuş bir binary dosyasını çeken paketlerin betiklere ihtiyacı vardır; betikler kapalı olduğunda bu paketler kurulum anında değil, çalışma anında eksik binding dosyası hatası vererek durur. npm ci --ignore-scripts komutunu çalıştırın, ardından güvenmeye karar verdiğiniz az sayıdaki paket için npm rebuild <package> --ignore-scripts=false komutunu kullanın; çünkü npm rebuild aksi takdirde .npmrc ayarına sadık kalır ve hiçbir şey çalıştırmaz. npm query ":attr(scripts, [postinstall])" komutu, gerçekte kaç tane betik olduğunu gösterir.

Sunucumun aslında hangi paket sürümünü kurduğunu nasıl öğrenebilirim?

Kilit dosyasına değil, diske bakın. npm ls <package>, node_modules dizininde nelerin mevcut olduğunu raporlar; node -e "console.log(require('./node_modules/<package>/package.json').version)" ise yalnızca sürüm dizisini yazdırır. Git içindeki kilit dosyası farklı bir soruya yanıt verir; yani neyin kurulmuş olması gerektiğini gösterir. İkisini karşılaştırmak zaten asıl amaçtır. Uygulamayı git commit adını taşıyan bir dizine deploy etmek, her iki cevabı da aylar sonra ihtiyaç duyduğunuzda elinizin altında tutmanızı sağlar.

npm audit tedarik zinciri saldırılarını bulur mu?

Hayır. npm audit, ağacınızı raporlanmış güvenlik açıkları veritabanı ile karşılaştırır; bu nedenle yalnızca daha önce yayınlanmış ve bir tanımlayıcı atanmış sorunları bulur. Kötü amaçlı bir sürüm, kurulumun kritik olduğu saatler veya günler boyunca raporlanmamış olabilir. npm audit signatures daha yararlı bir komuttur: yüklü ağacınızdaki kayıt defteri imzalarını doğrular ve yayıncının oluşturduğu durumlarda köken kanıtlarını (provenance attestations) kontrol eder. Bu, bir tarball dosyasının bilinmeyen bir makineden değil, genel bir yapıdan (build) geldiğini size bildirir.

Saldırı kurulum anında gerçekleşiyorsa, uygulamayı yetkisiz bir kullanıcı olarak çalıştırmak neden önemlidir?

Çünkü iki hata türünün erişim alanı farklıdır ve siz her ikisine karşı da savunma yapıyorsunuz. Kurulum anındaki kod, deploy kullanıcısı yetkileriyle çalışır ve bu kullanıcının SSH anahtarlarını, kayıt defteri tokenlarını ve bulut kimlik bilgilerini okuyabilir. Çalışma anındaki kod ise servis hesabı yetkileriyle çalışır; User=nodeapp, ProtectSystem=strict ve diskte okunabilir kimlik bilgileri olmadığında, erişim alanı uygulamanın kendi ortamı ve veritabanı ile sınırlı kalır. Hesapları ayırmak, trafiği karşılayan sürecin node_modules dosyasını yeniden yazamayacağı anlamına da gelir; böylece çalışma anındaki bir ihlal kalıcı hale gelmek yerine bir sonraki yeniden başlatmada temizlenmiş olur.

Bu yazı işinize yaradı mı?