Зона IPv6 дозволяла обійти SSRF-фільтр Gotenberg: виправлення вийшло у 8.38.0

У версіях Gotenberg 8.31.0–8.37.0 зона в IPv6-адресі дозволяла обійти SSRF-фільтр і звернутися до локального сервісу. Виправлення випустили у версії 8.38.0.

· 4 хв читання · 4 коментарі

Користувачам 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. Зате запит має пройти перевірку там, де сервер справді збирається вийти в мережу. Красу коду це трохи псує; відповідь внутрішнього сервісу назовні псує день значно сильніше.

Джерела

Звідки новина. Текст — переказ своїми словами, факти — з джерела, думка — автора.

  1. Четыре символа мимо SSRF-фильтра: зона IPv6 и netip.Prefix.Contains в Go habr.com

Про автора

Олівер Лопеш

досвідчений бекенд-розробник

Працюю над продуктивністю вебзастосунків та інфраструктурою невеликих продуктів. Люблю інструменти, для підтримки яких не потрібен окремий фахівець.

Усі публікації автора

Бекенд 4 хв читання

У NGINX виявили дві критичні вразливості, що дають змогу виконувати код через HTTP/2

У NGINX виявили дві критичні вразливості HTTP/2, що дають змогу виконувати код на сервері без автентифікації. F5 випустила виправлення: адміністраторам слід перевірити версії та оновити вразливі екземпляри.

Бекенд 4 хв читання

Перевірка 284 сайтів Рунету виявила проблеми з поштою, DNS і захистом даних

Перевірка 284 сайтів великих російських організацій виявила проблеми з DMARC, DNS, застарілими бібліотеками та сторонніми сервісами. Автоматично виявлені проблеми потребують ручної перевірки.

Бекенд 4 хв читання

Уразливість у ядрі Linux дає змогу атакувати сервер через вхідне TCP-з’єднання

Критична помилка в ядрі Linux дає змогу атакувати сервер через вхідне TCP-з’єднання без пароля. Власникам серверів потрібно перевірити стан виправлення для свого дистрибутива й встановити оновлення.

Написати коментар

Не публікується. Надішлемо посилання, щоб підтвердити коментар.

Без посилань і реклами. Перший коментар публікується після перевірки. Надсилаючи коментар, ви погоджуєтеся з політикою конфіденційності.

  1. Додатково варто перевірити, чи клієнт після перевірки URL не робить редирект на приватну адресу: SSRF-фільтр має контролювати кожну ціль під час переходу, а не лише початковий IPv6-адрес.

    1. Тут редирект — окрема проблема, але не пояснює цей баг: зона в IPv6 ламала саму перевірку адреси ще до підключення, тож контроль переходів його не закриває.

      1. хм, я б не розділяв це так жорстко: зона могла зламати перевірку початкової адреси, але редирект на приватну ціль лишається окремим способом обійти SSRF-захист і потребує перевірки кожного переходу. Інакше виправлення саме цього бага не закриє весь ланцюжок запитів.

    2. Особливо підступно, якщо редирект веде на приватну адресу вже після початкової перевірки: URL наче безпечний, а фактичне з’єднання — ні. Фільтр має перевіряти кожну адресу в ланцюжку переходів, а ще краще — не дозволяти клієнту сліпо йти за редиректами 😅