核心功能
vmware-harden 是一款专为 VMware vSphere/ESXi/NSX 环境设计的 AI-native 合规扫描工具。核心能力包括：
1. 多标准基线扫描：内置6大权威合规框架——CIS ESXi 8.0、vSphere SCG v8、等保2.0三级、PCI-DSS 4.0、BSI IT-Grundschutz（德国）、EU NIS2（欧盟），同时支持自定义YAML基线导入。
2. 配置漂移检测：通过 Twin DuckDB 存储多时间点快照，实现节点级配置差异比对（新增/删除/变更字段），支持跨时间维度的安全态势追踪。
3. LLM驱动修复建议：集成 Anthropic Claude API，针对每个违规项生成上下文感知的修复步骤；未配置API密钥时自动降级为模板化建议。修复建议仅限参考，不执行任何变更。
4. Web 可视化看板：FastAPI + Jinja2 构建的只读仪表板，支持违规项排序、漂移时间线浏览、基线规则详情查看。
5. MCP 协议支持：提供6个只读工具（基线列表、规则详情、违规查询、修复建议、漂移事件、扫描触发），专为AI Agent集成设计。
显著优点
- 合规覆盖全面：同时满足中国（等保2.0）、美国（CIS/PCI-DSS）、德国（BSI）、欧盟（NIS2）四大区域监管要求，跨国企业场景友好。
- 架构解耦安全：不直连vCenter/NSX，依赖上游 vmware-aiops 采集器获取数据，扫描行为本身零写操作，风险可控。
- 漂移追踪能力：业界少有的VMware配置历史比对功能，可精准定位"上周发生了什么变更导致合规失败"。
- AI建议可解释：LLM建议基于结构化证据（typed Twin queries），非自由文本输入，且经过
_sanitize()过滤控制字符，降低提示注入风险。 - 开源可审计：MIT许可证，源码托管于 GitHub，无黑盒依赖。
潜在局限
- 非独立运行：强制依赖 vmware-aiops 作为数据源，无法单独直连vCenter；若上游采集器故障，hardern 完全不可用。
- 修复执行分离：本技能仅生成建议，实际修复需通过 vmware-pilot 执行，多技能编排增加使用复杂度。
- 等保基线条件触发：等保2.0规则涉及多采集器数据（vCenter高级设置 + ESXi NTP + NSX DFW），部分采集器未运行时规则会被跳过，可能导致"假阴性"。
- LLM依赖外部服务：实时修复建议需调用 Anthropic API，离线环境或网络受限场景下降级为模板建议，质量下降。
- DuckDB 单点存储：Twin数据默认存储于本地SQLite兼容的DuckDB，无内置高可用或分布式能力，多节点部署需自行同步。
适合人群
- 负责 VMware 环境合规审计的 安全工程师 与 运维审计员
- 需要满足 等保2.0三级、PCI-DSS 或 EU NIS2 监管要求的跨国企业云团队
- 构建 DevSecOps流水线 的SRE，需将合规扫描集成至CI/CD门禁
- 运维 多区域vCenter集群、需统一合规看板的平台架构师
- 希望用 自然语言查询 合规状态的AI Agent开发者（通过MCP协议）
常规风险
| 风险类别 | 具体描述 | 缓解措施 |
|---------|---------|---------|
| **数据泄露** | DuckDB文件存储于 `~/.vmware-harden/twin.duckdb`，包含完整配置快照 | 文件权限设为600，定期清理历史快照，敏感环境使用 `VMWARE_HARDEN_DB` 指向加密卷 |
| **API密钥泄露** | `ANTHROPIC_API_KEY` 若写入 shell history 或明文.env文件 | 使用密钥管理工具（如1Password CLI），避免提交至版本控制 |
| **误报/漏报** | 等保基线因采集器缺失导致规则跳过，或自定义YAML基线路径错误 | 扫描后检查 `report` 中的 `skipped` 状态，验证 `baseline validate` 通过 |
| **供应链污染** | uv/PyPI 依赖被投毒 | 使用 `uv tool install` 固定版本，启用 `UV_NATIVE_TLS` 校验TLS，企业环境使用内部PyPI镜像 |
| **权限提升误用** | 用户混淆 vmware-harden（只读）与 vmware-pilot（可写），误以为自己仅在"查看建议" | 严格遵守技能路由表，执行变更前必须通过 vmware-pilot 的审批门 |
安全设计亮点
- 零网络外连：除可选的Anthropic API外，无其他出站连接；web dashboard 默认绑定127.0.0.1。
- 凭证隔离：不存储任何vCenter密码，全部委托至 vmware-aiops 的凭据管理。
- 审计追踪：所有MCP调用通过
@vmware_tool装饰器记录至~/.vmware/audit.db，支持vmware-audit log回溯。 - 提示注入防护：LLM上下文严格限定为结构化查询结果，用户输入经
_sanitize()截断+过滤控制字符。