xavient/cisco-advisory-impact-analyzer

GitHub: xavient/cisco-advisory-impact-analyzer

一款利用AI将Cisco安全公告与防火墙设备清单自动比对并生成Excel影响评估报告的运维工具。

Stars: 0 | Forks: 0

# Cisco 公告影响分析器粘贴一个 Cisco **Event Response (ERP)** 链接，即可获取一个电子表格，告诉你 **哪些防火墙受到了影响**。在后台，它会查找 ERP 引用的每个安全公告，下载每个公告的官方数据 (CSAF)，并使用 AI（通过 **FueliX**）将受影响的产品和软件版本与**你的防火墙清单**进行比较。结果是一个带有时间戳的 Excel 文件，其中按公告列出了受影响的防火墙——或者显示为 `Indeterminate` / `Not Affected`。支持 **macOS、Windows 和 Linux**。 ## 开始之前 — 你需要什么请确保你拥有以下所有四项内容。没有它们，该工具将无法运行。 | # | 要求 | 如何获取 | | - | ----------- | ------------- | | 1 | **Python 3.9 或更高版本** | 从下方链接一次性安装。 | | 2 | **一个 FueliX API key** | 从获取你的专属 key — 每个人都需要自己的 key（步骤如下）。 | | 3 | **你的防火墙清单**，作为一个单独的 Excel `.xlsx` 文件放置在 **`inventory`** 文件夹中 | 你需要自己构建它（格式如下）。 | | 4 | 连接到 `sec.cloudapps.cisco.com` 和 `api.fuelix.ai` 的 **互联网访问权限** | 通常已经具备；公司代理可能会阻止这些连接。 | **安装 Python（一次性）：** - **Windows:** — 在安装程序的第一个屏幕上，在点击 Install 之前勾选 **“Add python.exe to PATH”**。（或者从 Microsoft Store 安装 “Python”。） - **macOS:** （或运行 `brew install python`）。 - **Linux:** 使用你的包管理器，例如 `sudo apt install python3 python3-venv`。 ### 清单格式你的清单 `.xlsx` 必须包含一个名为 **`FW_List`** 的工作表，并包含以下列（标题名称可以略有不同 — 匹配规则很灵活）： | FirewallName | Model | Firewalltype | IOS version | Priority | | ------------ | ----- | ------------ | ----------- | -------- | | FWLOC1-001 | ISA-3000 | FTD | 7.4.2 | 2 | | FWLOC3-004 | ASA 5506 | ASA | 9.16(4)67 | 1 | `Firewalltype` 应该是 `FTD`、`ASA` 或 `ASAv`。如果你没有模板，请先运行安装程序 — 它会告诉你将文件放在哪里。 ## 安装（一次性） **1. 获取工具。** 在 GitHub 页面上，点击绿色的 **`Code`** 按钮 → **Download ZIP**。解压它。你会得到一个文件夹（例如 `cisco-advisory-impact-analyzer`）。 **2. 将你的清单放入 `inventory` 文件夹。** 将你的清单 `.xlsx` 复制到解压后文件夹的 **`inventory`** 子文件夹中（如果该文件夹不存在，工具会在首次运行时自动创建）。在其中保留**且仅保留一个** `.xlsx` 文件 — 如果工具发现多于一个文件，它会停止并要求你进行清理。 **3. 在*该文件夹中*打开终端。** - **Windows:** 在文件资源管理器中打开该文件夹，然后按住 Shift + 右键单击空白区域 → **“Open PowerShell window here.”** - **macOS:** 打开 **Terminal**，输入 `cd `（带一个空格），然后将该文件夹拖到 Terminal 窗口中并按 Enter 键。 - **Linux:** 右键单击该文件夹 → **“Open Terminal Here,”**，或者使用 `cd` 进入它。 **4. 运行安装程序。** ``` python3 install.py # macOS / Linux python install.py # Windows (if that fails, try: py install.py) ``` 安装程序将： 1. 检查你的 Python 版本， 2. 创建一个私有的、独立的环境（`.venv`）— 它**不会**触及你的系统 Python， 3. 安装它需要的两个小型包， 4. **询问你的 FueliX API key**（输入将被隐藏）并将其保存到 `.env`， 5. 确认你的 `inventory.xlsx` 存在， 6. 运行快速自检。完成后，你将看到 **“Setup complete.”**。 ## 运行在同一个文件夹中，每当你想要分析 ERP 时： ``` python3 run.py # macOS / Linux python run.py # Windows (or: py run.py) ``` 然后在出现提示时**粘贴 Cisco ERP 链接**，例如： ``` https://sec.cloudapps.cisco.com/security/center/viewErp.x?alertId=ERP-75736 ``` （单个公告链接 — `.../CiscoSecurityAdvisory/cisco-sa-...` — 也可以。）该工具会查找所有公告，将每个公告与你的清单进行比对分析，并写入一个名为 **`analysis_output__.xlsx`** 的文件到 **`output`** 文件夹中（会自动创建）。每次运行都会添加一个带有时间戳的新文件，因此会保留以前的报告。随时按 **Ctrl+C** 可干净地取消。 ### 理解输出电子表格有三列： | 列 | 含义 | | ------ | ------------- | | **Vendor Advisory#** | 公告 ID（例如 `cisco-sa-...`） | | **Effected Product Description** | 受影响产品的简要总结 | | **Expected Assessment** | 受影响的防火墙（每行一个 `FirewallName`），或 `Indeterminate` / `Not Affected` | - **防火墙名称列表** — 这些设备符合受影响的产品和软件版本；请检查它们。 - **`Not Affected`** — 该公告适用于 ASA/FTD，但你的设备都不在受影响的版本上。 - **`Indeterminate`** — 仅凭清单无法确定影响。通常是因为它取决于你未追踪的运行时配置（High Availability、VPN/SAML、文件策略、Snort 设置等），或者因为它仅影响你没有的产品（FMC、 cdFMC、SCC、Snort）。这些需要手动检查。 ## `.env` 文件和你的 API key 你的 FueliX API key 保存在工具文件夹中一个名为 **`.env`** 的小文件中。安装程序会创建此文件并询问你的 key，因此通常你只需在出现提示时粘贴它即可。**没有它，工具将无法运行。** ### 获取你的 FueliX API key 1. 前往 **** 并登录。 2. 你应该已经拥有一个 **Default** 项目。点击它的 **`...`** 菜单，然后点击 **View**。 3. 在 **API keys** 下，应该已经列出了一个 key。**Copy** 它。 4. 在安装程序询问 `FUELIX_API_KEY` 时将其粘贴进去（或者粘贴到下面的 `.env` 中）。每个人使用**自己的** key — 请勿共享 key。 ### `.env` 中包含什么 ``` FUELIX_API_KEY=your-key-here FUELIX_MODEL=claude-sonnet-5 FUELIX_BASE_URL=https://api.fuelix.ai/v1 ``` - **`FUELIX_API_KEY`**（必填）— 你的 Dev Portal 个人 key（步骤同上）。 - **`FUELIX_MODEL`**（可选）— 要使用的 AI 模型。默认为 `claude-sonnet-5`；仅当你的组织启用了不同的模型 ID 时才更改它。 - **`FUELIX_BASE_URL`**（可选）— API endpoint；除非另有说明，否则保持原样。 - 对 `.env` **保密** — 它包含你的 key。请勿提交或共享它。如果你想手动设置而不使用安装程序，请将提供的 **`.env.example`** 复制到 **`.env`** 并将你的 key 粘贴进去。 ## 故障排除 - **`python: command not found` / `'python' is not recognized`** — 未安装 Python 或它不在你的 PATH 中。在 macOS/Linux 上使用 `python3`；在 Windows 上尝试使用 `py` 代替 `python`，或者在重新安装 Python 时勾选 **“Add python.exe to PATH”**。 - **`Missing FUELIX_API_KEY`** — 你的 `.env` 中没有 key。重新运行 `python install.py`，或者打开 `.env` 并设置 `FUELIX_API_KEY=...`。 - **`No inventory file found`** — 在 `inventory` 文件夹中仅放入一个清单 `.xlsx` 文件。 - **`More than one inventory file found`** — `inventory` 文件夹中有多个 `.xlsx`；删除多余的文件，只保留一个。 - **Dependency install failed / `pip` errors** — 通常是由于网络或公司代理阻止了对 PyPI 的访问。确认你有互联网访问权限，然后再试一次；如果 PyPI 被阻止，请咨询 IT 部门。 - **Everything comes back `Indeterminate`** — 要么是公告确实依赖于配置 / 仅限 FMC，要么是工具无法访问 `sec.cloudapps.cisco.com`。运行 `python run.py --dry-run` 以查看在不调用 AI 的情况下下载了什么。 - **`FueliX API error` (4xx)** — 检查你的 API key 是否正确，并确保 `FUELIX_MODEL` 是你的组织已启用的模型（在 FueliX Dev Portal，中）。 ## 高级选项可以通过 `run.py` 传递额外的 flag，例如 `python run.py --dry-run`： | Flag | 用途 | | ---- | ------- | | `--url ` | 提供 ERP/公告 URL，而不是进行提示 | | `--inventory ` | 使用特定的清单文件，绕过 `inventory` 文件夹 | | `--sheet ` | 清单工作表名称（默认为 `FW_List`） | | `--output-dir ` | 报告写入的位置（默认：`output` 文件夹） | | `--dry-run` | 在**不**调用 AI 的情况下运行所有内容（无需 API key）— 非常适合测试设置 | | `--no-keep-temp` | 完成后删除下载的 CSAF 文件 | ## 维护者指南

工作原理及如何分发

**Modules** | File | 职责 | | ---- | -------------- | | `analyzer.py` | 编排 + 交互式提示 | | `cisco.py` | 获取 ERP/CSAF，发现公告，提取部分 + 受影响版本 | | `inventory.py` | 读取清单，将其折叠为不同的型号/类型/版本组合 | | `fuelix.py` | 兼容 OpenAI 的 FueliX 客户端 + 每个公告的评估 | | `report.py` | 编写带样式的 Excel 报告 | | `install.py` / `run.py` | 跨平台安装程序和启动器 | | `ui.py` | 终端颜色 + 提示（无依赖项） | 为了保持 AI prompt 的小巧和可靠，清单行被折叠成不同的 `(model, type, version)` 组合；AI 返回哪些组合受到影响，工具再将它们扩展回防火墙名称。 **交给团队成员：** 只需将他们引导至 GitHub 仓库 — 他们按照上面的 Install 部分进行操作即可。Secrets 和用户数据（`.env`、`.venv/`、`inventory/` 和 `output/` 文件夹）会通过 `.gitignore` 排除，因此它们永远不会出现在仓库中。每个团队成员提供自己的 API key 和清单。

标签：AI辅助, Cisco, GPT, PB级数据处理, Python, 安全运维, 无后门, 漏洞管理, 自动化报告, 逆向工具, 防火墙