Ім'я файлу, завантажене клієнтом, не можна безпосередньо використовувати як шлях до зберігання: щоб запобігти проходженню шляху та повторюваному покриттю імен
Завантажений файл називається `../../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


