mafifrizi/aresMITRE ATT&CKモジュールオーケストレーション、DAG攻撃パス解決、OPSEC制御、暗号化資格情報保管庫、マルチフォーマットレポートを備えた自律型レッドチームエンゲージメントプラットフォーム。
エンタープライズのレッドチーム、MSSP、セキュリティオペレーションセンターが、標的型攻撃エンゲージメントを実行し、決定論的な攻撃パスを発見し、副次的なリスクゼロで防御態勢を継続的に検証できるようにするオープンコアプラットフォーム。
プラットフォームショーケース • なぜARESなのか? • 競合比較マトリクス • アーキテクチャ • MITREマトリクス • クイックスタート • ゼロトラストセキュリティ • ドキュメント
従来のペネトレーションテストは根本的に欠陥を抱えています。高コストで、断続的で、ある一時点の状態しか示さず、新たに導入された設定ミスや新興の攻撃者手法に対して組織を無防備なままにします。一方、自動化された脆弱性スキャナは、悪用可能性や多段階の横展開攻撃パスを実証することなく、数千もの仮説上のCVEでSOCチームを圧倒するだけです。
ARESはこのギャップを埋めます。 最新のエンタープライズインフラ向けにゼロから構築されたARESは、現実世界の脅威アクターをモデル化した自律的で目標指向のレッドチームエンゲージメントプラットフォームを提供します。カーネルレベルの厳格なスコープファイアウォール、適応型OPSECノイズプロファイリング、インタラクティブな有向非巡回グラフ(DAG)攻撃ソルバー、そしてMITRE ATT&CKにマッピングされた60以上の武器化された技術を組み合わせることで、ARESはセキュリティチームが脆弱性の悪用可能性を証明し、Active Directoryの最重要資産(Crown Jewels)への最短侵害パスを特定し、運用停止ゼロで経営層向けの成果物を生成することを可能にします。
THE ARES ADVANTAGE
┌─────────────────────────┐ ┌─────────────────────────┐ ┌─────────────────────────┐ │ STRICT SCOPE ENCLAVE │ │ AUTONOMOUS DAG ENGINE │ │ ZERO-TRUST ARCHITECTURE │ │ Hard kernel CIDR egress │ │ Computes shortest paths │ │ Memory-only JWT tokens, │ │ whitelisting prevents │───│ to Domain Admins & Crown│───│ AES-256 encrypted vault,│ │ any collateral impact. │ │ Jewels deterministically│ │ strict HMAC-CSRF checks.│ └─────────────────────────┘ └─────────────────────────┘ └─────────────────────────┘ │ ▼ ┌─────────────────────────┐ │ INSTANT EXECUTIVE SUITE │ │ Branded PDF, HTML, JSON │ │ deliverables with zero │ │ native GTK dependencies │ └─────────────────────────┘
### コアバリューピラー
1. **🛡️ ゼロ・コラテラル・スコープ・ガバナンス**: すべてのキャンペーンは隔離された暗号境界内で実行されます。ネットワークソケット層での厳格なターゲットIPおよびCIDR検証により、スコープ外のインフラにパケットが到達することは一切ありません。
2. **🧠 自律的目標指向プランニング**: オペレーターは高レベルの目標（例: `domain_admin`、`full_compromise`、`cloud_audit`）を設定し、ARES意思決定エンジンがグラフヒューリスティクスとオプションのLLMエージェント（Claude / OpenAI / ローカルOllama）を用いて多段階の実行パスを自律的に合成します。
3. **🕸️ マルチベクター攻撃グラフ（DAG）**: BloodHoundコレクションを取り込むか、アクティブなドメインセッションをリアルタイムでマッピングします。内蔵のグラフエンジンが最短攻撃パスを計算し、チョークポイントを強調表示し、横方向へのピボットの実現可能性をシミュレートします。
4. **🔐 多層防御セキュリティモデル**: ゼロトラスト環境向けに設計されています。データベースを権威とするセッション、メモリのみの短命JWTアクセストークン、HttpOnlyのローテーションリフレッシュクレデンシャル、およびAES-256-GCM暗号化ローカルボールトが、収集したハッシュと機密性の高いクライアント証拠を保護します。
5. **📑 自動化された成果物パイプライン**: ブランド化された監査対応のコンプライアンス成果物をPDF、HTML、Markdown、JSON形式でワンクリック生成します。外部GTK依存なしでWindows/Linux上での自動ヘッドレスブラウザPDFレンダリングを特徴とします。
---
## 📊 市場比較マトリクス
| 運用能力 | 従来の手動ペネトレーションテスト | レガシー脆弱性スキャナー | ARES自律型プラットフォーム |
| :--- | :---: | :---: | :---: |
| **テスト頻度** | 年次 / 半年次 | 毎日 / 毎週のスケジュール | **継続的 / オンデマンド** |
| **悪用可能性の検証** | 手動かつ労力集約的 | ❌ 理論上のCVEマッチング | **決定論的多段階プルーフ** |
| **マルチホップ攻撃パス** | 手動描画 | ❌ なし | **リアルタイムインタラクティブDAG** |
| **スコープエンクレーブ & エグレスファイアウォール** | オペレーターの規律のみ | ネットワークファイアウォールのみ | **ハードソケットレベルのCIDR強制** |
| **Active Directory横方向パス** | 低速なスクリプト実行 | ❌ アクティブパスなし | **ネイティブBloodHound & Kerberosスイート** |
| **クレデンシャルセキュリティ & ストレージ** | 緩いフラットファイル / 平文 | 脆弱性ログ | **AES-256-GCM暗号化ボールト** |
| **OPSEC & テレメトリ調整** | 手動ジッタースクリプト | 高いネットワークノイズ | **適応型ノイズプロファイル & ガバナー** |
| **レポートの納品時間** | エンゲージメント後1～2週間 | 生データダンプ | **即時マルチフォーマット成果物** |
| **デプロイフットプリント** | 外部コンサルタント | 肥大化したクラウドエージェント | **エアギャップされたローカル / セルフホスト** |
---
## 🖥️ プラットフォームショーケース & コントロールサーフェス
ARESプラットフォームは、ダークテックの美学、低い認知負荷、および監査済みの運用制御を備えて設計された、高性能でレスポンシブなオペレーターダッシュボードを特徴としています。```powershell
# Launch local development environment
.\.venv\Scripts\ares.exe dashboard dev --no-reload
認可された攻撃オペレーターおよびセキュリティ担当者専用に設計された自律型エントリー・バリア。
ARES Operator Enclave — Sign In ボタンはホバー、クリック、Enter キーで深紅のプラズマファイアを噴出。動的アーキテクチャグリッドキャンバス、システム環境仕様、右パネルに ARES Cyber Dragon マスコット。
requestAnimationFrame を使用した浮力、乱流、放射状グローを備えた物理ベースのパーティクル。InResponseTo/nonce)、JIT ロールマッピング、フェデレーション ID に対する厳格なローカルパスワードロックアウトを特徴とする。(詳細は SSO セットアップガイド を参照)。X-ARES-CSRF)。アクティブなキャンペーン全体にわたるインスタントな態勢可視性を提供するリアルタイム運用コマンドコンソール。
リアルタイムテレメトリ、重大度別の確認済み検出結果、運用ヘルスを表示するエグゼクティブ・コマンドセンター。
タクティカル・ゼロステート・オーバービュー — アクティブなキャンペーンがゼロの状態で実行した際の、インスタント・レディネス・ストリップと初期化アクションを備えたクリーンなオンボーディングヒーロー。
panel-subtle)、動的なリアクティブトップバーヘルスインジケーター、未初期化メトリクスベースライン用の明確な破線プログレストラックを特徴とする。Staged、Executing、Standby) により、スコープ対象と実行中キャンペーンを区別。ハード CIDR ホワイトリスト境界と暗号化された証拠分離を強制するゼロ・コラテラル・ターゲットガバナンス。
ターゲットスコープ、CIDR 境界、ノイズコントロール、暗号化認証情報ボールトを表示するキャンペーン管理インターフェース。
<label> 定義により、迅速なエンゲージメント中のオペレーターの曖昧さを防止。Stealth、Normal、Aggressive) を構成。MITRE ATT&CK エンタープライズマトリクスに整合した武器化された敵対者技術の広範なカタログ。
MITRE ATT&CK 分類、動的パラメータ生成、ドライラン安全モードを備えたモジュールカタログ。
ad.kerberoast、ad.adcs、ad.enum_users)、Windows (windows.uac_bypass)、Linux、クラウド (AWS、Azure、GCP)、ネットワークインフラストラクチャをカバーする 60+ のモジュラーテクニック。エンタープライズ攻撃パスと権限昇格チェーンを可視化するインタラクティブな有向非巡回グラフ (DAG) ソルバー。
自動化された発光ホワイトパッチケーブル、左から右への階層 (ドメインコントローラー → 検出結果 → ホスト)、リアルタイムの安全なメタデータ検査を備えたマルチベクター攻撃グラフ。
#ffffff) を手動ドラッグなしでリアルタイムレンダリング。DC01) から始まり、アクティブなセキュリティ検出結果を経て、ターゲットメンバーホストに至る、クリーンで衝突のないカラムレイアウト。複数のエンタープライズフォーマット (エグゼクティブ PDF、テクニカル Markdown、Defect CSV) にわたるブランド化された監査対応コンプライアンスレポートを即座に生成。
同期されたリアルタイムライフサイクル管理を備えたマルチフォーマットエクスポートをサポートするレポートエンジンとアーティファクトライブラリ。
<label> 要素 (Target Campaign、Export Format) とクリーンなインライン検証エラーフィードバックを備えた整列されたマルチカラムレイアウト。OPSEC 制限を尊重しながら複雑な攻撃チェーンを計画、優先順位付け、実行する目標指向の自律エンジン。
目標ベースのキャンペーン計画と適応型コンテインメントガバナンスのための自律戦略コンソール。
GET /api/tags) に対するリアルタイム非同期ヘルスチェックと、動的なサーバーサイドクラウドキー検証 (Claude、OpenAI) のペアリング。Target Campaign、Strategic Objective、AI Planning Engine、Explicit Authorizations)、人間が読める目標記述、UI ラベルにおけるサーバー環境変数漏洩の完全な排除。キャンバス内で直接行う、詳細な Active Directory エンティティテレメトリ、関係検査、リアルタイムの安全な詳細監査。
ドメインコントローラー (DC01 10.10.10.2) テレメトリ、アクティブな侵害レベル、オープンな攻撃サーフェスポート (53、88、135、139、389、445、636、3268、3389)、資産所有状態を表示するインタラクティブな安全詳細ドロワー。
is_dc) を即座に検査。53、Kerberos 88、RPC 135、NetBIOS 139、LDAP 389、SMB 445、LDAPS 636、Global Catalog 3268、RDP 3389) のリアルタイム可視性。偵察、認証情報収集、ラテラルムーブメントを順番にオーケストレーションする決定論的なマルチステップキルチェーン。
AD Kerberos Exposure Chain や AD Domain Enumeration Chain を含む自動実行チェーン。
asreproast -> kerberoast -> hashcat)、ドメイン列挙、クラウド権限昇格のためのすぐに使えるチェーン。エンタープライズエンドポイント検出応答 (EDR) プラットフォーム全体にわたる回避有効性の実証的追跡。
CrowdStrike Falcon、SentinelOne、Microsoft Defender 全体にわたるテクニック成功率を追跡するバイパスナレッジベース。
監査済みマルチロールアクセス制御、暗号学的 API キーライフサイクル、継続的なプラットフォーム整合性検証。
オペレータープロファイル管理、スコープ付き API キープロビジョニング、自動システムセキュリティ監査。
Team Lead、Operator、Recon、Reporter)。運用テレメトリ、モジュール出力、パイプラインステータスをストリーミングする高頻度 WebSocket イベントバス。
バッファリングされたテレメトリと高スループット WebSocket ストリーミングを備えたライブ運用イベントコンソール。
定期的なレッドチーム演習、コンプライアンス監査、パープルチームドリル用の標準化されたエンゲージメントアーキテクチャ。
Internal Pentest、AD Full Compromise、Cloud Assessment、Assumed Breach を含むビルトインエンゲージメントテンプレート。
カスタムツール、SOC オーケストレーション、CI/CD パイプライン統合用の完全に文書化されたインタラクティブ REST API サーフェス。
エンタープライズ自動化のための 70+ の運用エンドポイントを公開するインタラクティブ Swagger UI ドキュメント。
| :--- | :--- | :--- | :--- |
| Overview | エグゼクティブヘルス、テレメトリカウンター、検出重要度メトリクス。 | Single Pane | すべてのステークホルダー |
| Campaigns | スコープホワイトリスト、ノイズプロファイル、暗号化された資格情報保管庫。 | List、Scope、Findings | チームリード、オペレーター |
| Modules | 60以上のモジュールカタログ、パラメータ入力フォーム、実行コンソール。 | Catalog、Run Panel、Results | オペレーター |
| Reports | 成果物ビルダー、エビデンスパッケージ、レポートライブラリのライフサイクル。 | Generate、Library | オペレーター、レポーター |
| Graph | DAGエンティティ探索、最短攻撃パス、BloodHound取り込み。 | Entities、Attack Paths、Ingest | オペレーター、偵察 |
| Templates | 再現可能なエンゲージメントプレイブックと多段階ワークフロープラン。 | Templates、Plan Builder | チームリード、オペレーター |
| | 目標指向の自律エンジン、AIプランナー統合。 | 、、 | チームリード、オペレーター |
| | オペレーター資格情報、APIキーライフサイクル、依存関係監査チェック。 | 、、 | チームリード |
| | 防御的テレメトリ、バイパストラッキング、検知回避ルール。 | 、 | オペレーター |
| | リアルタイムWebSocketイベントストリームとバッファリングされたテレメトリログ。 | 、 | オペレーター |
ARESは、プレゼンテーション、実行オーケストレーション、セキュリティガバナンス、永続的な暗号化ストレージを分離する厳格な多層防御アーキテクチャを採用しています：```mermaid
flowchart TB
subgraph Client["Presentation Layer (Operator Enclave)"]
UI["React 19 Dashboard
(Vite + TypeScript)"]
Mesh["Dynamic Architectural Grid
(Canvas 2D Engine)"]
WSClient["WebSocket Client
(Real-Time Telemetry Stream)"]
end
subgraph Gateway["Zero-Trust Security Gateway"]
FastAPI["FastAPI Async Engine<br>(Uvicorn Backend)"]
AuthGuard["Auth & Session Guard<br>(Memory-Only JWT + HttpOnly Refresh)"]
CSRF["HMAC Double-Submit CSRF<br>(X-ARES-CSRF Validation)"]
RateLimit["Rate Limiting & Brute-Force Shield"]
end
subgraph Core["ARES Core Engine & Governance"]
ScopeFirewall["Scope Egress Firewall<br>(Strict CIDR & IP Whitelist)"]
Governor["OPSEC Noise Governor<br>(Adaptive Jitter & Throttling)"]
Orchestrator["Module Execution Orchestrator<br>(Worker Thread Pool)"]
AutoPlanner["Autonomous Strategy Engine<br>(DAG Heuristics / AI Planner)"]
end
subgraph Storage["Cryptographic Persistence Layer"]
DB[(SQLite / PostgreSQL<br>Alembic Versioned)]
Vault[(AES-256-GCM Vault<br>Encrypted Credentials & Hashes)]
GraphEngine["Attack Graph DAG Engine<br>(BloodHound Ingest & Shortest Path)"]
end
subgraph Deliverables["Reporting Pipeline"]
PDFGen["Headless Chromium / Edge Engine<br>(Automated PDF Generation)"]
Artifacts["Evidence Library<br>(HTML, Markdown, JSON)"]
end
UI -->|HTTPS / REST| AuthGuard
WSClient -->|WSS / Ticket Barrier| AuthGuard
AuthGuard --> CSRF --> RateLimit --> FastAPI
FastAPI --> ScopeFirewall
ScopeFirewall --> Orchestrator
Orchestrator --> Governor
Orchestrator --> AutoPlanner
Orchestrator --> Storage
Storage --> GraphEngine
FastAPI --> Deliverables
---
## ⚔️ 攻撃者テクニック & MITRE ATT&CK マトリクス
ARES は MITRE ATT&CK Enterprise Framework にネイティブ対応した 60 以上のモジュール式攻撃者テクニックを実装しています:```
┌──────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ MITRE ATT&CK MATRIX COVERAGE │
├─────────────────────┬─────────────────────┬─────────────────────┬─────────────────────┬──────────────────────────┤
│ DISCOVERY │ CREDENTIAL ACCESS │ LATERAL MOVEMENT │ PRIVILEGE ESCALATION│ DEFENSE EVASION / CLOUD │
├─────────────────────┼─────────────────────┼─────────────────────┼─────────────────────┼──────────────────────────┤
│ • T1087 User Enum │ • T1558.003 Kerberoast│ • T1021.002 SMB/RPC │ • T1548.002 UAC Byps│ • T1070 Indicator Removal│
│ • T1069 Group Enum │ • T1558.004 AS-REP │ • T1021.006 WinRM │ • T1068 Token Privs │ • T1562 Impair Defenses │
│ • T1046 Port/Net │ • T1003 LSASS Dump │ • T1550 Use Ticket │ • T1053 Scheduled │ • T1078 Cloud IAM Enum │
│ • T1018 Host Disc │ • T1649 ADCS ESC1-8 │ • T1071 App Layer │ • T1055 Injection │ • T1580 Cloud Discovery │
│ • T1082 System Info │ • T1110 Pass Spray │ • T1021.001 RDP │ • T1134 Access Token│ • T1526 Cloud Hierarchy │
└─────────────────────┴─────────────────────┴─────────────────────┴─────────────────────┴──────────────────────────┘
ad.kerberoast)、AS-REP Roasting、ADCS 証明書テンプレート悪用 (ESC1 から ESC8)、DCSync アカウントレプリケーション、および BloodHound データ生成。git clone https://github.com/Mafifrizi/ARES.git Set-Location .\ARES
py -3.12 -m venv .venv ..venv\Scripts\python.exe -m pip install -U pip ..venv\Scripts\python.exe -m pip install -e ".[dev,pdf]"
Set-Location frontend & "C:\Program Files\nodejs\npm.cmd" ci Set-Location ..
$env:ARES_PDF_BROWSER = "C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe" ..venv\Scripts\ares.exe doctor --pdf-smoke
..venv\Scripts\ares.exe dashboard dev --no-reload
**`http://127.0.0.1:5173/dashboard/`** をブラウザで開きます。
- **初期 Operator**: `admin`
- **初期パスワード**: `.env` の `ARES_DEFAULT_ADMIN_PASSWORD` で設定（デフォルト: `Admin123456!`）
---
## 🔐 エンタープライズセキュリティモデルとコンプライアンス
ARES は、最も厳格なコンプライアンスと機密保持要件を持つ環境向けに設計されています：
### 多層防御認証
- **メモリのみのアクセストークン**: 短命な JWT（有効期間 15 分）はメモリ内の React state にのみ存在し、`localStorage` や `sessionStorage` には決して書き込まれません。
- **ローテーションするリフレッシュファミリー**: 長命なリフレッシュ資格情報は、厳格な host-only の HttpOnly Cookie（`ares_refresh`）にバインドされ、ワンタイムローテーションと自動的な再利用失効を備えています。
- **HMAC CSRF バリア**: 状態変更を伴うエンドポイントは、暗号学的に安全な Cookie トークンと照合される有効な `X-ARES-CSRF` ヘッダーを必須とします。
### ロールベースアクセス制御（RBAC）
ARES は、すべての API エンドポイント、バックグラウンドジョブ、UI サーフェスにわたって厳格な RBAC 権限を適用します：
| ロール | API 値 | 運用範囲 | 管理権限 |
| :--- | :---: | :--- | :--- |
| **Team Lead** | `team_lead` | 完全なプラットフォーム権限：キャンペーンの作成/削除、ユーザープロビジョニング、セキュリティ監査、高ノイズモジュールのオーバーライド。 | フルシステム管理者 |
| **Operator** | `operator` | 日次運用：承認されたモジュールの実行、検出結果のレビュー、攻撃グラフの探索、レポートの生成。ユーザー登録は不可。 | 運用層 |
| **Recon** | `recon` | 読み取り中心の偵察：安全なディスカバリおよびネットワークフィンガープリンティングモジュールの実行。破壊的モジュールの実行はブロックされます。 | 読み取り中心 |
| **Reporter** | `reporter` | ステークホルダーレビュー：キャンペーン分析、検出結果、攻撃グラフ、生成された成果物への読み取り専用アクセス。実行権限なし。 | 読み取り専用監査 |
#### ロールプロビジョニングと権限昇格防止の保証
- **権威あるデータベースアイデンティティ**: クライアント側の JWT ロールクレームを盲目的に信頼するシステムとは異なり、ARES はすべてのリクエストでライブデータベースから直接ユーザーアイデンティティとロールを解決します（`row = await db.resolve_access_token_principal(...)`）。改ざんされた JWT クレームは数学的に破棄されます。
- **アカウント作成時の厳格なロールゲーティング**: 新規ユーザーロールは、`team_lead` が `POST /auth/register`（`require_team_lead()` でガード）を通じて排他的に割り当てるか、SP 起点の SAML/OIDC SSO 中にエンタープライズ ID プロバイダーから自動的にマッピングされます。
- **ロールの不変性**: ロールの割り当ては作成後は不変です。ユーザーロールを変更する公開エンドポイントは存在せず（`PUT /users/{id}` は存在しません）、水平および垂直の権限昇格ベクター（例：`recon` が `team_lead` に昇格、または `reporter` が攻撃的モジュールを実行）を排除します。
- **監査されたユーザーインベントリ**: ダッシュボードの `Security` コンソールは、エンゲージメントの説明責任のために、登録されたすべてのアイデンティティとアクティブセッションの透過的なインベントリを提供します。
---
## 🔌 ARES MCP ゲートウェイと製品グレード CLI
ARES は、最新の AI コーディングアシスタント（Cursor IDE、Claude Desktop、Windsurf、VS Code Cline、Zed、Open-WebUI、LibreChat）が ARES パープルチーム攻撃プラットフォームと安全かつ厳格なガバナンスの下で対話できるようにする、本番グレードの **Model Context Protocol（MCP）** ゲートウェイを提供します。
<div align="center">
*リアルタイムのツールテレメトリ、ライブスコープ検査、1 キーでのトークン認可を備えた ARES MCP 2 ペイン分割ターミナルモニター（OpenClaw スタイル）。*
</div>
ガードレールなしで生のエンドポイントを LLM に公開する基本的な MCP サーバーとは異なり、ARES は、ライブの攻撃アクションが実行される前に、厳格な **Pre-Flight Scope Invariance（`ScopeGuard`）**、**Anti-Prompt-Injection Taint Isolation**、および **Single-Use 60-second HMAC Confirmation Tokens** を適用します。
### 🚀 まず何から始めればよいですか？（ステップバイステップのオンボーディング）
Cursor、Claude Desktop、または Windsurf を ARES に接続するオペレーターまたは開発者向け：
1. **サブシステムの準備状況を確認する（`doctor`）**：
すべてのコアサブシステム（Protocol Engine、9 Tools、3 Resources、3 Prompts、62 Modules、Security Gates）が `PASS` を報告することを確認します： ```powershell
.\mcp.bat doctor
1クリックAIクライアントセットアップ（手動JSON編集不要）: 1つのコマンドでお好みのIDEを自動設定: ```powershell
.\mcp.bat setup --client cursor
.\mcp.bat setup --client claude
.\mcp.bat setup --client windsurf
.\mcp.bat setup --client cline
これにより、アクティブな Python 仮想環境のパスがクライアント設定ファイル（例: .cursor/mcp.json）に直接書き込まれます。
Cursor IDE でウィンドウをリロード:
Ctrl + Shift + P を押します。Developer: Reload Window を選択します。Ctrl + ,）→ Features → MCP Servers を開きます。ares サーバーが緑のドット（Connected）で表示されます。ライブ2ペインモニターを起動（オプションのコンパニオンウィンドウ）: 専用のターミナルウィンドウで、OpenClaw スタイルの2ペインモニターを実行し、リアルタイムの AI ツール呼び出し、スコープチェック、トークンの承認を監視します: ```powershell .\mcp.bat monitor
ares_scope_check、ares_dry_run_module、ares_run_tool）。
Aを押して保留中の実行トークンを承認、Rで拒否、Cでストリームをクリア、Q**で終了。Ctrl + IまたはCtrl + L）を開き、次のプロンプトを試してください:
「アクティブなキャンペーンのステータスを確認し、ターゲット10.0.1.50のスコープを検証し、モジュールad_kerberoastのドライランをステージングせよ。」
詳細なアーキテクチャ、7つのセキュリティ不変条件、CLIスクリプト対応（--json）、POSIX終了コード、および運用ツールスキーマについては、ARES MCP Gateway & Product-Grade CLI Specificationを参照してください。
ARESは、カスタム敵対者モジュールを構築し、分離されたテストハーネスで技術をシミュレートし、エンゲージメントをプログラムで自動化するための、ファーストクラスの型安全なPython SDK（ares.sdk）を提供します:
BaseModule[P, R]および@ares_module）Pydantic v2で検証済みパラメータスキーマを宣言し、完全なIDEオートコンプリートでモジュールを作成します:```python from ares.sdk import ( BaseModule, ExecutionContext, ModuleResult, ModuleParams, param, SecretParam, OpsecLevel, Severity, ares_module, )
class KerberoastParams(ModuleParams): dc: str = param("Target Domain Controller IP or FQDN", min_length=3) domain: str = param("AD DNS domain name, e.g. CORP.LOCAL", min_length=3) password: SecretParam = param("Domain user password", secret=True, required=False)
class CustomKerberoastModule(BaseModule[KerberoastParams, ModuleResult]): MODULE_ID = "custom.ad.kerberoast" MODULE_NAME = "Custom Kerberoasting" MODULE_CATEGORY = "ad" OPSEC_LEVEL = OpsecLevel.LOW MITRE_TECHNIQUES = ["T1558.003"] PARAMS_MODEL = KerberoastParams
async def execute(self, ctx: ExecutionContext[KerberoastParams]) -> ModuleResult:
# ctx.params provides full static typing and runtime validation
await self.before_request(ctx.params.dc)
# Emit findings using fluent context helpers
finding = ctx.emit_finding(
title=f"Kerberoastable SPN Captured on {ctx.params.dc}",
severity=Severity.HIGH,
mitre_technique="T1558.003",
)
return ModuleResult(status="success", findings=[finding], module_id=self.MODULE_ID)
### 2. 分離テストとシミュレーション (`ModuleTestHarness`)
モックスコープガード、合成資格情報ボールト、流暢なアサーションマッチャーを使用して、カスタムテクニックをローカルで単体テストします:```python
from ares.sdk import ModuleTestHarness, Severity
async def test_module():
harness = ModuleTestHarness(CustomKerberoastModule)
result = await harness.simulate(params={"dc": "10.0.0.10", "domain": "LAB.LOCAL"})
result.assert_success()
result.assert_finding(severity=Severity.HIGH, mitre="T1558.003")
AresClient)Python スクリプトまたは CI/CD パイプラインを介して、エンゲージメントの自動化、モジュールのディスパッチ、およびリアルタイム WebSocket テレメトリのストリーミングを行います:```python from ares.sdk import AresClient
async with AresClient(base_url="http://127.0.0.1:8000", api_key="ares_key_...") as ares: campaign = await ares.campaigns.create(name="Op-Titan", scope=["10.0.0.0/24"]) job = await ares.modules.run("ad.kerberoast", target="dc01.corp.local", campaign_id=campaign["id"]) findings = await ares.campaigns.findings(campaign["id"])
完全な開発者向けドキュメント、アーキテクチャ仕様、および例については、[docs/module_sdk.md](https://github.com/mafifrizi/ares/blob/main/docs/module_sdk.md) と [docs/module-development.md](https://github.com/mafifrizi/ares/blob/main/docs/module-development.md) を参照してください。
---
## 📚 ドキュメントサイトマップ
包括的なドキュメントは [`docs/`](https://github.com/mafifrizi/ares/blob/main/docs) ディレクトリで入手できます：
- [**ドキュメントポータル & サブシステムインデックス**](https://github.com/mafifrizi/ares/blob/main/docs/README.md)
- [**クイックスタートエンゲージメントガイド**](https://github.com/mafifrizi/ares/blob/main/QUICKSTART.md)
- [**次世代モジュール SDK 仕様 (v2)**](https://github.com/mafifrizi/ares/blob/main/docs/module_sdk.md)
- [**ARES MCP サーバー & 製品グレード CLI 仕様**](https://github.com/mafifrizi/ares/blob/main/docs/mcp-server.md)
- [**ステップバイステップモジュール開発ガイド**](https://github.com/mafifrizi/ares/blob/main/docs/module-development.md)
- [**ダッシュボード画面別マニュアル**](https://github.com/mafifrizi/ares/blob/main/docs/dashboard-guide.md)
- [**アドバーサリモジュールカタログ & スキーマ**](https://github.com/mafifrizi/ares/blob/main/docs/modules.md)
- [**API エンドポイントリファレンス & ペイロード**](https://github.com/mafifrizi/ares/blob/main/docs/api-reference.md)
- [**エンタープライズ SSO 統合ガイド (SAML 2.0 / OIDC)**](https://github.com/mafifrizi/ares/blob/main/docs/sso-setup.md)
- [**エンタープライズセキュリティ & 脅威モデル**](https://github.com/mafifrizi/ares/blob/main/docs/security-model.md)
- [**検証ラボ & テストハーネス**](https://github.com/mafifrizi/ares/blob/main/docs/validation-lab.md)
---
## ⚖️ 責任ある使用と法的免責事項
> [!IMPORTANT]
> **ARES は、明示的な書面による許可を得た認可済みサイバーセキュリティ研究、内部エンタープライズレジリエンス検証、およびプロフェッショナルなレッドチームエンゲージメント専用に設計されたデュアルユースソフトウェアフレームワークです。**
- システム所有者からの事前の書面による許可なく、いかなるネットワーク、ホスト、またはクラウドインフラストラクチャに対して ARES を実行しないでください。
- 不正なシステムアクセスまたはテストは、国内および国際的なサイバー犯罪法（例：Computer Fraud and Abuse Act 18 U.S.C. § 1030）に違反します。
- ARES の作成者およびメンテナーは、本ソフトウェアによる誤用、損害、または規制違反に対して一切の責任を負いません。
ARES のセキュリティ脆弱性を報告するには、[セキュリティポリシー](https://github.com/mafifrizi/ares/blob/main/SECURITY.md) に従ってください。
---
## 📄 ライセンス
ARES はオープンソースの **[MIT License](https://github.com/mafifrizi/ares/blob/main/LICENSE)** の下で配布されています。
<br>
<div align="center">
**ARES — エンタープライズグレードの自律型レッドチームエンゲージメントシステム。**
*継続的なセキュリティ検証。ゼロの副次的リスク。*
</div>
ObjectiveActiveResultAccountAPI KeysAuditKnowledge BaseReport OutcomeStreamBuffer