← Browser Run / browser-run / reference
Automatické hlavičky požadavků
Cloudflare automaticky připojuje hlavičky ke každému požadavku odeslanému prostřednictvím Browser Run. Díky těmto hlavičkám cílové servery snadno poznají, že dané požadavky pocházejí od Cloudflare.
User-Agent
Výchozí User-Agent závisí na tom, jakým způsobem k Browser Run přistupujete:
| Metoda | Výchozí User-Agent | Přizpůsobitelné |
|---|---|---|
| Rychlé akce | Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/119.0.0.0 Safari/537.36 |
Ano, pomocí userAgent parametr |
| Endpoint pro procházení | CloudflareBrowserRenderingCrawler/1.0 |
Ne |
| CDP (Puppeteer, Playwright) | Výchozí User-Agent podkladové verze Chrome | Ano, prostřednictvím konfigurace Puppeteer/Playwright |
Nekonfigurovatelné hlavičky
| Hlavička | Popis |
|---|---|
cf-brapi-request-id |
Jedinečný identifikátor požadavku Browser Run při použití Rychlé akce |
cf-brapi-devtools |
Jedinečný identifikátor požadavku Browser Run při použití Puppeteer, Playwright, nebo CDP |
cf-biso-devtools |
Příznak označující, že požadavek pochází z vykreslovací infrastruktury Cloudflare |
Signature-agent |
Umístění veřejných klíčů bota ↗, použitý k podepsání požadavku a ověření, že pochází od Cloudflare |
Signature a Signature-input |
Digitální podpis, který slouží k ověření požadavků, jak je uvedeno v tento dokument o architektuře ↗ |
O Web Bot Auth
Signature hlavičky používají metodu ověřování zvanou Web Bot Auth. Web Bot Auth využívá kryptografické podpisy v HTTP zprávách k ověření, že požadavek pochází od automatizovaného bota. Chcete-li ověřit, že požadavek pochází z Cloudflare Browser Run, použijte klíče uvedené na tento adresář ↗ k ověření Signature a Signature-Input nalezený v hlavičkách příchozího požadavku. Úspěšné ověření prokazuje, že požadavek pochází z Cloudflare Browser Run a že s ním nebylo při přenosu manipulováno.
Detekce robotů
Browser Run používá různá ID detekce robotů v závislosti na metodě. Rychlé akce (kromě crawl endpoint), Puppeteer, Playwright, a CDP sdílejí jedno ID, zatímco koncový bod prohledávání má vlastní.
| Metoda | ID detekce robotů |
|---|---|
| Rychlé akce, Puppeteer, Playwright, CDP | 119853733 |
| Endpoint pro procházení | 128292352 |
Pokud se pokoušíte skenovat vlastní zónu a chcete, aby Browser Run mohl k vašemu webu přistupovat volně, aniž by tomu bránila konfigurace ochrany proti botům, můžete vytvořit pravidlo WAF skip rule pro přidat Browser Run na allowlist.