Имя файла, загруженное клиентом, не может быть напрямую использовано в качестве пути к хранилищу: во избежание обхода пути и дублирования имен.

Загруженный файл называется `../../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

Обновлено 2026-11-15