# CredAttack — 凭据攻击工具包
<p align="center">
<img src="https://img.shields.io/badge/release-v1.3.0-brightgreen?style=for-the-badge" alt="Release">
<img src="https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-blue?style=for-the-badge&logo=python" alt="Python">
<img src="https://img.shields.io/badge/protocols-17-orange?style=for-the-badge" alt="Protocols">
<img src="https://img.shields.io/badge/tests-passing-success?style=for-the-badge&logo=pytest" alt="Tests">
<img src="https://img.shields.io/badge/license-SEE--LICENSE-lightgrey?style=for-the-badge" alt="License">
</p>
> **⚠️ 法律声明 — 仅限授权安全测试。**
> 使用本工具针对您不拥有或未经**明确书面许可**的系统进行测试,在美国《计算机欺诈与滥用法》、英国《计算机滥用法》及全球同等法律下均属违法行为。请参阅 [SECURITY.md](https://github.com/amibhai/credential-attacks-toolkit/blob/main/SECURITY.md)。
---
## 目录
- [什么是 CredAttack?](#什么是-credattack)
- [攻击模式](#攻击模式)
- [支持的协议](#支持的协议)
- [架构](#架构)
- [快速开始](#快速开始)
- [安装](#安装)
- [CLI 参考](#cli-参考)
- [密码变异引擎](#密码变异引擎)
- [默认凭据数据库](#默认凭据数据库)
- [代理轮换](#代理轮换)
- [HTML 报告](#html-报告)
- [配置与环境变量](#配置与环境变量)
- [Docker](#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 测试(单元 + 协议模拟)
```
---
## 快速开始
```bash
# 克隆并设置
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(推荐)
```bash
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install --upgrade pip
pip install -r requirements.txt
```
### 选项 B — Makefile 快捷方式
```bash
make install # 核心依赖
make install-dev # + pytest-cov、ruff、mypy
```
### 选项 C — pip 安装(可编辑或从 wheel)
```bash
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
```bash
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 | 仅计数组合而不建立连接 |
### 子命令
```bash
# 协议专用(每个映射到专用攻击器)
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` 支持可组合策略:
| 策略 | 方法 | 示例输出 |
|----------|--------|----------------|
| Leet 语言 | `leet_speak(word)` | `p@ssw0rd`、`p455w0rd` |
| 大小写 | `capitalise_variants(word)` | `PASSWORD`、`Password`、`pAsSwOrD` |
| 后缀 | `suffix_append(word)` | `password123`、`password@2025` |
| 前缀 | `prefix_append(word)` | `!password`、`mypassword` |
| 键盘行走 | `keyboard_walk(word)` | `qassword`(a→q) |
| 用户名模式 | `username_patterns(user, company)` | `john123`、`Doe1!`、`ACME2024!` |
| **季节性**(v1.1) | `seasonal_patterns(company)` | `Summer2024!`、`Winter25` |
| **特殊字符包裹**(v1.1) | `special_char_wrap(word)` | `!@Password`、`Password!@` |
| 组合 | `combine(word, strategies)` | 链式组合上述任意策略 |
| 智能(一体化) | `smart_generate(user, company)` | 去重、限量输出流 |
```python
from credattack.core.mutator import PasswordMutator
m = PasswordMutator(max_mutations=5000)
# 组合所有策略
for pw in m.smart_generate("john.doe", company="ACME"):
print(pw)
# 仅季节性模式
for pw in m.seasonal_patterns(company="Contoso"):
print(pw)
```
---
## 默认凭据数据库
`credattack/data/default_creds.json` 包含 **200+ 个真实默认凭据组合**,涵盖:
Cisco · F5 · Juniper · Palo Alto · VMware · Jenkins · GitLab · Tomcat · WordPress · MySQL · MSSQL · Redis · MongoDB · PostgreSQL · Elasticsearch · RabbitMQ · Splunk · Nagios · Zabbix · pfSense · MikroTik · Huawei · HP iLO · Dell iDRAC · IPMI
```bash
# 查看某服务的所有默认凭据
python credattack.py defaults -t HOST --protocol mysql --dry-run
# 针对目标运行
python credattack.py defaults -t 10.0.0.1 --protocol ssh
```
---
## 代理轮换
传入代理文件(每行一个代理,`host:port` 格式):
```
# proxies.txt
192.168.1.10:1080
192.168.1.11:1080
socks5://10.0.0.5:9050
```
```bash
python credattack.py ssh -t TARGET -u admin -P passes.txt --proxy-file proxies.txt
```
`ProxyRotator` 在启动时执行健康检查,并将超过失败率阈值的代理降级。失效代理会被自动排除。
---
## HTML 报告
每次非试运行攻击后,都会在 `./output/` 中自动生成 HTML 报告:
- **统计卡片**:总尝试次数、成功率、持续时间、每秒尝试次数
- **已发现凭据表**:主机 · 协议 · 用户名 · 密码(可复制到剪贴板)
- **深色主题** Jinja2 模板
```bash
# 运行后打开
start output/report_*.html # Windows
open output/report_*.html # macOS
```
---
## 配置与环境变量
`credattack/core/config.py` 中的所有设置均可通过 `CREDATTACK_*` 环境变量覆盖:
```bash
export CREDATTACK_THREADS=20
export CREDATTACK_TIMEOUT=3.0
export CREDATTACK_DELAY=1.0
export CREDATTACK_JITTER=0.5
export CREDATTACK_LOCKOUT_THRESHOLD=3
export CREDATTACK_VERBOSITY=2
```
或在 CLI 层使用标准标志(`--threads`、`--timeout` 等)。
---
## Docker
```bash
# 构建镜像
docker build -t credattack -f docker/Dockerfile .
# 使用 Docker Compose 运行
cd docker
docker compose run credattack ssh -t 192.168.1.100 -u admin -P /app/wordlists/common_passwords.txt
# 通过环境变量设置配置
docker run --rm \
-e CREDATTACK_THREADS=20 \
-e CREDATTACK_TIMEOUT=3 \
-v $(pwd)/output:/app/output \
credattack defaults -t 10.0.0.1 --protocol mysql
```
---
## 测试
```bash
# 运行所有测试
pytest -q
# 带覆盖率
pytest --cov=credattack --cov-report=term-missing -q
# Makefile 快捷方式
make test-cov
```
**当前测试套件:50+ 个测试**,涵盖:
| 领域 | 测试 |
|------|-------|
| 锁定检测器(滑动窗口、线程安全) | `test_lockout.py` |
| 密码变异器策略 | `test_mutator.py` |
| 新增变异器策略(季节性、特殊字符) | `test_mutator_extended.py` |
| 代理轮换器(健康检查、降级) | `test_proxy.py` |
| Result 与 SessionReport 数据类 | `test_result.py` |
| SSH 协议模拟 | `test_protocols_ssh.py` |
| FTP 协议模拟 | `test_protocols_ftp.py` |
| HTTP Basic 与 Digest 模拟 | `test_protocols_http.py` |
---
## 字典列表
> **⚠️ 内置的 `wordlists/` 文件仅为最小冒烟测试桩。** 真实评估请自行提供。
### 推荐来源
| 字典列表 | 大小 | 最佳用途 |
|----------|------|----------|
| `rockyou.txt` | ~14 M | 通用字典 |
| `SecLists/Passwords/` | 多种 | 协议专用 |
| `kaonashi.txt` | ~64 M | 高级覆盖 |
| OSINT 衍生 | 不定 | 定向攻击 |
```bash
# 使用任何外部字典列表
python credattack.py ssh -t TARGET -u admin -P /opt/wordlists/rockyou.txt
```
---
## 项目结构
```
credential-attacks-toolkit/
├── credattack.py # 精简入口 -> credattack.cli:app(源码检出使用)
├── pyproject.toml # PEP 517/518 构建与工具配置
├── requirements.txt # 运行时依赖
├── Makefile # 开发者快捷方式
├── VERSION # 版本唯一来源
├── CHANGELOG.md
├── SECURITY.md
├── .github/
│ └── workflows/ci.yml # GitHub Actions:lint + 测试矩阵 + mypy
├── docker/
│ ├── Dockerfile
│ └── docker-compose.yml
├── credattack/
│ ├── cli.py # CLI(Typer)— 打包,支撑控制台脚本
│ ├── core/
│ │ ├── config.py # Pydantic v2 Settings
│ │ ├── engine.py # AttackEngine(ThreadPoolExecutor)
│ │ ├── lockout.py # LockoutDetector(滑动窗口)
│ │ ├── proxy.py # ProxyRotator
│ │ ├── mutator.py # PasswordMutator
│ │ ├── result.py # AttemptResult、SessionReport
│ │ ├── report.py # HTML 报告生成器
│ │ └── logger.py # Rich 日志器 + JSONL 写入器
│ ├── protocols/ # 18 个 ProtocolAttacker 实现
│ │ └── base.py # 抽象 ProtocolAttacker
│ └── data/
│ ├── default_creds.json # 200+ 厂商默认凭据
│ ├── smart_patterns.json # 140+ 企业模板
│ └── wordlists/ # 按服务分类的入门列表
├── attacks/ # 独立单文件工具(早于 credattack/;
│ └── *.py # 保留给尚未移植的脚本:JWT 破解、
│ # WAF 检测、基于时机的用户枚举)
├── utils/
│ └── credential_utils.py # attacks/ 脚本的共享辅助函数
├── tests/
│ ├── conftest.py # 共享夹具
│ ├── test_lockout.py
│ ├── test_mutator.py
│ ├── test_mutator_extended.py
│ ├── test_proxy.py
│ ├── test_result.py
│ ├── test_protocols_ssh.py
│ ├── test_protocols_ftp.py
│ └── test_protocols_http.py
├── wordlists/ # 最小冒烟测试桩
└── output/ # 生成的日志与报告(git 忽略)
```
---
## 攻击成功率(参考值)
| 密码类型 | 字典 | 智能模式 | 喷洒(常见密码) |
|---------------|-----------|------------|----------------|
| 4 个字符 | ~90% | ~95% | ~60% |
| 6 个字符 | ~65% | ~75% | ~25% |
| 8 个字符混合 | ~15% | ~25% | ~5% |
| 10+ 个字符复杂 | <5% | <5% | <1% |
---
## 贡献
请参阅 [CONTRIBUTING.md](https://github.com/amibhai/credential-attacks-toolkit/blob/main/CONTRIBUTING.md)。
提交大型 PR 前请先开启 issue。
所有贡献必须遵守 [SECURITY.md](https://github.com/amibhai/credential-attacks-toolkit/blob/main/SECURITY.md) 中的道德使用政策。
---
**负责任地使用。合乎道德地测试。保持合法。**