Skip to content

Commit c1ed04b

Browse files
bitsandfoxesbruno-garciacoolguyzone
authored
feat(.NET): Added obfuscation to troubleshooting (#12272)
* added obfuscation to troubleshooting * Update docs/platforms/dotnet/common/troubleshooting.mdx Co-authored-by: Bruno Garcia <[email protected]> * Update docs/platforms/dotnet/common/troubleshooting.mdx Co-authored-by: Bruno Garcia <[email protected]> * Apply suggestions from code review Co-authored-by: Alex Krawiec <[email protected]> * Update docs/platforms/dotnet/common/troubleshooting.mdx --------- Co-authored-by: Bruno Garcia <[email protected]> Co-authored-by: Alex Krawiec <[email protected]>
1 parent c06acb9 commit c1ed04b

File tree

1 file changed

+15
-0
lines changed

1 file changed

+15
-0
lines changed

docs/platforms/dotnet/common/troubleshooting.mdx

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -64,4 +64,19 @@ Additionally, if you were using an async main, associated transactions might not
6464
These issues have been fully resolved as of version 3.31.0 of the Sentry .NET SDK. To safely use an async main, update your version to the newest release.
6565
It's no longer required to dispose of the result of calling `SentrySdk.Init`.
6666

67+
## Obfuscated Code and Stack Traces
68+
69+
70+
It's important to define what obfuscation means. If you're getting illegible stack traces because of missing [debug files](/platforms/dotnet/data-management/debug-files/), all you need to do is enabling debug file upload, which is done automatically by the [Sentry SDK via MSBuild](/platforms/dotnet/guides/aspnet/configuration/msbuild/).
71+
72+
Some custom tools obfuscate .NET Intermediate Language (IL) in order to make apps harder to reverse-engineer; Sentry does not currently support these tools. This is because each obfuscator uses its own custom logic when dealing with deobfuscation, making it impractical to implement universal support.
73+
74+
If you're working with obfuscated code, you have several options:
75+
76+
1. **Use a proxy service**: You can route exceptions through your own web service proxy where you can deobfuscate the stack traces before sending them to Sentry. This gives you full control over the deobfuscation process.
77+
78+
2. **Preserve method names**: Many obfuscation tools allow you to disable method name obfuscation while still obfuscating the code inside methods. This approach results in more readable stack traces while maintaining code protection. Configure your obfuscator to preserve method names if this balance of readability and security meets your needs.
79+
80+
3. **Contribute to Symbolic**: [Our symbolication library is open source](https://github.com/getsentry/symbolic). You could create a ticket to discuss adding support to it with the maintainers.
81+
6782
<PlatformContent includePath="troubleshooting" />

0 commit comments

Comments
 (0)