Gapotchenko.Eazfuscator.NET.SDK 2021.4.263

Overview

Software Development Kit (SDK) for Eazfuscator.NET provides programmatic access to specific features of the product.

The SDK can be employed for various applications such as logging, diagnostics, data collection, automated error reporting et cetera.

How to Use

Symbol Decoder

Say you have an obfuscated stack trace or a log file and want to decode it, provided that you have a proper secret knowledge (password) at hand. Here is how it can be achieved in code:

using Gapotchenko.Eazfuscator.NET.SDK;

string stackTrace = SymbolDecoder.Decode("<obfuscated stack trace>", "secret-password");
Console.WriteLine(stackTrace);

SymbolDecoder.Decode is a static function that covers the most common usage scenario. It is simple but you may need more. For example, stack trace decoding does take some time and you may prefer to use the cancellable variant:

stackTrace = SymbolDecoder.Decode("<obfuscated stack trace>", "secret-password", cancellationToken);

Or if you need to decode a multitude of stacks/files with the same password, the simplest variant of SymbolDecoder.Decode may put you into trouble because it performs key derivation operation each and every time the function is called. And it tends to be relatively slow, as the key derivation function has to be computationally intensive to deter brute-force attacks on a secret.

To overcome that inherent performance bottleneck, symbol decoder can be created beforehand and then reused multiple times with a great efficiency:

using Gapotchenko.Eazfuscator.NET.SDK;

// Create symbol decoder beforehand. The creation operation is on a slower side.
using var decoder = SymbolDecoder.Create("secret-password");

// Reuse the decoder multiple times. Consequent decoding operations are fast.
stackTrace = decoder.Decode("<obfuscated stack trace 1>");  
stackTrace = decoder.Decode("<obfuscated stack trace 2>");  
// ...
stackTrace = decoder.Decode("<obfuscated stack trace N>");