OSV (Open Source Vulnerabilities)
O OSV é um formato de dados aberto para avisos de vulnerabilidades e uma base de dados gratuita, a OSV.dev, que reúne nesse formato avisos para pacotes open source do GitHub, PyPI, RustSec, Go, distribuições Linux e outros.
Última atualização: 13 de novembro de 2026
OSV significa Open Source Vulnerabilities. O nome abrange duas coisas: o esquema OSV, um formato JSON aberto para descrever uma vulnerabilidade em termos dos pacotes e versões que afeta, e a OSV.dev, uma base de dados e API gratuitas que reúnem avisos de muitas fontes nesse formato. Enquanto um registo CVE dá nome a uma vulnerabilidade, um registo OSV responde à pergunta que um programador realmente faz: a versão deste pacote que utilizo é afetada?
Quem gere o OSV
A Google lançou o OSV em fevereiro de 2021, começando pelas vulnerabilidades encontradas pelo seu serviço de fuzzing OSS-Fuzz. O esquema é agora mantido no repositório osv-schema da Open Source Security Foundation e chama-se OpenSSF vulnerability format; a base de dados e a sua infraestrutura são open source em google/osv.dev.
A OSV.dev não redige a maioria dos seus avisos. Agrega bases de dados que publicam no formato OSV, como a GitHub Advisory Database, as bases de dados do PyPI e da Python Software Foundation, a Go Vulnerability Database, a RustSec, a OpenSSF Malicious Packages, o Ubuntu, a Red Hat, a Chainguard e o Android. Para o Debian, o Alpine e as CVE da NVD sobre software open source, é a própria equipa da OSV.dev que converte os dados de origem (fontes de dados).
Prefixos de ID do OSV
Cada registo OSV tem um ID da forma <DB>-<ENTRYID>, em que o prefixo identifica a base de dados que o publicou. Alguns dos prefixos definidos no esquema:
| Prefixo | Base de dados | ID de exemplo |
|---|---|---|
| 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 | Registos da NVD convertidos pela OSV.dev | CVE-2021-44228 |
| OSV | Atribuído pela OSV.dev, atualmente apenas para o OSS-Fuzz | OSV-2020-111 |
A mesma vulnerabilidade tem muitas vezes vários registos, um por fonte. O campo aliases liga-os: GHSA-jfh8-c2jp-5v3q, o aviso do GitHub para o Log4Shell, indica CVE-2021-44228 como alias, para que as ferramentas a contem uma só vez. Os registos MAL- são de natureza diferente: descrevem pacotes maliciosos, que não têm versão corrigida.
Como é um registo OSV
O núcleo de um registo é a lista affected: para cada pacote, o seu ecossistema, o seu nome e os intervalos de versões vulneráveis, com eventos que indicam onde um intervalo foi introduced e onde foi fixed. Eis o GHSA-jfh8-c2jp-5v3q, reduzido a um dos seus intervalos:
{
"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" }]
}]
}]
}
Os intervalos podem ser SEMVER, ECOSYSTEM (a ordenação de versões própria do ecossistema, como no PyPI ou no Debian) ou GIT, que indica hashes de commits. Os intervalos Git permitem à OSV.dev associar uma vulnerabilidade a um commit em código C e C++ que não tem gestor de pacotes nenhum.
OSV vs NVD e CVE
| Pergunta | Registo CVE | NVD | OSV |
|---|---|---|---|
| O que é | ID e registo breve | Base de dados do NIST que enriquece CVE | Formato e base de dados agregada |
| Identifica o software por | Texto do fornecedor e produto | Nomes CPE | Ecossistema e nome do pacote, ou um repositório Git |
| Versões afetadas | Como a CNA as escreveu | Intervalos de versões CPE | Intervalos legíveis por máquina no esquema de versões de cada ecossistema |
| Abrange avisos sem CVE | Não | Não | Sim, como muitos registos RUSTSEC, PYSEC e MAL |
| Mais indicado para | Dar nome a uma vulnerabilidade | Produtos comerciais e de código fechado | Dependências open source |
Como o OSV é indexado por ecossistema e pacote, alinha-se diretamente com um lockfile ou com o package URL de um componente numa SBOM, sem as suposições de associar um pacote a um CPE. É mais fraco para produtos de código fechado e appliances, que não têm ecossistema de pacotes e são descritos na NVD.
A API do OSV e o osv-scanner
A API em https://api.osv.dev é gratuita, e a sua documentação não indica limites de utilização. Uma consulta por pacote e versão:
curl -d '{"package": {"name": "nokogiri", "ecosystem": "RubyGems"}, "version": "1.18.2"}' \
"https://api.osv.dev/v1/query"
/v1/querybatch verifica muitos pacotes num só pedido, e /v1/vulns/{id} devolve um registo. A base de dados completa também pode ser descarregada por ecossistema.
O OSV-Scanner, anunciado em dezembro de 2022, é a interface de linha de comandos da Google para a base de dados. Analisa lockfiles, SBOM, diretórios e imagens de contentores e reporta os registos OSV correspondentes.
Relação com o CRACI
O CRACI mostra os avisos de segurança de cada pacote, com os seus IDs CVE, GHSA e outros e a sua gravidade, para os componentes registados em cada build. Para saber o que uma SBOM tem de conter antes de qualquer base de dados a poder comparar, consulte SBOM de build.