Коротко
- Проверка авторизации и маршрутизация запроса — часто два разных компонента, которые не обязаны одинаково трактовать путь.
- Слэш на конце, двойной слэш, процентное кодирование и регистр символов — классические источники расхождения.
- Жадное сопоставление префиксов в шлюзе может пропускать запрос дальше, теряя контекст авторизации по пути.
- Тестировать нормализацию нужно отдельным набором запросов, а не полагаться на то, что фреймворк «сам разберётся».
Почему путь можно трактовать по-разному
HTTP-путь — это просто строка. Но компонентов, которые её читают, в типичном API-шлюзе несколько: модуль маршрутизации решает, какой обработчик вызвать; авторизатор решает, пропускать ли запрос; сама интеграция (например, функция) получает путь на вход и делает с ним что-то своё. Каждый из этих компонентов может нормализовать строку по-своему — или не нормализовать вовсе.
Проблема возникает, когда эти компоненты расходятся. Авторизатор проверил путь A, решение «разрешить» привязалось к запросу, а до интеграции дошёл путь B, который не прошёл бы ту же проверку напрямую. О похожем случае, когда расхождение привело к реальному обходу авторизации, редакция Vechron писала в материале о том, как слэш на конце пути вернул 200 вместо 401 в финтех-API.
Отдельная сложность возникает при использовании нескольких слоёв инфраструктуры одновременно: перед шлюзом API часто стоит ещё один компонент — балансировщик нагрузки, CDN или reverse-proxy, который тоже может нормализовать путь по-своему. В такой цепочке число точек, где трактовка пути может разойтись, растёт с каждым добавленным слоем, и проверять нужно не только сам шлюз, но и всю цепочку целиком.
Полезно формализовать это тестирование в виде отдельного набора автоматических проверок, который прогоняется при каждом изменении конфигурации маршрутизации или правил авторизации, а не выполняется вручную от случая к случаю перед релизом. Автоматизация снижает риск того, что проверка будет пропущена из-за нехватки времени перед очередным деплоем.
Хорошая практика — включать такие тесты в документацию самого API как часть контракта, а не держать их только во внутреннем наборе проверок команды безопасности: разработчики, которые добавляют новый маршрут, должны видеть этот чеклист до того, как маршрут окажется в продуктиве, а не узнавать о нём постфактум от команды, проводившей аудит.
Слэш на конце и двойной слэш
Самый частый источник путаницы — завершающий слэш. Для одних маршрутизаторов /v1/accounts и /v1/accounts/ — один и тот же маршрут. Для других — разные записи таблицы, и если явного правила для второго варианта нет, запрос может попасть в маршрут по умолчанию (catch-all) или в соседний обработчик с другими правами.
Двойной слэш (/v1/accounts//) усугубляет расхождение: часть систем «сворачивает» повторяющиеся слэши в один перед сопоставлением маршрута, часть — не трогает строку вовсе. Если нормализация происходит после проверки авторизации, а не до неё, два этих шага смотрят на разные версии одного и того же пути.
/v1/accounts— точное совпадение с правилом, авторизация проверяется штатно./v1/accounts/— может попасть под то же правило как префикс, но без повторной проверки контекста./v1/accounts//— может нормализоваться до совпадения с первым вариантом уже после авторизации.
Полезная практика — логировать исходный путь запроса и путь, с которым фактически сработала интеграция, отдельно друг от друга. Если эти два значения когда-либо расходятся для защищённого маршрута, это сигнал тревоги, который стоит разбирать немедленно, а не считать фоновым шумом логов.
Читайте такжеСекреты в Terraform state: как хранить состояние безопасноКодирование и регистр символов
Ещё один источник расхождения — процентное кодирование. Символ слэша, закодированный как %2f, для одного компонента шлюза — обычный символ строки, для другого — тот же разделитель пути, что и нормальный /. Если декодирование происходит в разных точках пайплайна в разное время, сравнение пути с правилами маршрутизации и правилами авторизации идёт по не совпадающим друг с другом строкам.
Регистр символов — менее очевидный, но тоже рабочий вектор: часть систем сравнивает пути с учётом регистра, часть — без. Если правило авторизации написано с учётом регистра, а маршрутизация — без, строки /v1/Accounts и /v1/accounts снова расходятся в трактовке.
| Вариант пути | Риск расхождения |
|---|---|
| Слэш на конце | Высокий — частый источник реальных обходов |
| Двойной слэш | Средний — зависит от того, где происходит нормализация |
| Процентное кодирование разделителя | Высокий — декодирование может происходить в разных точках |
| Регистр символов | Низкий на большинстве платформ, но стоит проверить явно |
Миграция между версиями платформы или типами шлюза — отдельный повод перепроверить нормализацию путей целиком, а не выборочно. Документация провайдера может не акцентировать разницу в поведении между версиями явно, особенно если синтаксис конфигурации выглядит похожим.
Жадное сопоставление и catch-all маршруты
Отдельная категория риска — маршруты-перехватчики, которые ловят всё, что не подошло явным правилам. Такой маршрут часто существует для служебных целей: отдать аккуратную ошибку 404 или простой ответ для проверки доступности сервиса. Если этот маршрут настроен без проверки авторизации — а для health-check она действительно обычно не нужна — важно убедиться, что под него не попадают пути, которые на самом деле должны были дойти до защищённой интеграции.
Жадное сопоставление по префиксу усугубляет это: путь, который «почти» совпал с защищённым маршрутом, но из-за лишнего символа не прошёл точное правило, может скатиться в catch-all или в соседний маршрут с другим контекстом авторизации. Условный пример: обработчик для /v1/accounts ожидает идентификатор пользователя из контекста авторизатора, но путь /v1/accounts/ после перезаписи приходит в ту же интеграцию уже без этого контекста — и обработчик либо должен сам отвергнуть запрос, либо, если проверки нет, выполнит его с пустым или дефолтным идентификатором.
Стоит также проверять поведение системы при отсутствии маршрута вовсе: возвращает ли она единообразный ответ без утечки информации о внутренней структуре API, или различается в зависимости от того, насколько путь был близок к существующему маршруту. Разница в таких ответах иногда сама по себе выдаёт структуру системы.
Как тестировать нормализацию путей
Нормализацию путей стоит проверять отдельным, целенаправленным набором запросов, а не надеяться, что обычные функциональные тесты её покроют заодно.
- Для каждого защищённого маршрута проверьте явно: без слэша, со слэшем, с двойным слэшем.
- Проверьте процентное кодирование разделителя пути там, где оно синтаксически допустимо.
- Проверьте запрос с изменённым регистром пути, если платформа это разрешает.
- Проверьте, что ответ без авторизации (без заголовка или с невалидным токеном) одинаков для всех вариантов пути выше.
- Отдельно проверьте catch-all и health-check маршруты — не попадают ли под них защищённые пути.
Любой путь, который «почти» совпадает с защищённым маршрутом, нужно явно проверить без авторизации. Если ответ отличается от строгого отказа — это сигнал, а не мелочь.
Такой же принцип «проверяй расхождение между компонентами, а не доверяй одному из них» применим и к инфраструктурным секретам — например, к тому, как разбирается материал про хранение состояния Terraform.
Команды, которые проводят регулярные пентесты или программы поиска уязвимостей за вознаграждение, часто находят именно такие расхождения первыми — не потому что ищут что-то экзотическое, а потому что систематически перебирают варианты написания одного и того же пути, которые штатное тестирование обычно не покрывает.
Читайте такжеСекреты в Terraform state: как хранить состояние безопасноЧто из этого переносится в ревью кода
В ревью пул-реквестов с изменениями в маршрутизации или авторизации стоит держать в чеклисте отдельный пункт про нормализацию пути: не полагается ли проверка прав на то, что путь придёт в одном-единственном виде. Особенно это важно при миграции между типами шлюзов или версиями платформы — правила сопоставления путей у них могут незаметно отличаться, даже если синтаксис конфигурации выглядит одинаково.
Если команда внедряет автоматические инструменты ревью, включая ИИ-агентов, которые пишут или проверяют инфраструктурный код, стоит явно указать такие пограничные случаи в правилах проверки — иначе шанс, что агент их заметит сам, не выше, чем у человека, который торопится. Подробнее о рисках автоматизации в этой зоне — в материале о модели угроз для ИИ-агентов в разработке.
В конечном счёте нормализация путей — частный случай более общего правила: любые два компонента системы, которые принимают решения на основе одной и той же строки, должны либо использовать общий код нормализации, либо явно согласовывать свои правила между собой, а не полагаться на то, что совпадение произойдёт само.
Частые вопросы
Почему слэш на конце пути вообще может что-то менять?
Потому что маршрутизация и проверка авторизации — часто разные компоненты шлюза, и они не обязаны одинаково трактовать один и тот же символ. Если нормализация происходит после авторизации, а не до неё, два шага смотрят на разные версии пути.
Достаточно ли одного фреймворка, чтобы не думать об этой проблеме?
Нет. Даже внутри одной платформы разные типы шлюзов и версии API могут по-разному сопоставлять пути с правилами. Нормализацию стоит тестировать явно для конкретной конфигурации, а не полагаться на предположения о поведении фреймворка.
Что делать с catch-all маршрутом, если он нужен для health-check?
Оставить его без авторизации можно, но нужно убедиться, что под него не попадают по ошибке защищённые пути из-за жадного сопоставления префиксов. Это проверяется отдельным тестом с «почти совпадающими» путями.
Как регистр символов влияет на безопасность API?
Если одна часть системы сравнивает пути с учётом регистра, а другая — без, запрос с изменённым регистром может попасть в маршрут, для которого проверка прав писалась для другой строки. Риск ниже, чем у слэшей, но стоит проверить явно.
Разбор подготовлен редакцией Vechron по открытым источникам. Нашли неточность — напишите нам.




