Securing an n8n Instance

Threat-model an n8n instance and independently control webhooks, credentials, community nodes, model outputs, permissions, auditing and unauthorized actions.

بعد از این درس می‌توانی

  • برای یک ورک‌فلوی n8n، دارایی، ورودی غیرقابل‌اعتماد، مسیر داده، دسترسی و شاهد آزمون را مشخص کند.
  • Webhook، API عمومی، نود انجمنی، Credential و ابزارهای پرخطر را از نظر سطح حمله و نیاز واقعی محدود کند.
  • توضیح دهد چرا خروجی ساختاریافته مدل مجوز اجرا نیست و پیش از ارسال/حذف، اعتبارسنجی معنایی و کنترل مستقل لازم است.
  • ممیزی امنیتی را به تصمیم قابل سنجش، مسئول و ثبت شاهد آزمون تبدیل کند؛ برای اقدام ممنوع آزمون رد اجباری طراحی کند.

چرا این درس مهم است

نمونه n8n فروشگاه برگ سبز به ایمیل، پایگاه سفارش، کلید مدل و ربات پیام‌رسان وصل است. یک Webhook بی‌احراز هویت می‌تواند ورک‌فلوی دارای دسترسی را اجرا کند؛ یک نود انجمنی نامعتبر می‌تواند مخاطره زنجیره تأمین ایجاد کند؛ و یک متن تولیدشده توسط مدل ممکن است به‌اشتباه دستور مجاز تلقی شود. مدل تهدید باید این سه مرز را جدا نشان دهد.

[اصل پایدار] کنترل را بر «داده کجا وارد می‌شود، چه دسترسی‌ای دارد، به چه عملی تبدیل می‌شود و چگونه رد اقدام نامجاز را ثابت می‌کنیم» بنا کن. تنظیمات و دستورهای این درس [ابزار] و نسخه‌حساس‌اند. مدیریت کامل کلید در api-authentication و config-secrets، تأیید انسانی در human-approval و پرونده جامع ایجنت در agent-governance-permissions است؛ اینجا تکرار نمی‌شوند.

مفاهیم کلیدی

مرزبندی: این درس سخت‌سازی یک نمونه n8n را آموزش می‌دهد. جزئیات API و رازها در api-authentication و config-secrets، ارزیابی مسیر ایجنت در agent-evals و مفهوم اسکیل/MCP در skills-plugins-connectors است.

  • [اصل پایدار] سطح حمله (`Attack Surface`): مجموعه مسیرهای ورود، خواندن داده، اجرای عملیات و دسترسی مدیریتی؛ از ویرایشگر تا Webhook و افزونه.
  • [اصل پایدار] مرز اعتماد (`Trust Boundary`): گذر محتوا از منبع بیرونی به تصمیم، ابزار یا داده درون سازمان؛ عبور باید با مجوز و اعتبارسنجی مستقل سنجیده شود.
  • [ابزار] احراز هویت `Webhook` (`Webhook Authentication`): شرط پذیرش پیام از فرستنده؛ هدر، توکن یا سازوکار امضای معتبر مطابق مستند سرویس.
  • [اصل پایدار] اعتبارسنجی ورودی/خروجی (`Payload Validation`): بررسی ساختار و معنا/دامنه/مجازبودن عملیات؛ JSON Schema به‌تنهایی مجوز اقدام نیست.
  • [ابزار/زنجیره تأمین] نود انجمنی (`Community Node`): کد نصب‌شده خارج از گره‌های رسمی؛ منشأ، نسخه، وابستگی و مجوزش باید بررسی شوند.src-n8n-community-node-risks
  • [اصل پایدار] کمترین اختیار و عاملیت (`Least Privilege`, `Least Agency`): خواندن، پیش‌نویس، نوشتن، ارسال و حذف را مجوزهایی جدا بدان؛ از کار لازم فراتر نرو.
  • [ابزار] ممیزی امنیتی (`Security Audit`): گزارشی از وضعیت نمونه و ورک‌فلو؛ هر یافته به «اصلاح/محدودکردن/پذیرفتن مستند» و شاهد آزمون تبدیل می‌شود.src-n8n-security-audit
  • [استاندارد] ریسک ایجنتی (`ASI`): OWASP Agentic 2026 ریسک‌هایی مثل سوءاستفاده ابزار، مجوز اضافی، زنجیره تأمین و تأیید انسانی نمایشی را طبقه‌بندی می‌کند؛ راهنمای آموزشی است، نه گواه امن‌بودن.src-owasp-agentic2026
  • [استاندارد/شاهد پژوهشی] `MCP` و اسکیل: مقاله src-mcp-threat-model، «۵۷ تهدید مدل‌شده» را بررسی می‌کند، نه ۵۷ رخداد واقعی. جای آموزش کامل MCP در skills-plugins-connectors است و در این درس فقط منشأ، مجوز و تغییرات اتصال بررسی می‌شوند.

مدل ذهنی

یک ورک‌فلوی n8n را به پنج ایستگاه تقسیم کن: «ورودی و مالک آن»، «داده و راز قابل‌دسترسی»، «نود/اسکیل و اجرای ابزار»، «خروجی و اقدام واقعی»، «ردپا و مالک رخداد». در هر گذر بپرس: کدام متن فقط داده است و کدام جزء واقعاً اختیار خواندن، نوشتن یا ارسال دارد؟

سطح حمله نمونه n8n و کنترل هر در: نقشه تهدید نمونه `n8n`: ویرایشگر و `Credential` → `Webhook` و ورودی نامطمئن → اعتبارسنجی و ورک‌فلو → نود رسمی/انجمنی و ابزارهای مدل → خروجی، اقدام و `Execution Log`. کنترل‌ها: احراز، محدودسازی مجوز، فهرست مجاز ابزار/مقصد، اعتبارسنجی معنایی، تأیید اقدام واقعی، ممیزی و توقف.

سطح حمله نمونه n8n و کنترل هر در

حد تشبیه: احراز هویت Webhook فقط هویت فرستنده را می‌سنجد، نه صحت داده او را. Credentialهای n8n نیز اختیار یکسان برای همه عملیات ندارند و باید با کمترین مجوز تعریف شوند. تنظیمات این درس نسخه‌حساس‌اند و جزئیات فنی باید پیش از استقرار با مستند رسمی همان نسخه تطبیق داده شود.

گام‌به‌گام

گام ۱: سطح حمله را بنویس

برای یک ورک‌فلوی فرضی، برگه پنج‌خانه‌ای بساز: دارایی/ورودی نامطمئن/دسترسی/کنترل/شاهد آزمون. مسیر را از ویرایشگر و Webhook تا Credential، HTTP Request، نود انجمنی، لاگ و مقصد خروجی ترسیم کن. برای هر خانه یک مالک یا مسئول مشخص کن. مستند n8n سخت‌سازی را شامل کنترل دسترسی، ممیزی، ایزوله‌سازی اجرا و محافظت در برابر SSRF می‌داند.src-n8n-security-overview

گام ۲: `Webhook` امن

[ابزار] در n8n نشانی آزمون و تولید Webhook کارکرد متفاوتی دارند. پیش از انتشار، هویت فرستنده، ساختار و معنای داده، سطح دسترسی ورک‌فلو و مقصد عمل را جدا بررسی کن. جزئیات نسخه را از مستند گره Webhook ببین.src-n8n-webhook-node

  1. احراز هویت: از راه سازوکار پشتیبانی‌شده همان نسخه مانند Header Auth یا JWT و با Credential استفاده کن؛ توکن را در متن ورک‌فلو ننویس.src-n8n-webhook-node
  2. محدودیت فرستنده: اگر IP معتبر و پایدار داری، فهرست مجاز مکمل احراز است؛ پشت پراکسی، نشانی واقعی را با احتیاط تشخیص بده.
  3. اعتبارسنجی: شکل، مقدار، مقصد و مجازبودن اقدام را پیش از هر فراخوانی ابزار بسنج و ورودی نامعتبر را صریح رد کن.
  4. مرز داده و عمل: متن سفارش، ایمیل یا خروجی مدل، فرمان اجرایی نیست؛ برای هر عمل نوشتنی/ارسالی مجوز مستقل و در موارد حساس تأیید نسخه دقیق بگذار.

فایل آزمایشی assets/n8n-secure-webhook.json و خروجی نمونه assets/webhook-session.txt برای تمرین موجودند. در مستند آزمون قبلی پاسخ‌های 403، 202 و 400 ثبت شده است؛ در این بازسازی آزمون تازه‌ای اجرا نشده. این اعداد را بدون اجرای تست روی نسخه خودت، ضمانت رفتاری همه استقرارها ندان.

گزینه Only Run If را جای احراز هویت مستقل قرار نده؛ طبق مستند نسخه مورد استناد، خطای ارزیابی شرط ممکن است باعث عبور درخواست با هشدار شود. محدودیت اندازه پیش‌فرض درخواست و تنظیمات امنیتی نیز [ابزار] و نسخه‌حساس‌اند.src-n8n-webhook-node

گام ۳: درهای اضافه را ببند

  • `API` عمومی [ابزار]: فقط در صورت نیاز فعال بماند؛ متغیرهای N8N_PUBLIC_API_DISABLED=true و N8N_PUBLIC_API_SWAGGERUI_DISABLED=true در مستند مرجع توضیح داده شده‌اند. نام و اثر آن‌ها را برای نسخه نصب‌شده بررسی کن.src-n8n-disable-public-api
  • نودهای انجمنی و زنجیره تأمین: در حالت غیرضروری غیرفعال؛ در حالت لازم منشأ، نسخه، وابستگی، مجوز، تغییرات و امکان بازگردانی را ثبت کن. متغیر N8N_COMMUNITY_PACKAGES_ENABLED=false گزینه نسخه‌حساس است.src-n8n-community-node-risks
  • گره‌های اجرای کد: در نسخه آزموده‌شده قبلی، Execute Command و Local File Trigger در فهرست پیش‌فرض NODES_EXCLUDE بودند؛ با تعریف دستی این متغیر، مقدار مؤثر را برای نسخه خودت دوباره بررسی کن. Code را با اجرای ایزوله و Task Runner متناسب پیکربندی کن.src-n8n-task-runners
  • داده ورودی و خروجی مدل: پاسخ مدل را مستقیماً فرمان پایگاه داده، آدرس درخواست یا مقصد ارسال قرار نده؛ ساختار، دامنه مقدار و مجوز عمل باید قطعی سنجیده شود. این موضوع با LLM05:2025 و LLM10:2026 مرتبط است.src-owasp-llm2026
  • مجوز و تأیید: خواندن، پیش‌نویس، ارسال و حذف اختیارهای جدا هستند؛ برای اقدام حساس، گیرنده، پیوست، نشانی مقصد و متن واقعیِ همان نسخه تأییدشده را نشان بده. پیاده‌سازی کامل در human-approval است.
  • تله‌متری و لاگ [ابزار]: تنظیم N8N_DIAGNOSTICS_ENABLED را به‌عنوان ویژگی نسخه‌حساس بررسی کن؛ اطلاعات محرمانه و کلیدها نباید در خروجی آزمون و لاگ عمومی منتشر شوند.src-n8n-deployment-env

assets/security.env.example نمونه تنظیمات است، نه پیکربندی تضمینی همه نسخه‌ها. مقایسه نسخه و کنترل محرمانگی را قبل از استقرار انجام بده؛ دستور کامل نگهداری راز را در config-secrets تکرار نمی‌کنیم.

گام ۴: ممیزی امنیتی

[ابزار] گزارش n8n audit را برای نمونه خودت اجرا و هر یافته را با مالک، شدت و شاهد آزمون ثبت کن.src-n8n-security-audit فایل assets/audit-summary.txt خروجی نمونه آموزشی قبلی است، نه گزارش اجرای همین دور. ممیزی خودکار همه خطرهای تزریق، نشت و سوءاستفاده ابزار را به‌تنهایی کشف یا برطرف نمی‌کند.

هر یافته را به حذف، محدودسازی یا پذیرش با دلیل و مالک تبدیل کن. برای اقدام ممنوع مثل حذف سفارش یا ارسال به گیرنده نامجاز، آزمون منفی طراحی کن که حتی اگر پاسخ نهایی مدل درست بود، اجرا رد شود. مسیر و ردپای آزمون را همراه با تصمیم نگه دار؛ طراحی کامل آزمون در agent-evals و مدیریت اختیار در agent-governance-permissions است.

مثال‌ها

پیاده‌سازی عملی

مدل تهدید و آزمون `Webhook` امن. حدود ۲۲ دقیقه. نتیجه باید پنج خانه دارایی/ورودی/مجوز/کنترل/شاهد و یک تست رد اقدام نامجاز داشته باشد.

  1. سطح حمله را با ویرایشگر، Webhook، API، Credential، نودهای انجمنی و مقصد خارجی ترسیم کن.
  2. یکی از مسیرهای محلی، میزبانی‌شده یا مطالعه خروجی نمونه را انتخاب کن.
  3. برای هر یافته، کنترل مستقل، مالک و شاهد آزمون تعیین کن؛ دست‌کم یک ورودی نامعتبر یا اقدام بدون اختیار باید رد شود.
اجرای محلی

در نمونه آزمایشی و جدا از داده واقعی: یک Credential مخصوص Header Auth بساز و فایل assets/n8n-secure-webhook.json را بررسی کن؛ ورودی درست، بی‌احراز و نامعتبر را مقایسه کن و از ردشدن درخواست نامعتبر پیش از اقدام شاهد بگیر. سپس n8n audit را اجرا و یافته‌ها را ثبت کن. اگر دستورهای Docker یا نام گزینه‌ها با نسخه تو فرق دارند، مستند همان نسخه را مرجع بگیر. توکن آزمایشی را هم در گزارش عمومی منتشر نکن.

سرویس میزبانی‌شده (در دسترس قانونی)

روی محیط آزمایشی با دسترسی مجاز، تنظیمات assets/security.env.example را با مستند نسخه مقایسه کن؛ قبل از هر تغییر، از پیکربندی و ورک‌فلو نسخه پشتیبان بگیر. Webhook را با احراز، اعتبارسنجی و مسیر رد صریح آزمایش کن. برای اقدام ارسال/حذف، کنترل مجوز مستقل لازم است؛ استقرار تولیدی بدون شاهد آزمون انجام نده.

بدون اجرا / شبیه‌ساز

بدون نصب: assets/webhook-session.txt و assets/audit-summary.txt را بخوان. برای هر سناریو پنج خانه دارایی/ورودی/مجوز/کنترل/شاهد را تکمیل کن، توضیح بده کدام درخواست قبل از اقدام رد می‌شود و چرا «خروجی مدل در قالب JSON» مجوز نوشتن در پایگاه داده نیست.

اشتباه‌های رایج

اشتباهنتیجهکار درست
Webhook بی‌احرازورود درخواست ناخواستهاحراز مستقل و سنجش داده قبل از عمل
توکن داخل گرهنمایان‌شدن راز در نسخه یا خروجیCredential و مدیریت راز
اتکا به Only Run Ifشرط نسخه‌حساس و غیرقابل اتکا برای امنیتاحراز مستقل + رد صریح داده نامعتبر
API باز بدون نیازسطح حمله و کلید بلااستفادهبستن یا محدودکردن دسترسی
نود انجمنی بدون منشأ و نسخهریسک زنجیره تأمین و تغییر رفتارثبت منشأ، نسخه، بازبینی مجوز و آزمون
تغییر NODES_EXCLUDE بدون بررسیفعال‌ماندن نود ناخواستهسنجش مقدار مؤثر برای نسخه نصب‌شده
فرستادن مستقیم خروجی مدل به عملاجرای مقدار نامعتبر یا خارج از اختیاراعتبارسنجی معنایی + فهرست مجاز عمل
تأیید فقط روی خلاصه مدلاحتمال ناهماهنگی عمل واقعی و تأییدنمایش گیرنده/متن/پیوست واقعی و قفل نسخه
ممیزی یک‌بارهتغییر مجوز یا وابستگی بدون پیگیریممیزی دوره‌ای و آزمون منفی مسیر

اشکال‌زدایی

فرستنده واقعی پس از فعال‌کردن احراز هویت پاسخ 403 «Authorization data is wrong!» می‌گیرد.

نام یا مقدار هدر در فرستنده با Credential یکی نیست، یا نشانی IP فرستنده در فهرست مجاز نیست.

سازوکار احراز، نام هدر و Credential، فهرست مجاز IP و هدرهای پراکسی را با مستند همان نسخه بررسی کن.

اشکال را در محیط آزمون برطرف کن و دوباره سه حالت درست/بی‌احراز/نامعتبر را تست کن؛ برای رفع موقت، احراز هویت را خاموش نکن.

ورک‌فلو با «Cannot read properties of undefined» وسط کار شکست می‌خورد.

ورودی بیرونی بدون اعتبارسنجی ساختاری/معنایی وارد مرحله دارای مجوز شده است.

داده ورودی اجرای ناموفق را در Executions ببین.

اعتبارسنجی قطعی شکل و دامنه را پیش از تماس با ابزار قرار بده و مسیر رد صریح بساز؛ درست‌بودن JSON به‌تنهایی کافی نیست.

پس از به‌روزرسانی یک نود انجمنی، چند ورک‌فلو خطا می‌دهند.

نگهدارنده نود تغییر ناسازگار داده استsrc-n8n-community-node-risks.

نسخه و ناشر نود، مجوز و وابستگی تازه، یادداشت تغییر و ردپای عمل را با نسخه سالم مقایسه کن.

اجرای نود مشکوک را محدود یا متوقف کن، نسخه قابل اعتماد را برگردان و پس از بررسی منشأ و مجوز، تست‌های منفی را تکرار کن.

نکته‌های امنیتی

تمرین کوتاه

تمرین · 12 دقیقه

هدف: تصمیم درباره هر در.

گام‌ها: نمونه n8n یک تیم کوچک از فرم سایت با Webhook سفارش می‌گیرد، داشبورد از API اجراها می‌خواند و یک نود انجمنی برای PDF دارد. برای هر مسیر، دارایی، ورودی، دسترسی و کنترل را بنویس؛ همچنین مشخص کن چرا خروجی مدل نباید اجازه ارسال یا حذف ایجاد کند.

معیار پذیرش: احراز Webhook، کمینه‌سازی API، ممیزی نود انجمنی، و رد قطعی اقدام خارج از اختیار ذکر شود.

راه‌حل نمونه

۱) Webhook: احراز فرستنده و سنجش دامنه و معنا پیش از تغییر سفارش. ۲) API: فقط در صورت ضرورت و با کلید محدود؛ ردپای خواندن. ۳) نود انجمنی: منشأ، نسخه، وابستگی و تغییرات بررسی یا حذف. ۴) خروجی مدل پیشنهاد است و قبل از ارسال/حذف باید به عملیات محدود، بررسی مجوز و تأیید نسخه واقعی تبدیل شود. جزئیات عملی ساخت کلید در api-authentication است.

چالش

تمرین · 35 دقیقه

موقعیت: یک بررسی امنیتی آموزشی برای نمونه n8n خودت یا سناریوی ساختگی انجام بده. داده مشتری یا کلید واقعی وارد گزارش نکن.

  1. نقشه دارایی، ورودی، حق خواندن/نوشتن، مقصد و کنترل هر مرز را ارائه کن.
  2. گزارش n8n audit یا خروجی نمونه را به تصمیم مالک‌دار تبدیل کن.
  3. شاهد رد درخواست نامعتبر و رد یک اقدام خارج از اختیار (مثلاً حذف یا ارسال بدون تأیید) را ثبت کن.
  4. ریسک نود انجمنی/MCP را با منشأ، مجوز، نسخه، تغییر و امکان قطع مستند کن.
  5. در پایان مشخص کن کدام آزمون‌ها واقعاً اجرا شده‌اند و کدام فقط سناریوی طراحی‌اند.

خروجی مورد انتظار: یک برگه مدل تهدید + ثبت تصمیم یافته‌ها + شواهد تست مثبت/منفی بدون کلید یا داده حساس.

معیار پذیرش:

  • پنج فیلد دارایی/ورودی/مجوز/کنترل/شاهد برای مسیرهای مهم کامل‌اند.
  • ورودی نامعتبر قبل از عملیات حساس رد می‌شود یا در مسیر بدون اجرا به‌روشنی طراحی شده است.
  • برای اقدام خارج از اختیار، دروازه رد مستقل از مدل وجود دارد.
  • نودها و اتصالات منشأ، مالک و مجوز مشخص دارند.
  • هیچ راز، داده واقعی یا ادعای تست اجرا‌نشده وارد گزارش نشده است.

پرسش‌های سنجش

جمع‌بندی

  • امنیت n8n با مدل‌سازی دارایی، ورودی غیرقابل‌اعتماد، مجوز، کنترل و شاهد آزمون آغاز می‌شود.
  • Webhook باید احراز و ورودی را مستقل از هویت فرستنده اعتبارسنجی کند.
  • API و نود انجمنی فقط در صورت نیاز، با منشأ و مجوز مشخص فعال باشند.
  • خروجی آزاد یا JSON معتبر مدل، دستور اجرایی یا مجوز تغییر داده نیست.
  • ارسال و حذف، مجوز و تأیید مستقل روی نسخه دقیق عمل می‌خواهند؛ روش کامل در human-approval.
  • هر یافته ممیزی تصمیم، مسئول و شاهد آزمون دارد؛ عبور از اختیار باید حتی با پاسخ درست رد شود.
  • چارچوب‌های NIST و ISO برای مدیریت ریسک‌اند؛ اجرای چک‌لیست به معنی دریافت گواهی نیست.

پرسش‌های سنجش

در نمونه `n8n` یک `Webhook` بدون احراز، یک کلید `API` متعلق به کارمند خارج‌شده و یک نود انجمنی ناشناس وجود دارد. سه اقدام اول را همراه با دلیل، مالک و شاهد بررسی تعیین کن.

پاسخ نمونه و معیار ارزیابی

۱) کلید کارمند سابق فوراً لغو و دامنه دسترسی‌اش بررسی شود؛ شاهد: استفاده از کلید قبلی رد شود. ۲) Webhook با احراز و سنجش ورودی پیش از عمل محافظت شود؛ شاهد: درخواست بدون احراز رد شود. ۳) نود انجمنی تا بررسی ناشر، نسخه و مجوز محدود یا حذف شود؛ شاهد: مسیرهای وابسته بازآزمایی شوند. ترتیب عملی بسته به ریسک و سطح مواجهه ممکن است تغییر کند؛ هر دو دسترسی فعال و ورودی باز فوریت دارند.

  • لغو کلید بی‌مالک و بررسی دامنه دسترسی را ذکر می‌کند (1 امتیاز)
  • احراز Webhook و سنجش مستقل ورودی را ذکر می‌کند (1 امتیاز)
  • زنجیره تأمین نود و شاهد آزمون/مسئول را بیان می‌کند (1 امتیاز)
  • فقط نسخه را ارتقا می‌دهم ← ارتقا جایگزین لغو دسترسی فعال و محافظت دروازه ورودی نیست.

سازنده یک `Webhook` از شرط `Only Run If` و توکن نوشته‌شده داخل ورک‌فلو برای امنیت استفاده کرده است. دو نقص و یک اصلاح مستقل پیشنهاد بده.

پیکربندی یک Webhook:

Authentication: None
Options > Only Run If: {{ $json.headers['x-token'] === 'abc123' }}
Respond: Immediately
پاسخ نمونه و معیار ارزیابی

شرط Only Run If را طبق مستند نسخه نباید تنها سد امنیتی دانست؛ رفتار خطای شرط ممکن است با انتظار فرق کند. توکن نوشته‌شده داخل گره در نسخه یا خروجی ورک‌فلو ممکن است افشا شود. اصلاح: احراز رسمی Webhook با Credential، تعویض توکن، اعتبارسنجی ورودی و تست رد درخواست نامعتبر پیش از عمل.

  • نامطمئن‌بودن شرط به‌عنوان تنها مرز امنیتی را بیان می‌کند (1 امتیاز)
  • خطر توکن قرارگرفته در متن ورک‌فلو را مشخص می‌کند (1 امتیاز)
  • Credential، احراز مستقل و آزمون منفی را پیشنهاد می‌دهد (1 امتیاز)
  • فقط توکن را طولانی‌تر کن ← مسئله جای توکن و رفتار Only Run If است، نه طول آن.

در سناریوی نسخه مرجع `n8n`، برای نمونه‌ای که `API` عمومی و نود انجمنی لازم ندارد، متغیرهای محیطی کنترل را بنویس. اگر `Read/Write Files from Disk` را هم مسدود می‌کنی، چه نکته‌ای درباره `NODES_EXCLUDE` باید بررسی شود؟

پاسخ نمونه و معیار ارزیابی

طبق مستند مبنا: N8N_PUBLIC_API_DISABLED=true، N8N_PUBLIC_API_SWAGGERUI_DISABLED=true، N8N_COMMUNITY_PACKAGES_ENABLED=false. مقدار مؤثر NODES_EXCLUDE را برای نسخه نصب‌شده بررسی کن و با تعریف دستی، حذف گره‌های ناخواسته مانند executeCommand، localFileTrigger و readWriteFile را صریح بازبینی کن. این تنظیمات نسخه‌حساس‌اند و بدون آزمون همان نسخه، نتیجه قطعی ادعا نمی‌شود.

  • کنترل API و Swagger را می‌شناسد (1 امتیاز)
  • غیرفعال‌سازی نودهای انجمنی را می‌شناسد (1 امتیاز)
  • جایگزینی/مقدار مؤثر NODES_EXCLUDE و لزوم آزمون نسخه را توضیح می‌دهد (1 امتیاز)
  • فقط readWriteFile ← با تنظیم متغیر، باید کنترل‌های پیش‌فرض مربوط به گره‌های پرخطر را هم در مقدار مؤثر بررسی کنی.

در نسخه مستند تمرین، یک `Webhook` با احراز هدر و فهرست مجاز `IP` روی 203.0.113.5 تنظیم شده است. درخواستِ هدرِ درست از 198.51.100.7 چه نتیجه مورد انتظار دارد؟

  • پذیرفته می‌شود چون هدر درست است.
  • پاسخ 403 می‌گیرد چون نشانی در فهرست مجاز نیست.
  • پذیرفته می‌شود ولی هشدار ثبت می‌شود.
  • ورک‌فلو اجرا و سپس متوقف می‌شود.
پاسخ نمونه و معیار ارزیابی
  • a ← IP(s) Allowlist جدا از احراز هویت بررسی می‌شود.
  • c ← این رفتار Only Run If هنگام خطای عبارت است، نه فهرست IP.
  • d ← درخواست پیش از اجرای ورک‌فلو رد می‌شود.

ممیزی، گره `HTTP Request` را در چند ورک‌فلو پرخطر گزارش کرده است و همکار می‌گوید همه آن‌ها را قطع کنیم. موازنه را با توجه به خروجی مدل، مجوز مقصد و آزمون رد اقدام نامجاز بیان کن.

پاسخ نمونه و معیار ارزیابی

مسدودکردن همه درخواست‌های خروجی ممکن است عملیات لازم را متوقف کند، اما فعال‌بودن بدون کنترل هم خطر درخواست به مقصد خارج از دامنه یا افشای داده دارد. تصمیم مناسبِ مستند: فقط مقصدهای مجاز و عملیات لازم، اعتبارسنجی مقصد و پارامتر مستقل از خروجی مدل، مجوز محدود، کنترل SSRF متناسب با محیط و آزمون منفی برای درخواست خارج از دامنه. اگر این کنترل‌ها ممکن نیست، جریان حساس را فعال نکن.

  • اثر مسدودکردن بر کارکرد را بیان می‌کند (1 امتیاز)
  • ریسک مقصد خارجی، داده محرمانه و خروجی مدل را می‌گوید (1 امتیاز)
  • فهرست مجاز/اعتبارسنجی مستقل و تست منفی را ارائه می‌دهد (1 امتیاز)
  • همه گره‌های پرخطر را مسدود کن ← تصمیم باید با ریسک، کارکرد ضروری و کنترل مستقل همراه باشد؛ یک حکم ثابت برای همه کاربردها کافی نیست.

فایل‌های درس

ورک‌فلوی Webhook با Header Auth، IP(s) Allowlist و سنجش payload (غیرفعال)

n8n-secure-webhook.json

خروجی واقعی چهار درخواست به Webhook امن

webhook-session.txt

خلاصه خروجی واقعی n8n audit روی نمونه آزمایشی

audit-summary.txt

متغیرهای سخت‌سازی با توضیح هرکدام

security.env.example

ابزارها و جایگزین‌ها

  • n8n 2.x خودمیزبان — اجرای Webhook و ممیزی — مسیر بدون نصب با خروجی واقعی

منابع

Secure n8n (security configuration overview) [مستند رسمی فنی؛ غیرمقاله داوری‌شده] n8n مستند جاری؛ نسخه مبنای 2026-10

Webhook node [مستند رسمی فنی؛ غیرمقاله داوری‌شده] n8n مستند جاری؛ نسخه مبنای 2026-10

Validating webhook deliveries [مستند رسمی فنی؛ غیرمقاله داوری‌شده] GitHub Docs مستند جاری؛ نسخه مبنای 2026-10

Disable the public API [مستند رسمی فنی؛ غیرمقاله داوری‌شده] n8n مستند جاری؛ نسخه مبنای 2026-10

Risks when using community nodes [مستند رسمی فنی؛ غیرمقاله داوری‌شده] n8n مستند جاری؛ نسخه مبنای 2026-10

Set up task runners [مستند رسمی فنی؛ غیرمقاله داوری‌شده] n8n مستند جاری؛ نسخه مبنای 2026-10

Deployment environment variables [مستند رسمی فنی؛ غیرمقاله داوری‌شده] n8n مستند جاری؛ نسخه مبنای 2026-10

Run security audits [مستند رسمی فنی؛ غیرمقاله داوری‌شده] n8n مستند جاری؛ نسخه مبنای 2026-10

OWASP Top 10 for Agentic Applications 2026 [راهنمای رسمی؛ غیرمقاله داوری‌شده] OWASP 2025-12-09

OWASP GenAI LLM Top 10 2026 [راهنمای رسمی؛ غیرمقاله داوری‌شده] OWASP 2026-08-03

OWASP Agentic Skills Top 10 [پروژه Incubator و در حال توسعه؛ غیرمقاله داوری‌شده] OWASP نسخه 1.0-2026؛ وضعیت توسعه در بررسی مبنا 2026-11-05

NIST AI Risk Management Framework 1.0 (AI 100-1) [چارچوب رسمی؛ غیرمقاله داوری‌شده] NIST 2023-01

ISO/IEC 42001:2023 Information technology — Artificial intelligence — Management system [استاندارد رسمی؛ غیرمقاله داوری‌شده] ISO/IEC 2023-12

Model Context Protocol Threat Modeling and Analyzing Vulnerabilities to Prompt Injection with Tool Poisoning [preprint؛ داوری مستقل احراز نشده] Huang et al. 2026-03-23

Course

n8n in Production