بتل کد Battle Codeدارد باز می‌شود…

جلسه‌ی 57: اشتباه‌های رایج توسعه‌دهنده ۱: رازها و اعتماد Developer Mistakes 1: Secrets and Trust

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

در این جلسه یاد می‌گیری

درس

⚠️ اگر در یک مخزن عمومی کلید یا رمزِ کس دیگری را دیدی، استفاده از آن (حتی «فقط برای امتحان این که کار می‌کند») دسترسی غیرمجاز است. کار درست: به صاحبش خبر بده که لو رفته. قانون جرایم رایانه‌ای ایران (۱۳۸۸) دسترسی غیرمجاز به سامانه‌ها، شنود و تغییر داده‌های دیگران را جرم می‌داند. در این درس فقط روی کدِ خودت، صفحه‌ی پیش‌نمایشِ خودت و تمرین‌های همین سایت کار می‌کنی. هیچ‌وقت سایت، حساب یا دستگاه کس دیگری را بدون اجازه‌ی کتبی آزمایش نکن. اگر جایی اشتباهی دیدی، فقط به صاحبش خبر بده (گزارش مسئولانه).

رایج‌ترین اشتباه دنیا: راز داخل کد. API_KEY = "sk-live-7f3a..." در فایل، فایل در گیت، گیت روی گیت‌هاب. ربات‌ها هر دقیقه گیت‌هاب را برای همین الگوها می‌گردند؛ کلید لو‌رفته در چند دقیقه استفاده می‌شود. درمان: راز در متغیر محیطی (os.environ["API_KEY"]) یا فایل .env که در .gitignore است. در کد فقط *نام* راز هست، نه خودش.

# bad
API_KEY = "sk-live-7f3a9c1d"

# good
import os
API_KEY = os.environ["API_KEY"]      # set outside the code; .env is in .gitignore

حذف کردن کافی نیست. اگر راز یک بار commit شده، در تاریخچه‌ی گیت می‌ماند، حتی بعد از پاک کردن از فایل. تنها درمان واقعی: راز را عوض کن (rotate)، یعنی کلید جدید بساز و قدیمی را باطل کن؛ بعد اگر خواستی تاریخچه را هم پاک کن. فرض همیشه این است: هر چیزی که یک بار در گیت رفت، لو رفته.

اشتباه دوم: پیام خطای پرحرف. User sara not found یا Password wrong for sara به مهاجم می‌گوید کدام نام‌ها وجود دارند. Database error: SELECT * FROM users WHERE ... ساختار پایگاه داده را لو می‌دهد. Traceback ... /home/app/secret_config.py مسیر فایل‌ها را. قاعده: به کاربر یک پیام کوتاهِ عمومی + یک شناسه‌ی خطا؛ جزئیات فقط در لاگ سرور.

# to the user
"Something went wrong. Error id: 4f2a"
# to the log (server only)
"4f2a 2026-10-18 10:31 login: db timeout for user sara"

اشتباه سوم: لاگی که راز دارد. لاگ‌ها در جاهای زیادی کپی می‌شوند (پشتیبان، سرویس مانیتورینگ، دست پشتیبانی). هر چیزی که در لاگ بنویسی، باید فرض کنی نیمی از شرکت می‌بیند. پس: نه رمز، نه توکن، نه شماره‌ی کارت، نه کل درخواست. آدرس ایمیل و IP را هم فقط اگر واقعاً لازم است.

چک‌لیست امروز، برای هر پروژه‌ی خودت:
۱. grep برای key =، password =، token =، secret در کد.
۲. .env و فایل‌های پیکربندی در .gitignore هستند؟
۳. پیام‌های خطا عمومی‌اند و جزئیات در لاگ است؟
۴. لاگ‌ها رمز/توکن ندارند؟
۵. اگر رازی لو رفته: عوضش کن، همین حالا.

مثال‌های این جلسه

چالش‌ها

  1. Secret Scanner (آسان)
  2. From Code to Environment (آسان)
  3. Generic Errors (متوسط)
  4. Scrub the Log (متوسط)
  5. Git History Leak (سخت)
  6. Key in the Page (سخت)

بیشتر بخوان

← جلسه‌ی 56: پروژه: یادداشت رمزشده‌ی مرورگری جلسه‌ی 58: اشتباه‌های رایج توسعه‌دهنده ۲: ده خطر اصلی وب →