Security
CORS, Cookies, and Headers
Worker-level CORS and security header behavior for partners-api consumers.
First created Last updated
End-to-end developer runbook
- Step 1 - Confirm the API area: Identify the product area, route module, endpoint path, and consumer before writing or calling code.
- Step 2 - Read the endpoint contract: Check method, auth, parameters, response, errors, side effects, and related docs.
- Step 3 - Prepare authentication and input: Use the right session, bearer token, webhook secret, or internal header. Validate body and query data before sending it.
- Step 4 - Make the request: Call the endpoint from the correct origin and environment. Keep credentials and secrets out of logs.
- Step 5 - Verify response, side effects, and records: Confirm status code, response shape, database records, external side effects, and audit evidence.
- Step 6 - Add tests, docs, and handoff notes: Update route inventory, consumer notes, and certification checks before depending on the change.
Worker CORS behavior
- Action 1 - Origin selection:
ALLOWED_ORIGINmay contain comma-separated origins. The Worker chooses the request origin when it is allowed, otherwise the first configured origin. - Action 2 - Local allowances: Local request URLs add
http://127.0.0.1:4321,http://localhost:4321,http://127.0.0.1:4322, andhttp://localhost:4322. - Action 3 - Allowed headers:
Authorization,Content-Type,X-Test-Control-Secret,X-Test-Run-Id, andX-Test-Rego-User-Id. - Action 4 - Allowed methods:
GET,POST,PUT,PATCH,DELETE, andOPTIONS. - Action 5 - Credentials: CORS is configured with credentials enabled.
Security headers
| Header | Value |
|---|---|
X-Content-Type-Options | nosniff |
X-Frame-Options | DENY |
Referrer-Policy | strict-origin-when-cross-origin |
X-XSS-Protection | 0 |