SuperAPI AI 工具集

transilience-report-style

安全与审计

查看项目

更新于 10-16 01:08

技能介绍

用途:在渗透测试、漏洞评估、网络扫描或合规项目完成并验证后,用一份结构化 findings JSON 生成品牌化 A4 PDF 交付物。生成器数据驱动:组装一个 JSON,运行一条命令。

主要能力:输出封面、自动 KPI 指标框的执行摘要、自由格式章节、按 Critical 到 Info 分组的问题卡片(含严重性条、CVSS 与向量、CWE/OWASP、状态、受影响对象、描述、影响、可选 PoC、修复建议),以及可选 CVE 登记表、覆盖表、攻击模式覆盖矩阵、排除项附录、工具与技术、修复路线图和免责声明。支持内部分节("internal": true 保留在 JSON 中但不渲染到客户 PDF)。可生成执行版(--exec-only,仅封面、KPI、叙述与路线图)和机器可读导出(CSV/XML)。

使用方式:

  1. 按 reference/report-data-schema.json 编写 report_data.json,仅 engagement 和 findings 必填,其余键为可选分节,缺失则跳过。
  2. 运行:python3 reference/generate_report.py <report_data.json> -o reports/My-Report.pdf 字体与 logo 从 formats/transilience-report-style/ 自动发现,可用 --assets <dir> 覆盖。依赖 reportlab(pip install reportlab)。
  3. 用 pdftoppm -png -r 100 -f 1 -l 1 out.pdf /tmp/p 渲染页面检查后再交付。 执行版:generate_report.py <data.json> --exec-only;导出:python3 ../../tools/report_export.py <data.json> --format csv|xml -o findings.csv。

适用场景:需要标准 Transilience 交付物的安全团队,以及合规变体报告。

限制与约定:严重性由 CVSS 区间设定(≥9 Critical、≥7 High、≥4 Medium、>0 Low、0 Info),除非有意调优并在 calibration 字段说明;不使用 emoji,仅文字严重性标签;一个问题对应一个已验证问题,系统性问题应合并。渲染时会防御性遮蔽 PAN/Aadhaar/卡号类值,但源文本仍应自行脱敏真实密钥与 PII。运行前建议先执行预检 lint(../../tools/report_data_lint.py)以拦截不合格 schema、字符串化叙述或不安全标签。修订与外部报告摄入分别使用 report_data_revise.py 和 report_ingest.py。字体、价格、平台支持等未在资料中明确说明的信息暂未提供。