
Import و Reimport در DefectDojo؛ تفاوت و کاربرد
در ورود تکراری گزارش، ممکن است گزارش جزئی باعث بستهشدن اشتباه یافته غایب شود. مسئله را با نتیجه ظاهری حلشده فرض نکنید. این راهنما روی حفظ پیوستگی یافتهها بین اجراها تمرکز دارد و نشان میدهد چه ورودی و شاهدی برای تصمیم قابل اتکا لازم است.
سرویس DAST در سایت درنا دوپس فعلاً «بهزودی» معرفی شده است؛ برای برنامهریزی اجرا، وضعیت ارائه را از تیم درنا استعلام کنید.
Import و Reimport چه تفاوتی دارند؟
Import گزارش را در Test جدید ثبت میکند. Reimport برای بهروزرسانی جریان آزمون موجود است و میتواند یافتههای جدید، تکراری یا دیگر دیدهنشده را دنبال کند. رفتار بستن موارد قدیمی باید با دامنه ثابت و تنظیمات صریح همراه باشد.
اگر ابزار، محیط، نقش یا فیلتر تغییر کرده، غیبت یک مورد لزوماً نشانه رفع آن نیست. مستند رسمی Reimport برای تصمیم درباره گزارش جزئی اهمیت دارد.
مثال مرجع: Semgrep با UI و Gitleaks با API
گزارش ابتدا فایل Semgrep را از فرم Import وارد میکند و سپس نتیجه Gitleaks را با API میفرستد. تصاویر زیر فرم و فهرست یافتهها را نشان میدهند. تصویر حاوی کلید واقعی API برای انتشار این مقاله استفاده نشده است.
نمونه آموزشی ارسال گزارش
متغیرها را خارج از مخزن و با حساب دارای اختیار کافی تنظیم کنید:
curl --fail-with-body --request POST "${DD_URL}/api/v2/import-scan/" --header "Authorization: Token ${DD_TOKEN}" --form "engagement=${DD_ENGAGEMENT_ID}" --form "scan_type=Semgrep JSON Report" --form "file=@semgrep.json" --form "active=true" --form "verified=false"
نام Parser، فیلدها و مجوز را از API نصبشده تأیید کنید. این نمونه برای API v2 است؛ توکن و URL واقعی را در مستند عمومی یا لاگ Debug نگذارید. TLS باید معتبر باشد.
پیش از Reimport چه چیزهایی کنترل شوند؟
- اسکن واقعاً تمام شده و فایل ناقص نیست.
- Test مقصد به همان ابزار و دامنه تعلق دارد.
- تنظیم
close_old_findingsبا کامل یا جزئی بودن گزارش سازگار است. - تعداد رکوردها و خطای Parser بررسی شدهاند.
- پاسخ موفق HTTP با موفقیت پردازش اشتباه گرفته نشده است.
Verified را فقط بر مبنای قرارداد روشن تیم فعال کنید. ورود خودکار داده بهتنهایی تأیید صحت یافته نیست.
سناریوی عملی: ورود تکراری گزارش
هدف این تمرین، حفظ پیوستگی یافتهها بین اجراها است. برای شروع به گزارش جدید با دامنه قابل مقایسه و Test درست نیاز دارید. سناریو را ابتدا در یک محدوده کوچک اجرا کنید تا بتوانید ورودی، نتیجه و علت خطا را بررسی کنید. این تمرین پیشنهادی برای استفاده از مفاهیم مقاله است؛ نتیجه آزمایش تازهای در گزارش مرجع محسوب نمیشود.
نکته فنی در اجرای این سناریو
دو گزارش آزمایشی بسازید: یکی با یافته مشترک و یافته تازه، دیگری با دامنه ناقص. پیش از اتصال CI، اثر Reimport را روی یافته غایب مشاهده کنید. نتیجه به تنظیمات و دامنه وابسته است؛ غیبت در گزارش جزئی، شاهد اصلاح نیست.
پیش از شروع چه چیزی را ثبت کنیم؟
یک برگه اجرای کوتاه تهیه کنید: نام محصول، نسخه یا تاریخ بررسی، مسئول اجرا و تعریف نتیجه مورد انتظار. شاهد اصلی در این سناریو، رفتار روشن یافته جدید و موجود و غایب است. اگر این شاهد در دسترس نباشد، صرف پایان یافتن فرایند برای قضاوت کافی نیست. مشخص کنید کدام اطلاعات باید برای بازبینی نگه داشته شوند و کدام دادهها، مانند اعتبارنامه یا اطلاعات مشتری، نباید وارد گزارش عمومی شوند.
پیشنیازها را با همان هویتی بررسی کنید که قرار است کار واقعی را انجام دهد. موفقیت مدیر سامانه لزوماً نشان نمیدهد حساب محدود تیم هم به ورودی لازم دسترسی دارد. اگر تفاوت دسترسی یا محیط وجود دارد، آن را پیش از مقایسه نتایج روشن کنید؛ وگرنه ممکن است یک تفاوت اجرایی بهاشتباه به کیفیت بررسی امنیتی نسبت داده شود.
یک شکست محتمل و روش تشخیص آن
در این مثال ممکن است گزارش جزئی باعث بستهشدن اشتباه یافته غایب شود. برای تشخیص، به اولین مرحلهای برگردید که شاهد مورد انتظار در آن وجود ندارد. ورودی آن مرحله را با اجرای قبلی مقایسه کنید و فقط یک متغیر را تغییر دهید. تغییر همزمان تنظیمات، داده و محدوده بررسی، فهم علت بهبود یا شکست را دشوار میکند.
راهکار پیشنهادی این است: سیاست بستن غایبها را با پوشش واقعی گزارش هماهنگ کنید. پس از تغییر، همان سناریوی محدود را تکرار و نتیجه قبل و بعد را کنار هم بررسی کنید. اگر نتیجه متفاوت شد، توضیح دهید کدام تغییر سبب تفاوت شده است. اگر تفاوتی دیده نشد، فرض اولیه را دوباره بررسی کنید؛ تکرار بیتغییر کار، شاهد تازهای برای درستی تصمیم ایجاد نمیکند.
تحویل نتیجه به مسئول پیگیری
مسئول پیشنهادی این بخش، مسئول اتصال اسکنر است. تحویل کار باید شامل مسئله، شاهد، اثر احتمالی و اقدام بعدی باشد. درخواست مبهم «امنیت را بهتر کنید» قابل پیگیری نیست. در عوض، روشن کنید کدام انتظار برآورده نشده، چه تغییری لازم است و چه کسی نتیجه آن تغییر را تأیید میکند. موعد پیگیری را هم بر اساس اهمیت دارایی و ظرفیت تیم تعیین کنید؛ یک عدد ثابت برای همه محصولات مناسب نیست.
برای بستن کار، همان شاهد تعریفشده در شروع را دوباره مطالبه کنید. اگر انجام اقدام به تیم دیگری وابسته است، وابستگی را در وضعیت کار بنویسید و پرونده را فقط به دلیل ارسال پیام یا ایجاد تیکت تمامشده ندانید. این شیوه باعث میشود خروجی تمرین از یک گزارش توصیفی به تصمیمی قابل بررسی تبدیل شود و در بازبینی بعدی، علت انتخاب مسیر روشن بماند.
شواهد تصویری گزارش مرجع
فرم ورود گزارش اسکن به DefectDojo؛ منبع: گزارش فنی درنا.
فهرست یافتههای واردشده از گزارش Semgrep؛ منبع: گزارش فنی درنا.
فهرست یافتههای Gitleaks در سامانه مدیریت یافته؛ منبع: گزارش فنی درنا.
جمعبندی: تاریخچه را با ورودی همدامنه بهروز کنید
یک Import و Reimport آزمایشی انجام دهید و تغییر وضعیتها را بازبینی کنید. برای خودکارسازی مسیر از پشتیبانی دواپس استفاده کنید؛ ورودی اسکن ایستا و اطلاع از وضعیت سرویس DAST را با Parserهای واقعی نصب خود تطبیق دهید.


