← Browser Run / browser-run / reference
Автоматические заголовки запросов
Cloudflare автоматически добавляет заголовки к каждому запросу, отправленному через Browser Run. Благодаря этим заголовкам серверы назначения могут легко определить, что запрос пришёл от Cloudflare.
User-Agent
User-Agent по умолчанию зависит от того, как вы обращаетесь к Browser Run:
| Метод | User-Agent по умолчанию | Настраиваемый |
|---|---|---|
| Быстрые действия | Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/119.0.0.0 Safari/537.36 |
Да, с помощью userAgent параметр |
| Эндпоинт для сканирования | CloudflareBrowserRenderingCrawler/1.0 |
Нет |
| CDP (Puppeteer, Playwright) | User-Agent по умолчанию для используемой версии Chrome | Да, через настройку Puppeteer/Playwright |
Ненастраиваемые заголовки
| Header | Описание |
|---|---|
cf-brapi-request-id |
Уникальный идентификатор запроса Browser Run при использовании Быстрые действия |
cf-brapi-devtools |
Уникальный идентификатор запроса Browser Run при использовании Puppeteer, Playwright, или CDP |
cf-biso-devtools |
Флаг, указывающий, что запрос исходит от инфраструктуры рендеринга Cloudflare |
Signature-agent |
Расположение публичных ключей ботов ↗, используемая для подписи запроса и проверки, что он пришёл от Cloudflare |
Signature и Signature-input |
Цифровая подпись, используемая для проверки запросов, как показано в этот документ об архитектуре ↗ |
О Web Bot Auth
Signature заголовки используют метод аутентификации под названием Web Bot Auth. Web Bot Auth использует криптографические подписи в HTTP-сообщениях, чтобы подтвердить, что запрос отправлен автоматизированным ботом. Чтобы убедиться, что запрос действительно пришёл от Cloudflare Browser Run, используйте ключи, указанные на этот каталог ↗ чтобы проверить Signature и Signature-Input в заголовках входящего запроса. Успешная проверка подтверждает, что запрос действительно отправлен Cloudflare Browser Run и не был изменён при передаче.
Обнаружение ботов
Browser Run использует разные ID обнаружения ботов в зависимости от метода. Быстрые действия (за исключением эндпоинт crawl), Puppeteer, Playwright, а также CDP используют общий идентификатор, тогда как у эндпоинта обхода есть собственный.
| Метод | ID обнаружения ботов |
|---|---|
| Быстрые действия, Puppeteer, Playwright, CDP | 119853733 |
| Эндпоинт для сканирования | 128292352 |
Если вы сканируете собственную зону и хотите, чтобы Browser Run свободно обращался к вашему сайту без вмешательства настроек защиты от ботов, вы можете создать правило пропуска WAF, чтобы добавление Browser Run в список разрешений.