
KASLD устраняет рандомизацию виртуального и физического размещения памяти ядра Linux из локального процесса, используя все доступные ему возможности — привилегии, конфигурацию и ограничения изоляции.
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/48542/27960c6a9cf0003d33879e796f71de7930ff461d87e9c6333b9522d822615306.png" alt="KASLD logo generated with Copilot (cropped)"/>
</p>
<p align="center">
<img src="https://github.com/bcoles/kasld/actions/workflows/build.yml/badge.svg" alt="Build Status"/>
<img src="https://github.com/bcoles/kasld/actions/workflows/codeql.yml/badge.svg" alt="CodeQL"/>
<img src="https://img.shields.io/badge/platform-Linux-informational" alt="Platform: Linux"/>
<img src="https://img.shields.io/badge/arch-x86%20%C2%B7%20ARM%20%C2%B7%20MIPS%20%C2%B7%20PPC%20%C2%B7%20RISC--V%20%C2%B7%20LoongArch%20%C2%B7%20s390-blue" alt="Architectures"/>
<img src="https://img.shields.io/badge/C-C99-blue.svg" alt="C99"/>
<img src="https://img.shields.io/github/v/release/bcoles/kasld" alt="Release"/>
<img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT"/>
</p>
KASLD восстанавливает виртуальное и физическое расположение памяти ядра Linux —
в первую очередь базовый адрес текста ядра — из локального процесса. То, что
удаётся восстановить, зависит от точки обзора этого процесса: его привилегий и
возможностей, конфигурации системы и любых ограничений контейнера. Там, где утечка
или побочный канал позволяют, базовый адрес восстанавливается напрямую; в
противном случае он сужается до наименьшего набора размещений, которые
поддерживаются доступными свидетельствами.
Механизм вывода объединяет свидетельства из десятков независимых методов с
известными инвариантами архитектуры, сужая размещение ядра до остаточного окна —
которое сообщается как число сохранившихся *слотов* (размещений, которые мог
выбрать KASLR) и представляющие их биты энтропии: верхняя граница защиты, которую
KASLR сохраняет с этой точки обзора, а не гарантия того, что базовый адрес
недосягаем для атакующего (см.
[docs/limitations.md](https://github.com/bcoles/kasld/blob/master/docs/limitations.md)).
Полное восстановление часто невозможно на усиленно защищённой цели — такой, где
не сохраняется прямая утечка текста ядра и закрыты побочные каналы, которые
предоставляют её архитектура и CPU — но множество ограничений редко бывает пустым.
На архитектурах без KASLR механизм определяет адрес загрузки, выбранный
загрузчиком.
Поддерживаются:
* x86 (i386+, amd64)
* ARM (armv6, armv7, armv8, aarch64)
* MIPS (mipsbe, mipsel, mips64, mips64el)
* PowerPC (ppc, ppcle, ppc64, ppc64le)
* RISC-V (riscv32, riscv64)
* LoongArch (loongarch64)
* s390
## Быстрый старт
```sh
sudo apt install libc-dev make gcc binutils git
git clone https://github.com/bcoles/kasld
cd kasld
make
./build/<arch>/kasld
```
Каталог `build/<arch>/` самодостаточен и может быть развёрнут на целевой системе:
```
build/<arch>/
kasld <- запускать это
components/ <- компоненты утечек
```
Усиленно защищённая конфигурация (`kernel.dmesg_restrict=1`,
`kernel.kptr_restrict=1`, `kernel.perf_event_paranoid=2` или выше,
`kernel.unprivileged_bpf_disabled=1` и хеширование указателей `%pK`) сужает
путь через оракулы файловой системы, но это лишь одна ось точки обзора: методы
побочных каналов, слабой энтропии и предоставляемые возможностями не зависят от
этих sysctl. Для тестирования скрипт
[extra/weaken-kernel-hardening](https://github.com/bcoles/kasld/blob/master/extra/weaken-kernel-hardening)
может временно ослабить эти настройки (требуется root).
## Пример вывода
Режим текстового вывода по умолчанию печатает обзор, начинающийся с ответа:
```
KASLD 0.4.2-dev -- Kernel Address Space Layout Derandomization
Target: x86_64 / 7.0.0
Running 117 of 120 components (3 experimental skipped; use -x to enable)...
[####################] 100% 117/117 40.9s
1 component timed out after 30s and was killed (prefetch_directmap)
Quantity Certainty Window Candidates Grain
------------------- ---------- --------------------------------------- ---------------- -----
Virtual Image Base guaranteed 0xffffffff81000000 - 0xffffffffbd400000 483 of 512 2 MiB
Virtual Image Base likely 0xffffffff93400000 slide +0x12400000 1 2 MiB
Physical Image Base guaranteed 0x1000000 - 0x3d400000 474 2 MiB
Physical Image Base likely 0x1000000 - 0x3c29d000 474 2 MiB
Direct Map Base guaranteed 0xffff800000000000 - 0xffffa4aa80000000 37,547 1 GiB
Vmalloc Base guaranteed 0xffff898000000000 - 0xffffd6d580000000 79,191 of 79,191 1 GiB
Vmemmap Base guaranteed 0xffffa98040000000 - 0xfffffd0000000000 85,504 1 GiB
Module Region Base guaranteed 0xffffffffa0000000 - 0xffffffffff000000 389,121 4 KiB
Module Region Base likely 0xffffffffc0000000 - 0xffffffffc0400000 1,025 4 KiB
Paging Level guaranteed 48 1 of 2 -
Note: physical and virtual text randomize independently
Note: 1 sub-range excluded from the windows above; the counts
already reflect them (-v lists the ranges).
Evidence (1 finding, 2 components)
Region Position Address Sources
----------------- -------- ------------------ -------
virt kernel image base 0xffffffff93400000 2
[-v: detailed results, memory map, system info] [-H: hardening assessment]
```
Столбец `Certainty` разделяет два разных утверждения об одной и той же
величине. Строка **guaranteed** доказана: истинное значение лежит внутри этого
окна. Строка **likely** — это единственная наилучшая оценка, которую
поддерживают свидетельства; она всегда является подмножеством гарантированного
окна и может быть неверной, поскольку опирается на сигналы ниже порога
достоверности, такие как временные побочные каналы. Результат, на котором стоит
действовать напрямую, — это строка `guaranteed`, суженная до одного кандидата;
значение `likely` — это зацепка для подтверждения, а не факт, на который можно
полагаться.
`-v` добавляет полный подробный вывод (баннер, блок конфигурации системы,
журналы по каждому компоненту, анализ KASLR, карты расположения памяти). `-j`
выдаёт машиночитаемый JSON — полное структурированное представление, всегда
включающее записи по каждому компоненту и оценку защищённости. `-1` выдаёт
одну строку, пригодную для передачи в shell. `-m` форматирует для трекеров
задач. `-H` добавляет оценку защищённости к текстовым/markdown-отчётам.
Полный CLI, подробности режимов вывода, режим объяснения и оценку защищённости
см. в [docs/usage.md](https://github.com/bcoles/kasld/blob/master/docs/usage.md).
## Точка обзора
То, что KASLD может восстановить, зависит от *точки обзора* запущенного
процесса — не от одного уровня привилегий, а от сочетания трёх независимых
вещей:
* **Привилегии, группы и возможности** — непривилегированный uid, членство
в группе, такой как `adm` (которая даёт доступ к журналам ядра в `/var/log/`),
задача контейнера, обладающая дополнительной возможностью, или root. Они не
образуют единой лестницы, поскольку права доступа файловой системы
ограничивают каждый источник независимо: контейнер, которому предоставлен
`CAP_SYS_RAWIO`, является root в init-пространстве имён для этой проверки и
может читать `/proc/kcore` — утечку, недоступную обычному пользователю — в то
время как дистрибутивы различаются в том, доступен ли файл, такой как
`/boot/System.map`, для чтения всем вообще.
* **Конфигурация системы** — `kptr_restrict`, `dmesg_restrict`,
`perf_event_paranoid`, непривилегированный BPF, блокировка ядра. Конфигурация
не зависит от привилегий: root не может читать `/proc/kallsyms` при
`kptr_restrict=2`, тогда как ослабленный sysctl или непривилегированный BPF
могут дать обычному пользователю утечку, в которой усиленно защищённая система
отказала бы.
* **Ограничение** — пространство имён или песочница seccomp, которая маскирует
оракулы `/proc` или блокирует системные вызовы, сужая то, что наблюдает любой
уровень привилегий.
Эти три оси ограничивают каждый источник утечки независимо — поэтому больше
привилегий не является надмножеством меньших: конфигурация может отказать в
источнике root, а побочные каналы обходят sysctl полностью.
[docs/usage.md](https://github.com/bcoles/kasld/blob/master/docs/usage.md#vantage) содержит матрицу «источник утечки —
ограничитель», показывающую, какая ось управляет каждым источником.
KASLD по умолчанию предполагает немного привилегий и оппортунистически
использует всё, что предоставляет точка обзора. Сообщаемое *гарантированное*
окно никогда не зависит от привилегий: повышенный доступ или слабая
конфигурация могут расширить то, что предпринимается, но никогда — достоверное
расположение, которое доказывают свидетельства. Подробный (`-v`), JSON (`-j`) и
Markdown (`-m`) выводы сообщают обнаруженную точку обзора — контейнер,
ограничение, читаемые оракулы и утечки, ограниченные возможностями, достижимые
из текущих возможностей.
## Документация
Впервые в KASLD? Читайте по порядку: [docs/kaslr.md](https://github.com/bcoles/kasld/blob/master/docs/kaslr.md) (что такое
KASLR и что он рандомизирует) → [docs/architecture.md → A leak from end to
end](https://github.com/bcoles/kasld/blob/master/docs/architecture.md#a-leak-from-end-to-end) (как KASLD превращает одну
утечку в ответ) → [docs/limitations.md](https://github.com/bcoles/kasld/blob/master/docs/limitations.md) (что результат
доказывает, а что нет) → [CONTRIBUTING.md](https://github.com/bcoles/kasld/blob/master/CONTRIBUTING.md) (добавление
компонента утечки или правила вывода). Таблица ниже индексирует документацию по
темам.
| Тема | Документ |
|---|---|
| Введение в KASLR | [docs/kaslr.md](https://github.com/bcoles/kasld/blob/master/docs/kaslr.md) — история KASLR по архитектурам, базовый адрес текста по умолчанию, vmsplit, FG-KASLR |
| Использование и CLI | [docs/usage.md](https://github.com/bcoles/kasld/blob/master/docs/usage.md) — CLI, режимы вывода, режим объяснения, оценка защищённости |
| Интерпретация результатов | [docs/limitations.md](https://github.com/bcoles/kasld/blob/master/docs/limitations.md) — что означает отрицательный или частичный результат: достоверный, но не полный, и почему неудача не является гарантией безопасности |
| Методы обхода | [docs/bypass-techniques.md](https://github.com/bcoles/kasld/blob/master/docs/bypass-techniques.md) — утечки через файловую систему, побочные каналы, утечки через системные вызовы / ioctl, слабая энтропия, исправленные CVE, произвольное чтение |
| Эксплуатация | [docs/exploitation.md](https://github.com/bcoles/kasld/blob/master/docs/exploitation.md) — где обход KASLR вписывается в эксплойт, поток управления против только данных, шаблон pwntools, `ksymoff` |
| След и обнаружение | [docs/footprint.md](https://github.com/bcoles/kasld/blob/master/docs/footprint.md) — как выглядит запуск на отслеживаемом хосте: поведенческая сигнатура для его обнаружения и цена OPSEC для оператора; шумный по замыслу |
| Утилиты | [extra/README.md](https://github.com/bcoles/kasld/blob/master/extra/README.md) — вспомогательные скрипты в `extra/` (захват/воспроизведение, проверка достоверности, сравнение состояний, `ksymoff`) и как они сочетаются |
| Архитектура и внутреннее устройство | [docs/architecture.md](https://github.com/bcoles/kasld/blob/master/docs/architecture.md) — механизм вывода, швы потоков данных, протокол строк с тегами, вывод между регионами |
| Достоверность | [docs/soundness.md](https://github.com/bcoles/kasld/blob/master/docs/soundness.md) — что гарантирует сообщаемое окно, как формальные свойства: решётка, которую обозначает каждая величина, обязательство для правила, включение истины, порог уверенности, граница завершения |
| Участие в разработке | [CONTRIBUTING.md](https://github.com/bcoles/kasld/blob/master/CONTRIBUTING.md) — написание компонента или правила, API эмиттера, коды выхода, метаданные |
| Схема JSON | [docs/kasld.schema.json](https://github.com/bcoles/kasld/blob/master/docs/kasld.schema.json) — документ `-j` как JSON Schema: проверка по ней принятого снимка или генерация типов из неё. `schema_version` и правило его совместимости — в [docs/usage.md](https://github.com/bcoles/kasld/blob/master/docs/usage.md#json--j) |
| Тестирование и CI | [docs/testing.md](https://github.com/bcoles/kasld/blob/master/docs/testing.md) — тесты на хосте, фикстуры воспроизведения, кросс-архитектуры под qemu-user, покрытие |
| Воспроизводимость | [docs/reproducibility.md](https://github.com/bcoles/kasld/blob/master/docs/reproducibility.md) — независимая проверка: на локальном ядре, вживую на разных архитектурах или по захваченному корпусу |
## Сборка
Требуется компилятор, поддерживающий макрос `_GNU_SOURCE`, из-за
использования непортируемого кода (`MAP_ANONYMOUS`, `getline()`, `popen()`, …).
```
make # build kasld + components
make run # build and run
make test # build and run unit tests
make cross # cross-compile for all supported architectures
make install # install to /usr/local (PREFIX=/usr/local)
make install-strip # install, then strip the installed binaries
make installcheck # smoke-test the installed bin/kasld + libexec/kasld/
make uninstall # remove installed files
make clean # remove build directory
make print-deps # list build dependencies (libs + per-component flags)
make help # show all targets and options
```
`COMPONENTS` ограничивает сборку компонентами, соответствующими шаблону, так
что цель, которая может запускать лишь несколько методов, поставляет только их.
Шаблоны именуют компоненты и разделяются запятыми или пробелами, в той же форме,
которую принимает флаг `--skip`; шаблон, не совпадающий ни с чем, останавливает
сборку, а не сужает её молча. Если не задано, собираются все компоненты.
```
make cross COMPONENTS='dmesg_*,sysfs_devicetree_*,devicetree_facts,proc_*'
```
Компоненты составляют большую часть установленного размера, поэтому выбор — это
рычаг для маленького rootfs — и он пропорционально сокращает сборку, что даёт
большую экономию на семнадцати целях.
Как и `CC`, выбор принадлежит вызову, а не дереву: запуск `install` или
`install-strip` без него пересобирает и устанавливает всё, поэтому передавайте
его и им тоже.
```
make install-strip COMPONENTS='dmesg_*,proc_*' DESTDIR=/staging PREFIX=/usr
```
`make print-deps` сообщает требуемый инструментарий, две необязательные
библиотеки (`pthread`, `zlib`) с результатом их автоопределения для текущего
компилятора и исключения флагов компиляции/компоновки по компонентам — этого
достаточно, чтобы заполнить control-файл пакета дистрибутива без чтения логики
проверок в Makefile.
`make installcheck` запускает установленный `bin/kasld` и подтверждает, что он
обнаруживает свои компоненты через путь FHS `../libexec/kasld` — дымовой тест
после установки для схемы раздельной установки, использующий те же
`PREFIX`/`DESTDIR`, что и `make install` (поэтому он также работает против
staging-корня `DESTDIR` в CI пакетов).
`make install` также устанавливает страницы руководства `man1` для `kasld` и
`ksymoff` в `<prefix>/share/man/man1/`, так что `man kasld` и `man ksymoff`
работают после установки.
KASLD можно кросс-компилировать с помощью `make`, указав подходящий компилятор
(`CC`). При кросс-компиляции статическая компоновка применяется автоматически:
```
make CC=aarch64-linux-musl-gcc
```
Собрать все поддерживаемые цели кросс-компиляции (инструментарии должны быть в
`PATH`):
```
make cross
```
## Лицензия
KASLD распространяется под лицензией MIT (см. [LICENSE](https://github.com/bcoles/kasld/blob/master/LICENSE)). Некоторые
компоненты утечек адаптируют сторонний код proof-of-concept или реализуют метод,
впервые опубликованный другими; каждый такой файл указывает своего исходного
автора и источник в заголовке, а [THIRD-PARTY-NOTICES.md](https://github.com/bcoles/kasld/blob/master/THIRD-PARTY-NOTICES.md)
перечисляет каждый с его лицензией или основанием для повторного использования
(лицензия upstream, разрешение автора или материал метода/воспроизведения,
перереализованный здесь).
## Цитирование KASLD
KASLD распространяется под лицензией MIT — указание авторства не требуется для
использования, но цитирование или ссылка приветствуются везде, где на него
ссылаются в исследованиях, инструментах, эксплойтах или текстах:
> **KASLD: Kernel Address Space Layout Derandomization**, Brendan Coles,
> https://github.com/bcoles/kasld
BibTeX:
```bibtex
@software{kasld,
title = {KASLD: Kernel Address Space Layout Derandomization},
author = {Coles, Brendan},
url = {https://github.com/bcoles/kasld},
version = {0.4.1},
year = {2026}
}
```
GitHub также показывает кнопку *"Cite this repository"* из
[CITATION.cff](https://github.com/bcoles/kasld/blob/master/CITATION.cff). Для невыпущенной сборки из `master` цитируйте
конкретный коммит и дату обращения — например, `bcoles/kasld@<commit>`
(accessed YYYY-MM-DD) — поскольку строки версии `-dev` не уникальны для
отдельного коммита.