Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/PI-Defender/pi-defender

Kernel Security driver used to block past, current and future process injection techniques on Windows Operating System.
https://github.com/PI-Defender/pi-defender

anti-injection anti-malware antivirus blue-team defense driver kernel malware process-injection security windows

Last synced: 3 months ago
JSON representation

Kernel Security driver used to block past, current and future process injection techniques on Windows Operating System.

Host: GitHub
URL: https://github.com/PI-Defender/pi-defender
Owner: PI-Defender
License: lgpl-3.0
Created: 2022-06-21T07:07:42.000Z (over 2 years ago)
Default Branch: main
Last Pushed: 2022-09-11T12:19:34.000Z (about 2 years ago)
Last Synced: 2024-06-16T02:43:03.130Z (5 months ago)
Topics: anti-injection, anti-malware, antivirus, blue-team, defense, driver, kernel, malware, process-injection, security, windows
Language: C++
Homepage: https://pi-defender.github.io/
Size: 3.25 MB
Stars: 148
Watchers: 4
Forks: 23
Open Issues: 1
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

awesome-game-security - Kernel Security driver used to block past, current and future process injection techniques on Windows Operating System

README

# PI-Defender

## What is PI-Defender ?

PI-Defender is a kernel security driver used to block past, current and future process injection techniques on Windows operating system:
* [Process Hollowing](https://attack.mitre.org/techniques/T1055/012/)
* [Process Doppelgänging](https://attack.mitre.org/techniques/T1055/013/)
* [Process Herpaderping](https://jxy-s.github.io/herpaderping/)
* [Process Ghosting](https://www.elastic.co/blog/process-ghosting-a-new-executable-image-tampering-attack)
* [Process Overwritting](https://github.com/hasherezade/process_overwriting)
* [Dll Injection](https://attack.mitre.org/techniques/T1055/001/)

## Demonstration

Process Ghosting PoC from [Hasherezade](https://github.com/hasherezade/process_ghosting).

https://user-images.githubusercontent.com/62078072/185355728-04c7fdca-9b8b-4cee-9296-e60c28c1d794.mp4

## How does it works ?

Whenever a binary wants to interact with the memory of a Windows Object, it has to specify rights according to what it wants to achieve.
Then, the system returns a *handle* associated to this object with the granted rights.
Since all process injection techniques need to write in the memory of a remote process, they need a handle with specific rights (PROCESS_VM_WRITE and PROCESS_VM_OPERATION).
The technique used by PI-Defender is simply to **remove forbidden access rights on handles associated with remote processes**.

![mermaid_workflow_picture](https://user-images.githubusercontent.com/62078072/189527100-89b83ecd-82b0-48af-9efe-be3369a47986.png)

### Driver Kernel

#### Handle Rights

| Requested | Granted |
| --------------------------------- | :----------------: |
| DELETE | :heavy_check_mark: |
| READ_CONTROL | :heavy_check_mark: |
| WRITE_DAC | :heavy_check_mark: |
| WRITE_OWNER | :heavy_check_mark: |
| SYNCHRONIZE | :heavy_check_mark: |
| PROCESS_TERMINATE | :heavy_check_mark: |
| PROCESS_CREATE_THREAD | :heavy_check_mark: |
| PROCESS_SET_SESSIONID | :heavy_check_mark: |
| PROCESS_VM_OPERATION | :x: |
| PROCESS_VM_READ | :heavy_check_mark: |
| PROCESS_VM_WRITE | :x: |
| PROCESS_DUP_HANDLE | :heavy_check_mark: |
| PROCESS_CREATE_PROCESS | :heavy_check_mark: |
| PROCESS_SET_QUOTA | :heavy_check_mark: |
| PROCESS_SET_INFORMATION | :heavy_check_mark: |
| PROCESS_QUERY_INFORMATION | :heavy_check_mark: |
| PROCESS_SUSPEND_RESUME | :heavy_check_mark: |
| PROCESS_QUERY_LIMITED_INFORMATION | :heavy_check_mark: |
| PROCESS_SET_LIMITED_INFORMATION | :heavy_check_mark: |

For detailled information about Process Security and Access Rights, please visit https://docs.microsoft.com/en-us/windows/win32/procthread/process-security-and-access-rights.

#### Configuration

##### Whitelist

You can whitelist an entire folder or a simple executable if you don't want the driver to filter these files.
Modify the registry key ```HKLM\SYSTEM\CurrentControlSet\Services\PI-Defender\Parameters\Whitelist```, then add folders and applications.

##### Cache

The cache holds by default 100 hashes corresponding to the last 100 applications that were analyzed.
It allows the driver to cache recurrent files and save computing time.
Modify the registry key ```HKLM\SYSTEM\CurrentControlSet\Services\PI-Defender\Parameters\CacheSize``` to increase or decrease the number of hashes hold by the cache.

##### Communication Port

The communication port is used by the driver and the user-mode service to communicate through a specified channel.
By default, the communication port is labelled _\PIDefenderPort_.
Modify the registry key ```HKLM\SYSTEM\CurrentControlSet\Services\PI-Defender\Parameters\CommunicationPort``` to modify the communication port.

##### Number of clients

By default, the number of clients is set to 1.
Modify the registry key ```HKLM\SYSTEM\CurrentControlSet\Services\PI-Defender\Parameters\MaxClients``` to increase this number.

### Service User-Mode

#### Verify Signature

There are two kinds of signature in Windows:
* Embedded signature.
* Catalog signature.

Both are checked in PI-Defender in order to trust an application.

#### Configuration

##### Listener Thread

The listener thread purpose is to wait for data send by the driver. Once a data is received it create a work pool and send the data to the worker thread.

Modify the registry key ```HKLM\SYSTEM\CurrentControlSet\Services\PI-Defender_UM\Parameters\ListenerThreads``` to increase this number.

##### Workers Threads

Workers threads have multiple goals:
* Verify the signature of an executable.
* Send the response back to the driver.
* Push a new message in queue for the listener.

Modify the registry key ```HKLM\SYSTEM\CurrentControlSet\Services\PI-Defender_UM\Parameters\MaxWorkerThreads \ MinWorkerThreads``` to increase/decrease the number of workers threads.

## Getting Started

These instructions will get you a copy of the project up and running on your local machine.

### Tested on
1. Windows 10 21H2 19044.1415
2. Microsoft Visual Studio version 2019.
3. Windows Driver Kit (WDK) 10.0.19041.685.
4. Windows Software Development Kit (SDK) 10.0.19041.685.

### Building
1. Clone the project.
```bash
git clone https://github.com/PI-Defender/pi-defender.git
```
2. Load PI-Defender.sln with Visual Studio.
3. Make sure the configuration manager is set to x64 (Release).
4. Build the solution (Crtl + Maj + B).

### Installing
1. The driver uses test signing, so before using it Windows should be set to install and run test signed drivers.
Enable test signed drivers can be done with the following steps:
* *Reset this PC* (search bar)
* *Troubleshoot*
* *Advanced Options*
* *Startup repair*
* Select the number **7** to disable the driver signature enforcement.

Windows will restart for changes to take effect.
2. Install the driver with the user-mode service.
```bash
PI-Defender_UM.exe install
```
To ensure a smooth installation, *PI-Defender_UM.exe*, *PI-Defender.sys* and *PI-Defender_MsgFile.dll* must be in the same folder before running the previous command.
If everything went well, you should have a success message.

## Usage
```
$ PI-Defender_UM.exe [install,start,query,stop,delete]

Protect your system from process injection.

Actions:
install Install the service User-Mode and the Driver kernel.
start Start the service User-Mode and the driver kernel.
query Query informations about the service and the driver.
stop Stop the service user-mode and the driver.
delete Delete the service user-mode and the driver.
```

## Documentation

The offline documentation is available in the **Doc/** directory.

The online documentation is available in the main [website](https://pi-defender.github.io/).

## Maintainers / Authors

* Nicolas JALLET (@Nikj-Fr)
* Bérenger BRAULT (@CapitaineHadd0ck)

## Credits

* [Naval Group](https://www.naval-group.com/en)
* Baptiste David

## Licence

This project is under [LGPLv3](https://choosealicense.com/licenses/lgpl-3.0) License.