SuperAPI AI 工具集

firewall-auditor

通用与其它

查看项目

更新于 10-16 08:09

技能介绍

用途:审计 UniFi 网络中的防火墙配置,发现冲突、冗余、安全缺口与最佳实践问题。依赖 network 工具;审计由模型通过 MCP 工具调用完成,不读取明文凭据。

主要能力:先判定站点使用哪种防火墙引擎(区域式 V2;若区域式与区域工具均为空而传统规则有内容则为传统引擎;三者皆空为不确定)。随后按 references/security-benchmarks.md 中的 16 项基准顺序评估:分段 SEG-01~04、出站控制 EGR-01~03、规则卫生 HYG-01~05、拓扑 TOP-01~04。按实例计数,例如固件可升级设备逐台生成一条 TOP-02 发现。

使用方式:并行调用 unifi_list_firewall_policies、unifi_list_firewall_zones、unifi_list_legacy_firewall_rules、unifi_list_networks、unifi_list_firewall_groups、unifi_list_devices,可选 unifi_get_dpi_stats;需要策略细节时并行调用 unifi_get_firewall_policy_details。若必需工具返回 success=false,则停止打分并在“覆盖与局限”中说明。将发现对象(benchmark_id、severity、message、可选 fix)管道给评分 CLI: echo '{"findings": [...]}' | "<firewall-auditor-skill-dir>/scripts/unifi-firewall-score" CLI 返回 overall_score、overall_status、rubric_version 与各分类分数。不要把打分自行心算。随后把 {timestamp, overall_score, overall_status, rubric_version} 追加到 ${UNIFI_SKILLS_STATE_DIR:-${XDG_STATE_HOME:-$HOME/.local/state}/unifi-mcp/skills}/audit-history.json,保留最近 50 条,并计算与上一条的差值;rubric_version 变化时不计算趋势。分数区间:80–100 健康,60–79 需关注,0–59 危急。

报告须写明所审计的引擎,并以“覆盖与局限”列出各来源状态、时间窗或采集时间、过滤器、返回条数、分页与失败调用;区分观察、假设与身份归属。空结果不等于来源不可用,不可用或部分覆盖的数据不得给出整体健康结论。发现按严重度排序,危急优先。修复本身不由审计执行,需切换到 firewall-manager 技能预览并确认后再改控制器。检查项以安全基准文档为准,不新增 benchmark_id。缺失事实暂未提供。