Имя файла, загруженное клиентом, не может быть напрямую использовано в качестве пути к хранилищу: во избежание обхода пути и дублирования имен.
Загруженный файл называется `../../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 | Выходной выход интерфейса выходит | Изменить имя диска нельзя решить проблему |
| Одно и то же имя на экране | Внутренняя изоляция ID | Он не должен отменять предыдущую загрузку |
📊 Сравнение ядра
| Метод | Что можно решить? | Недостатки |
|---|---|---|
| Используйте имя пользователя напрямую | Реализация — самая простая | Может происходить обход пути и перезапись дублированных имён |
| Удалите только разделитель путей | Обработанная часть входа | Просто убрать диагональную линию недостаточно |
| Определите тип на основе расширения | Предварительное дифференцирование документов | Расширения могут быть подделы, и они должны координироваться с обнаружением контента |
| Сервер генерирует внутренние идентификаторы | Изолировать дублирующиеся файлы с путями, управляемыми системой | Всё равно требуется сотрудничество с политикой «No Override» и контролем разрешений каталога |
Объектное хранилище имеет те же границы
R2 или другие объекты хранят всю семантику без традиционного обхода по каталогам, но ключи объектов всё равно влияют на изоляцию, переопределение и раскрытие URL.
- Не пишите строку, предоставленную арендатором, в общий префикс.
- Загрузчик не может сделать вывод авторизации только на основе ключевых имён.
Документы должны иметь идентичность до перехода в перевод
При доступе к рабочему процессу OmniDoc (запись продукта) пользователи продолжают видеть знакомые имена файлов, используя внутри себя независимые идентификаторы задач и идентификаторы файлов.
Чёткая идентификация документов приносит следующие преимущества:
- При неудаче и повторной попытке он может точно соответствовать исходной задаче.
- Загрузка перевода и последующая корректура гарантируют, что правильный файл сопоставлен.
- Снижает риск путать чужой файл с тем же именем с текущим результатом.
🎯 Какой способ тебе подходит?
Если нужно показать имя файла
Оригинальное имя пользователя сохраняется, но только для интерфейса, а не для пути к диску.
Если нужно сохранять и загружать файлы
Сервер генерирует внутренний идентификатор, берёт расширение из списка разрешений и управляет покрытием и разрешениями каталогов в соответствии с реальными политиками.
Если использовать объектное хранилище
Не пишите строки арендатора напрямую с префиксом 'share' и принимайте отдельные решения по авторизации при скачивании.
❓ Часто задаваемые вопросы (FAQ)
1. Если убрать диагональные линии, станет ли имя файла безопасным?
Недостаточно. Удаление только косых черт обрабатывает только часть входа; строительство путей, переопределение и определение типа файлов всё равно должны выполняться отдельно.
2. Если расширение файла — PDF, можно ли подтвердить его как PDF?
Нет. Можно подделывать расширения, требующие обнаружения и парсинга содержимого.
3. Что делать, если отображаемое имя содержит HTML?
Escape при выходе интерфейса нельзя решить, изменив имя файла на диске.
4. После использования уникального идентификатора, нужно ли мне всё равно отключать перезапись?
Да. Уникальный идентификатор не означает, что можно игнорировать политику «Без переопределения».
📝 Краткое содержание
Имя файла для загрузки должно обрабатываться отдельно от пути хранилища: отображаемое имя используется для отображения, а путь хранения генерируется сервером на основе внутреннего идентификатора. Пути, покрытие, типы и авторизации должны быть проверены отдельно.
Опыт сейчас: загрузите документ, чтобы начать перевод, сохраняя оригинальное форматирование
Источники: Python pathlib


