Зона IPv6 позволяла обойти SSRF-фильтр Gotenberg: исправление вышло в 8.38.0
В версиях Gotenberg 8.31.0–8.37.0 зона в IPv6-адресе позволяла обойти SSRF-фильтр и обратиться к локальному сервису. Исправление выпустили в версии 8.38.0.
Пользователям Gotenberg версий 8.31.0–8.37.0 стоит обновиться до 8.38.0: зона в IPv6-адресе позволяет обойти SSRF-фильтр. Как пишет Хабр, описание уязвимости CVE-2026-126799 опубликовали 11 ноября. Gotenberg превращает HTML и офисные документы в PDF; в затронутых версиях запрос с особым адресом мог дойти до локального сервиса, хотя фильтр должен был его остановить.
Где зона сбивает проверку адреса
Зона в IPv6-адресе нужна, чтобы указать сетевой интерфейс для link-local адресов: например, fe80::1%eth0. В URL знак процента кодируется, и запись превращается в http://[fe80::1%25eth0]/. Go разбирает такой URL, сохраняет зону в netip.Addr и может установить соединение. Но для адресов вне link-local диапазона зона не меняет маршрут, зато способна изменить результат проверки.
В разобранном варианте SSRF-фильтра приложение отвергает локальные адреса с помощью методов netip.Addr и списка запрещённых префиксов. Здесь важная деталь контракта библиотеки: netip.Prefix.Contains возвращает false для любого адреса с зоной. Даже если сам адрес относится к запрещённому диапазону, сравнение не сработает. Метод IsUnspecified() тоже учитывает зону при сравнении и не считает ::%1 неуказанным адресом.
При этом методы ведут себя по-разному. IsLoopback, IsPrivate и IsLinkLocalUnicast смотрят на адрес иначе и продолжают распознавать соответствующие случаи с зоной. Поэтому ::1%lo фильтр блокирует, а ::%1 пропускает. Аналогично fec0:1234::3 попадает в запрещённый префикс, но вариант fec0:1234::3%1 — уже нет. Автор получил одинаковый результат на Go 1.26.11 и 1.27.4: обновление до этих выпусков само по себе такую проверку не исправляет.
Что произошло при подключении
Для воспроизведения автор сделал сервис превью ссылок, который сначала проверяет URL, а затем загружает страницу. Рядом работал внутренний HTTP-сервис на IPv6 loopback. Прямые обращения к 127.0.0.1, localhost, [::1] и [::] проверка отклонила. Адрес http://[::%251]:9999/ прошёл фильтр: сервис превью подключился к [::1]:9999 и вернул ответ внутреннего сервиса наружу.
В том же прогоне сработали зоны lo и zzz. Последнего интерфейса в системе не существовало, но для такого адреса зона не помешала соединению. Это не означает, что приём открывает любой localhost: к сервису, привязанному только к 127.0.0.1, через [::] автор не подключился. В опыте был доступен сервис, слушавший IPv6 loopback.
Отдельно проверили запрещённые префиксы, включая NAT64 и 6to4. Старая функция пропускала адреса с зоной из этих диапазонов; фактическое подключение к сети NAT64 автор не испытывал. Это полезная граница вывода: тест классификатора показывает обход фильтра, но не доказывает доступность конкретной внутренней сети.
Что делать сервисам, принимающим URL
Для разработчиков превью ссылок, вебхуков, импорта по URL и прокси изображений исправление начинается с нормализации адреса. Перед классификацией нужно убрать зону через addr.WithZone(""): тогда проверки префиксов и IsUnspecified() получают адрес без неё. Если сервис всё равно запрещает link-local адреса, URL с зоной можно отклонять сразу. Для Gotenberg рубеж уже обозначен: уязвимые версии заканчиваются на 8.37.0, исправление есть в 8.38.0.
Но проверки перед запросом недостаточно. После неё DNS может вернуть другой адрес, а HTTP-клиент — перейти по редиректу. В примере автора дополнительная проверка в net.Dialer.Control остановила соединение, которое первоначальный фильтр разрешил. Она срабатывает при попытке подключения и тоже должна классифицировать адрес без зоны. В этой конфигурации прокси отключён: иначе проверка увидела бы адрес прокси вместо адреса цели.
Регрессионный тест стоит строить на парах адресов с зоной и без неё: :: и ::%1, адресах из запрещённых префиксов, а также IPv4-mapped IPv6. Тест функции подтверждает блокировку внутренних и допуск внешних адресов; отдельный прогон сервиса показал, что внешняя ссылка после исправления продолжает открываться. Так проверяется не только запрет, но и то, что фильтр не сломал обычный запрос.
Моё мнение
Меня здесь цепляет не экзотическая запись URL, а разница между соседними методами одной библиотеки. Один метод игнорирует зону, другой учитывает, третий не сравнивает адрес с префиксом вовсе. Код выглядит аккуратным, пока не выясняется, что его аккуратные части по-разному понимают один и тот же ввод. Отличный способ получить сюрприз без единой подозрительной конструкции.
Я бы не доверял защиту от SSRF только проверке в начале обработки URL. Нормализация, отказ от ненужных зон и контроль непосредственно при подключении выглядят менее элегантно, чем один короткий switch. Зато запросу приходится пройти проверку там, где сервер действительно собирается выйти в сеть. Красоту кода это немного портит; ответ внутреннего сервиса снаружи портит день сильнее.
Источники
Откуда новость. Текст — пересказ своими словами, факты — из источника, мнение — автора.
опытный backend-разработчик
Занимаюсь производительностью веб-приложений и инфраструктурой небольших продуктов. Люблю инструменты, которые не требуют отдельного специалиста для поддержания самого инструмента.
Все публикации автораПохожие статьи
В NGINX раскрыли две критические уязвимости с выполнением кода через HTTP/2
В NGINX обнаружили две критические уязвимости HTTP/2, позволяющие выполнить код на сервере без аутентификации. F5 выпустила исправления: администраторам нужно проверить версии и обновить затронутые экземпляры.
Проверка 284 сайтов Рунета выявила проблемы с почтой, DNS и защитой данных
Проверка 284 сайтов крупных российских организаций выявила проблемы с DMARC, DNS, устаревшими библиотеками и сторонними сервисами. Автоматические находки требуют ручной проверки.
Уязвимость в ядре Linux позволяет атаковать сервер через входящее TCP-соединение
Критическая ошибка в ядре Linux позволяет атаковать сервер через входящее TCP-соединение без пароля. Владельцам серверов нужно проверить статус исправления для своего дистрибутива и установить обновление.
Обсуждение 4
Рустам Саидов
Для сервисов, которые принимают URL, я бы отдельно проверил не только сам SSRF-фильтр, но и весь путь нормализации адреса: разбор, DNS-резолв и фактическое подключение должны опираться на одну и ту же проверенную цель. Иначе даже хороший список запрещённых диапазонов может не помочь, если между проверкой и соединением представление адреса меняется.
Вазир С.
Рустам, а как лучше на практике связать проверку и подключение, если DNS может вернуть несколько адресов? В случае с Gotenberg особенно интересно, на каком этапе отбрасывать зону в IPv6, чтобы проверялся именно тот адрес, к которому потом откроется соединение.
Оливер Лопеш Автор публикации
Зону лучше отвергать сразу после разбора URL, до DNS и любых проверок: для HTTP-запроса она здесь не нужна, а в этом кейсе меняла результат проверки адреса. DNS-ответы проверяйте все и подключайтесь только к одному из уже проверенных IP, не отдавая выбор адреса повторному резолву; иначе проверяли одну цель, а подключились к другой — классика TOCTOU, только с IPv6-зоной в роли мелкой пакости.
Рамин Алиев
Именно на границе между проверкой и connect обычно и прячется веселье: в Gotenberg зона сохранялась в `netip.Addr`, и фильтр мог увидеть не то, что потом использует сеть. Проверять нужно уже нормализованный адрес, который реально пойдёт в dialer.