OpenSCA v1.0.11 版本升级教学文档

一、版本概述

OpenSCA v1.0.11 是基于 v1.0.10 的迭代版本，主要针对用户反馈进行了功能优化和新增特性。该版本由 OpenSCA 社区于 2023 年 5 月 30 日发布，属于企业安全领域的工具更新。

二、主要升级内容

1. Java 解析逻辑优化

• 进一步优化了 Java 解析逻辑
• 考虑了更多特殊情况，提高了兼容性
• 建议用户体验并反馈使用情况

2. 终端界面输出优化

2.1 检测结果概览

• 组件风险及漏洞情况概览直接打印至执行终端
• 显示内容包括：
  • Components：组件总数
  • Vulnerabilities：漏洞总数
  • CHML：严重(Critical)/高危(High)/中危(Medium)/低危(Low)漏洞数量

2.2 报错信息显示

• 新增两种常见错误的终端显示：
  1. 文件路径错误（-path 参数输入错误）
  2. 云漏洞库服务鉴权失败（-url 和 -token 参数输入错误）

3. SBOM 清单格式支持扩展

新增支持两种国际标准格式的 SBOM 清单输出：

3.1 Cyclonedx 格式

• 通过控制 -out 参数的文件名后缀实现
• 示例命令：opensca-cli -path ${file_path} -out output.cyclonedx.json

3.2 SWID 格式

• 通过控制 -out 参数的文件名后缀实现
• 示例命令：opensca-cli -path ${file_path} -out output.swid.json

4. 检测速度提升

4.1 默认逻辑优化

• 新增阿里云镜像库作为 maven 官方库的备用
• 解决了官方库连接受限导致的检测速度过慢问题

4.2 旧版本速度优化方案

对于 v1.0.6-v1.0.10 版本：

1. 在配置文件 config.json 中设置 "maven" 字段：

   {
     "maven": {
       "repo": [
         "https://maven.aliyun.com/repository/public",
         "https://repo1.maven.org/maven2"
       ]
     }
   }
   

2. 执行命令时添加 -config 参数：

   opensca-cli -path ${file_path} -config config.json
   

对于 v1.0.5 及更低版本：

• 需要自行修改源码配置镜像库地址
• 建议升级到更高版本

三、使用建议

1. 升级建议：所有用户建议升级到 v1.0.11 版本以获得更好的性能和功能支持
2. 反馈渠道：
   • 在评论区留言
   • 在 Gitee/GitHub 项目的 Issues 中提交问题或建议
3. 贡献方式：欢迎成为开源贡献者，通过 PR 提交代码改进

四、资源链接

1. GitHub 发布页：
   https://github.com/XmirrorSecurity/OpenSCA-cli/releases
2. Gitee 发布页：
   https://gitee.com/XmirrorSecurity/OpenSCA-cli/releases
3. OpenSCA 官网：
   https://opensca.xmirror.cn/

五、注意事项

1. 检测速度影响因素：

   • 压缩包大小
   • 网络状况
   • 检测语言
   • 通常检测时间为几秒到几分钟

2. 错误排查：

   • 检查文件路径是否正确
   • 检查 url 和 token 参数是否正确
   • 查看终端输出的错误信息

3. 版本兼容性：

   • 不同版本有不同的优化方案
   • 建议使用最新版本以获得最佳体验