CycloneDX SBOM에서 보안 결과로
GitLab v19.6요약
초점: 의존성 스캔 cyclonedx 보고서가 security_findings가 되는 과정입니다. 모든 경로는 ee/ 아래에 있습니다. subgraph SBOMP["SBOM path (new dependency scanning): findings synthesized from the SBOM"] D -->|"Important: skipped if the same job also emitted&#x...
초점: 의존성 스캔 cyclonedx 보고서가 security_findings가 되는 과정입니다.
SBOM에 특화된 부분은, 결과가 스캐너 자체의 취약점 보고서에서 구문 분석되는 것이 아니라
저장 시점에 SBOM의 컴포넌트를 Package Metadata DB(PMDB) 권고와 대조해 SBOM에서 합성된다는 점입니다.
"DS 결과는 이제 메인 수집 프로세스 중에 수집됩니다"라는 말이 가리키는 것이 이것입니다.
모든 경로는 ee/ 아래에 있습니다. Sbom::*와 PackageMetadata::* 모델은
sec DB(gitlab_sec)에 있습니다. security_findings 테이블은 main/ci에 있습니다.
소스 코드 보기
flowchart TD
A["CI job completes<br/>(cyclonedx and/or security-report artifact)"] --> B["Ci::JobSecurityScanCompletedEvent<br/>(a cyclonedx job counts as a security_job)"]
B --> C["Security::Scans::IngestReportsWorker → IngestReportsService"]
C --> D["Security::StoreScansService"]
subgraph SBOMP["SBOM path (new dependency scanning): findings synthesized from the SBOM"]
D -->|"Important: skipped if the same job also emitted<br/>gl-dependency-scanning-report.json"| E["store_sbom_scans → StoreGroupedSbomScansService → StoreSbomScanService"]
E --> F["JobArtifact#security_reports (cyclonedx branch)<br/>parse_sbom_reports → Parsers::Sbom::Cyclonedx"]
F --> G["VulnerabilityScanning::SecurityReportBuilder<br/>scan_sbom_report_occurrences (DS-source SBOMs only)"]
ADV[("pm_advisories / pm_affected_packages")] -.->|"match components<br/>(AdvisoryUtils + FindingBuilder)"| G
G --> H["Reports::Security::Report(:dependency_scanning)<br/>synthetic scanner SecurityScanner.fabricate<br/>→ MergeReportsService (dedup)"]
H --> I["StoreSbomFindingsService<br/>(keep valid, drop existing uuids)"]
end
subgraph LEG["gl-dependency-scanning-report.json path: findings parsed from the security report"]
D --> J["store_security_scans → StoreGroupedScansService → StoreScanService"]
J --> K["Parsers::Security::* → Reports::Security::*"]
K --> L["StoreFindingsService"]
end
I --> M[("security_findings")]
L --> M
M -.->|"generic promotion, all scanners<br/>(see security report ingestion overview)"| N["Security::Ingestion → vulnerabilities"]
단계#
- 트리거. cyclonedx(또는 보안 보고서) 아티팩트를 생성한 CI job이
완료되면
Ci::Build가Ci::JobSecurityScanCompletedEvent를 게시합니다. cyclonedx job은security_job?로 간주되므로 분석기 보고서와 같은 파이프라인으로 들어갑니다. - 저장 단계.
Security::Scans::IngestReportsWorker→Security::StoreScansService가store_sbom_scans(cyclonedx)와store_security_scans(기타 보고서)로 갈라집니다. 중요: 같은 job이gl-dependency-scanning-report.json도 내보낸 경우 (job 범위이며job_id로 대조) cyclonedx SBOM 결과 합성은 건너뜁니다. 같은 의존성 스캔 결과가 두 번 수집되지 않도록 하기 위해서입니다. 이 건너뛰기는 결과 합성 경로에만 적용되며, 별도의sbom_*occurrence 수집은 여전히 cyclonedx 보고서를 처리합니다. 작업 항목 546429를 참고합니다. - SBOM 경로, 보고서 빌드. cyclonedx 아티팩트에 대해
JobArtifact#security_reports가 SBOM을 구문 분석하고(Parsers::Sbom::Cyclonedx)VulnerabilityScanning::SecurityReportBuilder에 넘깁니다. - 권고 대조(SBOM에 특화된 단계).
SecurityReportBuilder#scan_sbom_report_occurrences가AdvisoryUtils+FindingBuilder를 사용해 SBOM 컴포넌트를 PMDB 권고(pm_advisories/pm_affected_packages)와 대조하고, 합성 스캐너(SecurityScanner.fabricate)를 가진Reports::Security::Report(:dependency_scanning)를 생성합니다. 의존성 스캔 소스 SBOM(입력 파일 경로가 있는 것)만 처리되며,MergeReportsService가 보고서 안에서 중복을 제거합니다. - 결과 저장.
StoreSbomScanService가StoreSbomFindingsService를 호출하고, 이 서비스는 아직 존재하지 않는 유효한 결과를 유지해security_findings에 기록합니다. gl-dependency-scanning-report.json경로(겹치는 부분). 자체 보안 보고서를 내보내는 의존성 스캔 분석기는Parsers::Security::*로 구문 분석하고, 일반StoreFindingsService(다른 분석기가 사용하는 것과 같은 경로)를 통해 같은security_findings에 기록합니다.- 다음에 일어나는 일(여기서는 초점 밖).
security_findings는 모든 스캐너에 동일한 일반Security::Ingestion경로로vulnerabilities로 승격됩니다. 보안 보고서 수집 개요를 참고합니다. 별도로, cyclonedx 보고서는sbom_*occurrence 테이블(의존성 인벤토리)에 다시 수집되어 이 취약점에 연결되며, 이는 별개의 플로입니다(SBOM occurrence 수집 다이어그램 참고).
핵심: SBOM에 특화된 로직은 전부 cyclonedx →
security_findings(권고 대조)에 있습니다. 결과 → 취약점은 일반 경로이므로
의도적으로 여기에 다시 그리지 않았습니다.
관련 항목#
- 보안 보고서 수집 개요
- 일반적인 결과 → 취약점 승격입니다.
- SBOM occurrence 수집(의존성 인벤토리 + 취약점 연결), 짝이 되는 다이어그램입니다.
- 지속적 취약점 스캔(CVS), 여기서 보여 주는 권고 대조의 파이프라인 외부 대응 경로입니다.