x-glacier/kali-pentest / kali-pentest-zh
kali-pentest-zh
Flagged通过 SSH 或 Docker 使用 Kali Linux CLI 工具执行授权渗透测试。 覆盖:信息收集、漏洞分析、嗅探与欺骗、Web/API 渗透、漏洞利用、密码攻击、无线、云原生安全、RFID/NFC、VoIP/ICS、逆向工程、取证分析、后渗透/C2、报告生成。
references/playbooks/source-code-audit.md
View on GitHub# 源码与依赖审计 Playbook
用于授权的源码仓库、构建产物、CI/CD 流水线或依赖清单,且 SAST、密钥扫描和软件成分分析在测试范围内。
## 输入
- 范围内的仓库路径、归档文件或远程 Git URL。
- 语言栈、构建系统和包清单文件(如 `requirements.txt`、`package.json`、`pom.xml`、`go.mod`)。
- Git 历史是否在密钥扫描范围内。
- 凭据发现的批准输出格式和数据处理规则。
## 流程
1. **范围和访问验证**
- 确认范围:工作目录、完整 Git 历史、CI 产物、依赖锁文件或基于代码构建的容器镜像。
- 扫描前记录仓库名称、commit hash 或标签,以及语言/框架。
2. **密钥和凭据扫描**
- 扫描目录和 Git 历史中的硬编码密钥、API 密钥、令牌和凭据。
- Git 历史在范围内时使用 `gitleaks git`;对解压的归档或非 Git 目录使用 `gitleaks dir`。
- 所有发现均作为敏感证据处理;分享报告前对密钥内容脱敏。
(`gitleaks` 及相关工具选择参见 `../web/README.md`。)
```bash
# 扫描 Git 历史
gitleaks git --redact -f json -r /tmp/gitleaks_git.json /path/to/repo
# 扫描目录(无 Git 历史)
gitleaks dir --redact -f json -r /tmp/gitleaks_dir.json /path/to/source
# 使用基线抑制已知发现
gitleaks git --baseline-path /tmp/baseline.json --redact -f json -r /tmp/gitleaks_new.json /path/to/repo
```
完整参数说明见 `../web/tools/gitleaks.md`。
**零密钥验证:** 如果 gitleaks 报告零发现,在接受结果前进行手动抽查——`grep -rn` 搜索 `AKIA`、`BEGIN RSA`、`BEGIN OPENSSH`、`password\s*=`、`api_key\s*=` 等模式。记录手动检查及其结果。
3. **SAST——静态应用安全测试**
- 针对源码树运行适合该语言的 SAST 工具,识别注入点、不安全反序列化、弱加密、路径穿越等代码级漏洞。
- 按语言推荐工具:
- **多语言**:`semgrep`,配合社区或自定义规则集(`semgrep --config auto <path>`)
- **Python**:`bandit -r <path> -f json -o /tmp/bandit.json` + `semgrep`
- **JavaScript/TypeScript**:`semgrep` + `njsscan -o /tmp/njsscan.json --json <path>`
- **Go**:`semgrep` + `gosec -fmt=json -out=/tmp/gosec.json ./...`
- **Java**:`semgrep` + `find-sec-bugs` 概念(通过构建插件或独立分析集成)
- **Ruby**:`brakeman -o /tmp/brakeman.json -f json`
- **C/C++**:`flawfinder --json <path> > /tmp/flawfinder.json`
- **通用**:`trivy fs --scanners misconfig,secret <path>`,同步检查配置和密钥
- 决策点:检测仓库中存在的语言(检查文件扩展名、构建文件),在扫描前选择合适的 SAST 工具链。
- 报告前手工验证 SAST 发现;大规模扫描存在误报。
**发现验证方法论:** 不要将原始 SAST 输出作为发现直接报告。对每个高/严重发现:(1) 追踪从用户输入(源)到危险函数(汇)的数据流,(2) 检查路径上是否存在净化处理或框架级保护,(3) 确定代码路径是否可从外部入口点到达。标记为:已确认、可能、误报或需要动态测试。
`trivy fs` 用法见 `../vulnerability/tools/trivy.md`。
3b. **手动代码审查**
- 搜索常见导致漏洞的危险函数模式:
- 命令注入:`eval()`、`exec()`、`system()`、`Runtime.exec()`、`os.popen()`、带 `shell=True` 的 `subprocess.call()`
- 反序列化:`deserialize()`、`pickle.loads()`、不带 `SafeLoader` 的 `yaml.load()`、`ObjectInputStream`、`unserialize()`
- 客户端注入:`innerHTML`、`dangerouslySetInnerHTML`、`document.write()`、`v-html`
- SQL 注入:使用字符串拼接或 f-string 的原始查询构造
- 从入口点(控制器、路由、API 处理器)到汇聚点(数据库查询、文件操作、命令执行、模板渲染)跟踪用户输入。映射数据流以确认可利用性。
- 审查认证和授权逻辑:所有端点是否受保护?能否通过参数操纵、强制浏览或 IDOR 绕过授权检查?检查管理或内部端点是否缺少认证。
- 审查错误处理:异常是否被安全捕获和处理?是否在错误消息或 API 响应中泄露敏感数据(堆栈跟踪、数据库错误、内部路径)?
- 使用 `grep`/`semgrep` 配合自定义规则搜索项目特定模式:
```bash
# 搜索危险函数模式
grep -rn "eval\|exec\|system\|pickle\.loads\|yaml\.load\|innerHTML\|dangerouslySetInnerHTML" <path> --include="*.py" --include="*.js" --include="*.ts" --include="*.java" --include="*.rb"
# Semgrep 自定义规则
semgrep --config /tmp/custom-rules.yaml <path> -o /tmp/semgrep_custom.json --json
```
4. **软件成分分析(SCA)与依赖漏洞**
- 通过扫描清单文件或锁文件,识别第三方依赖中的已知 CVE。
- 使用 `trivy fs --scanners vuln` 覆盖多数语言生态;有 SBOM 时可用 `grype` 作为替代。
- 特定生态系统:Python 用 `pip-audit`,Node.js 用 `npm audit`。
**依赖可达性评估:** 不要将所有 CVE 作为同等级别的发现报告。对高/严重 CVE,检查受影响的函数/模块是否确实被应用代码导入和使用。优先报告漏洞代码路径可达的 CVE,而非仅存在于依赖树中但从未被调用的 CVE。
```bash
# 扫描源码树中的依赖漏洞(支持大多数生态)
trivy fs --scanners vuln --format json -o /tmp/trivy_deps.json /path/to/repo
# 生成 SBOM 后扫描
syft /path/to/repo -o cyclonedx-json > /tmp/sbom.json
grype sbom:/tmp/sbom.json -o json > /tmp/grype.json
# Python 依赖
pip-audit -r requirements.txt -o /tmp/pip_audit.json -f json
# Node.js 依赖
npm audit --json > /tmp/npm_audit.json
```
5. **IaC 和配置审查**
- 扫描 Dockerfile、Kubernetes 清单文件、Terraform、Helm charts 和 CI/CD 流水线配置文件,识别错误配置。
- 使用 `trivy config` 扫描 IaC 文件;将发现与依赖和 SAST 结果一并记录。
- 检查 CI/CD 流水线配置文件的安全问题:
- `.github/workflows/`(GitHub Actions):环境变量或步骤输入中的硬编码密钥、过于宽松的 `permissions`(如不必要的 `contents: write`)、使用 `pull_request_target` 并检出 PR 代码、未固定版本的第三方 actions。
- `.gitlab-ci.yml`(GitLab CI):暴露的变量、具有敏感访问权限的共享 runner、产物安全。
- `Jenkinsfile`(Jenkins):硬编码凭据、不安全的 `sh` 步骤、过于宽泛的 agent 标签。
- 在流水线配置中查找密钥:API 密钥、令牌、密码以明文环境变量传递而非通过密钥管理器。
- 评估产物安全:构建产物(包、镜像、二进制文件)是否已签名?流水线是否可被操纵以生成篡改的产物?
```bash
trivy config --severity HIGH,CRITICAL --format json -o /tmp/trivy_iac.json /path/to/repo
# 在 CI/CD 文件中搜索硬编码密钥
grep -rn "password\|secret\|token\|api_key\|AWS_ACCESS" .github/workflows/ .gitlab-ci.yml Jenkinsfile 2>/dev/null
```
IaC 扫描模式见 `../vulnerability/tools/trivy.md`。
6. **分诊与去重**
- 汇总密钥、SAST 和 SCA 发现,跨工具去除重复。
- 优先级:已确认有效的密钥 > 可利用的代码路径 > 可达依赖中的 HIGH/CRITICAL CVE > 信息性配置错误。
- 每个已确认发现记录工具名、规则/CVE ID、文件路径、行号和复现步骤。
## 交叉引用
- `web-application.md` — 线上 Web 端点测试。
- `api-security.md` — 线上 API 端点测试。
- `reporting-workflow.md` — 发现文档。
## 预期产物
- 密钥扫描报告,注明来源(历史或工作树)、文件路径和匹配类型;密钥内容脱敏。
- 按工具、规则、文件和行号整理的 SAST 发现,含严重性。
- 依赖漏洞报告,含 CVE ID、受影响包、版本和修复可用性。
- 若已生成,提供 CycloneDX 或 SPDX 格式的 SBOM。
- IaC 配置错误发现,含资源和检查 ID。
## 停止条件
- 所有范围内的仓库、清单和产物路径已完成扫描。
- SAST 发现已通过数据流追踪验证,不是原始工具输出。
- 零密钥扫描结果已手动验证。
- 高/严重依赖 CVE 已评估可达性。
- 后续工作需要访问生产密钥、运行被测代码或测试线上端点(切换到 `web-application.md` 或 `api-security.md`)。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |