Skip to content

Commit 10d3798

Browse files
ToriLindsaykathayl
andauthored
[Browser Rendering] Add signature headers (#23323)
* [Browser Rendering] Add signature headers * rewording * Update automatic-request-headers.mdx -capitalized the signature headers -fixed link for signature agent (does not have the .well-known path) -added back in instructions on how to verify using web bot auth --------- Co-authored-by: Kathy <[email protected]>
1 parent 7370f7a commit 10d3798

File tree

1 file changed

+10
-6
lines changed

1 file changed

+10
-6
lines changed

src/content/docs/browser-rendering/reference/automatic-request-headers.mdx

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -5,15 +5,19 @@ sidebar:
55
order: 2
66
---
77

8-
When using the [REST API](/browser-rendering/rest-api/) to fetch content via Browser Rendering, Cloudflare adds the following headers to outbound requests made to the target URL:
8+
Cloudflare automatically attaches headers to every [REST API](/browser-rendering/rest-api/) request made through Browser Rendering. These headers make it easy for destination servers to identify that these requests came from Cloudflare.
9+
10+
:::note[Note]
11+
12+
These headers are meant to ensure transparency and cannot be removed or overridden (with `setExtraHTTPHeaders`, for example).
13+
14+
:::
915

1016
| Header | Description |
1117
| -------------------- | ----------------------------------------------------------------------------------- |
1218
| `cf-biso-request-id` | A unique identifier for the Browser Rendering request |
1319
| `cf-biso-devtools` | A flag indicating the request originated from Cloudflare's rendering infrastructure |
20+
| `Signature-agent` | [The location of the bot public keys](https://web-bot-auth.cloudflare-browser-rendering-085.workers.dev), used to sign the request and verify it came from Cloudflare |
21+
| `Signature` and `Signature-input`| A digital signature, used to validate requests, as shown in [this architecture document](https://datatracker.ietf.org/doc/html/draft-meunier-web-bot-auth-architecture) |
1422

15-
:::note[Note]
16-
17-
These headers are unique to Browser Rendering and are automatically included and cannot be removed or overridden (such as via `setExtraHTTPHeaders`). They are intended to ensure transparency, allowing destination servers to identify traffic as coming from Cloudflare Browser Rendering.
18-
19-
:::
23+
The `Signature` headers use an authentication method called [Web Bot Auth](/bots/concepts/bot/verified-bots/web-bot-auth/). Web Bot Auth leverages cryptographic signatures in HTTP messages to verify that a request comes from an automated bot. To verify a request originated from Cloudflare Browser Rendering, use the keys found on [this directory](https://web-bot-auth.cloudflare-browser-rendering-085.workers.dev/.well-known/http-message-signatures-directory) to verify the `Signature` and `Signature-Input` found in the headers from the incoming request. A successful verification proves that the request originated from Cloudflare Browser Rendering and has not been tampered with in transit.

0 commit comments

Comments
 (0)