SSD Nodes Learn Hosting plans →
নির্দেশিকা Matt Connorদ্বারা Matt Connor

npm supply-chain attack থেকে সার্ভার সুরক্ষিত রাখার উপায়

npm supply-chain attack কীভাবে আপনার Node অ্যাপ্লিকেশনে প্রবেশ করে তা জানুন। malicious patch, postinstall scripts এবং typosquats থেকে সার্ভার বাঁচাতে সঠিক deploy পদ্ধতি অনুসরণ করুন।

আপনার সার্ভারে npm supply-chain attack কীভাবে ঘটে

আপনি ইনস্টল করার জন্য বেছে নেওয়া কোনো package-এর মাধ্যমে npm supply-chain attack আপনার সার্ভারে পৌঁছায়। এখানে কোনো open port জড়িত থাকে না এবং exploit চালানোর ধাপও থাকে না। npm code ইনস্টল করে, আর code ইনস্টল করার সময় সেই code-ই চালানো হয়। তাই একটি ছোট Node application এমন কয়েকশো package টেনে আনতে পারে, যেগুলো আপনি কখনো পড়ে দেখেননি। এর যেকোনো একটি package এক ঘণ্টা পর নতুন version প্রকাশ করতে পারে।

আপনার install command সর্বশেষ মিলে যাওয়া version চাওয়ায় deploy একটি malicious version সংগ্রহ করে। এরপর সেই code install চালানো ব্যক্তির privileges নিয়ে চলে। নিচের সবকিছু এই দুটি বাক্য থেকেই বোঝা যায়।

নিচের ধরনগুলো এমনভাবে সাজানো হয়েছে, যাতে একটি VPS-এ একটি Node app deploy করা একজন ব্যক্তিকে কোনটি কত ঘন ঘন আক্রমণ করে, সেই ক্রম প্রতিফলিত হয়। বড় কোনো কোম্পানি এই ক্রম ব্যবহার করবে না। কারণ বড় কোম্পানির internal registry, review team এবং public registry-এর mirror থাকে। আপনার আছে একটি deploy script।

আকৃতি 1: একজন মেইনটেইনারের অ্যাকাউন্ট হ্যাক হওয়া এবং একটি প্যাচ পাবলিশ করা

npm registry বিদ্যমান কোনো ভার্সনের বিষয়বস্তু পরিবর্তন করতে দেয় না। তাই কোনো আক্রমণকারী যদি ফিশিংয়ের মাধ্যমে মেইনটেইনারের তথ্য হাতিয়ে নেয় বা পাবলিশ টোকেন চুরি করে, তবে তারা 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 কমান্ডটি রান করার সময় সেই রেঞ্জটি নির্ধারণ করে, তাই একই দিনে দুইবার একই git commit ডেপ্লয় করলেও দুইবার ভিন্ন ভিন্ন কোড সেট ইনস্টল হতে পারে। এই ব্যবধানটিই হলো আক্রমণের সুযোগ বা attack surface। এটি ঘটার জন্য আপনার মেশিনের কোনো কিছু হ্যাক হওয়ার প্রয়োজন নেই।

ক্ষতিকারক রিলিজগুলো সাধারণত রিপোর্ট করা হয় এবং সরিয়ে ফেলা হয়, কিন্তু এই অপসারণের আগেই মানুষ সেগুলো ইনস্টল করে ফেলে। যে কেউ যদি সেই সময়ের মধ্যে ডেপ্লয় করে থাকে, তবে তাদের ডিস্কে সেই কোড থেকে যায়। যে পাইপলাইন প্রতিবার রান করার সময় রেঞ্জ নির্ধারণ করে, সেটি কোনো মানুষের সিদ্ধান্ত ছাড়াই সপ্তাহে কয়েকবার স্বয়ংক্রিয়ভাবে সেই ঝুঁকির মুখে পড়ে।

শেপ 2: deploy চালানো ব্যবহারকারীর অধীনে install script চলে

একটি package-এর package.json তার scripts block-এ preinstall, install, postinstall এবং prepare ঘোষণা করতে পারে। npm installation-এর সময় এগুলো চালায়। এগুলো sandbox করা থাকে না এবং কেউ এগুলো পর্যালোচনা করে না। এগুলো হলো install command টাইপ করা ব্যবহারকারীর অধীনে চলা shell command। এগুলো ওই ব্যবহারকারীর home directory, ওই ব্যবহারকারীর network access এবং সেই shell-এর সম্পূর্ণ environment ব্যবহার করে।

8 July 2026-এ released npm 12 এই default পরিবর্তন করে: project-এর allowScripts field package.json-এ সেগুলো অনুমোদন না করলে এটি dependency install script block করে। 12 October 2026 পর্যন্ত কোনো Node.js release npm 12 bundle করে না (Node.js 26.11.1-এর সঙ্গে npm 11.20.0 ships), তাই আপনি নিজে npm upgrade না করলে আপনার server-এর npm এখনও প্রতিটি script চালায়।

তাই package কী করতে পারে, সেটি কার্যকর প্রশ্ন নয়। কার্যকর প্রশ্ন হলো, ওই ব্যবহারকারী কী পড়তে পারে। একটি সাধারণ deploy box-এ এর মধ্যে থাকে registry token থাকা ~/.npmrc, SSH (secure shell)-এর deploy key হিসেবে ব্যবহৃত ~/.ssh/id_ed25519, ~/.aws/credentials, ~/.docker/config.json এবং shell-এ export করা প্রতিটি variable। সাধারণত DATABASE_URL এখানেই থাকে।

এ ধরনের payload-এর persistence বা privilege escalation-এর প্রয়োজন নেই। এটি কয়েকটি file পড়ে, HTTPS-এর মাধ্যমে সেগুলো একটি host-এ পাঠায় এবং status 0 দিয়ে শেষ হয়। আপনি কিছুই দেখতে পান না, কারণ npm default হিসেবে install-script output আড়াল করে। এটি বন্ধ করে আসলে কী চলছে তা দেখুন:

npm ci --foreground-scripts

foreground-scripts npm process-এর সঙ্গে standard input, output এবং error share করে। তাই build script আপনার terminal-এ print করে, install সফল হলে npm যে buffer বাতিল করে সেখানে নয়।

আকৃতি 3: typosquats এবং যে নামটি আপনি ভুল করে টাইপ করেছেন

একটি typosquat হলো এমন একটি প্যাকেজ যা জনপ্রিয় কোনো প্যাকেজের নামের কাছাকাছি নামে পাবলিশ করা হয়, যাতে কেউ ভুল করে বা ভুলভাবে পেস্ট করা install কমান্ডের মাধ্যমে সেটি ইনস্টল করে। এই আক্রমণের মূল কৌশলটি কমান্ডের ওপর নির্ভর করে, কোডের ওপর নয়, তাই lockfile এখানে আপনাকে সাহায্য করতে পারে না: আপনি একবার ভুল নামে প্যাকেজটি যোগ করলে, lockfile বিশ্বস্ততার সাথে সেই ভুল প্যাকেজটিই পিন করে রাখবে।

যে ভেরিয়েন্টটি ব্যক্তিগত ব্যবহারকারীর চেয়ে টিমকে বেশি বিপদে ফেলে তা হলো dependency confusion। ধরুন আপনার অভ্যন্তরীণ প্যাকেজের নাম billing-utils এবং এটি একটি private registry-তে থাকে। যদি public registry-তে billing-utils নামে কিছু না থাকে, তবে যে কেউ সেখানে এই নামে একটি প্যাকেজ পাবলিশ করতে পারে। npm unscoped নামগুলোকে ডিফল্ট public registry-র সাথে মিলিয়ে দেখে, তাই public কপিটি জিতে যেতে পারে। এর সমাধান হলো আপনার নিজস্ব একটি scope এবং সেই scope-এর জন্য একটি registry mapping ব্যবহার করা, যা .npmrc-এ দেওয়া হলো:

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

এখন @yourorg/billing-utils শুধুমাত্র সেই নির্দিষ্ট হোস্ট থেকেই আনা হবে, কারণ ডিফল্ট registry-র আগে scope-to-registry ম্যাপিং যাচাই করা হয়। একটি unscoped অভ্যন্তরীণ নামের কোনো ম্যাপিং থাকে না, তাই সেটির কোনো সুরক্ষা নেই।

নতুন কোনো dependency যোগ করার আগে, সেটির ডাউনলোড ব্যাজ দেখার চেয়ে প্যাকেজটি নিজে যাচাই করুন:

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

গত মাসে তৈরি একটি প্যাকেজ, যা এমন কোনো অ্যাকাউন্ট থেকে পাবলিশ করা হয়েছে যার সাথে কোনো public repository-র সংযোগ খুঁজে পাওয়া যাচ্ছে না, সেটি ছয় বছরের ইতিহাস থাকা প্যাকেজের চেয়ে ভিন্ন ধরনের ঝুঁকি তৈরি করে। কোনো তথ্যই চূড়ান্ত প্রমাণ নয়। তবে উভয়ই যাচাই করা সহজ।

আকৃতি 4: যে ডিপেন্ডেন্সির মালিক নীরবে পরিবর্তিত হয়েছে

মেইনটেইনাররা প্যাকেজের দায়িত্ব হস্তান্তর করেন। কেউ ক্লান্ত হয়ে পড়লে অন্য কেউ সাহায্যের প্রস্তাব দেন, পাবলিশ করার অধিকার হাতবদল হয়, কিন্তু এর ওপর নির্ভরশীল প্রজেক্টগুলো কোনো নোটিফিকেশন পায় না। এতে কোনো কিছু কম্প্রোমাইজ হয় না। 2021 সালে আপনি যে আস্থা রেখেছিলেন, তা এখন অন্য কারো হাতে।

এটি সবচেয়ে ধীরগতির এবং শনাক্ত করা কঠিন আকৃতি, কোনো কমান্ড সরাসরি এর উত্তর দিতে পারে না। দুটি বিষয় এটি যাচাই করতে সাহায্য করে। কোনো প্যাকেজ গ্রহণ করার আগে npm view লাইনটি ব্যবহার করে দেখুন কারা এটি পাবলিশ করতে পারে। এরপর যখন আপনার কোনো প্রয়োজনীয় প্যাকেজ পরিবর্তিত হয়, তখন নিচের ডিফারেন্সটি দেখুন:

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

প্রথম ফরম্যাটটি শুধুমাত্র পরিবর্তিত ফাইলের নামগুলো দেখায়, যা আপনার গুরুত্বপূর্ণ প্যাকেজগুলোর প্রতিটি আপগ্রেডের সময় চেক করার জন্য যথেষ্ট দ্রুত। কোনো প্যাচ রিলিজ যদি বিল্ড স্ক্রিপ্ট পরিবর্তন করে, প্যাকেজের রুটে নতুন ফাইল যোগ করে, অথবা scripts ব্লকটি এডিট করে, তবে তা আপনার সার্ভারে পৌঁছানোর আগেই সম্পূর্ণ পড়ে দেখা উচিত।

npm ci ব্যবহার করে একটি কমিট করা lockfile থেকে বিল্ড করা

package-lock.json ট্রি-তে থাকা প্রতিটি প্যাকেজের সঠিক সংস্করণ, প্রতিটি প্যাকেজ যে URL থেকে এসেছে, প্রতিটি tarball-এর sha512 ইন্টিগ্রিটি হ্যাশ এবং কোন প্যাকেজটি সেটির ওপর নির্ভরশীল, তা রেকর্ড করে। এটিকে কমিট করুন। এটিই একমাত্র ফাইল যা বলে আপনি আসলে কী পরীক্ষা করেছেন।

এরপর ডেভেলপার ল্যাপটপ নয় এমন যেকোনো মেশিনে npm ci ব্যবহার করে ইন্সটল করুন, কখনোই npm install ব্যবহার করবেন না:

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

npm ci এবং npm install-এর মধ্যে পার্থক্যগুলো এখানে অত্যন্ত গুরুত্বপূর্ণ। npm ci-এর জন্য একটি lockfile থাকা আবশ্যক। এটি শুরু করার আগেই বিদ্যমান যেকোনো node_modules মুছে ফেলে, যাতে আগের কোনো ডেপ্লয়মেন্টের অবশিষ্টাংশ বর্তমান ডেপ্লয়মেন্টে থেকে না যায়। এটি কখনোই package.json বা lockfile-এ কিছু লেখে না, তাই ইন্সটলেশন প্রক্রিয়া নীরবে আপনাকে নতুন সংস্করণে নিয়ে যেতে পারে না। যদি lockfile এবং package.json-এর মধ্যে অমিল থাকে, তবে এটি কোনো পার্থক্য সমাধান না করে ত্রুটি (error) প্রদর্শন করে বন্ধ হয়ে যায়।

এই ত্রুটিটি কোনো বিরক্তির কারণ নয়, বরং এটি একটি ফিচার। এর অর্থ হলো, কোনো ডিপেন্ডেন্সি পরিবর্তন অবশ্যই এমন একটি কমিট হিসেবে আসতে হবে যা কেউ পর্যালোচনা করেছে, রাত 2টার সময় ডেপ্লয়মেন্টের পার্শ্বপ্রতিক্রিয়া হিসেবে নয়।

প্রতিটি ফেচ (fetch)-এর সময় ইন্টিগ্রিটি হ্যাশ যাচাই করা হয়। যে tarball-এর বাইটগুলো রেকর্ড করা হ্যাশের সাথে মেলে না, তা আনপ্যাক না হয়ে code EINTEGRITY ত্রুটির মাধ্যমে ইন্সটলেশন ব্যর্থ করে দেয়। এটি আপনাকে কী সুবিধা দেয় তা স্পষ্টভাবে বুঝুন: এটি প্রমাণ করে যে আপনি যে ফাইলটি পেয়েছেন তা সেই ফাইলই যা lockfile-এ পিন করা ছিল। এটি সেই একই নিশ্চয়তা দেয় যা চেকসাম দিয়ে ডাউনলোড যাচাই করা আপনাকে প্রদান করে এবং এটি একইভাবে সীমাবদ্ধ। পিন করা সংস্করণটি প্রকাশের সময় ক্ষতিকারক ছিল কি না, সে সম্পর্কে এটি কিছুই বলে না।

--omit=dev সম্পর্কে একটি বিষয়: এই প্যাকেজগুলো তখনও রিজলভ হয় এবং lockfile-এ লেখা হয়। এগুলো কেবল ডিস্কে রাখা হয় না। ডিস্কে কম প্যাকেজ থাকার অর্থ হলো কম ইন্সটল স্ক্রিপ্ট এবং রানটাইমে কম কোড লোড হওয়া, তাই এটি করা লাভজনক। এটি আপনার ট্রি থেকে কোনো ডিপেন্ডেন্সি মুছে ফেলে না।

Install script-কে code হিসেবে বিবেচনা করুন এবং প্রয়োজনে সেগুলো প্রত্যাখ্যান করতে জানুন

আপনি install script বন্ধ করতে পারেন। প্রজেক্টের .npmrc-এ নিচের সেটিং যোগ করুন এবং এটি lockfile-এর পাশে commit করুন:

ignore-scripts=true
save-exact=true

ignore-scripts=true dependency-তে ঘোষিত script চালানো থেকে npm-কে বিরত রাখে। save-exact=true, npm install some-lib-কে ^1.4.2-এর পরিবর্তে package.json-এ 1.4.2 লিখতে বাধ্য করে। ফলে resolving range ভুল করে আপনার manifest-এ ঢুকে পড়ে না।

এতে কিছু বিষয় কাজ করা বন্ধ করবে। তাই এই সেটিং চালু করার আগে কীভাবে তা সামলাতে হয় জেনে নিন। Native addon compile করে বা prebuilt binary download করে এমন package install script-এ সেই কাজ সম্পন্ন করে। Script বন্ধ থাকলে install সফল হয়। কিন্তু পরে runtime-এ binding file load করা যায় না এবং module ব্যর্থ হয়। এর সমাধান হলো allowlist:

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

npm rebuild <package> ওই একটি package-এর build script চালায়। --ignore-scripts=false ঐচ্ছিক নয়। npm rebuild আপনি .npmrc-এ commit করা ignore-scripts=true মেনে চলে। Override ছাড়া এটি package-এর binary link করে, কিন্তু কোনো script চালায় না। এখন প্রতিটি package-এর জন্য আলাদা সিদ্ধান্ত নেওয়া হয়েছে। এমন কয়েকশো অচেনা package-কে একসঙ্গে execute permission দেওয়া হয়নি, যাদের কাউকেই আপনি ব্যক্তিগতভাবে চেনেন না।

আপনি npm 12 ব্যবহার করলে এই allowlist অন্তর্নির্মিত থাকে। npm approve-scripts better-sqlite3, package.json-এর allowScripts field-এ অনুমোদন সংরক্ষণ করে। অনুমোদন না পাওয়া dependency script warning সহ এড়িয়ে যায়। npm rebuild একই তালিকা পরীক্ষা করে। তাই npm 12-এ উপরের rebuild চালাতেও ওই অনুমোদন প্রয়োজন। Commit করা ignore-scripts=true সম্পূর্ণভাবে allowScripts policy-কে অগ্রাহ্য করে।

বর্তমানে এই অনুমোদনের পরিসর কত বড় তা দেখতে npm-কে জিজ্ঞেস করুন:

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

এটি installed tree-তে থাকা এবং postinstall script ধারণ করা প্রতিটি package দেখায়। সাধারণ application-এ এই তালিকা মানুষ যতটা আশা করে তার চেয়ে ছোট হয়। এ কারণেই allowlist ব্যবহার করা বাস্তবসম্মত।

বিল্ড এবং network traffic পরিবেশনকারী process আলাদা করুন

deploy user-কে node_modules-এ লিখতে হবে। HTTP request-এর উত্তর দেওয়া process-এর তা করতে হয় না। উভয় process একই account ব্যবহার করলে install-এর সময় চলা code আপনার user-দের জন্য পরিবেশিত code পরিবর্তন করতে পারে। Runtime-এ চলা code-ও তা করতে পারে।

এগুলো আলাদা করুন। একজন user হিসেবে build করুন, অন্য user হিসেবে পরিবেশন করুন, এবং serving account-এর জন্য পরিবেশিত directory 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.target

ProtectSystem=strict এই service-এর জন্য সম্পূর্ণ file system read-only হিসেবে mount করে, তবে /dev, /proc, /sys এবং ReadWritePaths-এ তালিকাভুক্ত path-গুলো এর ব্যতিক্রম। তাই application node_modules-এ লেখার চেষ্টা করলে EROFS: read-only file system ব্যর্থতা দেখা যায়। প্রায় এক মিনিটের মধ্যে আপনি নিজের লগেও এটি পুনরুৎপাদন করে দেখতে পারবেন। NoExecPaths writable upload directory-কে সুরক্ষিত করে: service সেখানে file লিখতে পারে, কিন্তু kernel সেগুলো execute করতে দেয় না। এই option-এর জন্য systemd 248 বা পরবর্তী সংস্করণ প্রয়োজন, এবং Ubuntu 24.04-এ 255 সংস্করণ রয়েছে।

এই unit file-এ দুটি সমস্যা হতে পারে। প্রথমত, MemoryDenyWriteExecute=yes যোগ করবেন না। অধিকাংশ systemd hardening তালিকায় এটি থাকে। কিন্তু এটি Node start হতে বাধা দেয়, কারণ V8 runtime-এ JavaScript-কে machine code-এ compile করে এবং একই সঙ্গে writable ও executable page প্রয়োজন। দ্বিতীয়ত, ExecStart path-টি command -v node থেকে নিন। Node version manager দিয়ে install করা হলে এটি deploy user-এর home directory-এর অধীনে থাকে। ProtectHome=yes তখন service-এর কাছ থেকে ওই directory আড়াল করে, এবং unit সঙ্গে সঙ্গে status=203/EXEC-সহ ব্যর্থ হয়। লগে executable খুঁজে পাওয়া যায়নি—এমন একটি বার্তাও দেখা যায়।

শুধু file দেখে বিশ্বাস না করে ফলাফল পরীক্ষা করুন:

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 প্রতিটি hardening setting এবং তার exposure তালিকাভুক্ত করে। এতে কোন setting এখনও default অবস্থায় আছে তা দেখা যায়। touch-এর ব্যর্থ হয়ে Permission denied দেখানোর কথা, কারণ nodeapp-এর মালিকানায় current-এর অধীনে কিছুই নেই। এটি সফল হলে আপনার file ownership ভুল এবং systemd settings নীরবে সেই ভুল আড়াল করছে।

EnvironmentFile সম্পর্কে একটি বিষয় মনে রাখুন: systemd User=nodeapp-এ privilege drop করার আগে root হিসেবে এটি পড়ে। তাই ওই file-টি mode 600 সহ root:root হতে পারে। Application তবুও variable-গুলো পায়। nodeapp হিসেবে shell access থাকা যে কেউ /proc/<pid>/environ থেকে সেগুলো পড়তে পারে। তাই এটি disk-এ সংরক্ষিত secret সুরক্ষিত করে, চলমান process-কে নয়।

বিল্ড পরিবেশের বাইরে deploy credential রাখুন

Install script পরিবেশের ভেরিয়েবল উত্তরাধিকারসূত্রে পায়। কোথায় build করবেন, এই একটি বিষয়ই তাই সিদ্ধান্ত নির্ধারণ করা উচিত।

সবচেয়ে নিরাপদ পদ্ধতি হলো production server-এর বাইরে build করে সম্পূর্ণ directory সেখানে কপি করা। সে ক্ষেত্রে 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=30

Read-only token package fetch করতে পারে, publish করতে পারে না। npm 9 December 2025 তারিখে সব classic token বাতিল করেছে। তাই এটি একটি granular access token, এবং permission flag-ই এটিকে read-only করে। বর্তমান npm এখনও পুরনো --read-only flag গ্রহণ করে, কিন্তু npm token create registry-তে এটি পাঠায় না। build পরিবেশ থেকে token চুরি হলে ক্ষতি সীমাবদ্ধ থাকবে token-টির আওতাভুক্ত package-এ read access পর্যন্ত।

সার্ভারেই build করতে হলে deploy user হিসেবে deliberately narrow environment ব্যবহার করুন। Runtime secret /etc/nodeapp/env-এ রাখুন, যা deploy পড়তে পারে না। নিজেরা পরিচালিত build automation-এর ক্ষেত্রেও একই যুক্তি প্রযোজ্য। একটি self-hosted GitHub Actions runner token ধরে রাখে এবং প্রতিটি job-এ প্রকাশিত যেকোনো code নির্বাহ করে। তাই ছোট deployment-এ এটি সবচেয়ে মূল্যবান machine। আপনার লেখা নয় এমন কোনো program যদি সম্পূর্ণ environment পায়, সেটিও একই শ্রেণির ঝুঁকি তৈরি করে। এই কারণেই AI agent-এর environment-এর বাইরে secret রাখা একই সমস্যার একটি ভিন্ন program-মধ্যস্থ রূপ।

আপনি যা নিরীক্ষা করতে পারবেন না, সেটি pin করুন বা vendor করুন

যে dependency-এর version কোনো commit ছাড়া পরিবর্তন করা যায় না, সেটি pinned dependency। পুরো dependency tree-এর জন্য committed lockfile ইতিমধ্যেই এই কাজটি করে। তবে আরও 2টি ক্ষেত্রে অতিরিক্ত ব্যবস্থা দরকার।

প্রথমটি হলো transitive dependency। আপনার dependency-গুলো কোন dependency ব্যবহার করে, তা আপনি নিয়ন্ত্রণ করেন না। overrides-এর package.json tree-এর যেকোনো স্থানে একটি version বাধ্যতামূলক করে:

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

এটি যোগ করার পরে একবার npm install চালান, যাতে lockfile ফলাফলটি সংরক্ষণ করে। এরপর দুইটি file-ই commit করুন।

দ্বিতীয় ক্ষেত্রে এমন একটি package রয়েছে যেটি আপনি audit করতে পারবেন না এবং বাদও দিতে পারবেন না। সেটি vendor করুন। npm pack registry যে exact tarball সরবরাহ করত, সেটিই download করে। আর একটি 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-তে রয়েছে এবং আপনার অজান্তে পরিবর্তিত হতে পারবে না। তবে এর update-এর দায়িত্ব এখন স্থায়ীভাবে আপনার। তাই এই পদ্ধতি এমন ছোট, পরিত্যক্ত package-এর জন্য ব্যবহার করুন যার ওপর আপনি নির্ভরশীল; web framework-এর জন্য নয়।

আরও একটি cooling-off period রয়েছে, যার কোনো খরচ নেই:

npm install --before=2026-08-01

before option ব্যবহার করলে tree পুনর্নির্মাণের সময় শুধু সেই version ব্যবহার করা হয় যেগুলো ওই তারিখে বা তার আগে প্রকাশিত হয়েছিল। Dependency refresh করার সময় তারিখটি এক বা দুই সপ্তাহ পিছিয়ে দিন। এতে কোনো খারাপ release প্রকাশিত হলেও সেটি রিপোর্ট হওয়ার আগের সময়সীমা এড়িয়ে চলা যায়। এটি একটি কঠোর পদ্ধতি, কারণ এতে প্রকৃত security fix-ও পিছিয়ে যায়। এটি range নির্ধারণের জন্য ব্যবহার করুন, কী পরিবর্তন হয়েছে তা পড়ুন, তারপর lockfile commit করুন। সাম্প্রতিক npm release-গুলো min-release-age-ও গ্রহণ করে। এটি দিনের হিসাবে একটি rolling window (min-release-age=7 in .npmrc), যা একই কাজ করে, তবে বারবার পরিবর্তন করতে হয় এমন কোনো তারিখের প্রয়োজন হয় না। npm থেকে install করা command-line tool-গুলোকেও dependency হিসেবে না রেখে install করার ক্ষেত্রে একই নীতি প্রযোজ্য। সেখানে unpinned npx call ওই সকালে প্রকাশিত যেকোনো version fetch করে, আর একটি নির্দিষ্ট dsh version pin করলেই দুইটি machine একই 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 ফিল্ড subpath import ব্লক করে রাখে এবং এটি কোনো ট্রি ডায়াগ্রাম ছাড়াই শুধুমাত্র ভার্সনটি প্রিন্ট করে।

তুলনার অন্য অংশের জন্য, git চেক করুন:

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

deploy লেআউটে commit-টি যুক্ত করে এই দুটির মধ্যে সংযোগ স্থায়ী করুন। /srv/nodeapp/releases/<short commit sha> ডিরেক্টরিতে রিলিজ করুন এবং একটি symlink দিয়ে /srv/nodeapp/current-কে সেটির দিকে নির্দেশ করুন। "বর্তমানে কী চলছে" এই প্রশ্নের উত্তর হবে readlink /srv/nodeapp/current, এবং এটি এমন কারো কাছে 03:00 টায় উপলব্ধ থাকবে যিনি এটি deploy করেননি।

পরিশেষে, registry কী নিশ্চয়তা দিচ্ছে তা যাচাই করুন:

npm audit signatures

এটি আপনার ইনস্টল করা ট্রিতে থাকা প্যাকেজগুলোর registry স্বাক্ষর যাচাই করে এবং যেসব প্যাকেজের provenance attestation আছে তা নিশ্চিত করে। Provenance একটি প্রকাশিত tarball-কে সেই পাবলিক continuous integration (CI) বিল্ডের সাথে যুক্ত করে যা এটি তৈরি করেছে। তাই একটি যাচাইকৃত attestation-এর অর্থ হলো আপনি কোডটিকে কোনো অজানা ল্যাপটপের পরিবর্তে একটি নির্দিষ্ট commit-এর সাথে মিলিয়ে দেখতে পারবেন। সব প্যাকেজের ক্ষেত্রে এটি প্রযোজ্য নয়, তাই কোনো attestation না থাকলে সেটিকে "তথ্য নেই" হিসেবে ধরুন, "খারাপ প্যাকেজ" হিসেবে নয়।

একটি ত্রুটিপূর্ণ রিলিজ আপনার সার্ভারে পৌঁছালে যা করবেন

যা রান করেছে এবং যে ব্যবহারকারীর অধীনে রান করেছে, সেখান থেকে কাজ শুরু করুন।

যদি ইনস্টলেশনের সময় কোডটি রান করে থাকে, তবে ধরে নিন বিল্ড ব্যবহারকারীর পড়ার যোগ্য সবকিছুই বেহাত হয়েছে। রেজিস্ট্রি টোকেন, সেই হোম ডিরেক্টরিতে থাকা SSH keys, ক্লাউড ক্রেডেনশিয়াল এবং সেই শেলে এক্সপোর্ট করা যেকোনো সিক্রেট পরিবর্তন (rotate) করুন। রোটেশনই একমাত্র সঠিক পদক্ষেপ, কারণ কোনো ফাইল পড়া হয়নি তা আপনি প্রমাণ করতে পারবেন না।

যদি কোডটি রানটাইমে একটি লক-ডাউন সার্ভিস অ্যাকাউন্টের অধীনে রান করে, তবে এর নাগাল অনেক সীমিত: অ্যাপ্লিকেশনটির নিজস্ব এনভায়রনমেন্ট ভেরিয়েবল এবং এর নেটওয়ার্ক অ্যাক্সেস যা কিছু স্পর্শ করতে পারে। VPS-এ আনপ্রিভিলেজড ব্যবহারকারী হিসেবে সার্ভিস রান করার পুরো যুক্তিটিই এটি। এটি কম্প্রোমাইজ প্রতিরোধ করে না। এটি নির্ধারণ করে যে কম্প্রোমাইজটি মেশিনের কতটা ক্ষতি করতে পারবে এবং রিস্টার্টের পরেও তা টিকে থাকবে কি না।

এরপর ক্লিন করার পরিবর্তে নতুন করে বিল্ড করুন। node_modules ডিলিট করুন, package.json-এ ক্ষতিগ্রস্ত প্যাকেজটিকে ত্রুটিপূর্ণ ভার্সনের নিচে পিন করুন, লকফাইল আপডেট করতে একবার npm install রান করুন, এটি কমিট করুন এবং npm ci দিয়ে ডিপ্লয় করুন। কোনো ট্রি (tree) সরাসরি মেরামত করার চেষ্টা করবেন না। একটি ইনস্টল স্ক্রিপ্ট কী কী পরিবর্তন করেছে তা আপনি পুরোপুরি তালিকাভুক্ত করতে পারবেন না।

সময়সীমাটিও লিখে রাখুন: প্রথম যে ডিপ্লয়টি ভার্সনটি টেনে থাকতে পারে এবং যে ডিপ্লয়টি এটি সরিয়ে ফেলেছে। সেই রেঞ্জটি আপনাকে বলে দেবে আপনার কোন লগগুলো পড়তে হবে, এবং এটি কেবল তখনই জানা সম্ভব যদি আপনার রিলিজগুলোর নামকরণ কমিট অনুযায়ী করা থাকে।

যেগুলো এর কোনোটিই সমাধান করে না

একটি lockfile কোনো dependency-কে নিরাপদ করে না। এটি dependency গ্রহণ করার মুহূর্তটিকে deploy-এর পার্শ্বপ্রতিক্রিয়া হিসেবে না রেখে তারিখসহ পর্যালোচিত সিদ্ধান্তে পরিণত করে। উপরের প্রতিটি পদ্ধতি একই রূপান্তর ঘটায়: দুর্ঘটনাকে ইচ্ছাকৃত সিদ্ধান্তে পরিণত করে।

এখানে npm audit কোনো প্রতিরক্ষা নয়। এটি আপনার tree-কে প্রকাশিত vulnerability-এর database-এর সঙ্গে তুলনা করে। তাই ইতিমধ্যে প্রকাশিত ও নামযুক্ত সমস্যাগুলো শনাক্ত করতে পারে। একটি supply-chain attack তার কার্যকর পুরো সময়জুড়ে নামহীন থাকে। পুরোনো, পরিচিত bug খুঁজতে npm audit চালান। কিন্তু চার ঘণ্টা আগে প্রকাশিত release সম্পর্কে এটি কিছু জানাবে—এমন আশা করবেন না।

এই guide-এর যেকোনো tool-এর চেয়ে dependency-এর সংখ্যা কমানো বেশি কার্যকর। অথচ এটিই সবচেয়ে কম জনপ্রিয় পরামর্শ। আপনি যে package যোগ করেন না, সেটি আপনার হয়ে phish করার জন্য আরও একজন publisher কমায়। একই সঙ্গে আপনার deploy user হিসেবে চালানোর জন্য একটি install script-ও কম থাকে।

এগুলোর কোনোটিই শুধু npm-এর ক্ষেত্রে প্রযোজ্য নয়। একই চারটি ধরন PyPI, RubyGems, container image এবং আপনার distribution-এর package manager-এর ক্ষেত্রেও প্রযোজ্য। npm-এ সমস্যাটি বেশি চোখে পড়ে, কারণ dependency tree সবচেয়ে গভীর এবং অধিকাংশ server-এ চলা npm ডিফল্টভাবে install script চালায়। আপনি আগে থেকেই চালানো কোনো tool-এর কার্যকারিতা বাড়ায় এমন যেকোনো কিছু একই সমস্যার উত্তরাধিকার পায়। তাই কোনো dsh plugin install করার আগে এটি কী কী access করতে পারে তা নির্ধারণ করা এবং একটি postinstall script পড়া একই ধরনের কাজ। পার্থক্য হলো, এখানে আপনার deploy user-এর জায়গায় agent-এর permission থাকে। আশপাশের machine-এর কতটা অংশ আপনাকে নিরাপদ রাখতে হবে, তা এটি কোথায় চলে তার ওপর নির্ভর করে। এটি VPS hosting নিরাপদ কি না—এই বৃহত্তর প্রশ্নের একটি অংশ।

FAQ

npm ci কি আমাকে compromised npm package থেকে সুরক্ষিত রাখে?

এটি আপনার অজান্তে version পরিবর্তন হওয়া থেকে সুরক্ষা দেয়। npm ci ঠিক package-lock.json-এ রেকর্ড করা জিনিসই install করে, প্রতিটি tarball-এর sha512 integrity hash দিয়ে যাচাই করে, এবং package.json ও lockfile-এর মধ্যে অমিল থাকলে পার্থক্য সমাধান না করে error দিয়ে বন্ধ হয়ে যায়। pinned version নিরাপদ কি না, সে বিষয়ে এটি কিছু বলে না। আপনি যদি malicious version pin করা একটি lockfile commit করেন, npm ci আপনার নিয়ন্ত্রিত প্রতিটি server-এ প্রতিবার সেই version-ই নির্ভুলভাবে install করবে।

সবকিছুর জন্য কি ignore-scripts=true সেট করা উচিত?

এটি সেট করুন, তারপর allowlist ব্যবহার করুন। Project-এর .npmrc-এ ignore-scripts=true dependency install script চালানো বন্ধ করে। এতে খারাপ package থেকে deploy user-এর credentials-এ পৌঁছানোর সবচেয়ে সরাসরি পথটি বন্ধ হয়। Native addon compile করে বা prebuilt binary fetch করে এমন package-এর সত্যিই নিজেদের script দরকার। Script বন্ধ থাকলে সেগুলো install-এর সময় নয়, পরে runtime-এ missing binding file error দিয়ে ব্যর্থ হবে। npm ci --ignore-scripts চালান, তারপর যেসব অল্প কয়েকটি package-কে আপনি বিশ্বাস করার সিদ্ধান্ত নিয়েছেন সেগুলোর জন্য npm rebuild <package> --ignore-scripts=false চালান। কারণ অন্যথায় npm rebuild .npmrc setting মেনে কোনো script চালায় না। npm query ":attr(scripts, [postinstall])" দেখায়, বাস্তবে এমন package কতটি আছে।

আমার server আসলে কোনো package-এর কোন version install করেছে, তা কীভাবে জানব?

Lockfile নয়, disk-এর তথ্য দেখুন। npm ls <package> node_modules-এ বর্তমানে যা আছে তা জানায়, আর node -e "console.log(require('./node_modules/<package>/package.json').version)" শুধু version string দেখায়। Git-এর lockfile ভিন্ন একটি প্রশ্নের উত্তর দেয়: কী install হওয়ার কথা ছিল। এই দুটির তুলনাই মূল বিষয়। Git commit অনুযায়ী নাম দেওয়া directory-তে deploy করলে কয়েক মাস পরেও উভয় তথ্য পাওয়া যায়, যখন আপনার সেগুলো প্রয়োজন হবে।

npm audit কি supply-chain attack শনাক্ত করে?

না। npm audit আপনার tree-কে report করা vulnerability-এর database-এর সঙ্গে মিলিয়ে দেখে। তাই আগে প্রকাশিত এবং identifier দেওয়া সমস্যাই এটি শনাক্ত করতে পারে। Malicious release report না-ও হতে পারে, বিশেষ করে এটি install করা গুরুত্বপূর্ণ হওয়ার আগের কয়েক ঘণ্টা বা দিনের মধ্যে। npm audit signatures বেশি কার্যকর command। এটি আপনার installed tree জুড়ে registry signature যাচাই করে এবং publisher সেগুলো তৈরি করে থাকলে provenance attestation পরীক্ষা করে। এর মাধ্যমে বোঝা যায় tarball কোনো public build থেকে এসেছে, নাকি অজানা machine থেকে।

Attack install-এর সময় ঘটলেও app-কে unprivileged user হিসেবে চালানো গুরুত্বপূর্ণ কেন?

কারণ দুটি failure-এর প্রভাবের পরিসর আলাদা, এবং আপনাকে উভয়ের বিরুদ্ধেই সুরক্ষা নিতে হবে। Install-time code deploy user হিসেবে চলে এবং সেই user-এর SSH key, registry token ও cloud credential পড়তে পারে। Runtime code service account হিসেবে চলে। User=nodeapp, ProtectSystem=strict এবং disk-এ কোনো credential না থাকলে এটি যা পড়তে পারে, তার পরিসর application-এর নিজস্ব environment ও database-এ সীমাবদ্ধ থাকে। Account আলাদা রাখলে traffic পরিবেশনকারী process node_modules-ও rewrite করতে পারে না। ফলে runtime compromise পরবর্তী restart-এ দূর হয়ে যায়, স্থায়ী অবস্থায় পরিণত হয় না।

এই লেখাটি কি কাজে লেগেছে?