Skip to content

docs(rum-util): add Backend CORS section to integration checklist#113

Merged
SethPaul merged 1 commit into
mainfrom
docs/rum-util-backend-cors
Jun 2, 2026
Merged

docs(rum-util): add Backend CORS section to integration checklist#113
SethPaul merged 1 commit into
mainfrom
docs/rum-util-backend-cors

Conversation

@SethPaul
Copy link
Copy Markdown
Contributor

@SethPaul SethPaul commented Jun 2, 2026

Why

hipponot/iac#358 — the @saga-ed/soa-rum-util README documents the required CSP additions but not the backend CORS allowedHeaders. That omission is what let the CORS-preflight breakage slip through when saga-dash first enabled RUM (dash.wootdev.com could no longer reach IAM).

What

Adds a "Backend CORS" step (#7) to the integration checklist, between CSP and Bootstrap:

  • The 7 Datadog tracing headers (traceparent, tracestate, x-datadog-*) that allowedTracingUrls injects on every matching cross-origin fetch, and that each backend must list in allowedHeaders.
  • Note that handlers which echo Access-Control-Request-Headers are auto-covered.
  • The validate-on-main/stable-not-previews gotcha (a preflight OPTIONS carries no cookies/custom headers, so x-saga-preview-* routing never applies — it always hits main), with a ready-to-run curl -X OPTIONS check.

Docs only.

The README documented the required CSP additions but not the backend CORS
allowedHeaders — which is what let the CORS preflight breakage slip through when
saga-dash enabled RUM. Add a 'Backend CORS' step listing the 7 Datadog tracing
headers, the echo-is-auto-covered note, and the validate-on-main-not-previews
gotcha. Re hipponot/iac#358.
@github-actions
Copy link
Copy Markdown

github-actions Bot commented Jun 2, 2026

❌ Test Results

Status Suites Tests
✅ Passed 152 382
❌ Failed 0 9
⏭️ Skipped 0 0
Total 152 391

Package Results

Package Tests Passed Failed
✅ @saga-ed/soa-core 23 23 0
✅ @saga-ed/soa-node 273 273 0
✅ @saga-ed/soa-web 17 17 0

Commits

  • Branch: 5ca8945 (docs/rum-util-backend-cors)
  • Merge: 2c0af3c

Links


Updated: 2026-06-02T15:45:23.169Z

@SethPaul SethPaul merged commit a082495 into main Jun 2, 2026
32 checks passed
@SethPaul SethPaul deleted the docs/rum-util-backend-cors branch June 2, 2026 18:54
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.

1 participant