
Автоматизированное обнаружение, проверка и подтверждение подмены DLL. Превращение локальных неверных конфигураций в вооруженные, подтвержденные пути атаки.
<p align="center">
<img src="https://img.shields.io/badge/Platform-Windows-blue?style=for-the-badge&logo=windows" />
<img src="https://img.shields.io/badge/.NET-8.0_%7C_10.0-purple?style=for-the-badge&logo=dotnet" />
<img src="https://img.shields.io/badge/License-MIT-green?style=for-the-badge" />
<img src="https://img.shields.io/badge/Version-2.6.0-orange?style=for-the-badge" />
<img src="https://img.shields.io/badge/Black%20Hat%20Arsenal-Europe%202026-CC0000?style=for-the-badge" />
<img src="https://img.shields.io/badge/Black%20Hat%20Arsenal-SecTor%202026-CC0000?style=for-the-badge" />
</p>
<h1 align="center">DLLHijackHunter</h1>
<h4 align="center">От <a href="https://projectmerai.com">ProjectMerai</a></h4>
<p align="center">
<strong>Автоматизированный поиск, проверка и подтверждение перехвата DLL в Windows</strong><br/>
<em>От «эту DLL, возможно, можно перехватить» до «обычный пользователь может заставить SYSTEM загрузить её — вот доказательство».</em>
</p>
---
## Содержание
- [Обзор](#overview)
- [Быстрый старт](#quick-start)
- [Как это работает](#how-it-works)
- [Что обнаруживается](#what-it-detects)
- [Снижение ложных срабатываний](#reducing-false-positives)
- [Верификация: проба загрузки и канарейка](#verification-load-probe-and-canary)
- [Оценка, уровни и цепочки атак](#scoring-tiers-and-attack-chains)
- [Справочник по использованию](#usage-reference)
- [Безопасность и операционное воздействие](#safety-and-operational-impact)
- [Сборка из исходного кода](#building-from-source)
- [Тестовая лаборатория (HijackRange)](#test-lab-hijackrange)
- [Известные ограничения](#known-limitations)
- [Сравнение](#comparison)
---
## Обзор
DLLHijackHunter находит возможности перехвата DLL на хосте Windows и стремится их доказать, а не просто перечислить. Он:
1. **Обнаруживает** каждое место, где бинарный файл запускается автоматически — службы, запланированные задачи, ключи Run, папки автозагрузки, COM-серверы, DLL AppInit/AppCert, записи IFEO и автоматически повышающие привилегии бинарники UAC — и вычисляет, где будет выполняться поиск каждой импортируемой DLL.
2. **Отфильтровывает** позиции, которые атакующий фактически не может использовать: API sets, KnownDLLs, каталоги, в которые обычный пользователь не может писать, защищённые процессы и другое.
3. **Проверяет** (опционально) с помощью настоящего загрузчика Windows, размещая безвредную пробную DLL и проверяя, какая копия побеждает в поиске.
4. **Подтверждает** (опционально) путём развёртывания безвредной канареечной DLL, запуска службы/задачи/COM-объекта и записи идентификатора, от имени которого она фактически выполнилась.
5. **Оценивает и сообщает** о каждой находке по уровню уверенности и воздействию, а также связывает находки в цепочки атак (например, *обычный пользователь → SYSTEM*).
Каждое суждение выносится **с точки зрения атакующего** — непривилегированного обычного пользователя — независимо от того, запущен ли сам сканер с повышенными привилегиями. Запуск от имени администратора даёт инструменту больше видимости (ETW, канарейка, триггеры служб); он никогда не делает защищённые каталоги доступными для записи и не завышает полученные привилегии.
---
## Быстрый старт
Скачайте или соберите `DLLHijackHunter.exe` (самодостаточный; установка .NET не требуется), затем из командной строки **с повышенными привилегиями**:
```powershell
# Passive, read-only triage: no file drops, no service/task starts
.\DLLHijackHunter.exe --profile safe
# Full static analysis without touching the system, JSON report
.\DLLHijackHunter.exe --profile aggressive --no-canary --no-etw -o report.json
# Static analysis + real-loader verification (writes probe DLLs transiently)
.\DLLHijackHunter.exe --profile aggressive --no-canary --no-etw --verify-load -o report.html
# Everything, including ETW and canary confirmation — lab / authorised targets only
.\DLLHijackHunter.exe --profile aggressive -o report.html
# Focus on one application
.\DLLHijackHunter.exe --target "C:\Program Files\MyApp\app.exe" --no-canary
```
> **Антивирус:** канареечные и пробные DLL не подписаны и ведут себя как полезные нагрузки для перехвата, поэтому Microsoft Defender может поместить их в карантин. Инструмент обнаруживает это и сообщает о таких результатах как **неубедительных**, а не как о «не поддающихся перехвату». На тестовой машине исключите целевые каталоги и `%ProgramData%\DLLHijackHunter`, чтобы получить однозначные результаты.
---
## Как это работает
```mermaid
flowchart TB
subgraph S1["1 · Discovery"]
direction LR
EN["Launch points<br/>services · tasks · Run keys<br/>startup · COM · AutoElevate"] --> PE["PE analysis<br/>imports · delay loads<br/>manifest"] --> SO["Search order<br/>identity-aware PATH"]
ETW["ETW runtime trace<br/>optional, elevated"]
end
subgraph S2["2 · Filter pipeline"]
direction LR
HG["Hard gates<br/>API sets · KnownDLLs<br/>writability"] --> SG["Soft gates<br/>manifest · privilege<br/>PPL · LoadLibraryEx"] --> DD["Dedup and<br/>profile filters"]
end
subgraph S3["3 · Verification (optional)"]
direction LR
LP["Load probe<br/>real Windows loader"] --> CN["Canary<br/>deploy, trigger, confirm"]
end
subgraph S4["4 · Output"]
direction LR
SC["Scoring and tiers"] --> AC["Attack chains"] --> RP["Console · JSON · HTML"]
end
S1 --> S2 --> S3 --> S4
```
| Фаза | Требует прав администратора | Изменяет систему |
|---|:---:|---|
| Статическое обнаружение + фильтры | Нет (администратор видит больше) | Нет |
| Обнаружение во время выполнения через ETW | **Да** | **Запускает** службы с автозапуском (до 100) и выполняет запланированные задачи (до 30), чтобы спровоцировать загрузку DLL |
| Проверка загрузки (`--verify-load`) | Нет | Кратковременно записывает безвредную пробную DLL в каждую позицию-кандидат, затем удаляет её и восстанавливает любую исходную |
| Подтверждение через canary | **Да** | Записывает canary DLL, останавливает/запускает службы, выполняет задачи, активирует COM-объекты, затем выполняет очистку |
---
## Что он обнаруживает
### Типы перехвата
| Тип | Что это означает | Примечания |
|---|---|---|
| **Phantom** | DLL не существует нигде в пути поиска | Разместите её в любом месте, где ищет бинарный файл |
| **Порядок поиска** | Каталог с правами записи просматривается раньше легитимной копии | Включает перезапись DLL в каталоге с правами записи |
| **ENV PATH** | Каталог с правами записи в `PATH` просматривается в поисках отсутствующей DLL | Службы проверяются только по **машинному** PATH — записи PATH самого пользователя службой никогда не просматриваются |
| **Перенаправление .local** | Перенаправление `<app>.exe.local\<dll>` | Сообщается только для исполняемых файлов **без манифеста** (или когда IFEO `DevOverrideEnable=1`); в противном случае загрузчик игнорирует `.local`, и он никогда не перенаправляет KnownDLLs |
| **Side-load (UAC)** | Копирование авто-повышающего права EXE рядом с подложенной DLL | Только для EXE с `<autoElevate>true</autoElevate>` в их манифесте. Авто-повышение требует доверенного расположения, поэтому копия должна пройти эту проверку (например, фиктивная папка `C:\Windows \System32\`) |
| **AppInit DLLs** | `AppInit_DLLs` указывает на DLL с правами записи | Загружается в каждый процесс, который загружает `user32.dll` |
| **AppCert DLLs** | `AppCertDLLs` указывает на DLL с правами записи | Загружается в каждый вызывающий `CreateProcess`/`WinExec` |
Бинарные файлы IFEO `Debugger` и `SilentProcessExit\MonitorProcess` перечисляются и анализируются как любая другая точка запуска. Перехваты на основе CWD в настоящее время не формируются.
### От чьего имени запускается цель
Правильная идентификация определяет как вердикт о повышении привилегий, так и оценку воздействия:
- **Службы** — `ObjectName` (LocalSystem, Local Service, Network Service или учётная запись); службы svchost также анализируют свою `ServiceDll`.
- **Запланированные задачи** — субъект задачи. Формы SID, такие как `S-1-5-18`, сопоставляются с `NT AUTHORITY\SYSTEM`; групповые субъекты выполняются от имени вошедшего участника (повышенными считаются только *Администраторы + наивысшие привилегии*). Полезные нагрузки, обёрнутые в `rundll32`, `cmd /c` или `powershell -File`, также анализируются.
- **Ключи Run / папки автозагрузки** — перечисляются для **каждого загруженного профиля пользователя** (`HKEY_USERS`) и папки автозагрузки каждого профиля с привязкой к этому пользователю — не только для учётной записи, запускающей сканер.
- **COM** — внепроцессные серверы следуют по цепочке `AppID` → `RunAs` / `LocalService`; внутрипроцессные серверы выполняются от имени того клиента, который их загружает.
### База знаний и вооружение PATH
- Сопоставляется встроенный снимок набора данных **[HijackLibs](https://hijacklibs.net/)** (≈590 DLL для ≈700 исполняемых файлов, `Resources/hijacklibs.json`). Совпадение повышает уверенность и связывает ссылку; отсутствие совпадения ничего не значит. Обновить его можно, заменив файл на `https://hijacklibs.net/api/hijacklibs.json`. Набор данных © проект HijackLibs и участники.
- Для каждого каталога с правами записи в **машинном** PATH генерируются кандидаты для известных служб SYSTEM, которые проверяют PATH в поисках отсутствующих DLL (`IKEEXT → wlbsctrl.dll`, `Spooler → ualapi.dll`, `Schedule → WptsExtensions.dll`, `SessionEnv → tsmsisrv.dll`, `WlanSvc → wlanhlp.dll`).
---
## Снижение числа ложных срабатываний
**Жёсткие фильтры** (кандидат отбрасывается):
- **Наборы API** — каждое имя контракта `api-ms-*` / `ext-ms-*` разрешается через схему API set, а не через порядок поиска.
- **KnownDLLs** — считываются из живых объектных каталогов `\KnownDlls` и `\KnownDlls32` (а не только из начального списка в реестре), плюс `ntdll.dll`, который всегда отображается первым.
- **Записываемость с точки зрения атакующего** — позиция учитывается только если `Users`, `Authenticated Users`, `Everyone` или `INTERACTIVE` (плюс непривилегированная сервисная учётная запись, такая как `LOCAL SERVICE`) обладают нужным правом: **создание файлов** для подмены DLL, **создание папок** для каталога `.local`. Это вычисляется из ACL независимо от собственного токена сканера, поэтому при сканировании с повышенными правами `System32`, `Program Files` или корень диска (`C:\`) никогда не видны как записываемые.
**Мягкие проверки** (уверенность корректируется, причина записывается в примечаниях к находке):
- **Привязка к манифесту / WinSxS** для DLL.
- **Дельта привилегий** — измеряется относительно **атакующего со стандартными правами пользователя**: цели SYSTEM, LOCAL/NETWORK SERVICE и цели с повышенными правами UAC считаются повышением привилегий; цели с теми же привилегиями сохраняются как находки о закреплении / обходе защиты.
- **Меры защиты LoadLibraryEx** — импорты `SetDefaultDllDirectories`, `AddDllDirectory`, `SetDllDirectory`.
- **Защищённые процессы** — известные бинарники PPL, службы с установленным `LaunchProtected` в конфигурации SCM (охватывает новые версии Windows и сторонние службы AV/EDR), а также образы с `FORCE_INTEGRITY`.
- **Необязательные загрузки с обработкой ошибок.**
Если проверку не удаётся выполнить, кандидат не штрафуется, но сбой записывается в его примечаниях и в журнале, а не скрывается.
---
## Проверка: проба загрузки и канарейка
### Проба загрузки (`--verify-load`)
Для кандидатов Phantom, Search-order и Side-load безвредная пробная DLL копируется в записываемую позицию, и короткоживущий дочерний процесс просит **настоящий загрузчик Windows** разрешить имя:
| Результат | Значение | Эффект |
|---|---|---|
| **Wins** | Загрузчик выбрал записываемую позицию | Порядок поиска доказан; находка может достичь **High** |
| **LosesToProtected** | Победила копия из KnownDLL, System32 или SxS | Вероятно ложное срабатывание; −40 к уверенности |
| **NotResolved** | Имя не разрешилось; ошибка загрузчика записана | Неубедительно |
| **Error** | Пробу не удалось выполнить — включая случай, когда проба **помещена в карантин антивирусом** | Неубедительно, без штрафа |
| **Skipped** | `.local`, PATH, AppInit/AppCert используют иной механизм | — |
Проба моделирует, где позиция действительно находится: DLL в **собственном каталоге** бинарника проверяется раньше System32 (как это делает загрузчик); другие позиции используют классический или современный порядок поиска, в зависимости от ситуации. Выполняется от имени стандартного пользователя; каждая проба удаляется, а любой исходный файл восстанавливается.
### Подтверждение канарейкой
```mermaid
sequenceDiagram
autonumber
participant H as DLLHijackHunter
participant P as Hijack position
participant T as Service / task / COM
Note over H: Pick canary for target bitness,<br/>or build an export-forwarding proxy
H->>P: Back up original DLL, write canary
H->>T: sc start / schtasks /run / COM activation
T->>P: Load DLL by name (search order)
Note over P,T: Canary DllMain records user,<br/>integrity level and SeDebug
T-->>H: Confirmation file written
Note over H: Finding marked CONFIRMED
H->>P: Remove canary, restore original DLL
H->>T: Restore original service state
```
- **Компилятор не нужен.** Встроены предварительно скомпилированные канарейки x64/x86; когда у перехваченной DLL есть экспорты, прокси-сервер пересылки экспорта синтезируется во время выполнения путём PE-хирургии, чтобы хост продолжал работать.
- **Самоопределение местоположения.** Канарейка выводит свой путь подтверждения (`%ProgramData%\DLLHijackHunter\canary_<hash>.confirm`) из собственного пути загрузки, поэтому один бинарный файл обслуживает каждого кандидата.
- **Без полезной нагрузки.** Она лишь фиксирует, кто её загрузил. Исходный код: `src/DLLHijackHunter/Resources/canary_src.c` (пересборка с помощью `Resources/build_canary.bat`, MSVC требуется только для этого).
- **Результаты:** `Fired`, `Timeout` (сработала, но так и не загружена), `Failed` (не удалось вызвать/развернуть), `Blocked` (канарейка помещена в карантин антивирусом — результат неоднозначен), `NotTested` (ключи Run, Startup, обход UAC и ручные цели требуют входа в систему/перезагрузки).
- **Оговорка по COM:** внутрипроцессные COM-объекты активируются из клиента, запущенного сканером, поэтому сработавшая канарейка доказывает загрузку, но её идентичность принадлежит сканеру — это записывается как *контекст вызывающего* и не завышает оценку воздействия.
Прокси-канарейки всё ещё могут давать неоднозначный результат для экспортов только по ординалам, декорированных имён экспортов или хостов, которым требуется реальная DLL в памяти. Неоднозначный результат канарейки **не** означает, что перехват невозможен.
---
## Оценка, уровни и цепочки атак
Каждая находка получает **уверенность** (на основе фильтров, пробы, канарейки и базы знаний) и оценку **воздействия** (полученные привилегии, надёжность срабатывания, скрытность, сохранение после перезагрузки), которые объединяются в итоговую оценку от 0 до 10.
| Уровень | Требование |
|---|---|
| **Confirmed** | Канарейка сработала |
| **High** | ≥ 80% **и** сигнал-доказательство: успех пробы, наблюдение ETW или совпадение с HijackLibs |
| **Medium** | ≥ 50% (непроверенные статические находки ограничены этим уровнем и помечены `Static-only`) |
| **Low** | ≥ 20% |
| **Informational** | Ниже 20%, но выше `--min-confidence` профиля |
**Цепочки атак** связывают находки в сценарии:
- **Direct Path (User → SYSTEM)** — любая находка уровня SYSTEM, которую может разместить обычный пользователь.
- **Ladder (User → Admin → SYSTEM)** — тихий обход UAC, показывается только при отсутствии прямого пути.
- **Long Con (Persistence)** — лучшая находка автозапуска, не связанная со службами (ключ Run, Startup, задача).
---
## Справочник по использованию
```text
-p, --profile <name> aggressive | strict | safe | redteam | uac-bypass [default: aggressive]
-o, --output <path> Write a report; format from extension (.json / .html / .htm)
-f, --format <format> console | json | html [default: console]
-t, --target <target> Binary path, directory, or file name (partial match). Scopes discovery
and ETW to that target and skips system-wide PATH weaponisation.
--min-confidence <0-100> Override the profile's threshold (only when explicitly passed)
--no-canary Disable canary confirmation
--no-etw Disable ETW runtime discovery (no service/task starts)
--verify-load Real-loader verification of search order (transient probe DLLs)
--confirmed-only Report only canary-confirmed findings
--lpe-only Ignore System32 / Program Files / Windows positions
--canary-settle <sec> Seconds to wait for a canary to fire after triggering
--log-file <path> Write a diagnostic log (enumeration, filter, and probe failures)
-v, --verbose Verbose console output
```
### Профили
| Профиль | Назначение | Canary | ETW | AutoElevate | COM | Same-priv findings | PPL findings | Мин. достоверность |
|---|---|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
| **aggressive** | Полный аудит, лаборатории | ✅ | ✅ | ✅ | ✅ | сохраняются | сохраняются | 15% |
| **strict** | Только повышение привилегий с высокой достоверностью | ✅ | ✅ | — | — | отбрасываются | отбрасываются | 80% |
| **safe** | Продакшн, только чтение | — | — | — | — | сохраняются | отбрасываются | 50% |
| **redteam** | Только подтверждённое повышение привилегий (подразумевает `--confirmed-only`) | ✅ | ✅ | — | ✅ | отбрасываются | отбрасываются | 50% |
| **uac-bypass** | Векторы авто-повышения привилегий | — | — | ✅ | — | отбрасываются | отбрасываются | 20% |
### Вывод
- **Консоль** (по умолчанию): сводка, диаграмма уровней, находки, цепочки атак. На диск ничего не записывается, если не передан `--output` (путь, не оканчивающийся на `.json`/`.html`, получает JSON-отчёт при наличии находок).
- **JSON / HTML**: полные находки с примечаниями, результаты фильтрации, результаты load-probe и canary, ссылки на базу знаний и цепочки атак. Отчёт записывается даже при отсутствии находок, поэтому пустой файл никогда не означает сбой запуска.
### Коды выхода
| Код | Значение |
|---|---|
| `0` | Сканирование завершено (с находками или без) |
| `1` | Необработанная ошибка |
| `3` | Запрошен `--confirmed-only` (или профиль `redteam`), но canary не может запуститься — нет повышенных привилегий или canary отключён. Отказ вместо ложного отчёта «0 находок». |
---
## Безопасность и операционное воздействие
Используйте DLLHijackHunter только на системах, которыми вы владеете или которые вам явно разрешено оценивать.
- `--profile safe` (или `--no-canary --no-etw`) — **только чтение** — подходит для триажа в продакшне.
- **Режим ETW запускает службы и выполняет запланированные задачи**, чтобы спровоцировать загрузку DLL, даже без canary.
- **Режим canary** заменяет DLL (с резервным копированием/восстановлением), останавливает и перезапускает службы, выполняет задачи и активирует COM-объекты. Хрупкие службы могут работать некорректно, пока загружена прокси-canary.
- **`--verify-load`** временно записывает пробные DLL в доступные для записи позиции.
- Неподписанные canary/probe DLL могут быть помещены в карантин антивирусом; такие результаты сообщаются как неокончательные (`Blocked` / probe `Error`), но никогда как «не уязвимо».
---
## Сборка из исходного кода
Требования: .NET 8 SDK (и .NET 10 SDK, если вы также собираете цель `net10.0-windows`). Сборка на Linux/macOS работает с `-p:EnableWindowsTargeting=true`.
```powershell
git clone https://github.com/projectmerai/DLLHijackHunter.git
cd DLLHijackHunter
# Self-contained single-file executable (no .NET runtime needed on the target)
dotnet publish src/DLLHijackHunter/DLLHijackHunter.csproj `
-c Release -f net8.0-windows -r win-x64 --self-contained `
-p:PublishSingleFile=true -p:IncludeNativeLibrariesForSelfExtract=true `
-o ./publish
```
Проект поддерживает несколько целевых платформ — `net8.0-windows` и `net10.0-windows`, поэтому для `dotnet publish` требуется явное указание `-f`.
---
## Тестовая лаборатория (HijackRange)
`HijackRange/` содержит намеренно уязвимую лабораторию для демонстраций и регрессионного тестирования:
- **Alpha** — служба SYSTEM, каталог с исполняемым файлом которой доступен для записи группе `BUILTIN\Users`.
- **Beta** — запланированная задача SYSTEM с той же схемой.
- **Gamma** — каталог с правом записи, добавленный в системный PATH.
Сборка выполняется через `HijackRange\build-all.bat`, развёртывание — через `HijackRange\setup.ps1` (с повышенными правами), удаление — через `HijackRange\teardown.ps1`. См. `HijackRange/demo-script.md`. Используйте одноразовую виртуальную машину.
---
## Известные ограничения
- **Статический порядок поиска является приближением.** Поведение во время выполнения (флаги `LoadLibraryEx`, `SetDefaultDllDirectories`, манифесты) выводится из импортов; для подтверждения используйте `--verify-load` или canary.
- **ETW** видит только процессы и загрузки, происходящие в течение окна трассировки (по умолчанию 120 с).
- **Персистентность** («переживает перезагрузку») выводится из конфигурации автозапуска, а не из теста с перезагрузкой.
- **Находки в Run-ключах / Startup / UAC side-load** не могут быть автоматически подтверждены с помощью canary.
- **Canary- и probe-DLL не подписаны** и могут блокироваться антивирусом или политикой управления приложениями.
---
## Сравнение
| Возможность | **DLLHijackHunter** | Robber | DLLSpy | WinPEAS | Procmon |
|---|:---:|:---:|:---:|:---:|:---:|
| Автоматическое обнаружение | ✅ | ✅ | ✅ | ✅ | ❌ |
| Обнаружение phantom DLL | ✅ | ❌ | ✅ | ❌ | ✅ |
| Анализ порядка поиска | ✅ | ❌ | ❌ | ❌ | ❌ |
| Проверка ACL относительно атакующего | ✅ | Частично | ❌ | Базовая | ❌ |
| Мониторинг выполнения через ETW | ✅ | ❌ | ❌ | ❌ | ✅ |
---
[Read more](https://github.com/ghostvectoracademy/dllhijackhunter)