Технологии

Нормализация путей в API-шлюзах: где ломается авторизация

Один лишний символ в пути запроса может развести проверку доступа и реальный маршрут в разные стороны. Разбираем механику и способы тестирования.

Редакция Vechron9 минобновлено 12 ноября 2026
Нормализация путей в API-шлюзах: где ломается авторизация
1 символслэш на конце пути сменил 401 на 200
12 000 $вознаграждение за обход авторизации через слэш
2 слоямаршрутизация и авторизация решают независимо

Коротко

  • Проверка авторизации и маршрутизация запроса — часто два разных компонента, которые не обязаны одинаково трактовать путь.
  • Слэш на конце, двойной слэш, процентное кодирование и регистр символов — классические источники расхождения.
  • Жадное сопоставление префиксов в шлюзе может пропускать запрос дальше, теряя контекст авторизации по пути.
  • Тестировать нормализацию нужно отдельным набором запросов, а не полагаться на то, что фреймворк «сам разберётся».

Почему путь можно трактовать по-разному

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, или различается в зависимости от того, насколько путь был близок к существующему маршруту. Разница в таких ответах иногда сама по себе выдаёт структуру системы.

Как тестировать нормализацию путей

Нормализацию путей стоит проверять отдельным, целенаправленным набором запросов, а не надеяться, что обычные функциональные тесты её покроют заодно.

  1. Для каждого защищённого маршрута проверьте явно: без слэша, со слэшем, с двойным слэшем.
  2. Проверьте процентное кодирование разделителя пути там, где оно синтаксически допустимо.
  3. Проверьте запрос с изменённым регистром пути, если платформа это разрешает.
  4. Проверьте, что ответ без авторизации (без заголовка или с невалидным токеном) одинаков для всех вариантов пути выше.
  5. Отдельно проверьте catch-all и health-check маршруты — не попадают ли под них защищённые пути.
Любой путь, который «почти» совпадает с защищённым маршрутом, нужно явно проверить без авторизации. Если ответ отличается от строгого отказа — это сигнал, а не мелочь.

Такой же принцип «проверяй расхождение между компонентами, а не доверяй одному из них» применим и к инфраструктурным секретам — например, к тому, как разбирается материал про хранение состояния Terraform.

Команды, которые проводят регулярные пентесты или программы поиска уязвимостей за вознаграждение, часто находят именно такие расхождения первыми — не потому что ищут что-то экзотическое, а потому что систематически перебирают варианты написания одного и того же пути, которые штатное тестирование обычно не покрывает.

Читайте такжеСекреты в Terraform state: как хранить состояние безопасно

Что из этого переносится в ревью кода

В ревью пул-реквестов с изменениями в маршрутизации или авторизации стоит держать в чеклисте отдельный пункт про нормализацию пути: не полагается ли проверка прав на то, что путь придёт в одном-единственном виде. Особенно это важно при миграции между типами шлюзов или версиями платформы — правила сопоставления путей у них могут незаметно отличаться, даже если синтаксис конфигурации выглядит одинаково.

Если команда внедряет автоматические инструменты ревью, включая ИИ-агентов, которые пишут или проверяют инфраструктурный код, стоит явно указать такие пограничные случаи в правилах проверки — иначе шанс, что агент их заметит сам, не выше, чем у человека, который торопится. Подробнее о рисках автоматизации в этой зоне — в материале о модели угроз для ИИ-агентов в разработке.

В конечном счёте нормализация путей — частный случай более общего правила: любые два компонента системы, которые принимают решения на основе одной и той же строки, должны либо использовать общий код нормализации, либо явно согласовывать свои правила между собой, а не полагаться на то, что совпадение произойдёт само.

Частые вопросы

Почему слэш на конце пути вообще может что-то менять?

Потому что маршрутизация и проверка авторизации — часто разные компоненты шлюза, и они не обязаны одинаково трактовать один и тот же символ. Если нормализация происходит после авторизации, а не до неё, два шага смотрят на разные версии пути.

Достаточно ли одного фреймворка, чтобы не думать об этой проблеме?

Нет. Даже внутри одной платформы разные типы шлюзов и версии API могут по-разному сопоставлять пути с правилами. Нормализацию стоит тестировать явно для конкретной конфигурации, а не полагаться на предположения о поведении фреймворка.

Что делать с catch-all маршрутом, если он нужен для health-check?

Оставить его без авторизации можно, но нужно убедиться, что под него не попадают по ошибке защищённые пути из-за жадного сопоставления префиксов. Это проверяется отдельным тестом с «почти совпадающими» путями.

Как регистр символов влияет на безопасность API?

Если одна часть системы сравнивает пути с учётом регистра, а другая — без, запрос с изменённым регистром может попасть в маршрут, для которого проверка прав писалась для другой строки. Риск ниже, чем у слэшей, но стоит проверить явно.

Разбор подготовлен редакцией Vechron по открытым источникам. Нашли неточность — напишите нам.

Главное — без шума

Новости о технологиях, безопасности, бизнесе и праве с первоисточником и разбором.

Свежие новостиRSS-лента
Свежее в RSS