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

جلسه‌ی 27: مسیر فایل و `..` File Paths and `..`

یک برنامه که فایل‌ها را با اسمی که کاربر می‌دهد باز می‌کند، اگر دقت نکند با ../ از پوشه‌ی مجاز بیرون می‌زند. با یک پوشه‌ی شبیه‌سازی‌شده (دیکشنری) این «فرار از مسیر» را می‌بینیم و تابع safe_path می‌نویسیم.

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

درس

⚠️ در این جلسه پوشه و فایل‌ها شبیه‌سازی‌شده هستند: یک دیکشنری در حافظه. هیچ فایل واقعی باز نمی‌شود. امتحان کردن ../ روی سایت یا سرور دیگران برای رسیدن به فایل‌هایی که مال تو نیستند، نفوذ است و جرم. اگر چنین سوراخی در سایتی دیدی، به مدیرش گزارش بده.

مسیر فایل مثل آدرس است: /home/user/notes.txt یعنی پوشه‌ی home، داخلش user، داخلش فایل notes.txt. دو اسم خاص داریم: . یعنی «همین پوشه» و .. یعنی «یک پوشه بالاتر». پس /home/user/../secret.txt همان /home/secret.txt است.

/home/user/notes.txt        -> notes.txt inside /home/user
/home/user/./notes.txt      -> the same (. = here)
/home/user/../secret.txt    -> /home/secret.txt (.. = go up)

پوشه‌ی شبیه‌سازی‌شده‌ی ما یک دیکشنری است: کلید مسیر کامل، مقدار محتوای فایل. برنامه‌ی ما فقط باید فایل‌های داخل /home/user/ را به کاربر نشان دهد. secret.txt در /home/ است و نباید دیده شود.

files = {
    "/home/user/notes.txt": "buy milk",
    "/home/user/todo.txt": "finish homework",
    "/home/secret.txt": "admin password: hunter2",
}
BASE = "/home/user/"

def read_naive(name):
    return files.get(BASE + name, "not found")

print(read_naive("notes.txt"))        # buy milk

با دیکشنری، BASE + "../secret.txt" کلید /home/user/../secret.txt می‌شود که وجود ندارد؛ پس امن به نظر می‌رسد. اما سیستم‌عامل واقعی .. را می‌فهمد و همان /home/secret.txt را باز می‌کند! برای این‌که واقعیت را شبیه‌سازی کنیم، تابعی می‌نویسیم که مسیر را مثل سیستم‌عامل «حل» کند.

نرمال‌سازی دستی: مسیر را با / بشکن، یک لیست خالی به نام parts بساز و روی تکه‌ها بچرخ: تکه‌ی خالی یا . را رد کن؛ .. یعنی آخرین تکه را از parts بردار (اگر چیزی هست)؛ هر اسم دیگر را به parts اضافه کن. در آخر با "/" + "/".join(parts) مسیر تمیز را بساز.

def normalise(path):
    parts = []
    for piece in path.split("/"):
        if piece == "" or piece == ".":
            continue
        if piece == "..":
            if parts:
                parts.pop()
        else:
            parts.append(piece)
    return "/" + "/".join(parts)

print(normalise("/home/user/../secret.txt"))   # /home/secret.txt
print(normalise("/home/user/./notes.txt"))     # /home/user/notes.txt

حالا حمله‌ی واقعی را می‌بینیم: read_real اول مسیر را نرمال می‌کند و بعد در دیکشنری می‌گردد. ورودی ../secret.txt به /home/secret.txt تبدیل می‌شود و رمز مدیر لو می‌رود. به این حمله پیمایش مسیر (path traversal) می‌گویند و در سایت‌هایی که فایل را با اسم دانلود می‌دهند بسیار رایج بوده است.

def read_real(name):
    full = normalise(BASE + name)
    return files.get(full, "not found")

print(read_real("../secret.txt"))   # admin password: hunter2  <- leaked!

دفاع: safe_path(name) مسیر را نرمال می‌کند و بعد چک می‌کند که با BASE شروع شود (startswith). اگر نه، None برمی‌گرداند و برنامه فایل را نمی‌خواند. حذف کردن .. از متن کافی نیست (....// بعد از حذف دوباره ../ می‌شود!)؛ همیشه بعد از نرمال‌سازی چک کن.

def safe_path(name):
    full = normalise(BASE + name)
    if full.startswith(BASE):
        return full
    return None

print(safe_path("notes.txt"))        # /home/user/notes.txt
print(safe_path("../secret.txt"))    # None

اشتباه‌های رایج: ۱) چک کردن .. با in به جای نرمال‌سازی. ۲) startswith("/home/user") بدون / آخر: مسیر /home/username/x هم قبول می‌شود! همیشه BASE را با / تمام کن. ۳) نرمال‌سازی بعد از چک کردن، به جای قبل از آن. ۴) فراموش کردن if parts: قبل از pop() که با ../../.. خطا می‌دهد.

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

چالش‌ها

  1. Split the Path (آسان)
  2. Naive Join (آسان)
  3. Normalise (متوسط)
  4. The Escape (متوسط)
  5. safe_path (سخت)
  6. Download Log (سخت)
  7. safe_path for Downloads (سخت)
  8. Blocked per User (متوسط)

بیشتر بخوان

← جلسه‌ی 26: تزریق با مثال ساختگی جلسه‌ی 28: پروژه: دفترچه‌ی یادداشت ضدخراب →