آموزش Gitleaks؛ کشف توکن آزمایشی در Commit قدیمی مخزن با Gitleaks و مسیر ابطال اعتبارنامه

آموزش Gitleaks؛ کشف رمز و توکن در تاریخچه Git

در تاریخچه مخزن Git، ممکن است Clone کم‌عمق بخش مهم تاریخچه را حذف کند. مسئله را با نتیجه ظاهری حل‌شده فرض نکنید. این راهنما روی شناسایی احتمال نشت اعتبارنامه تمرکز دارد و نشان می‌دهد چه ورودی و شاهدی برای تصمیم قابل اتکا لازم است.

اسکن فایل‌ها با بررسی تاریخچه چه تفاوتی دارد؟

در نسخه‌های جدید Gitleaks، git برای بررسی تاریخچه و dir برای فایل‌های یک مسیر استفاده می‌شود. نسخه ابزار را پیش از کپی دستور بررسی کنید؛ در گزارش مرجع نمونه‌هایی با فرمان قدیمی detect هم آمده است.

gitleaks git . --redact --report-format json --report-path git-secrets.json
gitleaks dir . --redact --report-format json --report-path files-secrets.json

دستور اول به مخزن Git و تاریخچه قابل دسترس نیاز دارد. در Clone کم‌عمق CI، دامنه بررسی محدود می‌شود؛ صرف اجرای دستور، پوشش تمام تاریخچه را تضمین نمی‌کند. رفتار فرمان‌ها در مخزن رسمی Gitleaks مستند شده است.

مثال گزارش: چرا اسکن با خطای Git شکست خورد؟

یکی از تصاویر مرجع نشان می‌دهد هدفِ Mountشده مخزن معتبر Git نبوده است. این خطا با نداشتن یافته فرق دارد. اگر هدف فقط فایل‌های کپی‌شده است، حالت دایرکتوری را انتخاب کنید؛ اگر قصد بررسی تاریخچه دارید، وجود .git و دامنه Fetch را اصلاح کنید.

تصویر فهرست یافته‌ها، موارد Gitleaks واردشده به DefectDojo را نشان می‌دهد. ثبت یافته در سامانه، شروع رسیدگی است؛ هنوز باید اعتبار Secret و دامنه استفاده از آن تعیین شود.

بعد از کشف Secret چه کنیم؟

حذف رشته از مخزن کافی نیست

  1. کلید یا توکن مشکوک را در سرویس صادرکننده باطل یا تعویض کنید.
  2. استفاده‌های وابسته را با Credential جدید به‌روز کنید.
  3. لاگ استفاده از Secret را برای دسترسی غیرمنتظره بررسی کنید.
  4. اصلاح مخزن و تصمیم درباره تاریخچه را با فرایند تیم انجام دهید.
  5. دوباره اسکن کنید و علت ورود Secret را برطرف سازید.

گزارش اسکن می‌تواند خودش داده حساس داشته باشد. Redaction، محدودیت دسترسی Artifact و زمان نگهداری را هم‌زمان تنظیم کنید. برای مقدار نمونه یا خطای کاذب، استثنای دقیق و مستند بسازید.

پیشگیری را نزدیک Commit قرار دهید

کنترل محلی، بازبینی Merge Request و اسکن دوره‌ای تاریخچه نقش‌های مکمل دارند. در CI، Credential را از سازوکار امن دریافت کنید و به Jobهای غیرقابل اعتماد ندهید. طراحی این جریان بخشی از خدمات و پشتیبانی دواپس است؛ بررسی کد مصرف‌کننده Secret هم در تحلیل ایستای امنیتی جای می‌گیرد.

سناریوی عملی: تاریخچه مخزن Git

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

نکته فنی در اجرای این سناریو

حذف رشته از آخرین Commit، راز منتشرشده را از تاریخچه و نسخه‌های Clone حذف نمی‌کند. در نشت واقعی، ابتدا اعتبارنامه را ابطال یا تعویض کنید و مصرف غیرعادی آن را بررسی کنید. پاک‌سازی تاریخچه اقدامی جداست که اثرش بر همکاری تیم باید برنامه‌ریزی شود.

پیش از شروع چه چیزی را ثبت کنیم؟

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

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

یک شکست محتمل و روش تشخیص آن

در این مثال ممکن است Clone کم‌عمق بخش مهم تاریخچه را حذف کند. برای تشخیص، به اولین مرحله‌ای برگردید که شاهد مورد انتظار در آن وجود ندارد. ورودی آن مرحله را با اجرای قبلی مقایسه کنید و فقط یک متغیر را تغییر دهید. تغییر هم‌زمان تنظیمات، داده و محدوده بررسی، فهم علت بهبود یا شکست را دشوار می‌کند.

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

تحویل نتیجه به مسئول پیگیری

مسئول پیشنهادی این بخش، مالک اعتبارنامه است. تحویل کار باید شامل مسئله، شاهد، اثر احتمالی و اقدام بعدی باشد. درخواست مبهم «امنیت را بهتر کنید» قابل پیگیری نیست. در عوض، روشن کنید کدام انتظار برآورده نشده، چه تغییری لازم است و چه کسی نتیجه آن تغییر را تأیید می‌کند. موعد پیگیری را هم بر اساس اهمیت دارایی و ظرفیت تیم تعیین کنید؛ یک عدد ثابت برای همه محصولات مناسب نیست.

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

شواهد تصویری گزارش مرجع

خطای اجرای اسکن تاریخچه در مسیر فاقد مخزن معتبر Gitخطای اجرای اسکن تاریخچه در مسیر فاقد مخزن معتبر Git؛ منبع: گزارش فنی درنا.فهرست یافته‌های Gitleaks در سامانه مدیریت یافتهفهرست یافته‌های Gitleaks در سامانه مدیریت یافته؛ منبع: گزارش فنی درنا.

جمع‌بندی: از کشف به ابطال برسید

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