OSV(Open Source Vulnerabilities)
OSV는 취약점 권고를 위한 개방형 데이터 형식이자, GitHub, PyPI, RustSec, Go, 리눅스 배포판 등에서 오픈 소스 패키지 권고를 이 형식으로 수집하는 무료 데이터베이스 OSV.dev입니다.
최종 업데이트: 2026년 11월 13일
OSV는 Open Source Vulnerabilities의 약자입니다. 이 이름은 두 가지를 가리킵니다. 하나는 취약점을 영향을 받는 패키지와 버전으로 설명하는 개방형 JSON 형식인 OSV 스키마이고, 다른 하나는 여러 출처의 권고를 이 형식으로 수집하는 무료 데이터베이스이자 API인 OSV.dev입니다. CVE 레코드가 취약점에 이름을 붙인다면, OSV 레코드는 개발자가 실제로 묻는 질문, 즉 내가 쓰는 이 패키지 버전이 영향을 받는가에 답합니다.
OSV의 운영 주체
Google은 2021년 2월에 OSV를 출시했으며, 퍼징 서비스 OSS-Fuzz가 발견한 취약점부터 시작했습니다. 스키마는 현재 Open Source Security Foundation의 osv-schema 리포지토리에서 관리되며 OpenSSF 취약점 형식이라고 불립니다. 데이터베이스와 그 인프라는 google/osv.dev에서 오픈 소스로 공개되어 있습니다.
OSV.dev는 권고 대부분을 직접 작성하지 않습니다. GitHub Advisory Database, PyPI 및 Python Software Foundation 데이터베이스, Go Vulnerability Database, RustSec, OpenSSF Malicious Packages, Ubuntu, Red Hat, Chainguard, Android처럼 OSV 형식으로 게시하는 데이터베이스를 집계합니다. Debian, Alpine, 그리고 오픈 소스 소프트웨어에 관한 NVD CVE의 경우 OSV.dev 팀이 원본 데이터를 직접 변환합니다(데이터 출처).
OSV ID 접두사
모든 OSV 레코드에는 <DB>-<ENTRYID> 형식의 ID가 있으며, 접두사는 레코드를 게시한 데이터베이스를 나타냅니다. 스키마에 정의된 접두사 일부는 다음과 같습니다.
| 접두사 | 데이터베이스 | ID 예시 |
|---|---|---|
| GHSA | GitHub Advisory Database | GHSA-jfh8-c2jp-5v3q |
| PYSEC | PyPI Vulnerability Database | PYSEC-2021-123 |
| RUSTSEC | RustSec Advisory Database(crates.io) | RUSTSEC-2021-0001 |
| GO | Go Vulnerability Database | GO-2022-0236 |
| MAL | OpenSSF Malicious Packages | MAL-2025-1234 |
| CVE | OSV.dev가 변환한 NVD 레코드 | CVE-2021-44228 |
| OSV | OSV.dev가 할당, 현재는 OSS-Fuzz 전용 | OSV-2020-111 |
같은 취약점에 출처별로 여러 레코드가 있는 경우가 많습니다. aliases 필드가 이를 연결합니다. Log4Shell에 대한 GitHub 권고인 GHSA-jfh8-c2jp-5v3q는 CVE-2021-44228을 별칭으로 나열하므로, 도구는 이를 한 번만 셀 수 있습니다. MAL- 레코드는 성격이 다릅니다. 수정 버전이 없는 악성 패키지를 설명합니다.
OSV 레코드의 모습
레코드의 핵심은 affected 목록입니다. 패키지마다 생태계, 이름, 취약한 버전 범위를 담고, 범위가 어디서 introduced되고 어디서 fixed되었는지를 이벤트로 나타냅니다. 다음은 범위 하나로 줄인 GHSA-jfh8-c2jp-5v3q입니다.
{
"schema_version": "1.9.0",
"id": "GHSA-jfh8-c2jp-5v3q",
"aliases": ["CVE-2021-44228"],
"summary": "Remote code injection in Log4j",
"published": "2021-12-10T00:40:56Z",
"affected": [{
"package": {
"ecosystem": "Maven",
"name": "org.apache.logging.log4j:log4j-core",
"purl": "pkg:maven/org.apache.logging.log4j/log4j-core"
},
"ranges": [{
"type": "ECOSYSTEM",
"events": [{ "introduced": "2.13.0" }, { "fixed": "2.15.0" }]
}]
}]
}
범위의 유형은 SEMVER, ECOSYSTEM(PyPI나 Debian처럼 생태계 고유의 버전 순서), 또는 커밋 해시를 제공하는 GIT입니다. Git 범위를 이용하면 OSV.dev는 패키지 관리자가 전혀 없는 C 및 C++ 코드에서도 취약점을 커밋과 대응시킬 수 있습니다.
OSV vs NVD와 CVE
| 질문 | CVE 레코드 | NVD | OSV |
|---|---|---|---|
| 개요 | ID와 짧은 레코드 | CVE를 보강하는 NIST 데이터베이스 | 형식과 집계 데이터베이스 |
| 소프트웨어 식별 방식 | 공급업체와 제품 텍스트 | CPE 이름 | 생태계와 패키지 이름, 또는 Git 리포지토리 |
| 영향을 받는 버전 | CNA가 작성한 그대로 | CPE 버전 범위 | 각 생태계 고유 버전 체계의 기계 판독형 범위 |
| CVE 없는 권고 포함 여부 | 아니요 | 아니요 | 예. 많은 RUSTSEC, PYSEC, MAL 레코드 등 |
| 적합한 용도 | 취약점 하나의 명명 | 상용 및 비공개 소스 제품 | 오픈 소스 의존성 |
OSV는 생태계와 패키지를 키로 사용하므로, 패키지를 CPE에 대응시키는 추측 작업 없이 락파일이나 SBOM 구성 요소의 package URL과 바로 맞아떨어집니다. 반면 패키지 생태계가 없어 NVD에서 설명되는 비공개 소스 제품과 어플라이언스에는 약합니다.
OSV API와 osv-scanner
https://api.osv.dev의 API는 무료이며, 문서에는 사용량 제한이 명시되어 있지 않습니다. 패키지와 버전으로 조회하는 예:
curl -d '{"package": {"name": "nokogiri", "ecosystem": "RubyGems"}, "version": "1.18.2"}' \
"https://api.osv.dev/v1/query"
/v1/querybatch는 한 번의 요청으로 여러 패키지를 확인하고, /v1/vulns/{id}는 레코드 하나를 반환합니다. 전체 데이터베이스를 생태계별로 다운로드할 수도 있습니다.
2022년 12월에 발표된 OSV-Scanner는 이 데이터베이스를 위한 Google의 명령줄 프런트엔드입니다. 락파일, SBOM, 디렉터리, 컨테이너 이미지를 스캔하고 일치하는 OSV 레코드를 보고합니다.
CRACI와의 관계
CRACI는 각 빌드에 기록된 구성 요소에 대해, 각 패키지의 권고를 CVE, GHSA 및 기타 ID와 심각도와 함께 표시합니다. 어떤 데이터베이스든 SBOM과 대조하려면 SBOM에 무엇이 들어 있어야 하는지는 빌드 시점 SBOM을 참조하세요.