npm supply-chain حملہ اور Node.js سرور کی حفاظت
npm supply-chain حملے آپ کے Node.js سرور تک کیسے پہنچتے ہیں؟ malicious patches، postinstall اسکرپٹس اور typosquats سے بچنے کے لیے اپنی deploy حکمت عملی کو محفوظ بنائیں۔
آپ کے سرور پر npm supply-chain attack کیا ہوتا ہے
npm supply-chain attack آپ کے سرور تک اس package کے ذریعے پہنچتا ہے جسے آپ نے خود install کرنے کا انتخاب کیا ہو۔ اس میں کوئی open port شامل نہیں ہوتا اور نہ ہی exploit کا کوئی مرحلہ ہوتا ہے۔ npm code install کرتا ہے، اور code install کرنے سے وہ code run بھی ہوتا ہے۔ اس لیے ایک چھوٹی Node application کئی سو ایسے packages کھینچ لیتی ہے جنہیں آپ نے کبھی پڑھا نہیں ہوتا، اور ان میں سے کوئی بھی package ایک گھنٹے بعد نیا version publish کر سکتا ہے۔
آپ کا deploy ایک malicious version fetch کرتا ہے، کیونکہ آپ کی install command نے matching versions میں سے تازہ ترین version مانگا تھا۔ اس کے بعد وہ code اسی user کے privileges کے ساتھ run ہوتا ہے جس نے install چلایا تھا۔ ذیل کی تمام باتیں انہی دو جملوں سے اخذ ہوتی ہیں۔
یہ صورتیں اس ترتیب سے دی گئی ہیں کہ ایک VPS پر ایک Node app deploy کرنے والے کسی ایک شخص کو وہ کتنی کثرت سے متاثر کرتی ہیں۔ بڑی company میں ترتیب مختلف ہو سکتی ہے، کیونکہ بڑی company کے پاس internal registry، review team اور public registry کا mirror ہوتا ہے۔ آپ کے پاس ایک deploy script ہے۔
شکل 1: ایک مینٹینر اکاؤنٹ کا ہیک ہونا اور پیچ جاری کرنا
npm رجسٹری کسی کو بھی پہلے سے موجود ورژن کے مواد کو تبدیل کرنے کی اجازت نہیں دیتی۔ لہذا، ایک حملہ آور جو کسی مینٹینر کو فشنگ کا شکار بناتا ہے یا پبلش ٹوکن چوری کرتا ہے، وہ 4.18.2 کو دوبارہ نہیں لکھ سکتا۔ وہ 4.18.3 شائع کرتے ہیں۔
اپنی package.json کو دیکھیں۔ "express": "^4.18.2" جیسی لائن کا مطلب ورژن 4.18.2 نہیں ہے۔ کیریٹ (caret) کا مطلب ہے "4.x کا کوئی بھی ورژن جو اس کے برابر یا اس سے اوپر ہو"، اور ~4.18.2 کا مطلب ہے "کوئی بھی 4.18.x ورژن"۔ npm install اس رینج کو چلنے کے وقت حل (resolve) کرتا ہے، لہذا ایک ہی git کمٹ، جسے ایک ہی سہ پہر میں دو بار ڈیپلائے کیا جائے، کوڈ کے دو مختلف سیٹ انسٹال کر سکتا ہے۔ یہ خلا ہی حملہ کرنے کی سطح (attack surface) ہے۔ اسے کھولنے کے لیے آپ کی مشین پر کسی چیز کا ہیک ہونا ضروری نہیں ہے۔
مضر ریلیزز کی عام طور پر اطلاع دی جاتی ہے اور انہیں ہٹا دیا جاتا ہے، لیکن یہ ہٹانا لوگوں کے انسٹال کرنے کے بعد ہوتا ہے۔ جس نے بھی اس ونڈو کے دوران ڈیپلائے کیا، اس کے پاس ڈسک پر وہ کوڈ موجود ہوتا ہے۔ ایک پائپ لائن جو ہر رن پر رینجز کو حل کرتی ہے، وہ خود بخود اس ونڈو میں داخل ہو جاتی ہے، ہفتے میں کئی بار، بغیر کسی کے فیصلہ کیے۔
شکل 2: install script deploy کرنے والے user کے طور پر چلتی ہے
کسی package کا package.json اپنے scripts block میں preinstall، install، postinstall اور prepare declare کر سکتا ہے۔ npm انہیں installation کے دوران چلاتا ہے۔ یہ sandbox میں نہیں چلتے اور کوئی ان کا review نہیں کرتا۔ یہ shell commands ہوتی ہیں جو install command ٹائپ کرنے والے user کے طور پر، اسی user کی home directory میں، اس user کی network access اور اس shell کے مکمل environment کے ساتھ چلتی ہیں۔
8 July 2026 کو release ہونے والا npm 12 اس default کو تبدیل کرتا ہے: یہ dependency install scripts کو block کرتا ہے، جب تک کہ project کا allowScripts field، package.json میں، انہیں approve نہ کرے۔ 12 October 2026 تک کوئی Node.js release npm 12 کو bundle نہیں کرتی (Node.js 26.11.1 کے ساتھ npm 11.20.0 آتا ہے)۔ اس لیے جب تک آپ نے npm کو خود upgrade نہ کیا ہو، آپ کے server پر موجود npm اب بھی ان سب کو چلاتا ہے۔
اس لیے مفید سوال یہ نہیں کہ package کیا کر سکتا ہے۔ سوال یہ ہے کہ وہ user کیا پڑھ سکتا ہے۔ عام deploy box پر اس میں ~/.npmrc شامل ہے، جس میں registry token موجود ہوتا ہے، ~/.ssh/id_ed25519، جو SSH (secure shell) کے لیے deploy key کے طور پر استعمال ہوتی ہے، ~/.aws/credentials، ~/.docker/config.json، اور shell میں export کیا گیا ہر variable شامل ہے۔ DATABASE_URL عموماً اسی میں موجود ہوتا ہے۔
اس طرح کے payload کو persistence یا privilege escalation کی ضرورت نہیں ہوتی۔ یہ چند files پڑھتا ہے، انہیں HTTPS کے ذریعے کسی host کو بھیجتا ہے، اور status 0 کے ساتھ ختم ہو جاتا ہے۔ آپ کو کچھ نظر نہیں آتا، کیونکہ npm default طور پر install-script output چھپا دیتا ہے۔ یہ output فعال کریں اور دیکھیں کہ حقیقت میں کیا چلتا ہے:
npm ci --foreground-scriptsforeground-scripts standard input، output اور error کو npm process کے ساتھ share کرتا ہے۔ اس لیے build scripts آپ کے terminal میں output دکھاتی ہیں، بجائے اس کے کہ ایسے buffer میں لکھیں جسے installation کامیاب ہونے پر npm ضائع کر دیتا ہے۔
شکل 3: ٹائپو سکواٹس، اور وہ نام جو آپ نے ٹھیک سے ٹائپ نہیں کیا
ٹائپو سکواٹ (typosquat) ایک ایسا پیکیج ہے جو کسی مقبول پیکیج کے ملتے جلتے نام سے شائع کیا جاتا ہے، تاکہ غلط ٹائپنگ یا غلط پیسٹ کیے گئے انسٹال کمانڈ کا فائدہ اٹھایا جا سکے۔ اس کا طریقہ کار کمانڈ ہے، کوڈ نہیں، اس لیے یہاں lockfile آپ کی مدد نہیں کرتی: آپ ایک بار غلط نام شامل کر لیتے ہیں، اور اس کے بعد lockfile وفاداری سے اسے پن (pin) کر دیتی ہے۔
جو ویریئنٹ افراد کے بجائے ٹیموں کو نشانہ بناتا ہے وہ dependency confusion ہے۔ آپ کا اندرونی پیکیج billing-utils کہلاتا ہے اور ایک نجی رجسٹری پر موجود ہے۔ اگر عوامی رجسٹری پر billing-utils نام کی کوئی چیز موجود نہ ہو، تو کوئی بھی اسے شائع کر سکتا ہے۔ npm غیر اسکوپڈ (unscoped) ناموں کو ڈیفالٹ عوامی رجسٹری کے خلاف حل کرتا ہے، لہذا عوامی کاپی جیت سکتی ہے۔ اس کا حل ایک ایسا اسکوپ ہے جس کے آپ مالک ہوں، اور اس اسکوپ کے لیے رجسٹری میپنگ، جو .npmrc میں درج ہو:
@yourorg:registry=https://npm.yourorg.example/
//npm.yourorg.example/:_authToken=${NPM_TOKEN}اب @yourorg/billing-utils صرف اسی ہوسٹ سے حاصل کیا جاتا ہے، کیونکہ اسکوپ ٹو رجسٹری میپنگ سے ڈیفالٹ رجسٹری سے پہلے مشورہ کیا جاتا ہے۔ ایک غیر اسکوپڈ اندرونی نام کی کوئی میپنگ نہیں ہوتی، اس لیے اس کی کوئی حفاظت نہیں ہوتی۔
کسی بھی نئی ڈیپینڈنسی کو شامل کرنے سے پہلے، اس کے ڈاؤن لوڈ بیج کے بجائے خود پیکیج کو دیکھیں:
npm view some-lib repository.url maintainers time.created time.modifiedپچھلے مہینے بنایا گیا پیکیج، جسے ایسے اکاؤنٹ نے شائع کیا ہو جس کا تعلق آپ کسی عوامی ریپوزٹری سے نہیں جوڑ سکتے، چھ سالہ تاریخ رکھنے والے پیکیج سے مختلف خطرہ ہے۔ ان میں سے کوئی بھی حقیقت ثبوت نہیں ہے۔ دونوں کی جانچ کرنا آسان ہے۔
شکل 4: وہ انحصار جس کا مالک خاموشی سے بدل گیا
Maintainers پیکیجز دوسروں کے حوالے کر دیتے ہیں۔ کوئی تھک ہار کر کام چھوڑ دیتا ہے، کوئی اجنبی مدد کی پیشکش کرتا ہے، اشاعت کے حقوق منتقل ہو جاتے ہیں، اور اس پر انحصار کرنے والے پروجیکٹس تک کسی قسم کی اطلاع نہیں پہنچتی۔ کوئی چیز compromised نہیں ہوتی۔ جو اعتماد آپ نے 2021 میں کیا تھا، اب وہ کسی اور شخص کے پاس ہے۔
یہ سب سے سست شکل ہے اور اس کا پتہ لگانا سب سے مشکل ہے، اور کوئی بھی کمانڈ براہ راست اس کا جواب نہیں دیتی۔ دو چیزیں اس کے دائرہ کار کو محدود کرتی ہیں۔ کسی پیکیج کو اپنانے سے پہلے چیک کریں کہ کون اسے publish کر سکتا ہے، اس کے لیے اوپر دی گئی npm view لائن استعمال کریں۔ پھر جب کوئی پیکیج جس پر آپ واقعی انحصار کرتے ہیں منتقل ہو، تو اس کا diff پڑھیں:
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پہلی شکل صرف تبدیل شدہ فائل کے نام پرنٹ کرتی ہے، جو کہ آپ کے لیے اہم پیکیج کی ہر اپ گریڈ پر چیک کرنے کے لیے کافی تیز ہے۔ ایک patch release جو build script کو چھوئے، پیکیج روٹ میں کوئی فائل شامل کرے، یا scripts بلاک میں ترمیم کرے، اسے آپ کے سرور تک پہنچنے سے پہلے مکمل پڑھنا ضروری ہے۔
npm ci کے ساتھ کمٹ شدہ lockfile سے بلڈ کریں
package-lock.json ٹری میں موجود ہر پیکیج کا درست ورژن، ہر ایک کا ماخذ URL، ہر tarball کا sha512 انٹیگریٹی ہیش، اور یہ کہ کس پیکیج نے اس کا مطالبہ کیا، ریکارڈ کرتا ہے۔ اسے کمٹ کریں۔ یہ واحد فائل ہے جو بتاتی ہے کہ آپ نے اصل میں کس چیز کا ٹیسٹ کیا ہے۔
پھر کسی بھی ایسی مشین پر جو ڈویلپر لیپ ٹاپ نہ ہو، npm ci کے ساتھ انسٹال کریں، کبھی بھی npm install استعمال نہ کریں۔
npm ci --omit=dev --ignore-scriptsnpm ci اور npm install میں ایسے فرق ہیں جو یہاں سب اہم ہیں۔ اسے موجود ہونے کے لیے ایک lockfile درکار ہے۔ یہ شروع کرنے سے پہلے کسی بھی موجودہ node_modules کو ہٹا دیتا ہے، تاکہ پچھلی ڈیپلائے کے باقی ماندہ حصے اس میں شامل نہ ہو سکیں۔ یہ کبھی بھی package.json یا lockfile میں کچھ نہیں لکھتا، لہذا انسٹالیشن آپ کو خاموشی سے کسی نئے ورژن پر منتقل نہیں کر سکتی۔ اگر lockfile اور package.json میں اختلاف ہو، تو یہ فرق کو حل کرنے کے بجائے ایرر کے ساتھ بند ہو جاتا ہے۔
وہ ایرر ایک فیچر ہے، نہ کہ پریشانی۔ اس کا مطلب ہے کہ ڈیپینڈنسی میں تبدیلی کسی ایسے کمٹ کے ذریعے آنی چاہیے جس کا کسی نے جائزہ لیا ہو، نہ کہ رات 02:00 بجے ڈیپلائے کے ضمنی اثر کے طور پر۔
ہر فیچ (fetch) پر انٹیگریٹی ہیش چیک کیا جاتا ہے۔ وہ tarball جس کے بائٹس ریکارڈ شدہ ہیش سے میل نہیں کھاتے، وہ ان پیک ہونے کے بجائے code EINTEGRITY کے ساتھ انسٹالیشن کو ناکام بنا دیتا ہے۔ اس کے فوائد کے بارے میں درست رہیں: یہ ثابت کرتا ہے کہ جو فائل آپ کو موصول ہوئی ہے وہ وہی فائل ہے جسے lockfile نے پن (pin) کیا تھا، جو کہ وہی گارنٹی ہے جو checksums کے ساتھ ڈاؤن لوڈز کی تصدیق آپ کو دیتی ہے، اور یہ اسی طرح محدود ہے۔ یہ اس بارے میں کچھ نہیں کہتا کہ آیا پن کیا گیا ورژن شائع ہونے کے وقت نقصان دہ تھا یا نہیں۔
--omit=dev کے بارے میں ایک تفصیل: وہ پیکیجز اب بھی ریزولو ہوتے ہیں اور اب بھی lockfile میں لکھے جاتے ہیں۔ انہیں صرف ڈسک پر نہیں رکھا جاتا۔ ڈسک پر کم پیکیجز کا مطلب ہے کم انسٹال اسکرپٹس اور رن ٹائم پر کم کوڈ لوڈ ہونا، لہذا یہ کرنا فائدہ مند ہے۔ یہ آپ کے ٹری سے کسی ڈیپینڈنسی کو نہیں ہٹاتا۔
انسٹال اسکرپٹس کو code سمجھیں، اور جانیں کہ انہیں کیسے مسترد کرنا ہے
آپ install scripts کو بند کر سکتے ہیں۔ اسے پروجیکٹ کی .npmrc میں شامل کریں اور lockfile کے ساتھ commit کریں:
ignore-scripts=true
save-exact=trueignore-scripts=true npm کو dependencies میں declared scripts چلانے سے روکتا ہے۔ save-exact=true، npm install some-lib کو ^1.4.2 کے بجائے package.json میں 1.4.2 لکھنے پر مجبور کرتا ہے، تاکہ resolving range غلطی سے آپ کے manifest میں شامل نہ ہو۔
اس سے کچھ چیزیں ناکام ہو جاتی ہیں، اس لیے اسے فعال کرنے سے پہلے طریقہ سمجھ لیں۔ جو packages native addon compile کرتے ہیں یا prebuilt binary download کرتے ہیں، وہ یہ کام install script میں کرتے ہیں۔ Scripts بند ہونے پر install کامیاب ہو جاتا ہے، لیکن خرابی بعد میں runtime پر ظاہر ہوتی ہے، جب module اپنی binding file load نہیں کر پاتا۔ اس کا حل allowlist ہے:
npm ci --ignore-scripts
npm rebuild better-sqlite3 --ignore-scripts=falsenpm rebuild <package> صرف اس package کے build scripts چلاتا ہے۔ --ignore-scripts=false اختیاری نہیں ہے: npm rebuild اس ignore-scripts=true کو ملحوظ رکھتا ہے جسے آپ نے ابھی .npmrc میں commit کیا ہے، اور override کے بغیر یہ package کی binaries link کرتا ہے اور اس کے کوئی scripts نہیں چلاتا۔ اب آپ نے ہر package کے لیے الگ فیصلہ کیا ہے، بجائے اس کے کہ چند سو ایسے اجنبیوں کو blanket execute permission دے دیں جن سے آپ کبھی نہیں ملیں گے۔
اگر آپ npm 12 چلاتے ہیں تو یہ allowlist built in ہے۔ npm approve-scripts better-sqlite3 منظوری کو package.json کے allowScripts field میں درج کرتا ہے، غیر منظور شدہ dependency scripts warning کے ساتھ skip کر دیے جاتے ہیں، اور npm rebuild اسی فہرست کو check کرتا ہے؛ اس لیے npm 12 پر اوپر دیا گیا rebuild بھی اس منظوری کا محتاج ہے۔ committed ignore-scripts=true، allowScripts policy کو مکمل طور پر override کرتا ہے۔
یہ دیکھنے کے لیے کہ اس وقت یہ grant کتنی بڑی ہے، npm سے پوچھیں:
npm query ":attr(scripts, [postinstall])"یہ installed tree میں موجود ہر اس package کو دکھاتا ہے جس میں postinstall script موجود ہے۔ عام application میں یہ فہرست لوگوں کی توقع سے مختصر ہوتی ہے، اور یہی چیز allowlist کو عملی بناتی ہے۔
build کو traffic فراہم کرنے والے process سے الگ رکھیں
deploy user کو node_modules میں لکھنے کی اجازت درکار ہے۔ HTTP درخواستوں کا جواب دینے والے process کو یہ اجازت درکار نہیں۔ اگر دونوں ایک ہی account ہوں تو install کے دوران چلنے والا code ان users کو فراہم کیے جانے والے code کو دوبارہ لکھ سکتا ہے، اور runtime پر چلنے والا code بھی ایسا کر سکتا ہے۔
انہیں الگ کریں۔ ایک user کے طور پر build کریں، دوسرے user کے طور پر service فراہم کریں، اور served directory کو serving account کے لیے read-only بنائیں:
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اب systemd کو اس پابندی کا نفاذ کرنے دیں۔ /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.targetProtectSystem=strict اس service کے لیے پورے file system کو read-only mount کرتا ہے، سوائے /dev، /proc، /sys اور ان تمام مقامات کے جو آپ ReadWritePaths میں درج کریں۔ اس لیے application کی طرف سے node_modules میں لکھنے کی کوشش EROFS: read-only file system کے ساتھ ناکام ہو جاتی ہے۔ آپ تقریباً ایک منٹ میں اپنے logs میں اس failure کو reproduce کر سکتے ہیں۔ NoExecPaths writable upload directory کو محفوظ رکھتا ہے: service وہاں files لکھ سکتی ہے، لیکن kernel انہیں execute ہونے سے روکتا ہے۔ اس option کے لیے systemd 248 یا اس کے بعد کا ورژن درکار ہے، اور Ubuntu 24.04 کے ساتھ 255 آتا ہے۔
اس unit file میں دو اہم traps ہیں۔ اول، MemoryDenyWriteExecute=yes شامل نہ کریں۔ یہ زیادہ تر systemd hardening lists میں شامل ہوتا ہے، لیکن Node کو start ہونے سے روکتا ہے، کیونکہ V8 runtime پر JavaScript کو machine code میں compile کرتا ہے اور اسے ایسے pages درکار ہوتے ہیں جو بیک وقت writable اور executable ہوں۔ دوم، ExecStart path، command -v node سے لیں۔ اگر Node کو version manager کے ذریعے install کیا گیا ہو تو یہ deploy user کی home directory کے اندر ہوتا ہے۔ ProtectHome=yes پھر وہ directory service سے چھپا دیتا ہے، اور unit فوراً status=203/EXEC کے ساتھ fail ہو جاتی ہے؛ log میں یہ بھی لکھا ہوتا ہے کہ executable تلاش نہیں کیا جا سکا۔
file پر بھروسا کرنے کے بجائے نتیجہ check کریں:
sudo systemctl daemon-reload
sudo systemctl enable --now nodeapp
sudo systemd-analyze security nodeapp.service
sudo -u nodeapp touch /srv/nodeapp/current/probesystemd-analyze security ہر hardening setting کو اس کی exposure کے ساتھ درج کرتا ہے، اس لیے آپ دیکھ سکتے ہیں کہ کون سی settings اب بھی default پر ہیں۔ touch کو Permission denied کے ساتھ fail ہونا چاہیے، کیونکہ nodeapp کے پاس current کے اندر کوئی چیز موجود نہیں ہے۔ اگر یہ کامیاب ہو جائے تو file ownership غلط ہے اور systemd settings خاموشی سے اس غلطی کو چھپا رہی ہیں۔
EnvironmentFile کے بارے میں ایک بات: systemd اسے User=nodeapp پر منتقل ہونے سے پہلے root کے طور پر پڑھتا ہے، اس لیے اس file کو mode 600 کے ساتھ root:root رکھا جا سکتا ہے۔ application کو variables پھر بھی موصول ہوتے ہیں۔ nodeapp کے طور پر shell رکھنے والا کوئی بھی شخص انہیں /proc/<pid>/environ سے پڑھ سکتا ہے، اس لیے یہ secret کو rest پر محفوظ کرتا ہے، running process کو نہیں۔
تعمیراتی credentials کو build environment سے باہر رکھیں
Install scripts کو environment وراثت میں ملتا ہے۔ build کہاں کرنا ہے، یہ حقیقت اسی بات سے طے ہونی چاہیے۔
بہترین طریقہ یہ ہے کہ build ایسی جگہ کریں جو production server نہ ہو، پھر مکمل directory وہاں copy کر دیں۔ اس صورت میں build machine پر صرف read-only registry token موجود ہوگا۔ SSH deploy key، cloud access key، database password یا container registry login میں سے کچھ بھی وہاں نہیں ہوگا۔
npm token create --name=build-readonly --packages-and-scopes-permission=read-only --packages-all --expires=30Read-only token packages حاصل کر سکتا ہے، لیکن publish نہیں کر سکتا۔ npm نے 9 December 2025 کو ہر classic token revoke کر دیا تھا، اس لیے یہ granular access token ہے، اور permission flag ہی اسے read-only بناتا ہے: موجودہ npm اب بھی پرانا --read-only flag قبول کرتا ہے، لیکن npm token create اسے registry کو نہیں بھیجتا۔ اگر build environment سے token چوری ہو جائے تو نقصان صرف ان packages تک read access تک محدود رہے گا جن کا یہ token احاطہ کرتا ہے۔
اگر server پر build کرنا ضروری ہو تو deploy user کے طور پر جان بوجھ کر محدود environment کے ساتھ build کریں، اور runtime secrets کو /etc/nodeapp/env میں رکھیں، جسے deploy پڑھ نہیں سکتا۔ یہی اصول اس build automation پر بھی لاگو ہوتا ہے جسے آپ خود host کرتے ہیں: self-hosted GitHub Actions runner ہر job کے دوران tokens رکھتا ہے اور شائع کیا گیا arbitrary code چلاتا ہے، اس لیے چھوٹی deployment میں یہ سب سے زیادہ اہم machine بن جاتا ہے۔ آپ کے پورے environment تک رسائی رکھنے والا کوئی بھی ایسا program جسے آپ نے خود نہیں لکھا، اسی زمرے میں آتا ہے۔ اسی لیے AI agent کے environment سے secrets باہر رکھنا بھی یہی مسئلہ ہے، صرف درمیان میں مختلف program موجود ہوتا ہے۔
جس کا audit نہیں کر سکتے، اسے pin یا vendor کریں
Pinned dependency وہ dependency ہے جس کا version commit کے بغیر تبدیل نہیں ہو سکتا۔ پورے dependency tree کے لیے committed lockfile پہلے ہی یہی کام کرتا ہے۔ دو صورتوں میں مزید اقدامات درکار ہوتے ہیں۔
پہلی صورت transitive dependencies کی ہے۔ آپ اس چیز کو control نہیں کرتے جس پر آپ کی dependencies منحصر ہیں۔ overrides کو package.json میں شامل کرنے سے پورے tree میں ہر جگہ ایک version نافذ ہو جاتا ہے:
{
"overrides": {
"some-transitive-lib": "1.4.2"
}
}اسے شامل کرنے کے بعد ایک بار npm install چلائیں تاکہ lockfile میں نتیجہ محفوظ ہو جائے، پھر دونوں files commit کریں۔
دوسری صورت ایسے package کی ہے جس کا audit نہیں کر سکتے اور جسے ہٹا بھی نہیں سکتے۔ اسے vendor کریں۔ npm pack وہی exact tarball download کرتا ہے جو registry فراہم کرتی، اور file: dependency آپ کی copy سے install ہوتی ہے:
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 آپ کی repository میں موجود ہے اور آپ کی نگرانی کے بغیر تبدیل نہیں ہو سکتا۔ اس کے updates کی ذمہ داری بھی اب ہمیشہ آپ پر ہے، اس لیے یہ طریقہ اس چھوٹے abandoned package کے لیے استعمال کریں جسے آپ کو رکھنا ضروری ہے، نہ کہ اپنے web framework کے لیے۔
ایک cooling-off period بھی ہے، جس پر کوئی لاگت نہیں آتی:
npm install --before=2026-08-01before option صرف ان versions کو استعمال کرتے ہوئے tree دوبارہ بناتا ہے جو اس تاریخ کو یا اس سے پہلے publish ہوئے تھے۔ Dependencies refresh کرتے وقت تاریخ ایک یا دو ہفتے پیچھے کی مقرر کریں۔ اس طرح وہ مدت گزر جاتی ہے جس میں کوئی خراب release live ہو چکی ہو لیکن ابھی report نہ ہوئی ہو۔ یہ ایک blunt tool ہے، کیونکہ اس سے حقیقی security fixes بھی مؤخر ہو جاتی ہیں۔ اسے ranges resolve کرنے کے لیے استعمال کریں، ہونے والی تبدیلیاں پڑھیں، پھر lockfile commit کریں۔ حالیہ npm releases min-release-age بھی قبول کرتے ہیں، جو دنوں میں rolling window ہے (min-release-age=7 کو .npmrc میں)، اور یہی کام ایسی تاریخ کے بغیر کرتا ہے جسے بار بار آگے منتقل کرنا پڑے۔ یہی اصول ان command-line tools پر بھی لاگو ہوتا ہے جنہیں آپ npm سے install کرتے ہیں مگر dependency کے طور پر استعمال نہیں کرتے۔ وہاں unpinned npx call اسی صبح ship ہونے والی کوئی بھی چیز fetch کر سکتی ہے، جبکہ exact dsh version کو pin کرنا ہی دو machines پر ایک ہی code چلنے کو یقینی بناتا ہے۔
مجھے کیسے معلوم ہوگا کہ میں نے اصل میں کون سا ورژن ریلیز کیا ہے؟
Git میں موجود lockfile یہ بتاتی ہے کہ کیا انسٹال ہونا چاہیے تھا۔ ڈسک یہ بتاتی ہے کہ کیا انسٹال ہوا ہے۔ صرف مؤخر الذکر ہی ثبوت ہے۔
npm ls some-lib
node -e "console.log(require('./node_modules/some-lib/package.json').version)"npm ls، node_modules کو پڑھتا ہے، لہذا یہ اس چیز کی اطلاع دیتا ہے جو جسمانی طور پر موجود ہے، نہ کہ اس کی جو lockfile کا ارادہ تھا۔ node -e لائن انسٹال شدہ مینی فیسٹ کو پاتھ کے ذریعے پڑھتی ہے، جو ان پیکجز کے لیے بھی کام کرتی ہے جن کا exports فیلڈ سب پاتھ امپورٹس کو بلاک کرتا ہے، اور یہ بغیر کسی ٹری ڈرائنگ کے ایک ورژن پرنٹ کرتی ہے۔
موازنہ کے دوسرے حصے کے لیے، git کو پڑھیں:
git log --oneline -- package-lock.json
git show <commit>:package-lock.json | grep -A3 '"node_modules/some-lib"'کمٹ کو deploy لے آؤٹ میں ڈال کر دونوں کے درمیان مستقل تعلق قائم کریں۔ /srv/nodeapp/releases/<short commit sha> میں ریلیز کریں اور /srv/nodeapp/current کو symlink کے ذریعے اس کی طرف اشارہ کریں۔ "ابھی کیا چل رہا ہے" کا جواب readlink /srv/nodeapp/current بن جاتا ہے، اور یہ 03:00 بجے اس شخص کے لیے بھی دستیاب ہوتا ہے جس نے اسے ڈیپلائے نہیں کیا تھا۔
آخر میں، چیک کریں کہ رجسٹری کس چیز کی تصدیق کرتی ہے:
npm audit signaturesیہ آپ کے انسٹال شدہ ٹری میں موجود پیکجز پر رجسٹری کے دستخطوں کی تصدیق کرتا ہے، اور ان پیکجز کے لیے provenance attestations کی تصدیق کرتا ہے جن کے پاس وہ موجود ہیں۔ Provenance ایک شائع شدہ tarball کو اس پبلک continuous integration (CI) بلڈ سے جوڑتا ہے جس نے اسے تیار کیا، لہذا ایک تصدیق شدہ attestation کا مطلب ہے کہ آپ کوڈ کو کسی نامعلوم لیپ ٹاپ کے بجائے ایک کمٹ تک ٹریس کر سکتے ہیں۔ کوریج ہر جگہ نہیں ہے، لہذا کسی غائب attestation کو "کوئی معلومات نہیں" کے طور پر پڑھیں، نہ کہ "خراب پیکج" کے طور پر۔
جب کوئی خراب ریلیز آپ کے سرور تک پہنچ جائے تو کیا کریں
جو کچھ چلا اور جس صارف (user) کے تحت چلا، وہاں سے باہر کی طرف کام شروع کریں۔
اگر کوڈ انسٹالیشن کے دوران چلا تھا، تو فرض کر لیں کہ build user کی پہنچ میں موجود ہر چیز خطرے میں ہے۔ registry token، اس home directory میں موجود SSH keys، cloud credentials، اور وہ تمام secrets جو اس shell میں export کیے گئے تھے، انہیں تبدیل (rotate) کریں۔ rotation ہی واحد ایماندارانہ ردعمل ہے، کیونکہ آپ یہ ثابت نہیں کر سکتے کہ کوئی فائل پڑھی نہیں گئی ہے۔
اگر کوڈ runtime پر کسی locked-down service account کے تحت چلا تھا، تو پہنچ کا دائرہ کار بہت چھوٹا ہوتا ہے: صرف ایپلیکیشن کے اپنے environment variables اور وہ سب کچھ جہاں تک اس کی network رسائی ممکن ہے۔ unprivileged users کے طور پر VPS پر سروسز چلانے کا پورا استدلال یہی ہے۔ یہ compromise کو روکتا نہیں ہے۔ یہ طے کرتا ہے کہ مشین کا کتنا حصہ compromise ہوا ہے، اور کیا یہ restart کے بعد بھی برقرار رہتا ہے۔
پھر صفائی کرنے کے بجائے دوبارہ تعمیر (rebuild) کریں۔ node_modules کو حذف کریں، متاثرہ پیکیج کو package.json میں خراب ورژن سے نیچے پن (pin) کریں، lockfile کو اپ ڈیٹ کرنے کے لیے ایک بار npm install چلائیں، اسے commit کریں، اور npm ci کے ساتھ deploy کریں۔ کسی tree کو اپنی جگہ پر مرمت نہ کریں۔ آپ یہ شمار نہیں کر سکتے کہ انسٹال اسکرپٹ نے کن چیزوں کو چھیڑا ہے۔
اس وقت کے دورانیے (window) کو بھی لکھ لیں: پہلی deploy جس نے ممکنہ طور پر وہ ورژن حاصل کیا ہو، اور وہ deploy جس نے اسے ہٹایا۔ یہ رینج آپ کو بتاتی ہے کہ آپ کو اپنے کون سے logs پڑھنے ہیں، اور اس کا جواب صرف تبھی ممکن ہے اگر آپ کی ریلیزز کے نام commits کے نام پر رکھے گئے ہوں۔
یہ چیزیں مسئلہ حل نہیں کرتیں
Lockfile کسی dependency کو محفوظ نہیں بناتی۔ یہ اس dependency کو قبول کرنے کے وقت کو تاریخ کے ساتھ review شدہ فیصلے میں بدل دیتی ہے، بجائے اس کے کہ وہ deploy کا غیر ارادی نتیجہ بنے۔ اوپر بیان کردہ ہر طریقہ اسی تبدیلی کو انجام دیتا ہے: حادثے کو انتخاب میں بدلنا۔
npm audit یہاں دفاع فراہم نہیں کرتا۔ یہ آپ کے tree کا موازنہ reported vulnerabilities کے database سے کرتا ہے، اس لیے یہ وہ مسائل تلاش کرتا ہے جو پہلے ہی publish اور نامزد کیے جا چکے ہیں۔ Supply-chain attack اپنی پوری مفید مدت میں نامعلوم رہتا ہے۔ پرانے معلوم bugs کے لیے npm audit چلائیں، لیکن چار گھنٹے پہلے ship ہونے والی release کے بارے میں اس سے کوئی نتیجہ حاصل ہونے کی توقع نہ رکھیں۔
اپنی dependencies کی تعداد کم کرنے سے اس guide کے کسی بھی tool سے زیادہ فائدہ ہوتا ہے، لیکن یہ وہ مشورہ ہے جو سب سے کم مقبول ہے۔ آپ جو package شامل نہیں کرتے، وہ ایک اضافی publisher ہے جسے آپ کی جانب سے phishing کا نشانہ نہیں بنایا جا سکتا، اور ایک اضافی install script ہے جو کبھی آپ کے deploy user کے طور پر نہیں چلتی۔
یہ بات صرف npm تک محدود نہیں۔ یہی چار صورتیں PyPI، RubyGems، container images اور آپ کی distribution کے package manager پر بھی لاگو ہوتی ہیں۔ npm میں یہ مسئلہ زیادہ نمایاں ہے، کیونکہ trees سب سے زیادہ گہرے ہوتے ہیں اور زیادہ تر servers پر چلنے والا npm default طور پر install scripts چلاتا ہے۔ جو بھی چیز آپ کے پہلے سے چلنے والے tool کو extend کرتی ہے، وہ یہی مسئلہ وراثت میں لیتی ہے۔ اسی لیے dsh plugin کو install کرنے سے پہلے یہ معلوم کرنا کہ وہ کن چیزوں تک رسائی حاصل کر سکتا ہے، postinstall script پڑھنے جیسی ہی مشق ہے؛ فرق صرف یہ ہے کہ یہاں آپ کے deploy user کے بجائے آپ کے agent کی permissions استعمال ہوتی ہیں۔ اردگرد کی machine کا کتنا حصہ محفوظ رکھنا آپ کی ذمہ داری ہے، یہ اس بات پر منحصر ہے کہ وہ کہاں چلتی ہے۔ یہ اسی وسیع سوال کا حصہ ہے کہ کیا VPS hosting محفوظ ہے۔
FAQ
کیا npm ci مجھے compromised npm package سے محفوظ رکھتا ہے؟
یہ آپ کو version کے آپ کی اطلاع کے بغیر تبدیل ہونے سے محفوظ رکھتا ہے۔ npm ci بالکل وہی install کرتا ہے جو package-lock.json record کرتا ہے، ہر tarball کو اس کے sha512 integrity hash سے check کرتا ہے، اور اگر package.json اور lockfile میں اختلاف ہو تو فرق خود حل کرنے کے بجائے error کے ساتھ exit ہو جاتا ہے۔ یہ نہیں بتاتا کہ pinned version محفوظ ہے یا نہیں۔ اگر آپ malicious version کو pin کرنے والا lockfile commit کر دیں تو npm ci آپ کے ہر server پر، ہر بار، اسی version کو faithfully install کرے گا۔
کیا مجھے ہر چیز کے لیے ignore-scripts=true set کرنا چاہیے؟
اسے set کریں، پھر allowlist بنائیں۔ project کے .npmrc میں ignore-scripts=true dependency install scripts کو چلنے سے روکتا ہے۔ اس سے malicious package سے deploy user کے credentials تک پہنچنے کا سب سے براہِ راست راستہ ختم ہو جاتا ہے۔ جو packages native addon compile کرتے ہیں یا prebuilt binary fetch کرتے ہیں، انہیں واقعی اپنے install scripts درکار ہوتے ہیں۔ Scripts بند ہونے پر یہ packages install time کے بجائے runtime میں missing binding file کے باعث fail ہوں گے۔ npm ci --ignore-scripts چلائیں، پھر ان چند packages کے لیے npm rebuild <package> --ignore-scripts=false چلائیں جن پر آپ نے اعتماد کرنے کا فیصلہ کیا ہے، کیونکہ بصورتِ دیگر npm rebuild .npmrc setting کی پابندی کرتا ہے اور کوئی script نہیں چلاتا۔ npm query ":attr(scripts, [postinstall])" دکھاتا ہے کہ حقیقت میں ایسے packages کتنے ہیں۔
مجھے کیسے معلوم ہو کہ میرے server نے package کا کون سا version واقعی install کیا ہے؟
Lockfile نہیں، disk کو پڑھیں۔ npm ls <package> بتاتا ہے کہ node_modules میں کیا موجود ہے، اور node -e "console.log(require('./node_modules/<package>/package.json').version)" صرف version string print کرتا ہے۔ git میں موجود lockfile ایک مختلف سوال کا جواب دیتا ہے: کون سا version install ہونا چاہیے تھا۔ دونوں کا موازنہ کرنا ہی مقصد ہے۔ git commit کے نام پر بنائے گئے directory میں deploy کرنے سے کئی ماہ بعد بھی دونوں جوابات دستیاب رہتے ہیں، جب آپ کو ان کی ضرورت پڑتی ہے۔
کیا npm audit supply-chain attacks تلاش کرتا ہے؟
نہیں۔ npm audit آپ کے tree کا موازنہ reported vulnerabilities کے database سے کرتا ہے، اس لیے یہ صرف وہ مسائل تلاش کرتا ہے جو پہلے ہی publish ہو چکے ہوں اور جنہیں identifier دیا جا چکا ہو۔ Malicious release اس وقت report نہیں ہوتی جب اسے install کرنا اہم ہوتا ہے، جو کئی گھنٹے یا دن ہو سکتے ہیں۔ npm audit signatures زیادہ مفید command ہے: یہ آپ کے installed tree میں registry signatures verify کرتا ہے اور جہاں publisher نے provenance attestations فراہم کی ہوں وہاں انہیں check کرتا ہے۔ اس سے معلوم ہوتا ہے کہ tarball کسی public build سے آیا ہے، نہ کہ کسی نامعلوم machine سے۔
اگر attack install time پر ہوتا ہے تو app کو unprivileged user کے طور پر چلانا کیوں اہم ہے؟
کیونکہ دونوں failures کی reach مختلف ہے اور آپ کو دونوں سے تحفظ درکار ہے۔ Install-time code deploy user کے طور پر چلتا ہے اور اس user کی SSH keys، registry tokens اور cloud credentials پڑھ سکتا ہے۔ Runtime code service account کے طور پر چلتا ہے۔ User=nodeapp، ProtectSystem=strict اور disk پر credentials نہ ہونے کی صورت میں اس کی رسائی application کے اپنے environment اور database تک محدود رہتی ہے۔ Accounts الگ رکھنے کا ایک اور فائدہ یہ ہے کہ traffic serve کرنے والا process node_modules کو rewrite نہیں کر سکتا۔ اس لیے runtime compromise اگلے restart پر ختم ہو جاتا ہے، مستقل نہیں بنتا۔