Перейти к основному содержимому

Белый список для WAF и файрвола

PingZen идентифицирует себя через заголовки User-Agent и X-PingZen-Check. Используйте это руководство, чтобы добавить запросы мониторинга PingZen в белый список вашего файрвола или WAF.

Как PingZen идентифицирует себя

  1. User-Agent: PingZen/1.0 (+https://pingzen.dev/docs/bot)
  2. X-PingZen-Check: monitor_id=<ID>
  3. Документация: https://pingzen.dev/docs/bot

User-Agent:

PingZen/1.0 (+https://pingzen.dev/docs/bot) Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36
User-AgentX-PingZen-Check203.0.113.10WAF

IP-адреса чекеров

Все проверки с точек, которыми управляет PingZen — центральный сервер и наши публичные чекеры, — отправляются с этих IP-адресов. Добавьте их в белый список файрвола. Проверки с партнёрских community-чекеров здесь не перечислены.

Загружаем актуальные адреса…

API-эндпоинт для получения актуальных IP:

GET /api/v1/probe/ips

Машиночитаемый список (по адресу в строке, для программ верификации ботов и автоматизации): https://pingzen.dev/api/v1/probe/ips.txt

Cloudflare WAF

  1. Перейдите в Security → WAF → Custom Rules

  2. Создайте правило: если http.user_agent содержит “PingZen”, то Allow

    any(http.request.headers["x-pingzen-check"][*] contains "monitor_id") or (http.user_agent contains "PingZen/")
  3. Или добавьте IP-адреса из списка выше

Совет: правила по IP надёжнее, чем по User-Agent, так как заголовки можно подделать.

203.0.113.10PingZen/1.0198.51.100.7PingZen/1.0

AWS WAF

  1. Создайте IP set с IP-адресами PingZen
  2. Добавьте правило в Web ACL: если IP источника в IP set, то Allow

Другие WAF / Файрволы

Общий подход для любого файрвола или WAF:

  • Разрешить запросы с заголовком X-PingZen-Check
  • Разрешить запросы с User-Agent содержащим “PingZen”
  • Разрешить запросы с IP-адресов чекеров PingZen (самый надёжный способ)

Проверка настройки

После добавления в белый список запустите проверку из панели PingZen, чтобы убедиться, что монитор получает успешные ответы.