基于 SBOM 检测 iOS 应用已知漏洞依赖:MASTG-TEST-0275 实战指南

原创2026-10-08 18:37:321,910 阅读
文章标签:文档教程网络安全

基于 SBOM 检测 iOS 应用已知漏洞依赖:MASTG-TEST-0275 实战指南

本篇指南聚焦 OWASP MASTG 中针对 iOS 平台的测试用例 MASTG-TEST-0275,系统讲解如何通过生成软件物料清单(SBOM)来识别 iOS 应用中带已知漏洞的第三方依赖,并结合仓库中的配套技术(MASTG-TECH-0132)、工具(cdxgen、Dependency-Track)与演示项目(MASTG-DEMO-0053),给出从 SBOM 生成、上传到漏洞核查与修复的完整可执行方案。读完本文,你将掌握一条不依赖 App 反编译、可直接在开发侧落地的供应链漏洞检测流水线。

背景:iOS 第三方依赖为何需要专项检测

iOS 应用普遍依赖第三方库来加速开发,但这同时引入了三类风险(详见 MASTG-KNOW-0059):

  • 库内含已知漏洞:历史上 AFNetworking 2.5.1 曾因禁用证书校验的缺陷,使依赖它的应用可被中间人(MITM)攻击;
  • 库停止维护:漏洞无人上报、无人修复,坏代码随库进入生产应用;
  • 许可证风险:如 LGPL2.1 类许可要求向使用者开放源码,可能危及应用的商业知识产权。

iOS 生态中主流的包管理工具是 Swift Package Manager(Xcode 11 起内置集成)、Carthage 与 CocoaPods,三者分别通过 Package.swift、Cartfile、Podfile 声明依赖。由于依赖关系复杂且更新频繁,人工追踪"哪个库、哪个版本、对应哪个 CVE"几乎不可行,因此 OWASP 将这一检查固化为基于 SBOM 的自动化测试用例。

该用例归属于 MASVS-CODE 类别,对应的弱点枚举为 MASWE-0044(Dependencies with Known Vulnerabilities)。除本文讲解的 iOS 用例 MASTG-TEST-0275 外,Android 平台有同族的 MASTG-TEST-0274 用例,方法学一致,仅生成 SBOM 的工具链入口不同。

测试用例核心:做什么、怎么做、怎么判

MASTG-TEST-0275 的完整定义如下:

  • 测试目标:通过软件物料清单(SBOM)检查 iOS 应用中是否存在已知漏洞的依赖;
  • SBOM 格式要求:必须为 CycloneDX 格式,这是描述软件组件与依赖关系的开放标准;
  • 测试类型:静态分析 + 开发者侧操作(type: [static, developer]),即建议在开发/CI 阶段由开发者执行,而非依赖黑盒测试。

三步执行流程

  1. 使用 MASTG-TECH-0132 描述的方法生成 SBOM,或直接向开发团队索取 CycloneDX 格式的 SBOM 文件;
  2. 将 SBOM 上传到 MASTG-TOOL-0132(Dependency-Track)平台;
  3. 在 Dependency-Track 的项目中检查是否存在使用了已知漏洞依赖的情况。

观察与判定标准

  • 观察项(Observation):输出应包含依赖清单,若存在漏洞,需给出依赖名称与对应的 CVE 标识符;
  • 评估(Evaluation):只要发现任何带已知漏洞的依赖,测试用例即判定为失败。

这一判定标准意味着该用例是一种"存在性检查":结果不是评分,而是明确的通过与不通过,便于直接接入 CI 门禁。

工具链选型:cdxgen + Dependency-Track

SBOM 生成器:cdxgen(MASTG-TOOL-0134)

MASTG-TOOL-0134(cdxgen)由 CycloneDX 社区维护,能用单条命令为大多数应用和容器镜像生成 SBOM。对移动端:

  • iOS:支持 SwiftPM 依赖;
  • Android:支持 Maven 依赖。

需要特别说明的是,cdxgen 对已编译 APK/AAB 的 SBOM 生成支持有限且大多不完整,原因是编译后库的元数据被剥离;因此官方建议在 App 工程目录下执行 cdxgen 以获得完整 SBOM(该建议同样适用于 Xcode 工程场景)。

漏洞分析平台:Dependency-Track(MASTG-TOOL-0132)

Dependency-Track 是一个组件分析平台,用于帮助组织识别并降低软件供应链风险,具备以下关键特性:

  • 安装:官方推荐基于 Docker 部署,首次启动时的默认凭据见其初始设置文档;
  • 输入:依赖 SBOM 识别漏洞依赖,SBOM 可由 cdxgen 等工具生成后经 API 上传;
  • REST API:支持 API Key 认证,上传时需指定目标项目。

默认部署下,Dependency-Track 的 Web 前端位于 http://localhost:8080,REST API 位于 http://localhost:8081。

实操一:生成 iOS 应用的 CycloneDX SBOM

执行命令

按照 MASTG-TECH-0132,进入待扫描的 Xcode 工程根目录,执行:

$ cdxgen -o sbom.json

该命令会分析工程的 SwiftPM 依赖清单(Package.resolved),输出 CycloneDX 格式的 sbom.json。仓库中的演示项目 MASTG-DEMO-0053 的 run.sh 正是这一条命令的直实现:

cdxgen -o sbom.json

使用边界(务必先确认)

  • 仅支持 SwiftPM:当前版本的 cdxgen 对 iOS 仅支持 Swift Package Manager,Carthage 与 CocoaPods 暂不支持;
  • 不覆盖传递依赖:cdxgen 对 SwiftPM 的传递依赖(transitive dependencies)并不支持,生成的 SBOM 仅含直接依赖,分析结果可能存在漏报,需要在报告中注明该局限;
  • 若开发团队已有现成的 CycloneDX SBOM(例如由其他 SCA 平台导出),可直接索取使用,跳过本步骤。

实操二:将 SBOM 上传至 Dependency-Track

1. 对 SBOM 做 Base64 编码

$ cat sbom.json | base64

2. 通过 REST API 上传

MASTG-TECH-0132 给出了完整的 PUT 请求示例:

$ curl -X "PUT" "http://localhost:8081/api/v1/bom" \
     -H 'Content-Type: application/json' \
     -H 'X-API-Key: <YOUR API KEY>' \
     -d $'{
  "project": "<YOUR PROJECT ID>",
  "bom": "<BASE64-ENCODED SBOM>"
  }'

各字段含义:

字段 说明
X-API-Key Dependency-Track 的 REST API 密钥,用于认证(API 密钥的获取与项目管理参见 Dependency-Track 的 REST API 集成文档)
project 目标项目 ID,即 SBOM 要归入的 Dependency-Track 项目
bom Base64 编码后的 SBOM 内容

3. 大文件上传的备选方案

如果生成的 sbom.json 文件过大,TECH-0132 提示可参考 Dependency-Track 官方文档中的 CI/CD 上传备选方式(如使用其提供的 cicd 上传工具或分块策略),不必强行使用单条 curl。

4. 前端确认

若采用 Dependency-Track 的默认 Docker 容器配置,上传完成后打开 Web 前端 http://localhost:8080,进入刚才上传 SBOM 的项目页面,即可核查是否存在漏洞依赖。

实操三:在 Dependency-Track 中核查漏洞

上传完成后,Dependency-Track 会基于 NVD 等漏洞数据库对 SBOM 中的每个组件(component)做交叉比对,给出:

  • 依赖(组件)清单:名称、版本、purl 标识;
  • 漏洞清单:每个漏洞对应的 CVE 标识符与严重程度;
  • 受影响组件:漏洞与依赖的对应关系。

对照 MASTG-TEST-0275 的评估标准,只要项目页面中出现任何"存在已知漏洞的依赖",即可判定测试不通过,进入修复流程(通常为升级到已修复版本或替换依赖)。

演示实证:MASTG-DEMO-0053 的完整扫描输出

仓库中的 MASTG-DEMO-0053 是 MASTG-TEST-0275 的真实落地演示:在示例工程 MASTestApp-iOS-MASWE-0076 根目录执行 cdxgen -o sbom.json,再把 SBOM 按 MASTG-TECH-0132 上传到 Dependency-Track。

生成结果:CycloneDX 1.5 的字段结构

演示的输出文件 output.txt 展示了一份标准的 CycloneDX 1.5 SBOM,关键结构如下:

  • 顶层元信息:bomFormat 为 CycloneDX,specVersion 为 1.5,并带有唯一 serialNumber(uuid);
  • 生成工具(tools):记录生成器 cdxgen 版本 10.10.5 及其 purl,形成可追溯的生成链路;
  • 主组件(component):即被测应用 MASTestApp-iOS-MASWE-0076,type 为 application,purl 为 pkg:swift/...@latest;
  • 组件清单(components):本次扫描识别出 2 个第三方组件:
    • actions/checkout v4(type: application,来源 GitHub Actions)
    • github.com/apple/swift-nio 1.4.0(type: library)
    • github.com/apple/swift-nio-zlib-support 1.0.0(type: library)
  • 证据(evidence):每个组件均记录了身份确认方法 manifest-analysis 及来源路径 .../swiftpm/Package.resolved,说明 cdxgen 是直接解析 SwiftPM 锁文件得出的依赖清单。

分析结论

按演示文档的观察记录,SBOM 上传到 Dependency-Track 后,扫描识别出 2 个唯一依赖(组件),其中 2 个为漏洞依赖,共 2 个漏洞(随着时间推移,漏洞库更新后数量可能增加)。评估结论明确指向:swift-nio(1.4.0)存在 2 个已知漏洞,应升级到最新版本。

这正是本用例的价值闭环:SBOM 生成 → 平台比对 → CVE 定位 → 依赖升级,全程无需逆向 App 二进制,测试数据与证据链清晰可审计。

评估结果处置与注意事项

判定为失败后的处置路径

  1. 升级依赖:将存在漏洞的库升级到已修复版本(如上述 swift-nio),重新生成 SBOM 并复测;
  2. 替换依赖:对已停止维护且无法修复的库,评估替代方案并迁移;
  3. 接受与缓解:若漏洞位于不可达路径或暂无可修复版本,需记录风险接受决策,并持续关注 CVE 更新(Dependency-Track 会持续跟踪漏洞库,同一项目可能随库更新出现新增漏洞)。

执行注意事项

  • 由于 cdxgen 对 SwiftPM 不覆盖传递依赖,扫描结果可能漏报,测试报告中应注明该限制,必要时结合其他 SCA 工具交叉验证;
  • Carthage、CocoaPods 项目目前无法用 cdxgen 生成 SBOM,可要求开发团队提供其使用的 SCA 平台导出的 CycloneDX 文件;
  • SBOM 分析依赖漏洞数据库的及时性,同一份 SBOM 的结论会随时间变化,建议将本测试接入 CI 定期运行而非一次性检查。

仓库资源速览

资源 路径 用途
测试用例 MASTG-TEST-0275 iOS SBOM 漏洞依赖检测的定义与判定标准
执行技术 MASTG-TECH-0132 SBOM 生成与上传的完整命令
生成工具 MASTG-TOOL-0134 cdxgen 能力与平台支持范围
分析平台 MASTG-TOOL-0132 Dependency-Track 部署与 API 说明
演示项目 MASTG-DEMO-0053 完整扫描输出与漏洞实证(run.sh、output.txt)
知识背景 MASTG-KNOW-0059 iOS 第三方依赖风险与包管理工具生态
同族用例 MASTG-TEST-0274 Android 平台的 SBOM 漏洞依赖检测
登录后查看全文
mastg