{"componentChunkName":"component---src-templates-post-template-js","path":"/magical-windbg-vol2-01-en","result":{"data":{"markdownRemark":{"id":"4ef73994-843b-57ef-87ea-eecdcdfd6c96","html":"
\n

This page has been machine-translated from the original page.

\n
\n

This chapter explains the environment setup procedure used in this book.

\n

Execution and debugging of the binaries used in this book assume that you will use a virtual machine.

\n

I recommend using Hyper-V, which is included with the Pro editions of Windows 10/11.

\n

However, even when using the Home edition of Windows 10/11, you can still create a virtual machine by using third-party virtualization applications such as VirtualBox or VMware.

\n\n

Table of Contents

\n\n

About the Environment Used in This Book

\n

The content of this book has been verified in the following environment.

\n

OS : Windows 10 Pro 22H2

\n

Because this book assumes that you will prepare a virtual machine, I recommend using a system with at least an Intel Core i3 CPU and at least 8 GB of RAM so that you can work reasonably comfortably.

\n

Create the Virtual Machine

\n

This book does not explain the detailed procedure for installing a virtual machine.

\n

If you are using Windows 10/11 Pro, Enterprise, or Education, I recommend using Hyper-V, which is available free of charge.

\n

For instructions on enabling Hyper-V and creating a virtual machine, you can follow the official documentation below.

\n
\n

Install Hyper-V on Windows 10:

\n

https://learn.microsoft.com/ja-jp/virtualization/hyper-v-on-windows/quick-start/enable-hyper-v

\n
\n

If your current OS edition is Windows 10/11 Home, you cannot use Hyper-V.

\n

In that case, you can use a virtual machine platform such as VirtualBox, which can be installed for free. (At least at the time of writing, I confirmed that the then-latest version, VirtualBox 7.0.14, could be installed on Windows 10/11 Home and used to create virtual machines. However, because that version has been reported to contain known vulnerabilities that are easy to exploit, I recommend installing the latest available version whenever possible.)

\n

VirtualBox can be installed using the installer available from the download page below.

\n
\n

Download VirtualBox:

\n

https://www.virtualbox.org/wiki/Downloads

\n
\n

To install VirtualBox 7.0.14, you also need to run vc_redist.x64.exe, which can be downloaded from the URL below, and install the latest redistributable package.

\n
\n

vc_redist.x64.exe:

\n

https://aka.ms/vs/17/release/vc_redist.x64.exe

\n
\n

Once you have prepared a virtual machine platform such as Hyper-V or VirtualBox, create a Windows 10 virtual machine.

\n

In general, regardless of which virtualization platform you use, you start by installing the OS from an ISO image file for OS installation.

\n

When setting up the Windows virtual machine used for analysis in this book, use the evaluation-version OS ISO that can be downloaded below. (Downloading it requires entering an email address and other information.)

\n

After installing the evaluation OS, you can use the full functionality of Windows 10 for 90 days after installation.

\n
\n

Windows 10 Enterprise (Evaluation):

\n

https://www.microsoft.com/ja-jp/evalcenter/evaluate-windows-10-enterprise

\n
\n

Set Up the Virtual Machine

\n

Once the virtual machine for running the program to be analyzed is ready, perform the setup needed to install the device driver and do kernel debugging.

\n

First, run the following three commands in a Command Prompt started with administrator privileges, and then reboot the OS.

\n
bcdedit /set testsigning on\nbcdedit /debug on\nbcdedit /dbgsettings serial debugport:1 baudrate:115200
\n

Running these commands enables installation of the test-signed driver 1 and kernel debugging over a COM port 2 on the target virtual machine.

\n

On systems since Windows Vista, all drivers installed on the system must have a valid signature. In particular, on systems running Windows 10 version 1607 or later, drivers must have a valid signature issued by Microsoft.3 4

\n

However, if you run bcdedit /set testsigning on on Windows to enable installation of test-signed drivers, you can install drivers signed with a test self-signed certificate or similar means.

\n

For that reason, you need to enable test-signing mode in order to install and run the kernel driver used in this book on the system.

\n

When test-signing mode is enabled on the system, “Test Mode” is displayed in the lower-right corner of the desktop, as shown below.

\n

\n \n \n \n \n \n \n \n \n

\n

Note that when test-signing mode is enabled, you can install drivers that do not have a Microsoft signature, which creates the risk that a malicious driver could be installed on the system.

\n

Therefore, be sure to enable test-signing mode only inside a virtual machine.

\n

Install WinDbg

\n

To analyze the program, install the latest version of WinDbg on your computer.

\n

Because kernel debugging will be performed, be sure to install WinDbg on the host machine that manages the virtual machine.

\n

Of course, there is no problem with also installing it inside the virtual machine for user-mode debugging.

\n

If your environment can use the WinGet package manager, you can easily install the latest WinDbg by running the following command in Command Prompt or PowerShell.

\n
winget install Microsoft.WinDbg
\n

If you cannot use the WinGet package manager, download the WinDbg installer from the URL below and install WinDbg manually.

\n
\n

Install the Windows debugger:

\n

https://learn.microsoft.com/ja-jp/windows-hardware/drivers/debugger/

\n
\n

Install Debugging Tools for Windows

\n

Next, install Debugging Tools for Windows on the machine where you will perform the analysis.

\n

Debugging Tools for Windows includes debuggers such as WinDbg Classic 5 and tools such as GFlags 6 that are useful for troubleshooting Windows environments.

\n

There are several ways to install Debugging Tools for Windows, but in this book we use the Windows SDK (10.0.22621) to install it.

\n

First, go to the Windows SDK download page at the URL below and download winsdksetup.exe from [Download the installer].

\n
\n

Windows SDK:

\n

https://developer.microsoft.com/ja-jp/windows/downloads/windows-sdk/

\n
\n

Next, double-click the downloaded winsdksetup.exe and run it.

\n

\n \n \n \n \n \n \n \n \n

\n

By following the installer’s instructions with the default settings, you will eventually reach a screen where you choose which packages to install.

\n

It does not matter which items you download here, but make sure that [Debugging Tools for Windows] is checked.

\n

\n \n \n \n \n \n \n \n \n

\n

Run the installer with [Debugging Tools for Windows] checked.

\n

After installation completes, confirm that windbg.exe and gflags.exe are present in C:\\Program Files (x86)\\Windows Kits\\10\\Debuggers\\x64.

\n

The windbg.exe that can be installed through the Windows SDK is the traditional debugger, also known as WinDbg Classic.

\n

The latest version of WinDbg and WinDbg Classic use the same debugger commands and windows, but the latest version of WinDbg provides powerful debugger features such as JavaScript debugger scripts and Time Travel Debugging (TTD).

\n

In this book, we use the latest version of WinDbg installed in the [Install WinDbg] section above rather than WinDbg Classic.

\n

Install Sysinternals Utilities

\n

Note: Sysinternals utilities are not used in this book, so installing them is optional.

\n

Next, download Sysinternals 9, which includes useful tools such as Process Monitor 7 and Process Explorer 8.

\n

This book does not go into detail about these tools.

\n

If you want to learn more, the official documentation or “Windows Sysinternals徹底解説” 10, for example, should be helpful.

\n

To install these tools all at once, visit the URL below and click [Sysinternals Suite].

\n
\n

Sysinternals Utilities:

\n

https://learn.microsoft.com/ja-jp/sysinternals/downloads/

\n
\n

By extracting the ZIP file downloaded there, you will be able to use tools such as Process Monitor and Process Explorer.

\n

Register the Symbol Server in WinDbg and Sysinternals

\n

When using WinDbg or Process Monitor (Procmon) for troubleshooting, obtaining the correct symbols is extremely important.

\n

Symbols 11 are information such as the names of functions and variables that are not included in executable files such as exe and dll files.

\n

When using tools such as WinDbg, obtaining and referencing the correct symbols makes analysis much smoother.

\n

In general, the symbol information used for analyzing dump files can be obtained from Microsoft’s public symbol server 12.

\n

However, symbol information for some non-public modules and symbol information for software independently developed by third parties cannot be downloaded from Microsoft’s public symbol server.

\n

If the program being analyzed was developed by the user, pdb or dbg files generated when the program is built can be loaded into the debugger and used as symbol information.

\n

In this section, we configure WinDbg and Process Monitor so that they can retrieve symbols from Microsoft’s public symbol server.

\n

Although this book does not use it, you may also want to apply the same configuration to Process Explorer if necessary.

\n

To configure the symbol server, start WinDbg with administrator privileges and open [File] > [Settings] > [Debugging Settings].

\n

Enter the following in [Default Symbol Path] in the window that appears, and click [OK].

\n
srv*https://msdl.microsoft.com/download/symbols
\n

\n \n \n \n \n \n \n \n \n

\n

By default, C:\\WINDOWS\\SYSTEM32\\dbghelp.dll is registered for [DbgHelp.dll path(version 6.0 or later)].

\n

However, C:\\WINDOWS\\SYSTEM32\\dbghelp.dll usually does not satisfy the requirement of version 6.0 or later, so you need to specify the path to a dbghelp.dll that does.

\n

A dbghelp.dll that meets that requirement is located directly under C:\\Program Files (x86)\\Windows Kits\\10\\Debuggers\\x64, alongside WinDbg x64 and the other tools installed in the [Install Debugging Tools for Windows] section.

\n

Therefore, specify the following path for [DbgHelp.dll path(version 6.0 or later)].

\n
C:\\Program Files (x86)\\Windows Kits\\10\\Debuggers\\x64\\dbghelp.dll
\n

Also, for [Symbol paths:], specify the same Microsoft symbol server address you used for WinDbg.

\n
srv*https://msdl.microsoft.com/download/symbols
\n

\n \n \n \n \n \n \n \n \n

\n

This completes the symbol server configuration.

\n

Install Ghidra 11.0.2

\n

Note: Ghidra 11.0.2 is not used in this book, so installing it is optional.

\n

Next, set up the reverse engineering tool Ghidra 11.0.2.

\n

This book does not explain Ghidra itself or how to use it in detail, but the built-in Help and books such as a practical guide to Ghidra 13 and a comprehensive guide to mastering Ghidra 14 should be useful references.

\n

To set up Ghidra, download the Ghidra 11.0.2 package (ghidra_11.0.2_PUBLIC_20240326.zip) from the GitHub Releases page below and extract it.

\n
\n

Ghidra Release Page:

\n

https://github.com/NationalSecurityAgency/ghidra/releases

\n
\n

Next, download the Windows x64 MSI Installer from the page below in order to install JDK 17, which is required to run Ghidra.

\n
\n

Java Downloads:

\n

https://www.oracle.com/jp/java/technologies/downloads/#jdk17-windows

\n
\n

Run the downloaded JDK 17 MSI installer and complete the installation of JDK 17.

\n

After installation is complete, launch Ghidra by double-clicking ghidraRun.bat in the extracted ghidra_11.0.2_PUBLIC_20240326.zip.

\n

\n \n \n \n \n \n \n \n \n

\n

Once Ghidra has launched, create a project with any name from [File] > [New Project].

\n

Install Binary Ninja

\n

In addition to Ghidra, there are other strong options for analyzing Windows programs, including IDA and Binary Ninja.

\n

You can install Binary Ninja by downloading the free installer from [Download For Windows] at the URL below.

\n
\n

Binary Ninja 4.0 Free:

\n

https://binary.ninja/free/

\n
\n

For instructions on installing Binary Ninja and its basic operations, please refer to the official page at the link below.

\n
\n

Binary Ninja 4.0 Getting Started:

\n

https://docs.binary.ninja/getting-started.html

\n
\n

Incidentally, if you want to learn more about how to use Binary Ninja, I personally recommend the official YouTube channel of VECTOR 35, the company behind Binary Ninja.

\n
\n

YouTube VECTOR 35:

\n

https://www.youtube.com/@Vector35

\n
\n

Install Other Analysis Tools

\n

In addition to the tools introduced so far, this book uses PEStudio for analyzing Windows programs.

\n

Although this book does not use them, PE-bear and CFF Explorer included in Explorer Suite are also convenient tools for similar purposes.

\n

I will omit the detailed setup procedure, but each tool can be downloaded from the links below.

\n
\n

PEStudio:

\n

https://www.winitor.com/download

\n
\n
\n

PE-bear:

\n

https://github.com/hasherezade/pe-bear

\n
\n
\n

Explorer Suite:

\n

https://ntcore.com/explorer-suite/

\n
\n

Prepare for Kernel Debugging with WinDbg

\n

Verify that the virtual machine configured in the [Set Up the Virtual Machine] section can be kernel-debugged over a COM port from WinDbg installed on the host machine.

\n

If you are using Hyper-V, open the settings screen for the target virtual machine, and under the hardware settings for [COM 1], change [Attachment] to [Named pipe] and set the pipe name to [com1].

\n

As shown in the screen below, it is fine as long as the value shown in [Named pipe path] is \\\\.\\pipe\\com1.

\n

\n \n \n \n \n \n \n \n \n

\n

After configuring the COM port on the virtual machine created with Hyper-V or VirtualBox, start WinDbg and attach the kernel debugger.

\n

When using the newer version of WinDbg, choose [File] > [Start Debugging] > [Attach to Kernel].

\n

Open the [Attach to Kernel] settings screen, set [Baud Rate] on the [COM] tab to 115200, and set [Port] to \\\\.\\pipe\\com1.

\n

\n \n \n \n \n \n \n \n \n

\n

When the kernel debugger is debugging the kernel of the virtual machine, the virtual machine itself stops running.

\n

For that reason, if you are connected to the virtual machine remotely using Hyper-V Enhanced Session or RDP, the screen will black out and remote access will be disconnected.

\n

When performing kernel debugging on a virtual machine built with Hyper-V, I recommend using console access with Enhanced Session disabled.

\n

If you want to resume system operation, run the g command.

\n

Perform Kernel Debugging over the Network

\n

In the previous section, we set up a kernel debugger connection that uses a COM port, but data transfer over a COM port is extremely slow even when the baud rate is set to its maximum value of 115200.

\n

You probably will not notice much delay when running ordinary debugger commands such as lm or k, but when using commands that require large amounts of data transfer, such as the .dump command 15, it can take several hours or more to finish if you are using a COM port.

\n

In such cases, I recommend setting up kernel debugging over the network instead of using a COM port.

\n

You can set up network-based kernel debugging manually, but using kdnet.exe is more reliable.16

\n

To use kernel debugging over the network, first prepare an environment where the host machine that performs debugging and the target virtual machine can communicate over IPv4.

\n

If you are using Hyper-V as the virtualization platform, it is a good idea to create an internal virtual switch from [Virtual Switch Manager], attach it to the virtual machine, and assign fixed static IPv4 addresses.

\n

In this book, I assign 192.168.50.1/25 to the host machine and 192.168.50.12/25 to the virtual machine.

\n

Once network connectivity between the host machine and the virtual machine has been established, next run Command Prompt as Administrator inside the virtual machine and execute \"C:\\Program Files (x86)\\Windows Kits\\10\\Debuggers\\x64\\kdnet.exe\".

\n

kdnet.exe is located in the folder where Debugging Tools for Windows was installed in the [Install Debugging Tools for Windows] section.

\n

\n \n \n \n \n \n \n \n \n

\n

When you run this command, you will get output containing key=<KEY string> as shown in the image above, so copy the string after key=.

\n

Next, start WinDbg on the host machine, enter the port number configured with kdnet.exe and the copied string after key= into [Port number] and [Key] on the [Net] tab of [Attach to Kernel], and click [OK].

\n

\n \n \n \n \n \n \n \n \n

\n

In this state, if you reboot the virtual machine that was configured with kdnet.exe, WinDbg on the host machine will attach to the kernel of the virtual machine over the network, and network-based kernel debugging becomes possible.

\n

\n \n \n \n \n \n \n \n \n

\n

If network-based kernel debugging does not work properly, check the network connectivity between the host machine and the virtual machine, and also confirm whether communication by WinDbg is allowed through Microsoft Defender Firewall on the host machine.

\n

Download the Target Programs

\n

Download the DoP programs analyzed in this book from the release page below.

\n

In this book, the goal is to analyze these DoP programs and identify two Flags.

\n

The Flag format is ^FLAG\\{[\\x20-\\x7E]+\\}$.

\n
\n

DoP -The dream of a pumpkin-:

\n

https://github.com/kash1064/ctf-and-windows-debug/releases/tag/v1.0/

\n
\n

From the release page, you can download the following two files.

\n
DoPClient.exe(SHA256:59D52D6AF3479A75B21784916B8C73396971E75142A1AF0C0900C843E4491710)\n\nDoPDriver.sys(SHA256:4C2F4F26A8F19083CE699B83F91C4430D03EB62DDECA509A16E66FCD7FE46D3D)
\n

Please copy the two downloaded files into the same folder inside the virtual machine that you created for debugging.

\n

Note that in most CTF challenges, symbol files used for analyzing the target, such as PDB files, are not provided.

\n

Even when debugging is done for troubleshooting rather than for a CTF, it is rare to be able to obtain the proper symbol files unless the reader is directly involved in developing that software.

\n

For that reason, this book also debugs unknown files without symbol files.

\n

Analyzing an unknown program without symbol files using only WinDbg is extremely difficult, but you can debug efficiently by combining it with analysis tools such as IDA, Ghidra, and Binary Ninja.

\n

Incidentally, these tools also include debugging features, so it is not strictly necessary to use WinDbg.

\n

However, powerful features such as automating debugger operations with scripts, as used in this book, are not available in the free editions of IDA or Binary Ninja, where functionality is limited.

\n

In this book, I therefore use WinDbg, which offers full functionality including these advanced features, to analyze the user-mode program and the kernel driver.

\n

To run the DoP programs, depending on your environment you may need to install the latest redistributable package beforehand by running vc_redist.x64.exe, which can be downloaded from the URL below.

\n
\n

vc_redist.x64.exe:

\n

https://aka.ms/vs/17/release/vc_redist.x64.exe

\n
\n\n\n
\n
\n
    \n
  1. \n

    Enable Loading of Test-Signed Drivers https://learn.microsoft.com/ja-jp/windows-hardware/drivers/install/the-testsigning-boot-configuration-option

    \n↩\n
    2. \n
  2. \n

    Setting Up Kernel-Mode Debugging of a Virtual Machine Manually using a Virtual COM Port https://learn.microsoft.com/ja-jp/windows-hardware/drivers/debugger/attaching-to-a-virtual-machine—kernel-mode-

    \n↩\n
    3. \n
  3. \n

    Signing a Driver https://learn.microsoft.com/ja-jp/windows-hardware/drivers/develop/signing-a-driver

    \n↩\n
    4. \n
  4. \n

    Driver Signing Policy https://learn.microsoft.com/ja-jp/windows-hardware/drivers/install/kernel-mode-code-signing-policy—windows-vista-and-later-

    \n↩\n
    5. \n
  5. \n

    What is WinDbg? https://learn.microsoft.com/ja-jp/windows-hardware/drivers/debugger/windbg-overview?source=recommendations

    \n↩\n
    6. \n
  6. \n

    GFlags https://learn.microsoft.com/ja-jp/windows-hardware/drivers/debugger/gflags

    \n↩\n
    7. \n
  7. \n

    Process Monitor https://learn.microsoft.com/ja-jp/sysinternals/downloads/procmon

    \n↩\n
    8. \n
  8. \n

    Process Explorer https://learn.microsoft.com/ja-jp/sysinternals/downloads/process-explorer

    \n↩\n
    9. \n
  9. \n

    Sysinternals https://learn.microsoft.com/ja-jp/sysinternals

    \n↩\n
    10. \n
  10. \n

    Windows Sysinternals徹底解説 : 無償ツールで極めるトラブルシューティングテクニック (Mark E. Russinovich・Aaron Margosis 著 / 山内 和朗 訳 / 日経BP社 / 2017 年)

    \n↩\n
    11. \n
  11. \n

    Symbols and Symbol Files https://learn.microsoft.com/ja-jp/windows-hardware/drivers/debugger/symbols-and-symbol-files

    \n↩\n
    12. \n
  12. \n

    Using a Symbol Server https://learn.microsoft.com/ja-jp/windows-hardware/drivers/debugger/using-a-symbol-server

    \n↩\n
    13. \n
  13. \n

    Reverse Engineering Tool Ghidra Practical Guide: From Security Contest Basics to Malware Analysis (Shota Nakajima, Yasukazu Kotake, Hiroaki Hara, Kohei Kawabata / Mynavi Publishing / 2020)

    \n↩\n
    14. \n
  14. \n

    Mastering Ghidra: A Complete Reverse Engineering Manual from the Basics (Chris Eagle, Kara Nance / technical supervision by Tomohisa Ishikawa / translated by Shota Nakajima, Yasukazu Kotake, Hiroaki Hara / O’Reilly Japan / 2022)

    \n↩\n
    15. \n
  15. \n

    .dump (Create Dump File) https://learn.microsoft.com/ja-jp/windows-hardware/drivers/debuggercmds/-dump—create-dump-file-

    \n↩\n
    16. \n
  16. \n

    Automatically Setting Up a KDNET Network Kernel Debugging Connection https://learn.microsoft.com/ja-jp/windows-hardware/drivers/debugger/setting-up-a-network-debugging-connection-automatically

    \n↩\n
    17. \n
\n
","fields":{"slug":"/magical-windbg-vol2-01-en","tagSlugs":["/tag/magical-win-dbg/","/tag/windows/","/tag/win-dbg/","/tag/english/"]},"frontmatter":{"date":"2024-05-26","description":"This is the web edition of Magical WinDbg 2 - Learn User-Mode & Kernel Debugging Through CTFs -, distributed at Tech Book Fest 16.","tags":["Magical WinDbg","Windows","WinDbg","English"],"title":"Magical WinDbg VOL.2 [Chapter 1: Environment Setup]","socialImage":{"publicURL":"/static/e9bfc3718fd53ab58623a496fc9a302e/magical-windbg-vol2.png"}}}},"pageContext":{"slug":"/magical-windbg-vol2-01-en"}},"staticQueryHashes":["251939775","401334301","825871152"]}