Skip to content

Commit de102d6

Browse files
authored
Add DSN utilization (#3123)
* add DSN utilization * remove anchor link
1 parent abe9794 commit de102d6

File tree

2 files changed

+10
-0
lines changed

2 files changed

+10
-0
lines changed

src/docs/product/sentry-basics/dsn-explainer.mdx

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,14 @@ If this value is not provided, SDKs will try to read it from the `SENTRY_DSN` en
1414

1515
If an SDK is not initialized or if it is initialized with an empty DSN, the SDK will not send any data over the network, such as captured exceptions.
1616

17+
### DSN Utilization
18+
19+
DSNs are safe to keep public because they only allow submission of new events and related event data; they do not allow read access to any information.
20+
21+
While there is a risk of abusing a DSN, where any user can send events to your organization with any information they want, this is a rare occurrence. Sentry provides controls to [block IPs](/platform-redirect/?next=/configuration/options/) and similar concerns. You can also rotate (and revoke) DSNs by navigating to _Settings > Projects > Client Keys (DSN)_.
22+
23+
If your application is shipped to client devices, if possible, we recommend having a way to configure the DSN dynamically. In an ideal scenario, you can "ship" a new DSN to your application without the customer downloading the latest version. We recognize that this may not always be practical, but we cannot offer further advice as this scenario is implementation specific.
24+
1725
### Where to Find Your DSN
1826

1927
If you forget your DSN, view _Settings -> Projects -> Client Keys (DSN)_ in [sentry.io](https://sentry.io/).

src/platforms/common/configuration/options.mdx

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,8 @@ The _DSN_ tells the SDK where to send the events. If this value is not provided,
2222

2323
In runtimes without a process environment (such as the browser) that fallback does not apply.
2424

25+
Learn more about [DSN utilization](/product/sentry-basics/dsn-explainer/#dsn-utilization).
26+
2527
</ConfigKey>
2628

2729
<ConfigKey name="stack-trace-mode" supported={["dotnet"]}>

0 commit comments

Comments
 (0)