SBOM
CycloneDX란 무엇인가?
CycloneDX는 자재 명세서를 위한 개방형 표준으로, OWASP Foundation이 운영하고 Ecma International이 ECMA-424로 발행합니다. 가장 잘 알려진 용도는 SBOM 형식입니다. 소프트웨어를 구성하는 구성 요소, 구성 요소 간의 종속 관계, 그리고 그 취약점에 대해 알려진 정보를 기계가 읽을 수 있는 형태로 정리한 목록입니다. 현재 버전은 CycloneDX 1.7이며, 같은 형식으로 서비스, 하드웨어, 암호화, 머신러닝 모델도 기술할 수 있습니다.
업데이트
CycloneDX 한눈에 보기
| 관리 주체 | OWASP Foundation의 CycloneDX 프로젝트와 Ecma International 기술위원회 54(TC54) |
|---|---|
| 표준 | ECMA-424. 제1판(2024년 6월)은 CycloneDX 1.6, 제2판(2025년 12월)은 CycloneDX 1.7 |
| 현재 버전 | CycloneDX 1.7, 2025년 10월 출시 |
| 인코딩 | JSON, XML, Protocol Buffers |
| 미디어 타입 | application/vnd.cyclonedx+json, version=1.7 같은 버전 매개변수 포함 |
| 파일 이름 | bom.json, bom.xml, *.cdx.json, *.cdx.xml |
첫 버전인 CycloneDX 1.0은 2018년에 보안 중심의 자재 명세서로 나왔습니다. Ecma는 2023년 12월 공급망 표준을 위해 TC54를 설립했고, CycloneDX 1.6은 2024년 6월 ECMA-424가 되었습니다. 사양 개요와 ECMA-424 페이지가 1차 참고 자료입니다.
CycloneDX SBOM에 담기는 내용
CycloneDX 문서는 흔히 BOM이라고 부르는 하나의 객체입니다. 필수 필드는 bomFormat(항상
"CycloneDX")과 specVersion 두 개뿐입니다. 나머지는 모두 선택 사항이므로, 유효한 CycloneDX
파일 두 개가 실제로 알려 주는 내용은 크게 다를 수 있습니다.
| 요소 | 담는 내용 |
|---|---|
metadata |
BOM이 언제 어떻게 만들어졌는지: 타임스탬프, 도구, 작성자, 수명 주기 단계, BOM이 기술하는 구성 요소 |
components |
각 라이브러리, 프레임워크, 컨테이너, 파일, 펌웨어, 장치 또는 모델과 그 버전, 식별자, 해시, 라이선스 |
services |
API처럼 소프트웨어가 호출하는 외부 서비스와 그 엔드포인트 및 데이터 흐름 |
dependencies |
어떤 구성 요소나 서비스가 무엇에 종속되는지. 전이적 단계까지 포함해 트리를 다시 구성할 수 있습니다 |
compositions |
BOM의 각 부분이 얼마나 완전한지: complete, incomplete, unknown 또는 not specified |
vulnerabilities |
알려진 취약점과 그 등급, 그리고 VEX의 경우 제품에 영향을 미치는지 여부와 방식 |
formulation |
제품이 어떻게 빌드되었는지: 그 뒤에 있는 워크플로, 태스크, 환경 |
annotations |
BOM의 다른 부분에 붙인 주석과 메모, 그리고 작성자와 작성 시점 |
declarations, definitions, citations |
표준 준수에 대한 증명, 표준 자체, 그리고 BOM 안의 데이터 출처 |
metadata.lifecycles 필드는 BOM이 만들어진 시점을 나타냅니다: design, pre-build, build, post-build,
operations, discovery 또는 decommission. 같은 제품이라도 빌드 단계 SBOM과 빌드 후 스캔은 서로 다른 구성 요소를 나열할
수 있으므로, 두 파일을 비교할 때는 단계가 중요합니다.
CycloneDX BOM 유형
같은 객체 모델이 소프트웨어 이상을 다룹니다. CycloneDX 프로젝트는 다음 기능을 나열합니다.
| 유형 | 기술 대상 |
|---|---|
| SBOM | 소프트웨어 구성 요소와 그 종속성 |
| SaaSBOM | 호스팅되는 애플리케이션의 서비스, 엔드포인트, 데이터 흐름 |
| HBOM | 하드웨어 구성 요소 |
| CBOM | 암호화 자산: 알고리즘, 키, 인증서, 프로토콜 |
| ML-BOM | 머신러닝 모델과 그 바탕이 되는 데이터 세트 |
| OBOM 및 MBOM | 운영 환경, 그리고 제품의 제조 |
| VEX, VDR, BOV | 취약점이 제품에 영향을 미치는지 여부(VEX), 알려진 취약점에 대한 공급업체의 보고서(VDR), 그리고 취약점 명세서 |
| CDXA | 제품이 표준이나 요구 사항을 충족한다는 증명 |
이들은 별개의 형식이 아니라 하나의 형식을 다르게 쓰는 방식입니다. 예를 들어 VEX 문서는
vulnerabilities 항목이 분석 상태를 담고 SBOM의 구성 요소를 가리키는 CycloneDX BOM입니다.
식별자: purl, CPE, 해시
같은 이름이라도 생태계에 따라 다른 패키지를 뜻할 수 있으므로, 구성 요소의 이름만으로는 취약점과 매칭하기에
충분하지 않습니다. 그래서 CycloneDX 구성 요소는 식별자를 담습니다. pkg:npm/[email protected] 같은
패키지 URL(purl), CPE, SWID 태그, OmniBOR 및 SWHID 식별자, 암호화 해시가
그것입니다. 오픈 소스 패키지에 대해 대부분의 도구가 매칭에 사용하는 것은 purl이며, purl은 2025년 12월 자체 Ecma
표준인 ECMA-427이 되었습니다. 문서 안에서 각 요소는 bom-ref도 가질 수 있습니다. 이는 dependencies,
compositions, vulnerabilities 섹션이 해당 요소를 가리킬 때 사용하는 로컬 ID입니다.
CycloneDX JSON 예시
애플리케이션 acme-api의 작지만 완전한 SBOM입니다. 이 애플리케이션은 npm 패키지 하나(debug)를
사용하며, 이 패키지는 다시 ms에 종속됩니다. CycloneDX 1.7 JSON 스키마에 대해 유효성이 검증됩니다.
{
"bomFormat": "CycloneDX",
"specVersion": "1.7",
"serialNumber": "urn:uuid:3e671687-395b-41f5-a30f-a58921a69b79",
"version": 1,
"metadata": {
"timestamp": "2026-11-16T09:30:00Z",
"lifecycles": [{ "phase": "build" }],
"component": {
"type": "application",
"bom-ref": "acme-api",
"name": "acme-api",
"version": "1.4.0"
}
},
"components": [
{
"type": "library",
"bom-ref": "pkg:npm/[email protected]",
"name": "debug",
"version": "4.4.0",
"purl": "pkg:npm/[email protected]",
"licenses": [{ "license": { "id": "MIT" } }]
},
{
"type": "library",
"bom-ref": "pkg:npm/[email protected]",
"name": "ms",
"version": "2.1.3",
"purl": "pkg:npm/[email protected]",
"licenses": [{ "license": { "id": "MIT" } }]
}
],
"dependencies": [
{ "ref": "acme-api", "dependsOn": ["pkg:npm/[email protected]"] },
{ "ref": "pkg:npm/[email protected]", "dependsOn": ["pkg:npm/[email protected]"] },
{ "ref": "pkg:npm/[email protected]", "dependsOn": [] }
],
"compositions": [
{ "aggregate": "complete", "dependencies": ["acme-api"] }
]
}
-
serialNumber와version은 이 BOM을 식별합니다. 새로 생성되는 모든 BOM은 새 일련번호를 받으며, 기존 BOM을 수정하면 일련번호는 유지되고 버전이 1 올라갑니다. -
metadata.component는 SBOM이 기술하는 제품이자 종속성 트리의 루트입니다. -
dependencies는ms를 전이적 종속성으로 만듭니다. 애플리케이션이 요청한 것이 아니라debug가 요청한 것입니다. 비어 있는dependsOn은 해당 구성 요소에 종속성이 없다는 뜻입니다. 구성 요소를 그래프에서 빼 두면 종속성이 없다는 뜻이 아니라 종속성을 알 수 없다는 뜻이 됩니다. -
compositions는acme-api아래의 종속성 트리가 완전하다고 명시합니다. 모든 것을 볼 수 없었던 도구는 대신incomplete또는unknown이라고 표시해야, 읽는 사람이 누락된 패키지를 없는 것으로 취급하지 않습니다.
해시와 공급자 정보가 담긴 더 큰 파일과 같은 애플리케이션의 SPDX 버전은 SBOM 예시를 참조하세요.
CycloneDX SBOM을 생성하는 방법
생성 방법은 세 가지이며, 각각 다른 것을 기술합니다.
| 방법 | 작동 방식 | 놓치는 것 |
|---|---|---|
| 매니페스트 및 잠금 파일 스캔 | package-lock.json, requirements.txt, pom.xml 같은 파일을 읽습니다 |
설치 스크립트, 빌드 스크립트, 베이스 이미지처럼 패키지 관리자 밖에서 가져온 모든 것 |
| 이미지, 파일 시스템 또는 바이너리 분석 | 완성된 컨테이너 이미지, 디렉터리 또는 바이너리에서 패키지 메타데이터와 시그니처를 검사합니다 | 메타데이터를 남기지 않은 구성 요소, 그리고 추측해야 하는 컴파일된 코드 |
| 빌드 시점 기록 | 빌드가 실행되는 동안 실제로 가져온 것을 기록합니다 | 기록 도구가 볼 수 없는 것뿐이며, 좋은 도구는 이를 incomplete로 표시합니다 |
CycloneDX를 작성하는 무료 도구:
-
cdxgen: OWASP 프로젝트로, 여러 언어와 컨테이너 이미지를 지원합니다.
cdxgen -o bom.json. 기본적으로 CycloneDX 1.7을 작성합니다. -
CycloneDX 생태계 플러그인:
@cyclonedx/cyclonedx-npm, cyclonedx-python, CycloneDX Maven 플러그인, cyclonedx-gomod 등으로, 각각 하나의 패키지 관리자를 지원합니다.npx @cyclonedx/cyclonedx-npm --output-file bom.json. -
Syft: Anchore의 도구로, 컨테이너 이미지와 파일 시스템을 지원합니다.
syft <image> -o cyclonedx-json.
CycloneDX Tool Center에 더 많은 도구가 나열되어 있습니다. 이 방식들이 실제로 어떻게 다른지는 오픈 소스 SBOM 생성기와 Docker 이미지 SBOM을 참조하세요.
CycloneDX 파일의 유효성을 검사하는 방법
공식 CycloneDX CLI는 파일을 해당 버전의 스키마에 대해 검사합니다.
cyclonedx validate --input-file bom.json --input-version v1_7 --fail-on-errors
같은 도구는 cyclonedx convert로 JSON, XML, Protocol Buffers 간, 사양 버전 간, 그리고 SPDX JSON으로
변환합니다. 스키마 검증은 파일의 형식이 올바르다는 것만 증명합니다. 구성 요소가 누락되었는지는 알려 주지 못합니다.
이를 확인하려면 SBOM 품질 체크리스트 같은 목록과 내용을 대조하세요.
CycloneDX와 SPDX 비교
SPDX는 널리 쓰이는 또 하나의 SBOM 형식으로, Linux Foundation이 호스팅하며 ISO/IEC 5962:2021로 발행되었습니다. SPDX는 라이선스 컴플라이언스에서 출발했고 CycloneDX는 보안에서 출발했기 때문에, CycloneDX는 취약점과 VEX를 같은 형식에 담습니다. 둘 다 구성 요소, 식별자, 라이선스, 관계를 기술하고, 도구로 서로 변환할 수 있으며, EU Cyber Resilience Act는 어느 쪽도 지정하지 않습니다. 어느 쪽을 만들지는 대개 고객과 도구가 무엇을 읽는지에 따라 정해집니다. 자세한 비교는 CycloneDX와 SPDX 비교에 있습니다.
CRACI가 CycloneDX SBOM을 만드는 방법
CRACI는 각 작업이 실행되는 동안 가져오는 모든 패키지를 종속성 트리의 모든 깊이에서, CI 캐시에서 복원된 패키지까지 포함해 기록하는 GitHub Actions 러너입니다. 따라서 SBOM의 모든 구성 요소는 실제로 빌드에 들어간 것입니다. 각 패키지는 purl과 선언된 라이선스를 담고, 각 작업의 SBOM에는 작업이 볼 수 없었던 것을 알려 주는 완전성 상태가 표시됩니다. SBOM은 전이적 종속성과 구성 요소에서 발견된 취약점을 포함해 CycloneDX 또는 SPDX로 내보낼 수 있으며, API는 이를 CycloneDX 1.7 JSON으로 반환합니다. 빌드 시점 SBOM 생성 또는 SBOM 모범 사례를 참조하세요.
CRACI가 답이 아닌 경우
- 하드웨어, 암호화 또는 서비스 BOM. CRACI는 빌드가 가져오는 소프트웨어 패키지를 기록합니다. HBOM, CBOM, SaaSBOM에는 다른 출처가 필요합니다.
- GitHub Actions 밖의 빌드. 현재 지원되는 CI는 GitHub Actions뿐이며, 다른 CI 시스템은 로드맵에 있습니다. 그동안에는 cdxgen 같은 생성기를 사용하세요.
- 바이너리로 받는 소프트웨어. 직접 빌드하지 않았다면 그 빌드를 기록할 수 없습니다. 공급업체에 SBOM을 요청하거나 바이너리 분석을 사용하세요.
CycloneDX: 자주 묻는 질문
CycloneDX는 어디에 사용됩니까?
주로 SBOM에 사용됩니다. 소프트웨어를 구성하는 구성 요소를 나열해 취약점과 라이선스를 추적하고 그 목록을 고객과 공유할 수 있게 합니다. 같은 형식으로 VEX, 서비스, 하드웨어, 암호화, 머신러닝 모델도 다룹니다.
CycloneDX는 누가 관리합니까?
OWASP Foundation이 CycloneDX 프로젝트를 운영하고, Ecma International 기술위원회 54가 이를 ECMA-424 표준으로 발행합니다.
CycloneDX의 최신 버전은 무엇입니까?
2025년 10월에 출시된 CycloneDX 1.7입니다. 이는 2025년 12월에 발행된 ECMA-424 제2판이기도 합니다. 제1판은 CycloneDX 1.6에 해당합니다.
CycloneDX는 JSON입니까, XML입니까?
둘 다이며, Protocol Buffers도 지원합니다. 가장 흔한 것은 JSON으로, 미디어 타입은 application/vnd.cyclonedx+json이고 파일 이름은 bom.json 또는 name.cdx.json 같은 형태입니다.
CycloneDX가 SPDX보다 낫습니까?
일반적으로 어느 쪽이 더 낫다고 할 수는 없습니다. CycloneDX는 보안에서 출발해 취약점과 VEX를 기본으로 담고, SPDX는 라이선스 컴플라이언스에서 출발했으며 ISO 표준입니다. 고객과 도구가 읽는 형식을 만드세요. 양방향 변환 도구가 있습니다.
CycloneDX 파일이 유효한지 어떻게 확인합니까?
공식 CycloneDX CLI를 실행하세요: cyclonedx validate --input-file bom.json --fail-on-errors. 이 명령은 구조를 스키마에 대해 검사할 뿐, 구성 요소가 누락되었는지는 검사하지 않습니다.
빌드에서 직접 만드는 CycloneDX
GitHub Actions 작업이 가져오는 모든 패키지를 완전성 상태와 함께 기록하고, CycloneDX 또는 SPDX로 내보내세요.
데모 예약