binary-analysis-patterns について
コンパイル済みバイナリを調べるセキュリティ分析者やリバースエンジニア向けのパターンガイドです。アセンブリ、制御フローの復元、データ構造の推定、Ghidra と IDA Pro の手法を扱います。
主な機能
- 01一般的なアセンブリパターンの識別
- 02プログラム制御フローの復元
- 03データ構造と型の推定
- 04関数シグネチャの推定
- 05Ghidra と IDA Pro の手法
活用シーン
- 01未知の実行ファイルの調査
- 02マルウェアや難読化バイナリの分析
- 03コンパイル済みコードからのロジック復元
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ wshobson/ agents --skill binary-analysis-patternsインストール後、Claude Code で/binary-analysis-patternsを入力して読み込まれたか確認します。
同梱ファイルreferences/details.md
詳細
バイナリ解析パターン
コンパイル済みバイナリを解析し、アセンブリコードを理解し、プログラムロジックを再構築するための包括的なパターンとテクニック。
このスキルを使用する場面
- 未知の実行ファイルをリバースエンジニアリングして動作を理解する
- Ghidra / IDA Pro / Binary Ninja でマルウェアや難読化されたバイナリを解析する
- 一般的なアセンブリのイディオム(関数プロローグ、スイッチテーブル、vtable ディスパッチ)を認識する
- コンパイル済みコードから高レベルの制御フローを再構築する
- コンパイラが導入したパターン(スタックカナリア、PIC トランポリン)を特定する
詳細セクション: 逆アセンブリの基礎
元々この SKILL.md 内にあった 2047 バイトのセクションです。Codex のスキル本体 8 KB の上限に収めるため、references/details.md に移動しました。
制御フローパターン
条件分岐
; if (a == b)
cmp eax, ebx
jne skip_block
; ... if body ...
skip_block:
; if (a < b) - signed
cmp eax, ebx
jge skip_block ; Jump if greater or equal
; ... if body ...
skip_block:
; if (a < b) - unsigned
cmp eax, ebx
jae skip_block ; Jump if above or equal
; ... if body ...
skip_block:
ループパターン
; for (int i = 0; i < n; i++)
xor ecx, ecx ; i = 0
loop_start:
cmp ecx, [n] ; i < n
jge loop_end
; ... loop body ...
inc ecx ; i++
jmp loop_start
loop_end:
; while (condition)
jmp loop_check
loop_body:
; ... body ...
loop_check:
cmp eax, ebx
jl loop_body
; do-while
loop_body:
; ... body ...
cmp eax, ebx
jl loop_body
switch 文のパターン
; Jump table pattern
mov eax, [switch_var]
cmp eax, max_case
ja default_case
jmp [jump_table + eax*8]
; Sequential comparison (small switch)
cmp eax, 1
je case_1
cmp eax, 2
je case_2
cmp eax, 3
je case_3
jmp default_case
データ構造パターン
配列アクセス
; array[i] - 4-byte elements
mov eax, [rbx + rcx*4] ; rbx=base, rcx=index
; array[i] - 8-byte elements
mov rax, [rbx + rcx*8]
; Multi-dimensional array[i][j]
; arr[i][j] = base + (i * cols + j) * element_size
imul eax, [cols]
add eax, [j]
mov edx, [rbx + rax*4]
構造体アクセス
struct Example {
int a; // offset 0
char b; // offset 4
// padding // offset 5-7
long c; // offset 8
short d; // offset 16
};
; Accessing struct fields
mov rdi, [struct_ptr]
mov eax, [rdi] ; s->a (offset 0)
movzx eax, byte [rdi+4] ; s->b (offset 4)
mov rax, [rdi+8] ; s->c (offset 8)
movzx eax, word [rdi+16] ; s->d (offset 16)
連結リストの走査
; while (node != NULL)
list_loop:
test rdi, rdi ; node == NULL?
jz list_done
; ... process node ...
mov rdi, [rdi+8] ; node = node->next (assuming next at offset 8)
jmp list_loop
list_done:
一般的なコードパターン
文字列操作
; strlen pattern
xor ecx, ecx
strlen_loop:
cmp byte [rdi + rcx], 0
je strlen_done
inc ecx
jmp strlen_loop
strlen_done:
; ecx contains length
; strcpy pattern
strcpy_loop:
mov al, [rsi]
mov [rdi], al
test al, al
jz strcpy_done
inc rsi
inc rdi
jmp strcpy_loop
strcpy_done:
; memcpy using rep movsb
mov rdi, dest
mov rsi, src
mov rcx, count
rep movsb
算術パターン
; Multiplication by constant
; x * 3
lea eax, [rax + rax*2]
; x * 5
lea eax, [rax + rax*4]
; x * 10
lea eax, [rax + rax*4] ; x * 5
add eax, eax ; * 2
; Division by power of 2 (signed)
mov eax, [x]
cdq ; Sign extend to EDX:EAX
and edx, 7 ; For divide by 8
add eax, edx ; Adjust for negative
sar eax, 3 ; Arithmetic shift right
; Modulo power of 2
and eax, 7 ; x % 8
ビット操作
; Test specific bit
test eax, 0x80 ; Test bit 7
jnz bit_set
; Set bit
or eax, 0x10 ; Set bit 4
; Clear bit
and eax, ~0x10 ; Clear bit 4
; Toggle bit
xor eax, 0x10 ; Toggle bit 4
; Count leading zeros
bsr eax, ecx ; Bit scan reverse
xor eax, 31 ; Convert to leading zeros
; Population count (popcnt)
popcnt eax, ecx ; Count set bits
逆コンパイルパターン
変数の復元
; Local variable at rbp-8
mov qword [rbp-8], rax ; Store to local
mov rax, [rbp-8] ; Load from local
; Stack-allocated array
lea rax, [rbp-0x40] ; Array starts at rbp-0x40
mov [rax], edx ; array[0] = value
mov [rax+4], ecx ; array[1] = value
関数シグネチャの復元
; Identify parameters by register usage
func:
; rdi used as first param (System V)
mov [rbp-8], rdi ; Save param to local
; rsi used as second param
mov [rbp-16], rsi
; Identify return by RAX at end
mov rax, [result]
ret
型の復元
; 1-byte operations suggest char/bool
movzx eax, byte [rdi] ; Zero-extend byte
movsx eax, byte [rdi] ; Sign-extend byte
; 2-byte operations suggest short
movzx eax, word [rdi]
movsx eax, word [rdi]
; 4-byte operations suggest int/float
mov eax, [rdi]
movss xmm0, [rdi] ; Float
; 8-byte operations suggest long/double/pointer
mov rax, [rdi]
movsd xmm0, [rdi] ; Double
Ghidra 解析のヒント
逆コンパイルの改善
// In Ghidra scripting
// Fix function signature
Function func = getFunctionAt(toAddr(0x401000));
func.setReturnType(IntegerDataType.dataType, SourceType.USER_DEFINED);
// Create structure type
StructureDataType struct = new StructureDataType("MyStruct", 0);
struct.add(IntegerDataType.dataType, "field_a", null);
struct.add(PointerDataType.dataType, "next", null);
// Apply to memory
createData(toAddr(0x601000), struct);
パターンマッチングスクリプト
# Find all calls to dangerous functions
for func in currentProgram.getFunctionManager().getFunctions(True):
for ref in getReferencesTo(func.getEntryPoint()):
if func.getName() in ["strcpy", "sprintf", "gets"]:
print(f"Dangerous call at {ref.getFromAddress()}")
IDA Pro パターン
IDAPython による解析
import idaapi
import idautils
import idc
# Find all function calls
def find_calls(func_name):
for func_ea in idautils.Functions():
for head in idautils.Heads(func_ea, idc.find_func_end(func_ea)):
if idc.print_insn_mnem(head) == "call":
target = idc.get_operand_value(head, 0)
if idc.get_func_name(target) == func_name:
print(f"Call to {func_name} at {hex(head)}")
# Rename functions based on strings
def auto_rename():
for s in idautils.Strings():
for xref in idautils.XrefsTo(s.ea):
func = idaapi.get_func(xref.frm)
if func and "sub_" in idc.get_func_name(func.start_ea):
# Use string as hint for naming
pass
ベストプラクティス
解析ワークフロー
- 初回トリアージ: ファイル形式、アーキテクチャ、インポート/エクスポート
- 文字列解析: 興味深い文字列、エラーメッセージを特定する
- 関数の特定: エントリポイント、エクスポート、クロスリファレンス
- 制御フローのマッピング: プログラム構造を理解する
- データ構造の復元: 構造体、配列、グローバルを特定する
- アルゴリズムの特定: 暗号、ハッシュ、圧縮
- ドキュメント化: コメント、シンボルのリネーム、型定義
よくある落とし穴
- 最適化による痕跡: コードがソース構造と一致しないことがある
- インライン関数: 関数がインライン展開されていることがある
- 末尾呼び出し最適化:
call+retではなくjmp - デッドコード: 最適化による到達不能コード
- 位置独立コード: RIP 相対アドレッシング
コメント
Markdown 対応