
امنیت GitLab CI؛ پیادهسازی اسکن و دروازه انتشار
در پایپلاین امنیت، ممکن است allow_failure یا حذف گزارش شکست واقعی را پنهان کند. مسئله را با نتیجه ظاهری حلشده فرض نکنید. این راهنما روی تفکیک اجرای ابزار از تصمیم انتشار تمرکز دارد و نشان میدهد چه ورودی و شاهدی برای تصمیم قابل اتکا لازم است.
سرویس DAST در سایت درنا دوپس فعلاً «بهزودی» معرفی شده است؛ برای برنامهریزی اجرا، وضعیت ارائه را از تیم درنا استعلام کنید.
معماری گزارش مرجع چه الگویی دارد؟
در گزارش درنا، ابزارها Jobهای جدا دارند: بررسی اسرار، تحلیل کد، اسکن فایلسیستم، بررسی ایمیج، تولید SBOM و آزمون سرویس. برای ZAP هم Juice Shop بهصورت Service با نام مستعار juiceshop در دسترس Job قرار میگیرد.
این تفکیک کمک میکند خطای هر لایه مستقل دیده شود. ایمیج نهایی باید پس از Build بررسی شود و DAST باید به سرویس آماده و دامنه مشخص برسد. اجرای همزمان کورکورانه این مراحل پوشش معتبر نمیسازد.
یک Job کوچک و قابل بازبینی
نمونه زیر فرض میکند قواعد محلی در مخزن قرار دارند و متغیر SEMGREP_IMAGE به ایمیج آزمودهشده و ثابت ابزار اشاره میکند:
stages: [security]
semgrep_scan:
stage: security
image:
name: "$SEMGREP_IMAGE"
entrypoint: [""]
script:
- semgrep scan --config rules/ --error --json --output semgrep.json .
artifacts:
when: always
paths:
- semgrep.json
expire_in: 7 days
خالی کردن Entrypoint زمانی لازم است که Entrypoint ایمیج با شیوه اجرای Shell در Runner سازگار نباشد. آن را بدون بررسی به تمام Jobها تعمیم ندهید. مرجع YAML گیتلب رفتار Image و Artifact را مستند میکند.
سه شکست که نباید نتیجه پاک تولید کنند
داده و قواعد دریافت نشدهاند
کش خالی یا پایگاه ناسازگار یعنی اسکن نامعتبر. نسخه و زمان داده را در شواهد اجرا نگه دارید.
سرویس هنوز آماده نیست
نام مستعار Service را Resolve کنید و Health Check متناسب بگذارید. پاسخ صفحه عمومی، دسترسی به مسیر پشت ورود را ثابت نمیکند.
ابزار شکست خورده و گزارش حذف شده است
when: always برای حفظ گزارش مفید است، اما وجود فایل و کامل بودن آن نیز باید کنترل شود. JSON معمولی هر ابزار لزوماً قالب Security Report بومی GitLab نیست.
سیاست انتشار را صریح کنید
یافته امنیتی، خطای اجرا و استثنای پذیرفتهشده سه وضعیت متفاوتاند. از || true عمومی برای سبز کردن همه آنها استفاده نکنید. اسرار را نیز فقط به Jobهای مورد اعتماد بدهید و گزارش خام را با دسترسی مناسب نگه دارید.
سناریوی عملی: پایپلاین امنیت
هدف این تمرین، تفکیک اجرای ابزار از تصمیم انتشار است. برای شروع به کد و ایمیج و محیط آزمایشی همان نسخه نیاز دارید. سناریو را ابتدا در یک محدوده کوچک اجرا کنید تا بتوانید ورودی، نتیجه و علت خطا را بررسی کنید. این تمرین پیشنهادی برای استفاده از مفاهیم مقاله است؛ نتیجه آزمایش تازهای در گزارش مرجع محسوب نمیشود.
نکته فنی در اجرای این سناریو
خروجی امنیتی را به همان Commit و ایمیجی متصل کنید که قرار است منتشر شود. اگر بعد از اسکن، Build تازهای ساخته شد، نتیجه قبلی را خودکار به آن نسبت ندهید. برای DAST نیز آمادگی و هویت نسخه مستقر را پیش از آغاز آزمون بررسی کنید.
پیش از شروع چه چیزی را ثبت کنیم؟
یک برگه اجرای کوتاه تهیه کنید: نام محصول، نسخه یا تاریخ بررسی، مسئول اجرا و تعریف نتیجه مورد انتظار. شاهد اصلی در این سناریو، Artifact قابل تحلیل حتی هنگام شکست Job است. اگر این شاهد در دسترس نباشد، صرف پایان یافتن فرایند برای قضاوت کافی نیست. مشخص کنید کدام اطلاعات باید برای بازبینی نگه داشته شوند و کدام دادهها، مانند اعتبارنامه یا اطلاعات مشتری، نباید وارد گزارش عمومی شوند.
پیشنیازها را با همان هویتی بررسی کنید که قرار است کار واقعی را انجام دهد. موفقیت مدیر سامانه لزوماً نشان نمیدهد حساب محدود تیم هم به ورودی لازم دسترسی دارد. اگر تفاوت دسترسی یا محیط وجود دارد، آن را پیش از مقایسه نتایج روشن کنید؛ وگرنه ممکن است یک تفاوت اجرایی بهاشتباه به کیفیت بررسی امنیتی نسبت داده شود.
یک شکست محتمل و روش تشخیص آن
در این مثال ممکن است allow_failure یا حذف گزارش شکست واقعی را پنهان کند. برای تشخیص، به اولین مرحلهای برگردید که شاهد مورد انتظار در آن وجود ندارد. ورودی آن مرحله را با اجرای قبلی مقایسه کنید و فقط یک متغیر را تغییر دهید. تغییر همزمان تنظیمات، داده و محدوده بررسی، فهم علت بهبود یا شکست را دشوار میکند.
راهکار پیشنهادی این است: سیاست خطای اجرا و سیاست یافته را جدا و نگهداری گزارش را صریح تعریف کنید. پس از تغییر، همان سناریوی محدود را تکرار و نتیجه قبل و بعد را کنار هم بررسی کنید. اگر نتیجه متفاوت شد، توضیح دهید کدام تغییر سبب تفاوت شده است. اگر تفاوتی دیده نشد، فرض اولیه را دوباره بررسی کنید؛ تکرار بیتغییر کار، شاهد تازهای برای درستی تصمیم ایجاد نمیکند.
تحویل نتیجه به مسئول پیگیری
مسئول پیشنهادی این بخش، مالک CI/CD است. تحویل کار باید شامل مسئله، شاهد، اثر احتمالی و اقدام بعدی باشد. درخواست مبهم «امنیت را بهتر کنید» قابل پیگیری نیست. در عوض، روشن کنید کدام انتظار برآورده نشده، چه تغییری لازم است و چه کسی نتیجه آن تغییر را تأیید میکند. موعد پیگیری را هم بر اساس اهمیت دارایی و ظرفیت تیم تعیین کنید؛ یک عدد ثابت برای همه محصولات مناسب نیست.
برای بستن کار، همان شاهد تعریفشده در شروع را دوباره مطالبه کنید. اگر انجام اقدام به تیم دیگری وابسته است، وابستگی را در وضعیت کار بنویسید و پرونده را فقط به دلیل ارسال پیام یا ایجاد تیکت تمامشده ندانید. این شیوه باعث میشود خروجی تمرین از یک گزارش توصیفی به تصمیمی قابل بررسی تبدیل شود و در بازبینی بعدی، علت انتخاب مسیر روشن بماند.
شواهد تصویری گزارش مرجع
شمای کلی ابزارهای بررسی امنیت در زنجیره توسعه؛ منبع: گزارش فنی درنا.
نمونه بررسی ساختار یک Plan در ZAP؛ منبع: گزارش فنی درنا.
فهرست یافتههای واردشده از گزارش Semgrep؛ منبع: گزارش فنی درنا.
جمعبندی و اقدام بعدی
از یک جریان کوچک با شواهد کامل شروع کنید. برای ساخت پایپلاین CI/CD متناسب با تیم، دامنه کد را با اسکن ایستا و رفتار نسخه آزمایشی را با اطلاع از وضعیت سرویس DAST مشخص کنید.


