Ім'я файлу, завантажене клієнтом, не можна безпосередньо використовувати як шлях до зберігання: щоб запобігти проходженню шляху та повторюваному покриттю імен

Завантажений файл називається `../../report.pdf`, що не означає, що сервер повинен зберігати його під цим ім’ям. Ім'я файлу походить від користувача і належить до вхідних даних; шлях до диска належить межі дозволу системи. Плутання цих двох може легко призвести до таких проблем, як обхід шляху, покриття дублікатів імен і різна поведінка між Windows і Linux.

Те, що завантажений файл має назву ../../report.pdf, не означає, що сервер повинен зберегти його під цим ім’ям. З цією проблемою зіткнуться розробники, які пишуть функції завантаження на стороні сервера, а також команди, яким потрібно мати справу з файлами користувача та турбуватися про проходження шляху та покриття дублікатів імен. Прочитавши цю статтю, ви зможете розрізняти відображувані імена та імена зберігання, знати, які перевірки слід виконувати на кожному рівні, і переглядати власну реалізацію відповідно до елементів прийняття.

Ім'я файлу походить від користувача і належить до вхідних даних; шлях до диска належить до межі дозволу системи. Плутання цих двох може легко призвести до таких проблем, як обхід шляху, покриття дублікатів імен і різна поведінка між Windows і Linux.

У цій статті використовуються синтетичні зразки для демонстрації методу обробки. Зразок коду перевірено в ізольованому середовищі, і він не є гарантією всіх реальних файлів або продуктивності продукту. Перед обробкою важливих документів збережіть оригінали та перегляньте їх відповідно до меж і пунктів прийняття в тексті.

Чи можна назву завантаженого файлу використовувати безпосередньо як шлях до зберігання? Висновок одним реченням

Його не можна використовувати безпосередньо. Відображуване ім’я використовується для відображення інтерфейсу, а шлях зберігання генерується сервером на основі внутрішнього ідентифікатора.

ваша ситуаціяРекомендовані практикипричина
Оригінальна назва файлу користувача має відображатися в інтерфейсіВідображувана назва зарезервована лише для відображенняВідображуване ім’я відокремлено від шляху до диска, щоб уникнути перетинання шляхів
Необхідно зберегти завантажені файлиСервер генерує внутрішній ідентифікатор і з’єднує шлях зберіганняУникайте перезапису повторюваними іменами та не впливайте на введення користувача
Розширення файлу має брати участь у сховищіВзяти суфікс із дозволеного списку сервераНе копіюйте розширення, надані користувачами
Необхідно визначити справжній тип файлуВиконуйте виявлення та аналіз вмістуНарощування можна підробити

Ім'я для відображення та ім'я для зберігання розділені

Оригінальна назва зберігається для відображення інтерфейсу, але внутрішня ідентифікація генерується сервером. Суфікс зберігання також має надходити зі списку дозволених на стороні сервера, а не копіювати розширення, надане користувачем.

У наступному прикладі створюється лише шлях, а не каталог або файл.

Конструктор мінімального шляху

from pathlib import Path
import re

def storage_path(root, internal_id, extension):
    if not re.fullmatch(r"[a-f0-9]{32}", internal_id):
        raise ValueError("invalid internal id")
    if extension not in {".pdf", ".docx", ".udoc"}:
        raise ValueError("unsupported extension")
    base = Path(root).resolve()
    candidate = (base / (internal_id + extension)).resolve()
    if candidate.parent != base:
        raise ValueError("outside storage root")
    return candidate

root = Path.cwd() / "synthetic-uploads"
identifier = "a" * 32
p = storage_path(root, identifier, ".pdf")
assert p.parent == root.resolve()
assert p.name == identifier + ".pdf"
for bad in ["../../report", "A" * 32, "a" * 31, "a" * 32 + "/x"]:
    try:
        storage_path(root, bad, ".pdf")
    except ValueError:
        pass
    else:
        raise AssertionError(bad)

У цьому прикладі передбачається, що внутрішній ідентифікатор був згенерований сервером. Це не безпечна реалізація файлу запису для довільних дискових атак:

  • Змагання все ще можуть відбуватися між перевіркою та фактичним відкриттям.
  • Дозволи батьківського каталогу та політики символічних посилань повинні контролюватися окремо.
  • Унікальний ідентифікатор також не означає, що можна ігнорувати політику "без перевизначення".

Очищення імені файлу не є автентифікацією файлу

Очищення імен файлів може вирішити лише частину проблеми, і різні явища потрібно обробляти на різних рівнях:

вхідний феноменНа якому рівні його слід обробляти?недоліки
Містить роздільник шляхуНе використовується як шлях зберіганняПросто видалити косу риску недостатньо
розширення PDFВиявлення та аналіз контентуНадставки можна підробити
Відображуване ім'я містить HTMLЕкранування виводу інтерфейсуЦю проблему неможливо вирішити, змінивши назву диска.
Те саме відображуване ім’яВнутрішня ідентифікаційна ізоляціяПопереднє завантаження не повинно бути перезаписано

📊 Основне порівняння

практикаЩо можна вирішитинедоліки
Використовуйте назву файлу користувача безпосередньоНайпростіша реалізаціяМоже виникнути перетинання шляхів і дублювання імен
Просто видаліть роздільники шляхуОпрацьована частина вхідних данихПросто видалити косу риску недостатньо
Визначте тип на основі розширенняфайл попередньої диференціаціїРозширення можна підробити, і потрібне виявлення вмісту.
Внутрішній ідентифікатор, створений серверомІзолювати файли з однаковою назвою, шлях контролюється системоюВсе ще потрібно співпрацювати з політикою "без перезапису" та керуванням дозволами каталогу

Сховище об'єктів також має ті самі межі

R2 або інші сховища об’єктів не мають повної семантики традиційного обходу каталогу, але ключі об’єктів все ще впливають на ізоляцію, перевизначення та відкриті URL-адреси.

  • Не вводьте безпосередньо рядок, наданий орендарем, у спільному префіксі.
  • Завантажувач не може зробити висновок про авторизацію лише на основі імені ключа.

Файл повинен мати ідентичність перед введенням перекладу

Підключившись до робочого процесу OmniDoc (портал продуктів), ви можете продовжувати відображати користувачам знайомі імена файлів і використовувати внутрішні ідентифікатори завдань і файлів.

Чітка документальна ідентифікація дає такі переваги:

  • Якщо повторна спроба не вдається, вона може точно відповідати початковому завданню.
  • Завантаження рукопису перекладу та подальше рецензування можуть відповідати правильному файлу.

— Зменшення ризику обробки чужого файлу з тим самим іменем, що й поточний результат.

🎯 Який спосіб вам підходить?

Якщо потрібно відобразити назву файлу

Оригінальне відображуване ім'я користувача зберігається, але використовується лише для інтерфейсу, а не для шляху до диска.

Якщо потрібно зберегти завантажений файл

Внутрішній ідентифікатор генерується сервером, бере суфікс зі списку дозволених і контролює покриття та дозволи каталогу відповідно до фактичної політики.

Якщо ви використовуєте зберігання об'єктів

Не вводьте безпосередньо рядок клієнта в спільний префікс і робіть окремі рішення про авторизацію під час завантаження.

❓ Часті запитання (FAQ)

1. Якщо косу риску видалити, чи буде назва файлу безпечною?

недостатньо. Лише видалення скісної риски може обробити лише частину вхідних даних, а конструкція шляху, перезапис і визначення типу файлу все ще повинні оброблятися окремо.

2. Чи означає це те, що розширення PDF?

не можна. Розширення можуть бути підробленими та потребують виявлення та аналізу вмісту.

3. Що робити, якщо відображуване ім'я містить HTML?

Вихід під час виведення інтерфейсу не можна вирішити, змінивши назву файлу на диску.

4. Після використання унікального ідентифікатора чи потрібно мені вимикати перезапис?

потреба. Унікальний ідентифікатор не означає, що можна ігнорувати політику "без перевизначення".

📝 Підсумок

Ім’я завантаженого файлу слід обробляти окремо від шляху зберігання: відображуване ім’я використовується для відображення, а шлях зберігання створюється сервером на основі внутрішнього ідентифікатора. Шлях, покриття, тип і авторизація перевіряються незалежно.

Спробуйте зараз: завантажте документ, щоб розпочати переклад, зберігаючи вихідний макет

Джерела: Python pathlib

Оновлено 2026-11-16