OGhidra 3 - AIを活用したGhidraによるリバースエンジニアリング

Claudeにインスパイアされたオーケストレーターを使用するバージョンは、 https://github.com/llnl/OGhidra/tree/orchestrator を参照してください。

OGhidraは、大規模言語モデルとGhidraのリバースエンジニアリングプラットフォームを橋渡しし、自然言語によるAI駆動のバイナリ解析を可能にします。対話的にバイナリを分析し、複雑なワークフローを自動化し、ローカルAIモデルで完全なプライバシーを維持します。

YouTubeセットアップチュートリアル

---

OGhidraとは？

OGhidraはGhidraにAI機能を追加し、以下のことが可能になります：

• 自然言語分析 - 関数、文字列、インポートについて平易な英語で質問
• 自動化ワークフロー - 関数の名前変更、パターン検出、包括的なレポート生成
• ローカルAIモデル - ハードウェア上で動作するモデルで完全なプライバシー（Ollama）
• クラウドAIサポート - 外部APIへの接続（OpenAI, Google Gemini, Anthropic Claude）
• マルウェア検出 - 12以上の回避・インジェクション手法の自動パターンマッチング
• スマート列挙 - バイナリ解析から検索可能なナレッジグラフを構築
• マルチインスタンス解析 - 並列解析のために複数のGhidraインスタンスを実行

動作の仕組み

graph TD
    A[User Query] --> B[Planning Phase]
    B --> C{Execution Phase}
    C -- Tool Calls --> D[Ghidra/LLM]
    D --> C
    C --> E[Review Phase]
    E -- Agentic Loop --> B
    E --> F[Final Response]

    style E fill:#f9f,stroke:#333,stroke-width:2px
    style B fill:#bbf,stroke:#333,stroke-width:2px

エージェントループ: OGhidraは適応型プランニングシステムを使用します。各実行サイクルの後、結果がレビューされ、AIは最終応答を提供する前に、より多くの情報を収集するか分析を洗練するかを選択できます。

---

クイックスタート

前提条件

1. Python 3.12以上 - バージョンを確認: python --version
2. Ghidra 12.0.3（推奨） - Ghidra Releasesからダウンロード
   • プラグインのビルド/インストールパスはGhidra 12.0.3向けに文書化されています
   • テスト済み: Ghidra 11.0.3, 11.3.2, 12.0.2, 12.0.3
3. Java 21 - Ghidra 12.0.3拡張機能のビルドに必要: java -version
4. Ollama（オプション、ローカルモデル用） - ollama.comからインストール

インストール

# Clone repository
git clone https://github.com/LLNL/OGhidra.git
cd OGhidra

# Install dependencies (choose one)
uv sync                          # Using UV (recommended)
pip install -r requirements.txt  # Using pip

# Configure environment
cp .env.example .env
# Edit .env with your settings

Ghidraプラグインのセットアップ

以下のOGhidraMCPプラグインビルド手順はGhidra 12.0.3（推奨）を対象としています。 YouTubeのビデオチュートリアルもあります: https://www.youtube.com/watch?v=hBD92FUgR0Y

GhidraMCP拡張機能のビルド

開発者は、Ghidraにインストールする前にGhidraMCP拡張機能をビルドする必要があります：

1. 前提条件:

   • Ghidra 12.0.3がインストールされていること
   • Java 21

2. オプション1: 自動ビルドスクリプトを使用:

   • Windows:

     # Set the path to your Ghidra installation (will attempt to find last run copy of Ghidra if not set)
     set GHIDRA_INSTALL_DIR=C:\path\to\ghidra_12.0.3_PUBLIC
     
     # Run the build script
     build_ghidra_plugin.bat
     

   • Unix/Linux/Mac:

     # Set the path to your Ghidra installation (will attempt to find the last run copy of Ghidra if not set)
     export GHIDRA_INSTALL_DIR=/path/to/ghidra_12.0.3_PUBLIC
     
     # Run the build script (make it executable first if needed)
     chmod +x build_ghidra_plugin.sh
     ./build_ghidra_plugin.sh
     

3. オプション2: 手動ビルド手順:

   • Ghidraのインストールパスを指定してOGhidraMCP/gradle.propertiesを作成/更新:

     GHIDRA_INSTALL_DIR=/absolute/path/to/ghidra_12.0.3_PUBLIC
     

   • Unix/Linux/macOSの場合:

     cd OGhidraMCP
     $GHIDRA_INSTALL_DIR/support/gradle/gradlew buildExtension --info
     

   • Windowsの場合:

     cd OGhidraMCP
     "%GHIDRA_INSTALL_DIR%\support\gradle\gradlew.bat" buildExtension --info
     

4. ビルドされた拡張機能の場所:

   • 拡張機能のzipファイルはOGhidraMCP/dist/に作成されます
   • ファイル名はghidra_12.0.3_PUBLIC_YYYYMMDD_OGhidraMCP.zipのようになります

GhidraMCP拡張機能のインストール

拡張機能のビルドが成功したら：

1. Ghidraにインストール:

   • Ghidraを開き、File -> Install Extensions
   • Add Extension（緑のプラスアイコン）をクリック
   • OGhidraMCP/dist/ディレクトリを参照
   • 新しくビルドした拡張機能のzipファイル（例: ghidra_12.0.3_PUBLIC_YYYYMMDD_OGhidraMCP.zip）を選択
   • Ghidraを再起動

2. プラグインを有効化:

   • Ghidraプロジェクトを開く
   • File → Configure → Enable Developer
   • OGhidraMCPプラグインを有効化
   • サーバーがhttp://localhost:8080/methodsで起動します

   コードブラウザを開いている必要があります

AIモデルのプル

# For Ollama (local models)
ollama pull gemma3:27b           		# Good balance (20GB RAM)
ollama pull nomic-embed-text     		# Embedding model for RAG

# Alternative models
ollama pull gpt-oss:120b         		# High quality (80GB RAM)
ollama pull devstral-2:123b 			# High quality (80GB RAM)
ollama pull devstral-2:123b-cloud       # Cloud Model

OGhidraの起動

# GUI Mode (recommended)
uv run main.py --ui

# Interactive CLI
uv run main.py --interactive

# In interactive CLI, test connection
health

GUIモードで起動した場合は、以下を使用:

curl http://localhost:8080/methods

---

設定

.envを編集してAIプロバイダを設定:

オプション1: ローカルモデル（Ollama）

LLM_PROVIDER=ollama
OLLAMA_BASE_URL=http://localhost:11434/
OLLAMA_MODEL=gemma3:27b
OLLAMA_EMBEDDING_MODEL=nomic-embed-text

オプション2: 外部API

LLM_PROVIDER=external
EXTERNAL_PROVIDER=google
EXTERNAL_API_KEY=your-api-key-here
EXTERNAL_MODEL=gemini-3.1-flash-lite-preview
EXTERNAL_EMBEDDING_MODEL=gemini-embedding-001

オプション3: カスタムOpenAI互換API

LLM_PROVIDER=custom_api
CUSTOM_API_URL=https://api.example.com/v1/chat/completions
CUSTOM_API_KEY=your-api-key-here
CUSTOM_API_MODEL=your-model-name
CUSTOM_API_EMBEDDING_MODEL=your-embedding-model

コンテキスト管理設定

モデルのコンテキストウィンドウに基づいて調整:

# Context budget in tokens (adjust to your model's limit)
CONTEXT_BUDGET=100000              # 100K tokens for mid-size models
                                   # 200K+ for frontier models

# Execution settings
MAX_EXECUTION_STEPS=5              # Steps per planning cycle
MAX_AGENTIC_CYCLES=3               # How many plan-execute-review loops
AGENTIC_LOOP_ENABLED=true          # Enable adaptive replanning

---

主な機能

1. スマートツールボタン（GUI）

一般的なリバースエンジニアリングタスクへのワンクリックアクセス:

ツール	説明
現在の関数を分析	選択した関数の動作を詳細に調査
現在の関数をリネーム	AIが分析に基づいて意味のある名前を提案
すべての関数をリネーム	Smart/Full/リネームのみのオプションで一括リネーム
インポートを分析	ライブラリと外部依存関係を特定
文字列を分析	URL、認証情報、設定データを検出
レポート生成	包括的なセキュリティ評価

2. タスクモード

専門的な分析目標を設定:

# In GUI: Use "Task Mode" dropdown
# In CLI: set task_mode <mode>

task_mode malware      # Malware analysis with pattern detection
task_mode vuln         # Vulnerability research focus
task_mode general      # General reverse engineering

3. マルウェアパターン検出

12以上のマルウェアパターンを自動検出:

• 回避: PEB Walking、動的API解決、アンチデバッグ、アンチVM
• インジェクション: プロセスインジェクション（ローカル/リモート）
• 永続化: レジストリ、ファイルシステムフック
• 難読化: 文字列エンコーディング、APIハッシュ
• 権限昇格: トークン操作、UACバイパス

パターンはMITRE ATT&CKマッピングとともにAIのコンテキストで自動アラートをトリガーします。

4. スマート列挙

バイナリ解析からリッチで検索可能なナレッジを構築:

# Enumerate all functions with AI summaries
# Choose from:
- Rename Only: Only process generic function names
- Smart Enumeration: Focus on security-relevant functions
- Full Enumeration: Analyze every function in the binary

機能:

• 構造化メタデータ抽出（LOC、複雑性、操作）
• セマンティック検索の最適化
• インテントベースのコンテキストアセンブリ
• 正確な検索のためのマルチベクターサポート

5. セッション管理

分析セッションの保存と復元:

# Save progress
File → Save Session

# Load previous work
File → Load Session

# Auto-save after bulk operations
# Sessions include:
- Analyzed functions with summaries
- RAG vectors for semantic search
- Performance statistics
- UI state

---

バックエンドのセットアップ

OGhidraは2つのバックエンドタイプをサポート:

• MCP — GhidraMCPサーバーと統合し、分析中はGhidraクライアントが実行中である必要があります
• PyGhidra — Ghidraクライアントなしでヘッドレス分析をサポートし、MCPで必要なサーバーコンポーネントを排除します

バックエンドの選択

以下のコマンドラインオプションを使用してバックエンドを選択:

--ghidra-backend={http,pyghidra}