Вимкнення Encrypted Client Hello (ECH)

Вимкнення Encrypted Client Hello (ECH)

Навіщо вимикати ECH?

Роскомнагляд заблокував технологію Encrypted Client Hello (ECH), що викликало проблеми для користувачів Cloudflare в Росії. Більше того, Cloudflare примусово активував цю технологію для всіх користувачів, включаючи тих, хто знаходиться на безкоштовному тарифі.

У цьому гайді ми розберемо, як вимкнути ECH для вашого домену через Cloudflare API.

Для користувачів з Росії: Вимкнення ECH може бути необхідним для забезпечення доступності вашого сайту для російських користувачів через блокування цієї технології Роскомнаглядом.

Крок 1: Перевірка увімкнення ECH

Перш ніж вимикати ECH, перевірте, чи увімкнений він для вашого домену. Це можна зробити за допомогою запиту до Google Public DNS:

  1. Перейдіть за наступним посиланням, замінивши [ВАШ_ДОМЕН] на ім’я вашого домену:
https://dns.google/resolve?name=[ВАШ_ДОМЕН]&type=HTTPS
  1. Якщо в результатах видно, що ECH активний, переходьте до наступного кроку.

Приклад: Для домену example.com посилання буде виглядати так:

https://dns.google/resolve?name=example.com&type=HTTPS

Крок 2: Отримання даних для Cloudflare API

Для взаємодії з API вам знадобляться два ключові елементи:

Global API Key

  1. Перейдіть на сторінку профілю Cloudflare
  2. Знайдіть розділ з вашим Global API Key та скопіюйте ключ
Важливо: Global API Key дає повний доступ до вашого акаунту. Ніколи не діліться ним з третіми особами та зберігайте в безпечному місці!

Zone ID

  1. Зайдіть до панелі керування вашим доменом у Cloudflare
  2. Прокрутіть сторінку вниз у правій колонці
  3. Скопіюйте значення Zone ID
Zone ID — це унікальний ідентифікатор вашого домену в системі Cloudflare.

Крок 3: Вимкнення ECH через Cloudflare API

Спосіб 1: Використання команди curl

Для вимкнення ECH виконайте наступну команду в терміналі, замінивши {ID_ZONE}, {ACCOUNT_EMAIL} та {GLOBAL_API_KEY} на ваші дані:

curl -X PATCH "https://api.cloudflare.com/client/v4/zones/{ID_ZONE}/settings/ech" \
     -H "X-Auth-Email: {ACCOUNT_EMAIL}" \
     -H "X-Auth-Key: {GLOBAL_API_KEY}" \
     -H "Content-Type: application/json" \
     --data '{"id":"ech","value":"off"}'

Приклад:

curl -X PATCH "https://api.cloudflare.com/client/v4/zones/abc123def456/settings/ech" \
     -H "X-Auth-Email: [email protected]" \
     -H "X-Auth-Key: c2547eb745079dac9320b638f5e225cf483cc5cfdda41" \
     -H "Content-Type: application/json" \
     --data '{"id":"ech","value":"off"}'
При успішному виконанні ви отримаєте JSON-відповідь з підтвердженням зміни налаштування.

Спосіб 2: Використання Postman

Ви можете виконати цей запит через Postman, дотримуючись інструкцій:

1. Налаштування запиту

  • Метод: PATCH
  • URL:
https://api.cloudflare.com/client/v4/zones/{ID_ZONE}/settings/ech

2. Налаштування Headers

У розділі Headers додайте наступні поля:

Key Value
X-Auth-Email ваш email-адрес Cloudflare
X-Auth-Key ваш Global API Key
Content-Type application/json

3. Налаштування Body

У розділі Body виберіть raw та JSON, потім введіть:

{
  "id": "ech",
  "value": "off"
}

4. Відправка запиту

Натисніть кнопку Send та дочекайтеся відповіді від сервера.


Спосіб 3: У випадку з платним тарифом

Якщо ви використовуєте платний тариф Cloudflare, вимкнути ECH можна через інтерфейс панелі керування:

  1. Перейдіть до розділу SSL/TLS
  2. Відкрийте вкладку Edge Certificates
  3. Знайдіть налаштування Encrypted ClientHello (ECH)
  4. Встановіть значення Disabled
Зверніть увагу: Ця опція доступна тільки для користувачів платних тарифів (Pro, Business, Enterprise).

Перевірка результату

Після вимкнення ECH рекомендується перевірити зміни:

  1. Зачекайте 5-10 хвилин для застосування налаштувань
  2. Знову виконайте перевірку через Google Public DNS (Крок 1)
  3. Перевірте доступність вашого сайту для користувачів з Росії
Готово! ECH тепер вимкнений для вашого домену, і сайт має бути доступний для російських користувачів.

Можливі проблеми та рішення

Помилка аутентифікації

Проблема: Отримуєте помилку Authentication error або Invalid credentials

Рішення:

  • Перевірте правильність email-адреси
  • Переконайтеся, що скопіювали Global API Key повністю
  • Перевірте, що не додали зайві пробіли при копіюванні

Помилка Zone ID

Проблема: Отримуєте помилку Zone not found

Рішення:

  • Переконайтеся, що Zone ID скопійований правильно
  • Перевірте, що використовуєте Zone ID саме того домену, який хочете змінити

ECH не вимикається

Проблема: Після виконання команди ECH залишається увімкненим

Рішення:

  • Зачекайте 10-15 хвилин для застосування змін
  • Очистіть DNS-кеш на вашому пристрої
  • Повторіть запит до API

Додаткові ресурси

Потрібна допомога? Якщо у вас виникли складнощі з вимкненням ECH, зверніться до підтримки Cloudflare або на форуми спільноти.