
KASLDは、ローカルプロセスからLinuxカーネルの仮想メモリおよび物理メモリのレイアウトを非ランダム化する。その際、特権、設定、隔離といったその時点で利用可能な vantage を活用する。
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/48542/27960c6a9cf0003d33879e796f71de7930ff461d87e9c6333b9522d822615306.png" alt="Copilotで生成されたKASLDロゴ(切り抜き)"/>
</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カーネルの仮想メモリおよび物理メモリのレイアウト — 主にカーネルテキストベース — を復元します。何を復元できるかは、そのプロセスの視点(vantage)の関数です。すなわち、そのプロセスの権限とケイパビリティ、システムの設定、およびコンテナによる隔離です。リークやサイドチャネルが許す場合にはベースを直接復元し、そうでない場合には、利用可能な証拠が支持する最小の配置候補集合に絞り込みます。
推論エンジンは、数十の独立した手法からの証拠をアーキテクチャの既知の不変条件と融合し、カーネルの配置を残差ウィンドウに絞り込みます。これは、生き残った*スロット*数(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`列は、同じ量についての2つの異なる主張を区別します。**guaranteed**行は証明済みです。真の値はそのウィンドウ内にあります。**likely**行は、証拠が支持する単一の最良推定値です — 常にguaranteedウィンドウの部分集合であり、タイミングサイドチャネルなど健全性の下限を下回るシグナルに依拠するため、誤っている可能性があります。直接行動に移す価値のある結果は、1つの候補に絞り込まれた`guaranteed`行です。`likely`値は確認すべき手がかりであり、依拠すべき事実ではありません。
`-v`は完全な詳細読み出し(バナー、システム設定ブロック、コンポーネントごとのログ、KASLR分析、メモリレイアウトマップ)を追加します。`-j`は機械可読なJSONを出力します — 完全な構造化ビューであり、常にコンポーネントごとのレコードと堅牢化評価を含みます。`-1`はシェルでパイプ可能な単一行を出力します。`-m`はイシュートラッカー向けにフォーマットします。`-H`はテキスト/Markdownレポートに堅牢化評価を追加します。
完全なCLI、出力モードの詳細、explainモード、および堅牢化評価については[docs/usage.md](https://github.com/bcoles/kasld/blob/master/docs/usage.md)を参照してください。
## 視点(Vantage)
KASLDが復元できるものは、実行中プロセスの*視点*に依存します — 単一の権限レベルではなく、3つの独立した要素の組み合わせです:
* **権限、グループ、およびケイパビリティ** — 非特権uid、`adm`などのグループへの所属(`/var/log/`配下のカーネルログへのアクセスを許可する)、追加のケイパビリティを保持するコンテナタスク、またはroot。これらは単一のはしごを形成しません。なぜなら、ファイルシステムのパーミッションが各ソースを独立してゲートするからです。`CAP_SYS_RAWIO`を付与されたコンテナはそのチェックに対してinit名前空間のrootであり、`/proc/kcore`を読み取れます — これは通常のユーザーが到達できないリークです — 一方、`/boot/System.map`のようなファイルがそもそも誰でも読めるかどうかはディストリビューションによって異なります。
* **システム設定** — `kptr_restrict`、`dmesg_restrict`、`perf_event_paranoid`、非特権BPF、カーネルロックダウン。設定は権限とは独立です。rootは`kptr_restrict=2`の下では`/proc/kallsyms`を読めませんが、緩和されたsysctlや非特権BPFは、堅牢化されたシステムなら拒否するリークを一般ユーザーに与えることがあります。
* **隔離** — `/proc`オラクルをマスクしたり、システムコールをブロックしたりする名前空間またはseccompサンドボックスで、あらゆる権限レベルが観測できるものを狭めます。
3つの軸は各リークソースを独立してゲートします — したがって、より多くの権限はより少ない権限のスーパーセットではありません。設定はrootに対してソースを拒否でき、サイドチャネルはsysctlを完全にバイパスします。[docs/usage.md](https://github.com/bcoles/kasld/blob/master/docs/usage.md#vantage)には、各ソースをどの軸が制御するかを示すリークソース別ゲートのマトリクスがあります。
KASLDはデフォルトで少数の権限を想定し、視点が与えるものを日和見的に利用します。報告される*guaranteed*ウィンドウは決して権限に依存しません。昇格したアクセスや弱い設定は、試行されるものを広げることはあっても、証拠が証明する健全なレイアウトを広げることはありません。詳細(`-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が1つのリークをどのように答えに変えるか)→ [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、出力モード、explainモード、堅牢化評価 |
| 結果の解釈 | [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) — 独立した検証: ローカルカーネル上、アーキテクチャをまたいでライブで、またはキャプチャしたコーパス上で |
## ビルド
非ポータブルなコード(`MAP_ANONYMOUS`、`getline()`、`popen()`、…)を使用するため、`_GNU_SOURCE`マクロをサポートするコンパイラが必要です。
```
make # kasld + コンポーネントをビルド
make run # ビルドして実行
make test # ビルドしてユニットテストを実行
make cross # サポートされるすべてのアーキテクチャ向けにクロスコンパイル
make install # /usr/local にインストール (PREFIX=/usr/local)
make install-strip # インストール後、インストールされたバイナリをstrip
make installcheck # インストールされた bin/kasld + libexec/kasld/ のスモークテスト
make uninstall # インストールされたファイルを削除
make clean # ビルドディレクトリを削除
make print-deps # ビルド依存関係を一覧表示 (libs + コンポーネントごとのフラグ)
make help # すべてのターゲットとオプションを表示
```
`COMPONENTS`はビルドをglobに一致するコンポーネントに制限するため、ごく少数の手法しか実行できないターゲットにはそれだけを同梱します。パターンはコンポーネントを指定し、カンマまたはスペース区切りで、`--skip`フラグが取るのと同じ形式です。何にも一致しないパターンは、ビルドを黙って狭めるのではなく停止させます。未設定の場合、すべてのコンポーネントがビルドされます。
```
make cross COMPONENTS='dmesg_*,sysfs_devicetree_*,devicetree_facts,proc_*'
```
コンポーネントはインストールサイズの大部分を占めるため、選択は小さなrootfsのためのレバーです — そしてビルドを比例して削減します。これは17のターゲット全体でより大きな節約になります。
`CC`と同様に、選択はツリーではなく呼び出しに属します。それなしで`install`または`install-strip`を実行すると、すべてを再ビルドしてインストールするため、それらにも渡してください。
```
make install-strip COMPONENTS='dmesg_*,proc_*' DESTDIR=/staging PREFIX=/usr
```
`make print-deps`は、必要なツールチェーン、2つのオプションライブラリ(`pthread`、`zlib`)と現在のコンパイラでの自動検出結果、およびコンポーネントごとのコンパイル/リンクフラグの例外を報告します — Makefileのプローブロジックを読むことなく、ディストリビューションパッケージのcontrolファイルを埋めるのに十分です。
`make installcheck`は、インストールされた`bin/kasld`を実行し、FHSの`../libexec/kasld`パスを介してコンポーネントを検出することを確認します — 分割インストールレイアウトのインストール後スモークテストであり、`make install`と同じ`PREFIX`/`DESTDIR`を使用します(したがって、パッケージCIの`DESTDIR`ステージングルートに対しても機能します)。
`make install`はまた、`kasld`と`ksymoff`の`man1`マニュアルページを`<prefix>/share/man/man1/`にインストールするため、インストール後に`man kasld`と`man ksymoff`が機能します。
KASLDは、適切なコンパイラ(`CC`)を指定することで`make`でクロスコンパイルできます。クロスコンパイル時には静的リンクが自動的に適用されます:
```
make CC=aarch64-linux-musl-gcc
```
サポートされるすべてのクロスコンパイルターゲットをビルドします(ツールチェーンが`PATH`にある必要があります):
```
make cross
```
## ライセンス
KASLDはMITライセンスです([LICENSE](https://github.com/bcoles/kasld/blob/master/LICENSE)を参照)。一部のリークコンポーネントは、サードパーティの概念実証コードを適応させたり、他者によって最初に公開された手法を実装したりしています。そのような各ファイルは、そのヘッダーに元の作者とソースを明記しており、[THIRD-PARTY-NOTICES.md](https://github.com/bcoles/kasld/blob/master/THIRD-PARTY-NOTICES.md)はそれぞれをそのライセンスまたは再利用の根拠(アップストリームライセンス、作者の許可、またはここで再実装された手法/再現資料)とともに一覧表示しています。
## 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はまた、[CITATION.cff](https://github.com/bcoles/kasld/blob/master/CITATION.cff)から*「Cite this repository」*ボタンを表示します。`master`からの未リリースビルドについては、特定のコミットとアクセス日を引用してください — 例: `bcoles/kasld@<commit>`(アクセス日 YYYY-MM-DD)— `-dev`バージョン文字列は単一のコミットに固有ではないためです。