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

Email Address Obfuscation

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

Контекст

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

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

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

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

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

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

Cloudflare автоматически включает маскировку адресов электронной почты при регистрации.

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

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

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

Отключение маскировки email-адресов Cloudflare

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

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

Устранение неполадок с маскировкой email-адресов

Чтобы не нарушать ожидаемое поведение сайта, адреса электронной почты не маскируются, если они находятся в:

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