Skip to main content

DisclaimerThis article is for educational and training orientation, we are not responsible for the misuse of the techniques and explanations mentioned in this article and/or the use of the tools mentioned/provided, also we do not assume responsibility for the actions carried out with the information of the same. Please use this information for ethical purposes.

All tools and decompilers mentioned are our own recommendations, nothing sponsored.


Why decompile .NET applications?

From ByteHide we do this article for a very simple reason, in our offices (a coworking space) there are quite a few companies that are developed in .NET.

One day at lunch I told them what we were doing and they didn’t understand anything, it turns out that they had no idea what decompilation is, they didn’t know that with a simple tool they could see, copy or modify their development.

Not in all cases you should worry, but for some of them the core of the business is the development itself and obviously it was not very funny.

I have to say that this happens in all compiled languages, but I will focus on .NET which is what we master.

What could be better than a step-by-step tutorial on how to decompile .NET applications?

In this article I am going to show basic notions about decompilation and reverse engineering, if you are interested in something more complex, do not hesitate to ask us!

There are many .NET decompilers that you can use as an alternative to DnSpy like ilspy, justDecompile telerik decompiler, jetbrains dotPeek decompiler, Spices .NET decompiler, Redgate .NET Reflector and more (you can find them for Windows, Linux or macOs).

What is decompilation in .NET?

You might know that C# is a high level programming language and it uses a combination of static and JIT compilation. This means that the code is compiled down to bytecode.

Decompilation is the reverse of compilation (I’m going to patent this great explanation).

That is, the COMPILATION is basically:

  1. You write code
  2. You push the magic compile button and it becomes an executable/file/.exe/dll… (well, it should… surely you forgot a semicolon or something like that 😪) you will also have 103 warnings ⚠, but if you don’t open your eyes, you don’t see them 🤭.

Well, decompile process is the opposite, you have an executable file, .dll, .exe…, and with a tool (decompiler) you get the original source code (in other words, the compiled code is converted into readable source code).

image 6

And is it simple?🙄

I’d say it’s easier than compiling, but let’s see how it’s done.

If you are wondering how long it takes to decompile a .NET application, too little.

How To Decompile .NET and .NET Core Applications

Let’s decompile a simple .NET application:

image 43

In order to explain it well, we will use the DnSpy C# decompiler. There are several dll decompilers and each one is good for something in particular, but DnSpy is one of the best for decompiling and debugging .NET applications.

This can be used for any type of .NET assembly. It doesn’t matter if it is an ASP.NET web application or VB.NET application or even mobile applications (apk). Anything within the .NET Framework.

When we compile our .NET Core application, we will obtain the compiled files, in the case of .NET Core the .exe file will be the executable, but it will be in charge of executing the .dll that contains the code of our application.

Ok, let’s proceed to decompile the .dll file:

image 44

To do this, all we have to do is drag it to DnSpy:

image 7

Once loaded, the original source code will be shown and we can work on it, we can analyze it, modify it, debug it, etc.

Viewing the source code of the decompiled .NET application

Once our application is decompiled, we can navigate through the source code as if it were our own project:

image 45

Debug the .NET application

This will be useful to understand how it works or to obtain some values in memory.

For example, let’s put a breakpoint before doing a subtraction:

image 46

and then we will run the application:

image 47

Here is a simple example:

image 48

This is a function that can be very useful at times, but it can also be dangerous ⚡.

Modify the code of the decompiled .NET application

We can modify and re-compile the decompiled .NET application without any problem:

image 49

We can also do it using IL code, but if we do not know it it will be much more complex.

We change that simple text:

image 50

and we compile again:

image 51

Now to save our modified application, we will give:

image 52

We will select the name of the file, its path and we will mark the following options:

image 53

and we will have our modified application:

image 54

Ok, these are simple and unimportant examples, I leave to your imagination 💭 everything that could be done with these simple tools.

Now we are going to see other types of applications, because compile process in .NET is the same, it does not matter if you use C#, VB (Visual Basic , ASP, Xamarin, Blazor, everything works in the same way, let’s see then with a Blazor application.

Decompiling a Blazor Web Application

Now we have created a sample web application with Blazor, this is the application code in visual studio:

image 55

Basically it is an application that shows the weather and we have added Dotnetsafer in the middle so that we can see it later in the decompiled application, here is the web application:

image 56

Ok, let’s get the code again.

First we will use our browser (it does not matter which one), since when loading the .NET libraries to display the application, it makes a call to obtain them.

We must enter inspection mode Ctrl + Shift + C and go to section Network, later reload the page with Ctrl + F5.

Here will be the file that contains the code of our web application:

image 57

You can also obtain all the dependencies or own .net files that are used by the application

Well, we download it and open it again with DnSpy:

image 58

Once we have the decompiled file we can do everything that I mentioned in the previous point.

Decompiling a Xamarin Mobile Application

We raised the level of difficulty a little 🧨, but the operation is still the same.

We have created a simple application for mobile devices with Xamarin, the compiled application will have the extension .APK

The first thing we will do is unzip the APK, there are tools for this, but it is not necessary, for something so simple we can use winrar, (yes, the program that never expires 🆓):

image 59

and we will copy all the files in a folder:

image 60

Inside the folder Assemblies all .NET files will be found:

image 61

Here comes the interesting thing, these files have lz4 compression, which will give us an error if we try to decompile it with DnSpy:

image 62

For this I bring a simple solution, a small Python script that will help us decompress all the .NET .dll files.

Yes, this sounds very complex, and it seems that you must be an expert:

image 8

But it really is something very simple that we will do in less than a minute.

Decompress Xamarin .NET Libraries

If you don’t have Python on your machine, install it previously.

Once we have Python (I run it from the VSCode terminal) we proceed:

Install lz4:

image 63

python -m pip install lz4 or simply pip install lz4

Use of the decompression script

import lz4.block
import sys
import struct
import os

def print_usage_and_exit():
    sys.exit("usage: py .\\decompressor.py target_path")

cwd = os.path.abspath(os.getcwd())

def decompress(filePath):
    input_filepath = filePath
    output_path = os.path.join("extracted", "");

    if(not os.path.exists(output_path)):
        os.mkdir(output_path)

    output_filepath = os.path.join(output_path, os.path.basename(filePath))
    header_expected_magic = b'XALZ'

    with open(input_filepath, "rb") as xalz_file:
        data = xalz_file.read()

        if data[:4] != header_expected_magic:
            sys.exit("The input file does not contain the expected magic bytes, aborting ...")

        header_index = data[4:8]
        header_uncompressed_length = struct.unpack('<I', data[8:12])[0]
        payload = data[12:]

        print("header index: %s" % header_index)
        print("compressed payload size: %s bytes" % len(payload))
        print("uncompressed length according to header: %s bytes" % header_uncompressed_length)

        decompressed = lz4.block.decompress(payload, uncompressed_size=header_uncompressed_length)

        with open(output_filepath, "wb") as output_file:
            output_file.write(decompressed)
            output_file.close()
        print("result written to file")

if __name__ == "__main__":
    n = 0
    for file in os.listdir(cwd):
        try:
            if(file.endswith(".dll")):
                decompress(file)
                n += 1;
        except:
            print("failed to decompress " + os.path.basename(file))

    print("\\nDecompressed ", n, " assemblies!")

The author of this script is Christian Reitter, X41 D-Sec GmbH, thank you for your article at X41 D-Sec GmbH, we have modified it to unzip all the files in the directory.

We will copy the code into a file called decompress.py and we will save it in the same path as our .dll files.

Decompress the files we need

image 64

We will do it with py .\decompressor.py .\, we’ll let it decompress all the .dll files in the directory.

In this case I am only interested in the two files corresponding to my application.

What has not been so difficult?

image 9

Now we have the files ready to open with the DnSpy dll decompiler:

image 65

Now again we can do everything I mentioned earlier, the procedure is always the same, only the way in which the files are compiled varies.

This applies to all applications under .NET, such as games developed in Unity with #, virtual reality applications and augmented reality.

Did you like this article?

It has been very simple but I consider it fine for a basic level and learn a little about these topics 😊.

If you have found it interesting, do not hesitate to support it, and tell us below 👇 if you want to know something else, like let’s talk about crackinginjection and other aspects.

Also, if you want to learn more about decompiling and reverse engineering I would recommend you to look for reverse engineering forums (yes, there are such forums).

Thank you for reading the article ❤ and remember that in ByteHide we will be uploading articles about security in relation to .NET 🛡.

Thank you for your attention, we hope you have learned a lot!

image 10
Fill out my online form.

One Comment

  • Umair says:

    Thank you for the article. I have a windows software exe. Is it in any way possible to convert it into android app?

Leave a Reply