Skip to content

Document Forwarded header support in web-bot-auth - #772

Merged
ulziibay-kernel merged 1 commit into
mainfrom
hypeship/wba-forwarded-docs
Nov 19, 2026
Merged

ulziibay-kernel merged 1 commit into
mainfrom
hypeship/wba-forwarded-docs

Conversation

@ulziibay-kernel

@ulziibay-kernel ulziibay-kernel commented Nov 19, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Adds a "Transitive trust with the Forwarded header" section to the Web Bot Auth page, matching the egress-proxy change in kernel/kernel#5629: on WBA-signed requests Kernel now forwards a client-supplied Forwarded header to the origin, and with Kernel's WBA token the header is part of the signature's covered components.

The section shows what the header is, what the signature covers in each key path (Kernel's token vs. own keys), and how to set it from automation code with CDP extra headers in TypeScript and Python. It also states that unsigned egress keeps stripping the header.

Preview: https://tbd-6fc993ce-hypeship-wba-forwarded-docs.mintlify.app/browsers/bot-detection/web-bot-auth


Note

Low Risk
Documentation-only update with no runtime or security logic changes.

Overview
Adds a Transitive trust with the Forwarded header section to the Web Bot Auth docs, aligned with Kernel egress behavior: on WBA-signed traffic, a client-set RFC 7239 Forwarded header (e.g. operator identity) is passed through to the origin instead of stripped.

The new text distinguishes KERNEL's WBA token (header in signature covered components) vs your own keys (must add forwarded to covered components), and includes TypeScript and Python examples using Playwright/CDP setExtraHTTPHeaders. It also notes that unsigned requests still strip Forwarded like other proxy-revealing headers.

Reviewed by Cursor Bugbot for commit 365bd42. Bugbot is set up for automated code reviews on this repo. Configure here.

Add a transitive trust section covering the Forwarded header: how it
reaches the origin on signed requests, what the signature covers, and
how to set it from automation code.
@mintlify

mintlify Bot commented Nov 19, 2026 •

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
Kernel 🟢 Ready View Preview Nov 19, 2026, 10:23 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

@ulziibay-kernel
ulziibay-kernel merged commit 423840c into main Nov 19, 2026
3 checks passed
@ulziibay-kernel
ulziibay-kernel deleted the hypeship/wba-forwarded-docs branch November 19, 2026 22:47

This branch was successfully deployed

1 active deployment
staging — 365bd42c Deployed Nov 19, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants