Skip to content

docs(sourcemaps): Document token exclusion when Allowed Domains is * - #18999

Open
elramen wants to merge 1 commit into
masterfrom
elramen-allowed-domains
Open

docs(sourcemaps): Document token exclusion when Allowed Domains is *#18999
elramen wants to merge 1 commit into
masterfrom
elramen-allowed-domains

Conversation

@elramen

@elramen elramen commented Aug 10, 2026

Copy link
Copy Markdown
Member

DESCRIBE YOUR PR

After getsentry/sentry#120182, sentry no longer sends the user-provided security token to symbolicator - which uses it for sourcemap scraping - if Allowed Domains is set to *. Unfortunately, this has broken stack traces for customers without them understanding why. This change is one step towards preventing this.

Ref: INGEST-1111

IS YOUR CHANGE URGENT?

  • None: Not urgent, can wait up to 1 week+

PRE-MERGE CHECKLIST

Make sure you've checked the following before merging your changes:

  • Checked Vercel preview for correctness, including links
  • PR was reviewed and approved by any necessary SMEs (subject matter experts)
  • PR was reviewed and approved by a member of the Sentry docs team

@elramen
elramen requested review from danielsheccoury-sentry and rodolfoBee and a lite review from Copilot August 10, 2026 12:21
@linear-code

linear-code Bot commented Aug 10, 2026

Copy link
Copy Markdown

INGEST-1112

INGEST-1111

@vercel

vercel Bot commented Aug 10, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
sentry-docs Ready Ready Preview Aug 10, 2026 12:28pm
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
develop-docs Ignored Ignored Aug 10, 2026 12:28pm

Request Review

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the JavaScript sourcemaps documentation to reflect that Sentry only includes the security token header when “Allowed Domains” is not configured as a wildcard (*), helping prevent confusing source map scraping failures.

Changes:

  • Clarified when the X-Sentry-Token header is included for source map scraping requests.
  • Fixed/improved the phrasing around “Security Token” + “Allowed Domains” behavior.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

If you want to keep your source maps secret and choose not to upload your source maps directly to Sentry, you can enable the “Security Token” option in your project settings.

This will cause outbound requests from Sentry’s servers to URLs originating from your “Allowed Domains” to have the HTTP header `X-Sentry-Token` header append:
With “Security Token” enabled and “Allowed Domains” not set to `*`, outbound requests from Sentry’s servers to URLs matching “Allowed Domains” will include the HTTP header `X-Sentry-Token`:

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think it's better to lead with the limitation rather than putting it at the end in case someone doesn't read the full thing.

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