supply-chain-security

サプライチェーンセキュリティテスト

必須アクション（読了後すぐに実行）

1. NOW: ../field-journal/precedent-pentest.md を読み込む — 本 skill の操作が承認済みの定常操作であることを確認する
2. NOW: 現在のタスクが本 skill の適用範囲に該当するか確認する
3. NEXT: ../tool-index.md を読み込み、ツールの可用性と実際のパスを検証する
4. NEXT: ツールが不足している場合は bootstrap を呼び出す。パスを推測しない
5. ACT: 「ワークフロー」の最初のステップに進んで実行する。確認状態で止まらない

SBOM / SCA / CI/CD パイプライン / 依存関係の来歴 規制による要求：米国大統領令 SBOM、中国国家標準、EU CRA

適用シナリオ

• ソフトウェアサプライチェーンセキュリティ評価
• オープンソース依存関係の脆弱性スキャンと検証
• CI/CD パイプラインのセキュリティ監査
• コンテナイメージのセキュリティ分析
• サードパーティコンポーネントのコンプライアンス審査
• ビルド成果物の来歴と完全性の検証

6 層のサプライチェーンガバナンスフレームワーク

Layer 1: 源码信任评估 → 上游仓库/维护者/发布历史审查
Layer 2: 构建管道集成 → CI/CD 安全门禁、签名验证
Layer 3: 制品分发完整性 → 签名、校验和、SBOM 附加
Layer 4: 运行时保护 → 容器扫描、准入控制
Layer 5: 持续监控 → CVE 实时追踪、漏洞可达性分析
Layer 6: 事件响应 → 供应链攻击应急、回滚策略

ワークフロー

1. SBOM の生成と監査

生成 SBOM：
□ CycloneDX 格式: cdxgen → bom.json
□ SPDX 格式: sbom-tool generate
□ Syft: syft <image|dir> -o spdx-json

审计要点：
□ 是否存在未知/未授权的依赖
□ 是否存在已废弃/停止维护的包
□ 许可证冲突检测
□ 直接依赖 vs 传递依赖清单
□ 每个组件的发布时间线和维护者状态

2. ソフトウェア構成分析（SCA）

# OSV-Scanner（免费、Google 维护）
osv-scanner scan -r . --format json

# OWASP Dependency-Track（企业级持续监控）
docker run -p 8080:8080 dependencytrack/apiserver
# → 上传 SBOM → 自动匹配 NVD/OSV/GitHub Advisory

# Snyk（商业）
snyk test --all-projects
snyk monitor  # 持续监控

# Trivy（容器 + 依赖 + IaC）
trivy fs .          # 文件系统扫描
trivy image nginx   # 容器镜像
trivy config .      # IaC 配置

3. 脆弱性の到達可能性検証

SCA 告警 ≠ 实际风险！大多数 SCA 工具只有 ~15% 的告警是实际可达的。

验证步骤：
1. 用 Dependency-Track 或 Trivy 获取 CVE 列表
2. 筛选 CVSS ≥ 7.0 的漏洞
3. 对有 PoC 的 CVE 做可达性分析
   - Code Property Graph 切片: 追踪用户输入到漏洞函数的路径
   - DEPTEX 方法: EPD (Execution Path Dominance) + LLM 语义验证
4. 在隔离环境中验证 PoC
5. 对可达的漏洞按实际影响排序修复优先级

ツール参考：

• CodeQL: GitHub コードクエリ → データフロー分析
• Snyk Code: 到達可能性のマーキング
• DEPTEX: LLM を活用したコンテキスト認識型リスク評価

4. CI/CD パイプラインセキュリティ

安全检查点：
□ 代码提交 → pre-commit hook: gitleaks (密钥扫描)
□ PR 阶段 → SCA 扫描 (Trivy/OSV-Scanner)
□ 构建阶段 → 制品签名 (cosign)
□ 推送阶段 → SBOM 附加 (syft + attest)
□ 部署阶段 → 准入控制 (OPA/Kyverno + 镜像扫描)
□ 运行时 → 持续漏洞监控 (Dependency-Track)

管道自身安全：
□ Pipeline as Code 审计（GitHub Actions / GitLab CI 配置注入）
□ Runner 隔离（防止恶意构建突破容器）
□ 密钥管理（Actions Secrets / Vault，禁止硬编码）
□ 第三方 Action 审查（锁定 commit SHA，非 tag）

5. コンテナイメージセキュリティ

# Dockerfile 审计
hadolint Dockerfile

# 镜像扫描（多层：OS + 应用依赖 + 配置）
trivy image --severity HIGH,CRITICAL nginx:latest

# 最小基础镜像
# 优先: distroless → alpine → slim → 避免 latest
docker scout quickview nginx:latest

# 镜像签名
cosign sign --key cosign.key myimage:tag
cosign verify --key cosign.pub myimage:tag

6. サードパーティ依存関係の審査

新增依赖 Checklist：
□ 维护状态：最近 6 个月有提交？维护者活跃度？
□ 安全历史：过去有无被植入恶意代码？
□ 依赖树：引入后新增多少传递依赖？
□ 许可证：与项目许可证兼容？
□ 替代方案：有无更安全的替代（Snyk Advisor / Socket.dev 评分）？

风险评估矩阵：
  高维护 × 低依赖数 × 兼容许可证 → 低风险
  低维护 × 高依赖数 × 许可证冲突 → 高风险

ツールチェーン

ツール	用途	入手方法
OWASP Dependency-Track	エンタープライズ向け継続的 SCA	docker pull dependencytrack/apiserver
OSV-Scanner	無料 SCA（OSV.dev エコシステム）	go install github.com/google/osv-scanner
Trivy	イメージ + 依存関係 + IaC スキャン	apt install trivy
Syft	SBOM 生成	curl -sSfL https://raw.githubusercontent.com/anchore/syft/main/install.sh
cdxgen	CycloneDX SBOM 生成	npm install -g @cyclonedx/cdxgen
Cosign	コンテナ署名	go install github.com/sigstore/cosign/v2/cmd/cosign
Gitleaks	シークレット／認証情報スキャン	go install github.com/gitleaks/gitleaks/v8
Snyk	商用 SCA + 到達可能性	npm install -g snyk
CodeQL	コードクエリ + データフロー	GitHub Actions 内蔵

参考

• references/sbom-sca-methodology.md — SBOM + SCA 方法論
• references/cicd-pipeline-security.md — CI/CD パイプラインセキュリティ監査

タスク完了セルフチェック（完了を主張する前に MUST で通過すること）

• ワークフローの各ステップを（読むだけでなく）実行しましたか？
• tool-index に基づいて実際のツールパスを使用しましたか？
• 再現可能な証拠（コマンド／スクリプト／スクリーンショット／レポート）を出力しましたか？
• RULES が要求する Checklist 項目を完了し、書き戻しましたか？