Skip to content

Commit 069e7d0

Browse files
authored
Document how X-Sentry-Token re: source maps (#901)
Refs #705
1 parent f162c9e commit 069e7d0

File tree

1 file changed

+7
-0
lines changed

1 file changed

+7
-0
lines changed

docs/sourcemaps.rst

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -128,6 +128,13 @@ For these reasons, it is recommended to upload source maps to Sentry beforehand
128128

129129
While the recommended solution is to upload your source artifacts to Sentry, sometimes it’s necessary to allow communication from Sentry’s internal IPs. For more information on Sentry’s public IPs, :ref:`ip-ranges`.
130130

131+
.. admonition:: Secure Access to Source Maps
132+
133+
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"
134+
option in your project settings. This will cause outbound requests from Sentry's servers to URLs originating from your "Allowed Domains" to have
135+
the HTTP header "X-Sentry-Token: {token}" appended, where {token} is a secure value you define. You can then configure your web server to allow access to your source maps when
136+
this header/token pair is present. You can alternatively override the default header name (X-Sentry-Token) and use HTTP Basic Authentication, e.g. by passing "Authorization: Basic {encoded_password}".
137+
131138
Uploading Source Maps to Sentry
132139
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
133140

0 commit comments

Comments
 (0)