Зона 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. Зате запит має пройти перевірку там, де сервер справді збирається вийти в мережу. Красу коду це трохи псує; відповідь внутрішнього сервісу назовні псує день значно сильніше.
Джерела
Звідки новина. Текст — переказ своїми словами, факти — з джерела, думка — автора.
досвідчений бекенд-розробник
Працюю над продуктивністю вебзастосунків та інфраструктурою невеликих продуктів. Люблю інструменти, для підтримки яких не потрібен окремий фахівець.
Усі публікації автораСхожі статті
У NGINX виявили дві критичні вразливості, що дають змогу виконувати код через HTTP/2
У NGINX виявили дві критичні вразливості HTTP/2, що дають змогу виконувати код на сервері без автентифікації. F5 випустила виправлення: адміністраторам слід перевірити версії та оновити вразливі екземпляри.
Перевірка 284 сайтів Рунету виявила проблеми з поштою, DNS і захистом даних
Перевірка 284 сайтів великих російських організацій виявила проблеми з DMARC, DNS, застарілими бібліотеками та сторонніми сервісами. Автоматично виявлені проблеми потребують ручної перевірки.
Уразливість у ядрі Linux дає змогу атакувати сервер через вхідне TCP-з’єднання
Критична помилка в ядрі Linux дає змогу атакувати сервер через вхідне TCP-з’єднання без пароля. Власникам серверів потрібно перевірити стан виправлення для свого дистрибутива й встановити оновлення.
Обговорення 4
Томас Янкаускас
Додатково варто перевірити, чи клієнт після перевірки URL не робить редирект на приватну адресу: SSRF-фільтр має контролювати кожну ціль під час переходу, а не лише початковий IPv6-адрес.
Іліє Негру
Тут редирект — окрема проблема, але не пояснює цей баг: зона в IPv6 ламала саму перевірку адреси ще до підключення, тож контроль переходів його не закриває.
Серджіу Ротару
хм, я б не розділяв це так жорстко: зона могла зламати перевірку початкової адреси, але редирект на приватну ціль лишається окремим способом обійти SSRF-захист і потребує перевірки кожного переходу. Інакше виправлення саме цього бага не закриє весь ланцюжок запитів.
Вазир С.
Особливо підступно, якщо редирект веде на приватну адресу вже після початкової перевірки: URL наче безпечний, а фактичне з’єднання — ні. Фільтр має перевіряти кожну адресу в ланцюжку переходів, а ще краще — не дозволяти клієнту сліпо йти за редиректами 😅