كيف تصل هجمات npm إلى خادم Node لديك؟
تعرّف على هجمات سلسلة توريد npm التي تصل إلى تطبيق Node على VPS عبر إصدارات التصحيح الضارة وpostinstall والحزم المقلدة، ولماذا يمنع package-lock التثبيت غير المتوقع.
ما هو هجوم سلسلة توريد npm على خادمك
يصل هجوم سلسلة توريد npm إلى خادمك عبر حزمة اخترت تثبيتها. لا يتطلب ذلك منفذاً مفتوحاً ولا خطوة استغلال. يثبّت npm التعليمات البرمجية، وتؤدي عملية تثبيت التعليمات البرمجية إلى تشغيلها. لذلك يسحب تطبيق Node صغير عدة مئات من الحزم التي لم تقرأها قط، ويمكن لأي حزمة منها نشر إصدار جديد بعد ساعة من الآن.
يجلب النشر إصداراً ضاراً لأن أمر التثبيت طلب أحدث إصدار متوافق. ثم تعمل تلك التعليمات البرمجية بالامتيازات التي يملكها المستخدم الذي نفّذ التثبيت. كل ما يلي ينتج عن هاتين الجملتين.
تأتي هذه الأشكال مرتبة حسب مدى تكرار تأثيرها في شخص واحد ينشر تطبيق Node واحداً على VPS واحد. لن تستخدم شركة كبيرة هذا الترتيب، لأن لديها مستودعاً داخلياً وفريق مراجعة ونسخة مطابقة من المستودع العام. أما أنت فلديك برنامج نصي للنشر.
النمط 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 ذلك النطاق عند لحظة تشغيله، ولذلك يمكن لعملية commit نفسها في git، إذا نُشرت مرتين في فترة بعد الظهر نفسها، أن تثبّت مجموعتين مختلفتين من الشيفرة. هذه الفجوة هي سطح الهجوم. ولا يلزم اختراق أي شيء على جهازك حتى تُفتح.
عادةً ما يُبلّغ عن الإصدارات الضارة وتُسحب، لكن السحب يحدث بعد أن يكون الأشخاص قد ثبّتوها. ومن نشر خلال هذه الفترة تكون الشيفرة موجودة على القرص لديه. يدخل خط أنابيب يحل النطاقات في كل تشغيل هذه الفترة تلقائياً عدة مرات في الأسبوع، من دون أن يقرر أي شخص ذلك صراحةً.
الشكل 2: يعمل البرنامج النصي للتثبيت بصلاحيات المستخدم الذي ينفّذ النشر
يمكن لـ package.json الخاص بحزمة ما تعريف preinstall وinstall وpostinstall وprepare داخل كتلة scripts. ينفّذها npm أثناء التثبيت. لا تعمل هذه البرامج النصية داخل بيئة معزولة، ولا يراجعها أحد. إنها أوامر shell تعمل بصلاحيات المستخدم الذي كتب أمر التثبيت، وفي الدليل الرئيسي لذلك المستخدم، وباستخدام وصوله إلى الشبكة والبيئة الكاملة لجلسة shell تلك.
يغيّر npm 12 هذا السلوك الافتراضي، وقد صدر في 8 July 2026. فهو يحظر البرامج النصية لتثبيت التبعيات ما لم يوافق عليها الحقل allowScripts في package.json الخاص بالمشروع. وحتى 12 October 2026، لا يتضمن أي إصدار من Node.js حزمة npm 12؛ إذ يأتي Node.js 26.11.1 مع npm 11.20.0. لذلك، ما لم تكن قد حدّثت npm بنفسك، سيواصل npm على خادمك تشغيل كل هذه البرامج النصية.
لذلك، ليس السؤال المفيد هو ما الذي تستطيع الحزمة فعله، بل ما الذي يستطيع ذلك المستخدم قراءته. في خادم نشر عادي، تشمل الإجابة ~/.npmrc الذي يحتوي على رمز وصول إلى السجل، و~/.ssh/id_ed25519 المستخدم كمفتاح نشر لـ SSH (secure shell)، و~/.aws/credentials، و~/.docker/config.json، وكل متغير مُصدَّر في shell، حيث يوجد DATABASE_URL عادةً.
لا يحتاج حمولة كهذه إلى آلية استمرارية أو تصعيد للامتيازات. فهي تقرأ بضعة ملفات، وترسلها إلى مضيف عبر HTTPS، ثم تنتهي بحالة 0. لن ترى شيئاً، لأن npm يخفي مخرجات برنامج التثبيت النصي افتراضياً. عطّل ذلك وراقب ما يُنفَّذ فعلياً:
npm ci --foreground-scriptsيشارك foreground-scripts الإدخال والإخراجين القياسيين مع عملية npm، لذلك تطبع برامج البناء مخرجاتها في الطرفية بدلاً من تخزينها في مخزن مؤقت يتجاهله npm عند نجاح التثبيت.
الشكل 3: الحزم التي تحاكي أسماء الحزم، والاسم الذي لم تكتبه بدقة
الحزمة التي تحاكي اسم حزمة أخرى هي حزمة منشورة باسم قريب من اسم حزمة شائعة، وتنتظر أمراً للتثبيت كُتب أو لُصق بصورة خاطئة. الآلية هنا هي الأمر، لا الشيفرة، لذلك لا يفيدك lockfile: تضيف الاسم الخطأ مرة واحدة، ومنذ ذلك الحين يثبّته lockfile بدقة.
النوع الذي يستهدف الفرق، لا الأفراد، هو التباس التبعيات. اسم حزمتك الداخلية هو billing-utils، وهي موجودة في registry خاص. إذا لم توجد حزمة باسم billing-utils في registry العام، فيمكن لأي شخص نشر واحدة بهذا الاسم. يحل npm الأسماء غير المسبوقة بنطاق مقابل registry العام الافتراضي، لذلك قد تتغلب النسخة العامة. الحل هو استخدام scope تملكه، مع تعيين registry لذلك الـscope في .npmrc:
@yourorg:registry=https://npm.yourorg.example/
//npm.yourorg.example/:_authToken=${NPM_TOKEN}الآن لا يجلب @yourorg/billing-utils إلا من ذلك المضيف، لأن تعيين الـscope إلى registry يُطبَّق قبل استخدام registry الافتراضي. أما الاسم الداخلي غير المسبوق بنطاق، فلا يملك أي تعيين، ولذلك لا يتمتع بهذه الحماية.
قبل إضافة أي تبعية جديدة، افحص الحزمة نفسها بدلاً من الاكتفاء بشارة عدد التنزيلات:
npm view some-lib repository.url maintainers time.created time.modifiedالحزمة التي أُنشئت الشهر الماضي ونشرها حساب لا يمكنك ربطه بمستودع عام تمثل خطراً مختلفاً عن حزمة لها سجل يمتد لست سنوات. لا تثبت أي من المعلومتين شيئاً بمفردها، لكن التحقق من كلتيهما لا يتطلب جهداً كبيراً.
الشكل 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
يسجل package-lock.json الإصدار الدقيق لكل حزمة في الشجرة، وعنوان URL الذي جاءت منه كل حزمة، وقيمة تجزئة سلامة sha512 لكل أرشيف tarball، والحزمة التي طلبتها. أضفه إلى المستودع. فهذا هو الملف الوحيد الذي يحدد ما اختبرته فعلياً.
ثبّت الحزم بعد ذلك باستخدام npm ci، وليس npm install، على أي جهاز ليس حاسوباً محمولاً للمطور:
npm ci --omit=dev --ignore-scriptsيختلف npm ci عن npm install بطرق مهمة جميعها هنا. فهو يتطلب وجود ملف قفل. ويحذف أي node_modules موجود قبل أن يبدأ، لذلك لا يمكن لبقايا نشر سابق أن تنتقل إلى هذا النشر. ولا يكتب أبداً إلى package.json أو إلى ملف القفل، لذلك لا يمكن لعملية التثبيت أن تنقلك بصمت إلى إصدار أحدث. إذا اختلف ملف القفل عن package.json، تنتهي العملية بخطأ بدلاً من حل الاختلاف.
هذا الخطأ هو الغرض من الميزة، وليس مصدر إزعاج. فهو يعني أن تغيير التبعية يجب أن يصل في commit راجعه شخص ما، لا أن يحدث كأثر جانبي لعملية نشر عند الساعة 02:00.
تُفحص قيمة تجزئة السلامة عند كل عملية جلب. إذا لم تتطابق بايتات أرشيف tarball مع قيمة التجزئة المسجلة، تفشل عملية التثبيت مع code EINTEGRITY بدلاً من فك الأرشيف. كن دقيقاً بشأن ما يضمنه ذلك: فهو يثبت أن الملف الذي استلمته هو الملف الذي ثبّته ملف القفل، وهو الضمان نفسه الذي يوفره التحقق من التنزيلات باستخدام قيم التجزئة، وله الحدود نفسها. ولا يثبت أن الإصدار المثبت لم يكن ضاراً عند نشره.
هناك تفصيل يتعلق بـ--omit=dev: ما زال يجري حل هذه الحزم، وما زالت تُكتب في ملف القفل. لكنها لا توضع على القرص. يعني انخفاض عدد الحزم على القرص انخفاض عدد نصوص التثبيت وتقليل الشفرة المحمّلة أثناء التشغيل، لذلك يستحق هذا الإجراء التنفيذ. لكنه لا يزيل تبعية من شجرتك.
تعامل مع نصوص التثبيت البرمجية على أنها تعليمات برمجية، واعرف متى ترفض تشغيلها
يمكنك تعطيل install scripts. ضع ذلك في ملف المشروع .npmrc، ثم أجرِ commit له بجانب lockfile:
ignore-scripts=true
save-exact=trueيمنع ignore-scripts=true npm من تشغيل البرامج النصية المعلنة في التبعيات. يجعل save-exact=true الأمر npm install some-lib يكتب 1.4.2 في package.json بدلاً من ^1.4.2، لذلك لا يدخل نطاق الإصدار الذي جرى حله في ملف البيان لديك عن طريق الخطأ.
يؤدي هذا إلى تعطّل بعض المكونات، ويجب أن تعرف آلية عمله قبل تفعيله. تنفّذ الحزم التي تترجم إضافة أصلية أو تنزّل ملفاً ثنائياً مُسبق البناء هذا العمل في نص تثبيت. عند تعطيل النصوص، تنجح عملية التثبيت نفسها، ويظهر الفشل لاحقاً أثناء التشغيل على شكل وحدة لا تستطيع تحميل ملف الربط الخاص بها. الحل هو قائمة سماح:
npm ci --ignore-scripts
npm rebuild better-sqlite3 --ignore-scripts=falsenpm rebuild <package> يشغّل نصوص البناء الخاصة بذلك الحزمة وحدها. الخيار --ignore-scripts=false إلزامي وليس اختيارياً: إذ يطبّق npm rebuild قيمة ignore-scripts=true التي أودعتها للتو في .npmrc، ومن دون هذا التجاوز، يربط ملفات الحزمة الثنائية ولا يشغّل أياً من نصوصها. لقد اتخذت الآن قراراً لكل حزمة، بدلاً من منح صلاحية التنفيذ الشاملة لبضع مئات من الغرباء الذين لن تلتقي بهم أبداً.
إذا كنت تستخدم npm 12، فهذه القائمة المسموح بها مضمّنة. يسجّل npm approve-scripts better-sqlite3 الموافقة في الحقل allowScripts من package.json، ويتم تخطي نصوص برمجية للتبعيات غير المعتمدة مع إصدار تحذير، كما يتحقق npm rebuild من القائمة نفسها؛ لذلك يحتاج إعادة البناء السابقة في npm 12 إلى هذه الموافقة أيضاً. يتجاوز ignore-scripts=true المضمّن في المستودع سياسة allowScripts بالكامل.
لمعرفة حجم هذا التفويض حالياً، اطلب ذلك من npm:
npm query ":attr(scripts, [postinstall])"يعرض ذلك كل حزمة في شجرة التثبيت تحتوي على سكربت postinstall. في التطبيق المعتاد، تكون القائمة أقصر مما يتوقعه المستخدمون، وهذا تحديداً ما يجعل قائمة السماح عملية.
افصل عملية البناء عن العملية التي تخدم حركة الشبكة
يحتاج مستخدم النشر إلى الكتابة في node_modules. أما العملية التي تستجيب لطلبات HTTP فلا تحتاج إلى ذلك. إذا كان المستخدمان متطابقين، يمكن للتعليمات البرمجية التي تعمل أثناء التثبيت إعادة كتابة التعليمات البرمجية التي تخدم مستخدميك، كما يمكن للتعليمات البرمجية التي تعمل أثناء التشغيل إعادة كتابتها أيضاً.
افصل بينهما. نفّذ البناء باستخدام مستخدم، وقدّم الخدمة باستخدام مستخدم آخر، واجعل الدليل المقدَّم للقراءة فقط بالنسبة إلى حساب الخدمة:
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 على تركيب نظام الملفات بالكامل للقراءة فقط لهذه الخدمة، باستثناء /dev و/proc و/sys وأي مسارات تدرجها في ReadWritePaths. لذلك يفشل أيٌّ من محاولات التطبيق للكتابة في node_modules مع EROFS: read-only file system، ويمكنك إعادة إنتاج ذلك في سجلاتك خلال نحو دقيقة. يغطي NoExecPaths دليل التحميل القابل للكتابة: يمكن للخدمة كتابة الملفات فيه، لكن النواة ترفض تنفيذها. يتطلب هذا الخيار systemd 248 أو إصداراً أحدث، وتأتي Ubuntu 24.04 مع الإصدار 255.
توجد نقطتان قد تسببان المشكلات في ملف الوحدة هذا. أولاً، لا تضف MemoryDenyWriteExecute=yes. يظهر هذا الخيار في معظم قوائم تقوية systemd، ويمنع Node من البدء، لأن V8 يترجم JavaScript إلى تعليمات آلة أثناء التشغيل ويحتاج إلى صفحات قابلة للكتابة والتنفيذ معاً. ثانياً، خذ مسار ExecStart من command -v node. إذا ثُبّت Node باستخدام مدير إصدارات، فسيكون موجوداً داخل الدليل الرئيسي لمستخدم النشر، ثم يخفي ProtectHome=yes ذلك الدليل عن الخدمة، ويفشل ملف الوحدة فوراً مع status=203/EXEC وتظهر في السجل رسالة تفيد بتعذر العثور على الملف التنفيذي.
تحقق من النتيجة بدلاً من الوثوق بالملف:
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 كل إعدادات التقوية مع مستوى تعريضها، حتى ترى الإعدادات التي ما زالت على قيمها الافتراضية. يجب أن يفشل touch مع Permission denied، لأن nodeapp لا يملك أي شيء ضمن current. إذا نجح، فملكية الملفات لديك غير صحيحة، وتغطي إعدادات systemd على المشكلة بصمت.
ملاحظة بشأن EnvironmentFile: يقرأه systemd بصفته root قبل أن ينتقل إلى User=nodeapp، لذلك يمكن أن يكون الملف root:root بالوضع 600. ما زال التطبيق يتلقى المتغيرات. ويمكن لأي شخص لديه shell بصفته nodeapp قراءتها من /proc/<pid>/environ، لذلك يحمي هذا السر أثناء تخزينه، لكنه لا يحمي العملية قيد التشغيل.
اجعل بيانات اعتماد النشر خارج بيئة البناء
ترث البرامج النصية للتثبيت البيئة. وهذه الحقيقة وحدها يجب أن تحدد مكان إجراء البناء.
الخيار الأكثر أماناً هو إجراء البناء في مكان ليس خادم الإنتاج، ثم نسخ الدليل المكتمل إليه. لا تحتفظ آلة البناء حينها إلا برمز وصول للقراءة فقط إلى السجل. ولا تحتوي على مفتاح نشر عبر SSH، أو مفتاح وصول سحابي، أو كلمة مرور قاعدة بيانات، أو بيانات تسجيل الدخول إلى سجل الحاويات.
npm token create --name=build-readonly --packages-and-scopes-permission=read-only --packages-all --expires=30يمكن للرمز المقيّد بالقراءة فقط جلب الحزم، لكنه لا يستطيع نشرها. ألغت npm كل الرموز المميّزة التقليدية في 9 December 2025، لذلك فهذا رمز وصول دقيق الصلاحيات، وعلامة الصلاحية هي التي تجعله للقراءة فقط: ما زالت npm الحالية تقبل العلامة القديمة --read-only، لكن npm token create لا يرسلها إلى السجل. إذا سُرق الرمز من بيئة البناء، تقتصر الخسارة على إمكانية قراءة الحزم التي يغطيها.
إذا اضطررت إلى إجراء البناء على الخادم، فأجره كمستخدم deploy مع بيئة محدودة عمداً، واحتفظ بأسرار وقت التشغيل في /etc/nodeapp/env، الذي لا يستطيع deploy قراءته. وينطبق المنطق نفسه على أتمتة البناء التي تستضيفها بنفسك: يحتفظ عامل GitHub Actions مستضاف ذاتياً بالرموز وينفّذ تعليمات برمجية منشورة عشوائية في كل مهمة، ما يجعله أعلى آلة قيمة في عملية نشر صغيرة. وينتمي أي برنامج لم تكتبه ويتلقى بيئتك كاملة إلى الفئة نفسها، ولذلك فإن إبقاء الأسرار خارج بيئة وكيل الذكاء الاصطناعي هو المشكلة نفسها مع وجود برنامج مختلف في الوسط.
ثبّت الإصدار أو أدرج الحزمة في مستودعك عندما يتعذر عليك تدقيقها
الاعتمادية المثبّتة هي اعتمادية لا يمكن تغيير إصدارها من دون commit. ويطبّق lockfile الملتزم به ذلك على شجرة الاعتماديات بأكملها. لكن هناك حالتين تتطلبان إجراءً إضافياً.
الاعتماديات الانتقالية هي الحالة الأولى. فأنت لا تتحكم في الاعتماديات التي تعتمد عليها اعتمادياتك. يفرض overrides في package.json إصداراً في أي موضع داخل الشجرة:
{
"overrides": {
"some-transitive-lib": "1.4.2"
}
}شغّل npm install مرة واحدة بعد إضافته حتى يسجّل lockfile النتيجة، ثم نفّذ commit للملفين معاً.
الحالة الثانية هي حزمة لا يمكنك تدقيقها ولا يمكنك إزالتها. أدرجها في مستودعك. ينزّل npm pack ملف tarball المطابق تماماً لما كان السجل سيقدّمه، وتثبّت اعتمادية file: من نسختك المحلية:
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 الآن داخل مستودعك، ولا يمكن أن يتغير من دون علمك. لكنك أصبحت مسؤولاً عن تحديثاته إلى الأبد، لذلك استخدم هذا الأسلوب مع الحزمة الصغيرة المتروكة التي لا خيار لك سوى استخدامها، وليس مع إطار عمل الويب.
يوجد أيضاً تأخير احترازي لا يكلّف شيئاً:
npm install --before=2026-08-01يعيد الخيار before بناء الشجرة باستخدام الإصدارات التي نُشرت في ذلك التاريخ أو قبله فقط. اضبط التاريخ على أسبوع أو أسبوعين سابقين عند تحديث الاعتماديات، لتتجاوز الفترة التي يكون فيها إصدار ضار متاحاً ولم يُبلّغ عنه بعد. هذه أداة عامة، لأنها تؤخر أيضاً إصلاحات الأمان الحقيقية. استخدمها لحل نطاقات الإصدارات، واقرأ التغييرات، ثم نفّذ commit لملف lockfile. تقبل الإصدارات الحديثة من npm أيضاً min-release-age، وهي نافذة متحركة محددة بالأيام (min-release-age=7 في .npmrc)، وتؤدي الغرض نفسه من دون تاريخ ثابت يجب تغييره. وينبغي تطبيق المبدأ نفسه على أدوات سطر الأوامر التي تثبّتها من npm بدلاً من تضمينها كاعتماديات؛ إذ إن استدعاء npx غير المثبّت ينزّل أي إصدار نُشر في ذلك الصباح، بينما تثبيت إصدار dsh محدد هو ما يجعل جهازين يشغّلان الشفرة نفسها.
كيف تعرف الإصدار الذي نشرته فعلياً؟
يُظهر lockfile في git ما كان ينبغي تثبيته. ويُظهر القرص ما هو مثبت فعلياً. الدليل الوحيد هو الثاني.
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"'اجعل الصلة بين الاثنين دائمة بإدراج commit في بنية النشر. انشر الإصدار في /srv/nodeapp/releases/<short commit sha>، وأشر /srv/nodeapp/current إليه باستخدام symlink. تصبح إجابة السؤال «ما الذي يعمل الآن؟» هي readlink /srv/nodeapp/current، وتكون متاحة في الساعة 03:00 لشخص لم يكن هو من نفّذ النشر.
وأخيراً، تحقّق مما سيؤكده السجل:
npm audit signaturesيتحقق هذا من توقيعات السجل للحزم الموجودة في شجرتك المثبتة، ومن attestations الخاصة بمصدر الحزم التي تتوفر لها هذه البيانات. تربط معلومات المصدر tarball منشوراً ببنية continuous integration (CI) العامة التي أنشأته، ولذلك يعني التحقق من attestation أنه يمكنك تتبع الشيفرة إلى commit بدلاً من حاسوب محمول غير معروف. التغطية ليست شاملة، لذلك فسّر غياب attestation على أنه «لا توجد معلومات»، لا على أنه «حزمة سيئة».
ما الذي تفعله بعد وصول إصدار ضار إلى خادمك
ابدأ بما تم تشغيله، وتحت أي حساب مستخدم تم تشغيله.
إذا شُغِّلت الشفرة أثناء التثبيت، فافترض أن كل ما يستطيع مستخدم البناء قراءته قد كُشف. بدّل رمز registry، ومفاتيح SSH الموجودة في ذلك الدليل المنزلي، وبيانات اعتماد السحابة، وأي سر جرى تصديره في جلسة shell تلك. التبديل هو الاستجابة الصادقة الوحيدة، لأنك لا تستطيع إثبات أن ملفاً ما لم تتم قراءته.
إذا شُغِّلت الشفرة أثناء وقت التشغيل تحت حساب خدمة مقيّد، فستكون مجموعة الموارد التي يمكنها الوصول إليها أصغر بكثير: متغيرات البيئة الخاصة بالتطبيق، وأي مورد يمكنها الوصول إليه عبر الشبكة. وهذا هو السبب الكامل وراء تشغيل الخدمات كمستخدمين غير مميّزين على VPS. لا يمنع ذلك الاختراق. لكنه يحدد مقدار أجزاء الجهاز التي يمكن أن يصل إليها الاختراق، وما إذا كان سيبقى بعد إعادة التشغيل.
بعد ذلك، أعد البناء بدلاً من التنظيف. احذف node_modules، وثبّت الحزمة المتأثرة على إصدار أقدم من الإصدار الضار في package.json، وشغّل npm install مرة واحدة لتحديث lockfile، ثم أجرِ commit له، وانشر باستخدام npm ci. لا تُصلح شجرة في مكانها. لا يمكنك حصر ما لمسه سكربت التثبيت.
دوّن أيضاً الفترة الزمنية: أول عملية deploy كان يمكن أن تسحب الإصدار، وعملية deploy التي أزالته. تخبرك هذه الفترة بأي من سجلاتك يجب قراءته، ولا يمكن تحديدها إلا إذا كانت إصداراتك تحمل أسماء commits.
ما الذي لا تعالجه أيّ من هذه الإجراءات
لا يجعل ملف القفل التبعية آمنة. بل يحوّل لحظة قبولك لهذه التبعية إلى قرار مؤرَّخ وخاضع للمراجعة، بدلاً من أن تكون نتيجة جانبية لعملية النشر. كل ممارسة مذكورة أعلاه تنفّذ التحويل نفسه: من حادث عرضي إلى خيار مقصود.
لا يُعد npm audit وسيلة دفاع في هذه الحالة. فهو يقارن شجرة تبعياتك بقاعدة بيانات للثغرات المُبلّغ عنها، ولذلك يكتشف المشكلات التي نُشرت تفاصيلها وأُطلقت عليها أسماء بالفعل. يظل هجوم سلسلة التوريد بلا اسم طوال فترة فائدته للمهاجم. شغّل npm audit لاكتشاف الأخطاء القديمة المعروفة، ولا تتوقع منه شيئاً بشأن إصدار صدر قبل أربع ساعات.
يساعد تقليل عدد تبعياتك أكثر من أي أداة في هذا الدليل، لكنه أقلّ نصيحة تحظى بالشعبية. كل حزمة لا تضيفها تعني ناشراً إضافياً لا يمكن تصيّده نيابةً عنك، ونص تثبيت إضافياً لا يُنفَّذ مطلقاً بصلاحيات مستخدم النشر.
ولا يقتصر أيّ من ذلك على npm. تنطبق الأشكال الأربعة نفسها على PyPI وRubyGems وصور الحاويات ومدير الحزم في توزيعتك. يظهر الأمر بوضوح أكبر في npm لأن أشجار التبعيات فيه أعمق، ولأن إصدار npm الذي تشغّله معظم الخوادم لا يزال ينفّذ نصوص التثبيت افتراضياً. كل ما يوسّع أداة تشغّلها بالفعل يرث المشكلة نفسها. لذلك فإن تحديد ما يمكن لإضافة dsh الوصول إليه قبل تثبيتها هو التمرين نفسه الذي يتطلب قراءة نص postinstall، مع وضع صلاحيات وكيلك مكان صلاحيات مستخدم النشر. يعتمد مقدار الجهاز المحيط الذي تقع عليك مسؤولية حمايته على مكان تشغيل الأداة، وهذا جزء من السؤال الأوسع حول مدى أمان استضافة VPS.
FAQ
هل تحميني npm ci من حزمة npm مخترقة؟
تحميك من تغيّر الإصدار دون علمك. يثبّت npm ci ما يسجّله package-lock.json بالضبط، ويتحقق من كل tarball مقابل تجزئة التكامل sha512 الخاصة به، ويتوقف مع عرض خطأ إذا اختلف package.json عن lockfile، بدلاً من محاولة حل الفرق. لكنها لا تحدد ما إذا كان الإصدار المثبّت آمناً. إذا أودعت lockfile يثبّت إصداراً ضاراً، فسيثبّت npm ci ذلك الإصدار بأمانة على كل خادم تملكه، في كل مرة.
هل ينبغي أن أضبط ignore-scripts=true لكل شيء؟
اضبطه، ثم أضف الاستثناءات المسموح بها. يؤدي ignore-scripts=true في .npmrc الخاص بالمشروع إلى منع تشغيل نصوص تثبيت التبعيات، ما يزيل المسار المباشر الأهم من حزمة ضارة إلى بيانات اعتماد مستخدم النشر. تحتاج الحزم التي تترجم native addon أو تجلب binary مُعدّاً مسبقاً إلى نصوصها فعلاً. وعند تعطيل النصوص، تفشل هذه الحزم لاحقاً وقت التشغيل بسبب غياب ملف binding، بدلاً من فشلها وقت التثبيت. شغّل npm ci --ignore-scripts، ثم npm rebuild <package> --ignore-scripts=false للحزم القليلة التي قررت الوثوق بها، لأن npm rebuild يلتزم بإعداد .npmrc ولا يشغّل شيئاً بخلاف ذلك. يوضح npm query ":attr(scripts, [postinstall])" عدد هذه الحزم فعلياً.
كيف أعرف إصدار الحزمة الذي ثبّته خادمي فعلياً؟
اقرأ ما هو موجود على القرص، لا ما في lockfile. يعرض npm ls <package> ما هو موجود في node_modules، ويطبع node -e "console.log(require('./node_modules/<package>/package.json').version)" سلسلة الإصدار فقط. يجيب lockfile الموجود في git عن سؤال مختلف، وهو ما كان ينبغي تثبيته. وتكمن الفائدة في مقارنة الإجابتين. يؤدي النشر داخل مجلد يحمل اسم git commit إلى إبقاء الإجابتين متاحتين بعد أشهر، عندما تحتاج إليهما.
هل يكتشف npm audit هجمات سلسلة التوريد؟
لا. يقارن npm audit شجرة التبعيات لديك بقاعدة بيانات للثغرات المبلّغ عنها، ولذلك لا يكتشف إلا المشكلات التي نُشرت مسبقاً وحصلت على معرّف. يظل الإصدار الضار غير مُبلّغ عنه خلال الساعات أو الأيام التي يكون تثبيته فيها مهماً. ويُعد npm audit signatures الأمر الأكثر فائدة: فهو يتحقق من توقيعات السجل عبر شجرة التبعيات المثبّتة لديك، ويفحص attestations الخاصة بمصدر الحزمة عندما يوفرها الناشر. وهذا يخبرك بأن tarball جاء من عملية build عامة، لا من جهاز غير معروف.
لماذا يهم تشغيل التطبيق كمستخدم غير مميّز إذا وقع الهجوم وقت التثبيت؟
لأن للفشلين نطاقي وصول مختلفين، وعليك الحماية من كليهما. تعمل الشفرة وقت التثبيت بصلاحيات مستخدم النشر، ويمكنها قراءة مفاتيح SSH الخاصة بذلك المستخدم، وregistry tokens، وcloud credentials. تعمل الشفرة وقت التشغيل بحساب الخدمة. ومع User=nodeapp وProtectSystem=strict، ومن دون credentials على القرص، يقتصر وصولها على بيئة التطبيق وقاعدة بياناته. ويعني فصل الحسابات أيضاً أن العملية التي تخدم network traffic لا تستطيع إعادة كتابة node_modules، ولذلك يزول أثر اختراق وقت التشغيل عند إعادة التشغيل التالية بدلاً من أن يصبح دائماً.