mirror of
https://github.com/joaoviictorti/shadow-rs.git
synced 2026-01-07 01:25:01 +01:00
172 lines
5.4 KiB
Markdown
172 lines
5.4 KiB
Markdown
# Windows Kernel Rootkit in Rust (shadow-rs) 🦀
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
This project, called shadow-rs, is designed to create a rootkit in the Windows kernel using the Rust language. The aim is to demonstrate advanced techniques for developing rootkits, taking advantage of the security and performance features of the Rust language.
|
|
|
|
## Summary
|
|
|
|
* [Notice](#notice)
|
|
* [Legal notice](#legal-notice)
|
|
* [Features](#contents)
|
|
* [Others](#others)
|
|
* [Build Instructions](#build-instructions)
|
|
* [Driver](#driver)
|
|
* [Client](#client)
|
|
* [Setup Instructions](#setup-instructions)
|
|
* [Enable Test Mode](#enable-test-mode)
|
|
* [Debug via Windbg](#debug-via-windbg)
|
|
* [Create/Start Service](#createstart-service)
|
|
* [Upcoming Features](#upcoming-Features)
|
|
* [Credits & References](#credits--references)
|
|
|
|
## Notice
|
|
|
|
> [!WARNING]
|
|
> This project is under development.
|
|
|
|
## Legal Notice
|
|
|
|
> [!WARNING]
|
|
> This project is for educational and research purposes. Malicious use of the software is strictly prohibited and discouraged. I am not responsible for any damage caused by improper use of the software.
|
|
|
|
## Features
|
|
|
|
### Process
|
|
- ✅ Process (Hide / Unhide)
|
|
- ✅ Process Signature (PP / PPL)
|
|
- ✅ Process Protection (Anti-Kill / Dumping)
|
|
- ✅ Elevate Process to System
|
|
- ✅ Terminate Process
|
|
- ✅ Lists protected and hidden processes currently on the system
|
|
|
|
### Thread
|
|
- ✅ Thread (Hide / Unhide)
|
|
- ✅ Thread Protection (Anti-Kill)
|
|
- ✅ Lists protected and hidden threads currently on the system
|
|
|
|
### Driver
|
|
- ✅ Driver (Hide / Unhide)
|
|
- ✅ Enumerate Driver
|
|
- ✅ Support for mapping the driver in memory
|
|
|
|
### Misc
|
|
|
|
- Driver Signature Enforcement (DSE)
|
|
- ✅ DSE (Enable / Disable)
|
|
|
|
- Keylogger
|
|
- ✅ Keylogger (Start / Stop)
|
|
|
|
- ETWTI
|
|
- ✅ ETWTI (Enable / Disable)
|
|
|
|
### Callbacks
|
|
- ✅ List / Remove / Restore Callbacks
|
|
- PsSetCreateProcessNotifyRoutine
|
|
- PsSetCreateThreadNotifyRoutine
|
|
- PsSetLoadImageNotifyRoutine
|
|
- CmRegisterCallbackEx
|
|
- ObRegisterCallbacks (PsProcessType / PsThreadType)
|
|
- ✅ Listing currently removed callbacks
|
|
|
|
### Module
|
|
- ✅ Hide Module
|
|
- ✅ Enumerate Module
|
|
|
|
### Registry
|
|
- ✅ Hide Key and Values
|
|
- ✅ Registry Protection (Anti-Deletion e Overwriting)
|
|
|
|
### Injection
|
|
- ✅ Process Injection - Shellcode / DLL (ZwCreateThreadEx)
|
|
- ✅ APC Injection - Shellcode
|
|
|
|
## Others
|
|
|
|
The following functionalities are not "features", they are basically techniques that may be of interest to you to explore, understand and apply in the development of your driver.
|
|
|
|
- Searching for a "Zw" api not exported from `ntoskrnl.exe` at runtime.
|
|
- Reflective Loading.
|
|
|
|
## Build Instructions
|
|
|
|
To build the project, ensure you have the Rust toolchain installed.
|
|
|
|
#### Driver
|
|
To build the driver, first go to the `driver` folder and then run the following command (When you do the first build you have to be as administrator, but after that you won't need to):
|
|
```sh
|
|
cargo make default --release
|
|
```
|
|
|
|
This driver can be mapped using `kdmapper` among other exploit tools, for example, to put mapping support, use the command:
|
|
```sh
|
|
cargo make default --release --features mapper
|
|
```
|
|
|
|
#### Client
|
|
To build the client, first go into the `client` folder, then run the following command:
|
|
```sh
|
|
cargo build --release
|
|
```
|
|
|
|
Since some features of the rootkit are not supported due to the controller mapping, use the following command to build the client with only the commands that can be executed with the mapping:
|
|
```sh
|
|
cargo build --release --features mapper
|
|
```
|
|
|
|
## Setup Instructions
|
|
|
|
#### Enable Test Mode or Test Signing Mode
|
|
|
|
```
|
|
bcdedit /set testsigning on
|
|
```
|
|
|
|
#### [Optional] Debug via Windbg
|
|
|
|
```
|
|
bcdedit /debug on
|
|
bcdedit /dbgsettings net hostip:<IP> port:<PORT>
|
|
```
|
|
|
|
#### Create / Start Service
|
|
|
|
You can use [Service Control Manager](https://docs.microsoft.com/en-us/windows/win32/services/service-control-manager) or [OSR Driver Loader](https://www.osronline.com/article.cfm%5Earticle=157.htm) to load your driver.
|
|
|
|
## Upcoming Features
|
|
|
|
These are some of the features that will be added, but there are many more on the way
|
|
|
|
### Port
|
|
- ❌ Hide port
|
|
|
|
### File
|
|
- ❌ Hide File / Directory
|
|
- ❌ Anti-Deletion e Overwriting
|
|
|
|
### Callback
|
|
- ❌ Minifilters
|
|
|
|
### Injection
|
|
- ❌ APC Injection - DLL
|
|
|
|
## Credits & References
|
|
- https://leanpub.com/windowskernelprogrammingsecondedition
|
|
- https://www.youtube.com/watch?v=t7Rx3crobZU&pp=ugMICgJwdBABGAHKBRBibGFja2hhdCByb290a2l0
|
|
- https://github.com/memN0ps/eagle-rs
|
|
- https://www.amazon.com/Rootkits-Bootkits-Reversing-Malware-Generation/dp/1593277164
|
|
- https://github.com/Idov31/Nidhogg
|
|
- https://www.unknowncheats.me/
|
|
- https://www.amazon.com.br/Rootkit-Arsenal-Escape-Evasion-Corners/dp/144962636X
|
|
- https://github.com/eversinc33/Banshee
|
|
- https://synzack.github.io/Blinding-EDR-On-Windows/
|
|
- https://github.com/JKornev/hidden
|
|
- https://www.amazon.com.br/Rootkits-Subverting-Windows-Greg-Hoglund/dp/0321294319
|
|
- https://github.com/mirror/reactos
|
|
- https://github.com/Kharos102/ReadWriteDriverSample
|
|
- https://imphash.medium.com/windows-process-internals-a-few-concepts-to-know-before-jumping-on-memory-forensics-part-4-16c47b89e826 |