expanso-cve-scan

🛡️ 软件供应链安全扫描利器

基于 Expanso Edge 的 SBOM 漏洞扫描工具,对接 OSV/NVD 权威漏洞库,帮助开发团队快速识别依赖组件中的已知 CVE 风险。

收藏
7.7k
安装
1.9k
版本
v1.0.0
CLS 安全性认证2026-05-09
点击查看完整报告 >

使用说明

核心用法

cve-scan 是一款专为软件供应链安全设计的漏洞扫描技能,通过解析 SBOM(Software Bill of Materials)文件,自动比对 OSV(Open Source Vulnerabilities)和 NVD(National Vulnerability Database)两大权威漏洞数据库,识别项目中依赖组件的已知 CVE 漏洞。该技能支持三种运行模式:CLI 管道模式适合本地快速扫描和 CI/CD 集成;MCP 模式可作为服务长期运行,接收外部请求;Expanso Cloud 部署模式则支持云端规模化执行。用户只需提供标准格式的 SBOM 文件(如 CycloneDX 或 SPDX),技能即可返回详细的漏洞报告,包括 CVE 编号、严重程度评分、影响版本范围及修复建议。

显著优点

该技能的最大优势在于其架构的简洁性与安全性。作为纯 YAML 配置型工具,它完全依赖 Expanso Edge 运行时执行,自身不包含任何可执行脚本代码,从根本上杜绝了代码注入和恶意执行风险。漏洞数据源方面,OSV 由 Google 维护,聚合了多个安全公告源,数据覆盖广且更新及时;NVD 则是美国国家标准与技术研究院的官方数据库,权威性无可置疑。此外,技能设计充分考虑了 DevSecOps 场景,CLI 模式可无缝嵌入 GitHub Actions、GitLab CI 等流水线,实现自动化安全门禁。配置灵活性也是亮点,NVD API Key 为可选项,既满足普通用户的轻量需求,也为企业级高频扫描提供更高配额。

潜在缺点与局限性

首先,该技能强依赖外部在线服务,OSV API 的可用性和响应速度直接影响扫描体验,在网络受限或离线环境中完全无法工作。其次,SBOM 数据外传可能引发合规顾虑——尽管 OSV API 是公开服务,但包名和版本信息属于项目敏感元数据,部分高安全要求场景可能禁止外发。第三,免费 API 存在请求限流,大规模代码库扫描时可能触发速率限制,需申请 NVD API Key 缓解,但这增加了配置复杂度。第四,输入验证相对基础,仅检查 sbom 字段存在性,缺乏对 SBOM 格式规范性和完整性的深度校验,错误输入可能导致扫描失败或结果不准确。最后,MCP 模式默认监听 0.0.0.0,若未配置防火墙存在被未授权访问的风险。

适合的目标群体

该技能主要面向三类用户:一是 DevOps 和平台工程团队,需要在 CI/CD 流水线中建立自动化安全扫描能力;二是安全工程师和合规审计人员,负责定期评估项目依赖风险;三是开源维护者和独立开发者,希望在发布前快速自检项目漏洞。特别适合已采用 Expanso 生态或愿意引入 Expanso Edge 作为数据处理引擎的技术团队。对于追求极致安全隔离的金融、军工等行业,建议评估本地漏洞数据库方案后再做决策。

使用风险

常规风险包括:网络依赖导致的可用性风险,建议设置超时重试和降级策略;API 配额耗尽导致的扫描中断,建议监控调用量并准备 Key 轮换机制;SBOM 数据质量风险,建议前置引入 SBOM 生成工具的标准化校验;MCP 模式的暴露面风险,建议通过环境变量限制监听地址并配合反向代理使用。此外,Expanso Edge 作为新兴运行时,其长期维护性和社区生态成熟度尚需观察。

安全解读

核心用法

cve-scan 是一款轻量级SBOM漏洞扫描Skill,通过调用Google OSV(Open Source Vulnerabilities)开放数据库,检测软件物料清单中的已知CVE漏洞。支持三种运行模式:CLI管道直调、MCP Server模式、以及Expanso Cloud云端部署。

典型工作流

# 生成SBOM后直调扫描
cat sbom.json | expanso-edge run pipeline-cli.yaml

显著优点

  • 零依赖架构:纯YAML配置驱动,无第三方代码依赖,依赖审计得分高达95分
  • 可信数据源:直接对接Google OSV官方API,安全业界公认的高质量漏洞数据库
  • 隐私友好:仅传输包名与版本信息,不收集PII或环境敏感数据,GDPR合规
  • 多模式部署:支持边缘本地执行、MCP协议集成、云端托管三种形态
  • 代码简洁:约150行配置代码,结构清晰,审计友好

潜在局限

  • 外部依赖:必须联网访问api.osv.dev,离线环境无法使用
  • 输入验证弱:SBOM JSON解析缺乏严格Schema校验,异常格式可能导致错误
  • 批处理限制:OSV API单批次上限100个包,超大规模SBOM需分页处理(文档未明确说明)
  • 无超时重试:网络不稳定时缺乏容错机制

适合人群

  • DevOps/SRE工程师:集成至CI/CD流水线进行发布前安全检测
  • 安全合规团队:快速审计项目依赖漏洞
  • 开源维护者:轻量级替代方案,无需部署Snyk/Dependabot等商业服务

常规风险

| 风险项 | 等级 | 说明 |
|--------|------|------|
| 数据外传 | Low | SBOM包信息发送至Google OSV,已TLS加密 |
| 输入注入 | Low | JSON解析无严格验证,但无代码执行风险 |
| 服务可用性 | Medium | 依赖OSV API在线服务,无离线缓存机制 |

总体评估:标准安全级别(Grade A/85分),无高危风险,适合生产环境集成,建议完善隐私声明文档。

expanso-cve-scan 内容

test文件夹
手动下载zip · 3.9 kB
test.yamltext/plain
请选择文件