InfoGrab DocsInfoGrab Docs

지속적 취약점 스캔

요약

초점: 지속적 취약점 스캔(CVS)이 파이프라인에서 분석기를 실행하지 않고, 이미 저장된 SBOM 데이터를 Package Metadata DB(PMDB) 권고와 대조해 취약점을 합성하는 방식입니다. 모든 경로는 ee/ 아래에 있습니다.

초점: 지속적 취약점 스캔(CVS)이 파이프라인에서 분석기를 실행하지 않고, 이미 저장된 SBOM 데이터를 Package Metadata DB(PMDB) 권고와 대조해 취약점을 합성하는 방식입니다. 활성 플로는 새로 게시된 권고마다 트리거되는 전역 스캔이며, CycloneDX에서 보안 결과로 플로와 같은 vulnerability_* 테이블로 합쳐집니다. 두 번째인 프로젝트별 트리거도 있지만 기본적으로 비활성화되어 있으므로, 다이어그램이 아니라 텍스트로 설명합니다.

모든 경로는 ee/ 아래에 있습니다. Sbom::* 모델과 CVS가 기록하는 vulnerabilities 및 vulnerability_* 테이블(예: vulnerability_occurrences, vulnerability_reads)은 gitlab_sec 스키마를 사용하며 sec 데이터베이스에 있습니다. 권고용 PackageMetadata::* 모델(pm_advisories, pm_affected_packages)은 현재 gitlab_main의 별칭인 gitlab_pm 스키마를 사용하며 main 데이터베이스에서 실행됩니다. gitlab_pm과 gitlab_sec 테이블 간의 교차 데이터베이스 조인은 허용되지 않습니다.

Mermaid 다이어그램 (16줄)
소스 코드 보기
flowchart TD
  accTitle: Continuous Vulnerability Scanning global advisory scan
  accDescr: How a newly published advisory triggers a global scan that reads stored SBOM occurrences, matches them against PMDB advisories, and writes to the same vulnerability tables as pipeline ingestion.

A["PackageMetadata::AdvisoriesSyncWorker<br/>cron every 5 min"] --> B["Advisory IngestionService<br/>publish PackageMetadata::IngestedAdvisoryEvent"] B --> C["PackageMetadata::GlobalAdvisoryScanWorker<br/>→ AdvisoryScanService<br/>→ VulnerabilityScanning::AdvisoryScanner<br/>scan_projects_for(advisory) (ALL projects)"] C --> R["Sbom::PossiblyAffectedOccurrencesFinder<br/>read sbom_occurrences (all projects, batched)"] DB[("pm_advisories / pm_affected_packages")] -.-> R R --> M["AffectedVersionRangeMatcher<br/>(semver-dialect aware)"] M --> D2["build FindingMap<br/>VulnerabilityScanning::FindingBuilder /<br/>BuildFindingMapService"] D2 --> E["AdvisoryUtils#create_vulnerabilities<br/>→ VulnerabilityScanning::CreateVulnerabilityService"] E --> F["Security::Ingestion::IngestCvsSliceService<br/>(same Security::Ingestion::Tasks framework;<br/>adds IngestCvsSecurityScanners +<br/>MAIN_DB MarkCvsProjectsAsVulnerable)"] F --> G[("vulnerabilities<br/>vulnerability_occurrences<br/>vulnerability_reads<br/>(same tables as pipeline ingestion)")] E --> H["publish Sbom::VulnerabilitiesCreatedEvent"] H --> I["Sbom::CreateOccurrencesVulnerabilitiesService"] I --> J[("sbom_occurrences_vulnerabilities (join)")]

단계#

  1. 트리거: 전역, 새 권고마다. AdvisoriesSyncWorker cron(5분마다)이 권고 IngestionService에 데이터를 공급하고, 이 서비스는 최근 게시된 권고마다 PackageMetadata::IngestedAdvisoryEvent를 게시합니다. GlobalAdvisoryScanWorker가 AdvisoryScanService와 Gitlab::VulnerabilityScanning::AdvisoryScanner.scan_projects_for(advisory)를 호출하며, 이는 해당 권고 하나의 영향을 받는 인스턴스의 모든 프로젝트를 스캔합니다. 파이프라인 모델로는 할 수 없는 일입니다.
  2. 저장된 SBOM 데이터 읽기. Sbom::PossiblyAffectedOccurrencesFinder가 프로젝트 전반의 sbom_occurrences를 배치로 읽고, semver 방언을 인식하는 AffectedVersionRangeMatcher를 사용해 PMDB 권고(pm_advisories, pm_affected_packages)와 대조합니다.
  3. 결과 빌드. 일치 항목은 VulnerabilityScanning::FindingBuilder와 BuildFindingMapService를 통해 결과 맵이 되며, 분석기 보고서에서 구문 분석한 것이 아니라 저장된 데이터에서 합성됩니다.
  4. 공유 쓰기 경로. 스캔은 AdvisoryUtils#create_vulnerabilities, Security::VulnerabilityScanning::CreateVulnerabilityService, Security::Ingestion::IngestCvsSliceService로 합쳐집니다. 이는 파이프라인 수집과 같은 Security::Ingestion::Tasks 프레임워크를 재사용하므로 같은 vulnerabilities, vulnerability_occurrences, vulnerability_reads 테이블에 기록합니다. CVS는 IngestCvsSecurityScanners와 main DB 작업 MarkCvsProjectsAsVulnerable을 추가하고, CVS 취약점과 분석기 취약점을 구분하기 위해 합성 sbom_scanner ID를 사용합니다.
  5. SBOM으로 다시 연결. CreateVulnerabilityService가 Sbom::VulnerabilitiesCreatedEvent를 게시하고, 이 이벤트가 Sbom::CreateOccurrencesVulnerabilitiesService를 구동해 sbom_occurrences_vulnerabilities 조인을 채움으로써 새 취약점을 해당 occurrence에 다시 연결합니다.

프로젝트별 트리거(기본적으로 비활성화)#

두 번째 트리거는 SBOM 수집 후마다 실행되지만 기본 인스턴스에서는 사실상 비활성화되어 있으므로 다이어그램에 표시하지 않습니다. Sbom::SbomIngestedEvent는 Sbom::ProcessVulnerabilitiesWorker가 처리하며, 이 워커는 해당 파이프라인에 대해 Sbom::CreateVulnerabilitiesService를 실행합니다. CreateVulnerabilitiesService#scan_sbom_reports는 항상 dependency_scanning 소스를 건너뛰고(DS 결과는 이제 메인 파이프라인 수집을 통해 들어옴), cvs_for_container_scanning이 활성화되지 않은 한 다른 모든 소스도 건너뜁니다. 이 플래그는 기본적으로 비활성화된 베타 플래그이므로, 활성화하기 전까지 워커는 실행되지만 취약점을 생성하지 않습니다. 활성화하면 이 경로는 컨테이너 스캔 occurrence를 처리하고, 더 이상 존재하지 않는 CVS 취약점을 자동으로 해결하기 위해 Security::Ingestion::MarkAsResolvedService(스캐너 sbom_scanner)도 실행합니다. 기록할 때는 위 전역 스캔과 같은 공유 쓰기 경로를 사용합니다.

설정과 플래그#

프로젝트 보안 설정 continuous_vulnerability_scans_enabled, cvs_for_container_scanning_enabled, cvs_for_dependency_scanning_enabled(nil은 활성화된 것으로 취급)가 CVS를 제어하고, cvs_for_container_scanning 기능 플래그가 프로젝트별 컨테이너 경로를 제어합니다.

파이프라인 수집과의 차이점: CI 아티팩트가 아니라 이벤트와 cron으로 구동됩니다. 결과는 스캐너에서 구문 분석하는 것이 아니라 저장된 SBOM 데이터와 PMDB 권고에서 합성됩니다. 전역 플로는 모든 프로젝트에 걸칩니다. 쓰기 슬라이스는 IngestReportSliceService가 아니라 IngestCvsSliceService입니다. 겹치는 점: 같은 sbom_occurrences를 읽고, 같은 Security::Ingestion::Tasks를 재사용하며, 같은 vulnerability_* 테이블에 기록합니다.

관련 항목#

지속적 취약점 스캔

GitLab v19.6
원문 보기

요약

초점: 지속적 취약점 스캔(CVS)이 파이프라인에서 분석기를 실행하지 않고, 이미 저장된 SBOM 데이터를 Package Metadata DB(PMDB) 권고와 대조해 취약점을 합성하는 방식입니다. 모든 경로는 ee/ 아래에 있습니다.

초점: 지속적 취약점 스캔(CVS)이 파이프라인에서 분석기를 실행하지 않고, 이미 저장된 SBOM 데이터를 Package Metadata DB(PMDB) 권고와 대조해 취약점을 합성하는 방식입니다. 활성 플로는 새로 게시된 권고마다 트리거되는 전역 스캔이며, CycloneDX에서 보안 결과로 플로와 같은 vulnerability_* 테이블로 합쳐집니다. 두 번째인 프로젝트별 트리거도 있지만 기본적으로 비활성화되어 있으므로, 다이어그램이 아니라 텍스트로 설명합니다.

모든 경로는 ee/ 아래에 있습니다. Sbom::* 모델과 CVS가 기록하는 vulnerabilities 및 vulnerability_* 테이블(예: vulnerability_occurrences, vulnerability_reads)은 gitlab_sec 스키마를 사용하며 sec 데이터베이스에 있습니다. 권고용 PackageMetadata::* 모델(pm_advisories, pm_affected_packages)은 현재 gitlab_main의 별칭인 gitlab_pm 스키마를 사용하며 main 데이터베이스에서 실행됩니다. gitlab_pm과 gitlab_sec 테이블 간의 교차 데이터베이스 조인은 허용되지 않습니다.

Mermaid 다이어그램 (16줄)
소스 코드 보기
flowchart TD
  accTitle: Continuous Vulnerability Scanning global advisory scan
  accDescr: How a newly published advisory triggers a global scan that reads stored SBOM occurrences, matches them against PMDB advisories, and writes to the same vulnerability tables as pipeline ingestion.

A["PackageMetadata::AdvisoriesSyncWorker<br/>cron every 5 min"] --> B["Advisory IngestionService<br/>publish PackageMetadata::IngestedAdvisoryEvent"] B --> C["PackageMetadata::GlobalAdvisoryScanWorker<br/>→ AdvisoryScanService<br/>→ VulnerabilityScanning::AdvisoryScanner<br/>scan_projects_for(advisory) (ALL projects)"] C --> R["Sbom::PossiblyAffectedOccurrencesFinder<br/>read sbom_occurrences (all projects, batched)"] DB[("pm_advisories / pm_affected_packages")] -.-> R R --> M["AffectedVersionRangeMatcher<br/>(semver-dialect aware)"] M --> D2["build FindingMap<br/>VulnerabilityScanning::FindingBuilder /<br/>BuildFindingMapService"] D2 --> E["AdvisoryUtils#create_vulnerabilities<br/>→ VulnerabilityScanning::CreateVulnerabilityService"] E --> F["Security::Ingestion::IngestCvsSliceService<br/>(same Security::Ingestion::Tasks framework;<br/>adds IngestCvsSecurityScanners +<br/>MAIN_DB MarkCvsProjectsAsVulnerable)"] F --> G[("vulnerabilities<br/>vulnerability_occurrences<br/>vulnerability_reads<br/>(same tables as pipeline ingestion)")] E --> H["publish Sbom::VulnerabilitiesCreatedEvent"] H --> I["Sbom::CreateOccurrencesVulnerabilitiesService"] I --> J[("sbom_occurrences_vulnerabilities (join)")]

단계#

  1. 트리거: 전역, 새 권고마다. AdvisoriesSyncWorker cron(5분마다)이 권고 IngestionService에 데이터를 공급하고, 이 서비스는 최근 게시된 권고마다 PackageMetadata::IngestedAdvisoryEvent를 게시합니다. GlobalAdvisoryScanWorker가 AdvisoryScanService와 Gitlab::VulnerabilityScanning::AdvisoryScanner.scan_projects_for(advisory)를 호출하며, 이는 해당 권고 하나의 영향을 받는 인스턴스의 모든 프로젝트를 스캔합니다. 파이프라인 모델로는 할 수 없는 일입니다.
  2. 저장된 SBOM 데이터 읽기. Sbom::PossiblyAffectedOccurrencesFinder가 프로젝트 전반의 sbom_occurrences를 배치로 읽고, semver 방언을 인식하는 AffectedVersionRangeMatcher를 사용해 PMDB 권고(pm_advisories, pm_affected_packages)와 대조합니다.
  3. 결과 빌드. 일치 항목은 VulnerabilityScanning::FindingBuilder와 BuildFindingMapService를 통해 결과 맵이 되며, 분석기 보고서에서 구문 분석한 것이 아니라 저장된 데이터에서 합성됩니다.
  4. 공유 쓰기 경로. 스캔은 AdvisoryUtils#create_vulnerabilities, Security::VulnerabilityScanning::CreateVulnerabilityService, Security::Ingestion::IngestCvsSliceService로 합쳐집니다. 이는 파이프라인 수집과 같은 Security::Ingestion::Tasks 프레임워크를 재사용하므로 같은 vulnerabilities, vulnerability_occurrences, vulnerability_reads 테이블에 기록합니다. CVS는 IngestCvsSecurityScanners와 main DB 작업 MarkCvsProjectsAsVulnerable을 추가하고, CVS 취약점과 분석기 취약점을 구분하기 위해 합성 sbom_scanner ID를 사용합니다.
  5. SBOM으로 다시 연결. CreateVulnerabilityService가 Sbom::VulnerabilitiesCreatedEvent를 게시하고, 이 이벤트가 Sbom::CreateOccurrencesVulnerabilitiesService를 구동해 sbom_occurrences_vulnerabilities 조인을 채움으로써 새 취약점을 해당 occurrence에 다시 연결합니다.

프로젝트별 트리거(기본적으로 비활성화)#

두 번째 트리거는 SBOM 수집 후마다 실행되지만 기본 인스턴스에서는 사실상 비활성화되어 있으므로 다이어그램에 표시하지 않습니다. Sbom::SbomIngestedEvent는 Sbom::ProcessVulnerabilitiesWorker가 처리하며, 이 워커는 해당 파이프라인에 대해 Sbom::CreateVulnerabilitiesService를 실행합니다. CreateVulnerabilitiesService#scan_sbom_reports는 항상 dependency_scanning 소스를 건너뛰고(DS 결과는 이제 메인 파이프라인 수집을 통해 들어옴), cvs_for_container_scanning이 활성화되지 않은 한 다른 모든 소스도 건너뜁니다. 이 플래그는 기본적으로 비활성화된 베타 플래그이므로, 활성화하기 전까지 워커는 실행되지만 취약점을 생성하지 않습니다. 활성화하면 이 경로는 컨테이너 스캔 occurrence를 처리하고, 더 이상 존재하지 않는 CVS 취약점을 자동으로 해결하기 위해 Security::Ingestion::MarkAsResolvedService(스캐너 sbom_scanner)도 실행합니다. 기록할 때는 위 전역 스캔과 같은 공유 쓰기 경로를 사용합니다.

설정과 플래그#

프로젝트 보안 설정 continuous_vulnerability_scans_enabled, cvs_for_container_scanning_enabled, cvs_for_dependency_scanning_enabled(nil은 활성화된 것으로 취급)가 CVS를 제어하고, cvs_for_container_scanning 기능 플래그가 프로젝트별 컨테이너 경로를 제어합니다.

파이프라인 수집과의 차이점: CI 아티팩트가 아니라 이벤트와 cron으로 구동됩니다. 결과는 스캐너에서 구문 분석하는 것이 아니라 저장된 SBOM 데이터와 PMDB 권고에서 합성됩니다. 전역 플로는 모든 프로젝트에 걸칩니다. 쓰기 슬라이스는 IngestReportSliceService가 아니라 IngestCvsSliceService입니다. 겹치는 점: 같은 sbom_occurrences를 읽고, 같은 Security::Ingestion::Tasks를 재사용하며, 같은 vulnerability_* 테이블에 기록합니다.

관련 항목#