← Документация WAF / tools / scrape-shield

Email Address Obfuscation

При включении Cloudflare Email Address Obfuscation адреса электронной почты на вашей веб-странице будут скрыты от ботов, оставаясь видимыми для людей. Для посетителей ваш сайт визуально никак не меняется.

Предыстория

Сборщики email-адресов и другие боты рыщут по интернету в поисках адресов электронной почты для пополнения спам-списков. В результате объём нежелательной почты постоянно растёт.

Веб-администраторы придумали хитрые способы защиты, записывая email-адреса, например help [at] cloudflare [dot] com или используя встроенные изображения адреса электронной почты. Однако при этом теряется удобство перехода по клику для автоматической отправки письма. При включении Cloudflare Email Address Obfuscation адреса электронной почты на вашей веб-странице будут скрыты (обфусцированы) от ботов, оставаясь видимыми для людей. Для посетителей ваш сайт визуально никак не меняется.

Как это работает

Когда включена Email Address Obfuscation, Cloudflare заменяет видимые адреса электронной почты в вашем HTML ссылками вида [email protected]. Если посетитель видит этот обфусцированный формат, он может нажать на ссылку, чтобы увидеть настоящий адрес электронной почты. Такой подход не позволяет ботам собирать адреса, сохраняя их доступными для реальных пользователей.

Cloudflare внедряет небольшой скрипт декодирования (email-decode.min.js) на страницу с помощью defer (атрибут). Это означает, что скрипт не блокирует отрисовку страницы: он загружается параллельно с разбором HTML и выполняется после полного разбора документа. Если у вас есть собственный JavaScript, работающий с обфусцированными элементами email-адресов, учтите, что скрипт декодирования выполняется до DOMContentLoaded (событие).

Изменение настройки Email Address Obfuscation

Cloudflare автоматически включает обфускацию email-адресов при регистрации.

Чтобы отключить Email Address Obfuscation в дашборде:

В панели управления Cloudflare перейдите в раздел Security Settings .
Перейдите в Settings ↗
(Необязательно) Отфильтруйте по Злоупотребления на стороне клиента.
Для Email Address Obfuscation, переведите переключатель в положение Off.

Чтобы отключить Email Address Obfuscation через API, отправьте PATCH запрос с email_obfuscation в качестве имени настройки в пути URI, а value (параметр) со значением "off".

Запрет обфускации email со стороны Cloudflare

Чтобы Cloudflare не обфусцировал определённые адреса электронной почты, вы можете:

Добавьте следующий комментарий в HTML-код страницы:
```
[email protected]
```
Возвращайте email-адреса в формате JSON для AJAX-вызовов, убедившись, что ваш веб-сервер возвращает тип содержимого application/json.
Отключите функцию Email Obfuscation, создав правило конфигурации для применения к конкретной конечной точке.

Устранение неполадок обфускации email

Чтобы избежать неожиданного поведения сайта, email-адреса не обфусцируются, когда они встречаются в:

Любой атрибут HTML-тега, кроме href атрибут элемента a .
Другие HTML-теги:
- <script></script>
- <noscript></noscript>
- <textarea></textarea>
- <xmp></xmp>
- <head></head>
Любая страница, у которой MIME-тип отличается от text/html или application/xhtml+xml.