基于 SBOM 检测 iOS 应用已知漏洞依赖:MASTG-TEST-0275 实战指南
基于 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):
- 库内含已知漏洞:历史上
AFNetworking2.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 阶段由开发者执行,而非依赖黑盒测试。
三步执行流程
- 使用 MASTG-TECH-0132 描述的方法生成 SBOM,或直接向开发团队索取 CycloneDX 格式的 SBOM 文件;
- 将 SBOM 上传到 MASTG-TOOL-0132(Dependency-Track)平台;
- 在 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/checkoutv4(type: application,来源 GitHub Actions)github.com/apple/swift-nio1.4.0(type: library)github.com/apple/swift-nio-zlib-support1.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 二进制,测试数据与证据链清晰可审计。
评估结果处置与注意事项
判定为失败后的处置路径
- 升级依赖:将存在漏洞的库升级到已修复版本(如上述
swift-nio),重新生成 SBOM 并复测; - 替换依赖:对已停止维护且无法修复的库,评估替代方案并迁移;
- 接受与缓解:若漏洞位于不可达路径或暂无可修复版本,需记录风险接受决策,并持续关注 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 漏洞依赖检测 |