OSV (Open Source Vulnerabilities)
OSV es un formato de datos abierto para avisos de vulnerabilidades y una base de datos gratuita, OSV.dev, que reúne en ese formato avisos de paquetes de código abierto de GitHub, PyPI, RustSec, Go, distribuciones Linux y otras fuentes.
Última actualización: 13 de noviembre de 2026
OSV significa Open Source Vulnerabilities. El nombre abarca dos cosas: el esquema OSV, un formato JSON abierto para describir una vulnerabilidad en función de los paquetes y versiones a los que afecta, y OSV.dev, una base de datos y una API gratuitas que reúnen en ese formato avisos de muchas fuentes. Mientras que un registro CVE da nombre a una vulnerabilidad, un registro OSV responde a la pregunta que de verdad se hace un desarrollador: ¿está afectada la versión de este paquete que utilizo?
Quién gestiona OSV
Google lanzó OSV en febrero de 2021, empezando por las vulnerabilidades encontradas por su servicio de fuzzing OSS-Fuzz. El esquema se mantiene ahora en el repositorio osv-schema de la Open Source Security Foundation y se denomina OpenSSF vulnerability format; la base de datos y su infraestructura son de código abierto en google/osv.dev.
OSV.dev no redacta la mayoría de sus avisos. Agrega bases de datos que publican en formato OSV, como la GitHub Advisory Database, las bases de datos de PyPI y de la Python Software Foundation, la Go Vulnerability Database, RustSec, OpenSSF Malicious Packages, Ubuntu, Red Hat, Chainguard y Android. Para Debian, Alpine y las CVE de la NVD sobre software de código abierto, el equipo de OSV.dev convierte él mismo los datos de origen (fuentes de datos).
Prefijos de ID de OSV
Cada registro OSV tiene un ID de la forma <DB>-<ENTRYID>, donde el prefijo indica la base de datos que lo publicó. Algunos de los prefijos definidos en el esquema:
| Prefijo | Base de datos | ID de ejemplo |
|---|---|---|
| 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 | Registros de la NVD convertidos por OSV.dev | CVE-2021-44228 |
| OSV | Asignados por OSV.dev, actualmente solo para OSS-Fuzz | OSV-2020-111 |
La misma vulnerabilidad suele tener varios registros, uno por fuente. El campo aliases los vincula: GHSA-jfh8-c2jp-5v3q, el aviso de GitHub sobre Log4Shell, indica CVE-2021-44228 como alias, de modo que las herramientas pueden contarla una sola vez. Los registros MAL- son de otra naturaleza: describen paquetes maliciosos, que no tienen versión corregida.
Cómo es un registro OSV
El núcleo de un registro es la lista affected: para cada paquete, su ecosistema, su nombre y los rangos de versiones vulnerables, con eventos que indican dónde se introdujo un rango (introduced) y dónde se corrigió (fixed). Este es GHSA-jfh8-c2jp-5v3q, reducido a uno de sus rangos:
{
"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" }]
}]
}]
}
Los rangos pueden ser SEMVER, ECOSYSTEM (el orden de versiones propio del ecosistema, como en PyPI o Debian) o GIT, que indica hashes de commit. Los rangos Git permiten a OSV.dev asociar una vulnerabilidad a un commit en código C y C++ que no tiene ningún gestor de paquetes.
OSV frente a NVD y CVE
| Pregunta | Registro CVE | NVD | OSV |
|---|---|---|---|
| Qué es | ID y registro breve | Base del NIST que enriquece las CVE | Formato más base de datos agregada |
| Identifica el software por | Texto de fabricante y producto | Nombres CPE | Ecosistema y nombre del paquete, o un repositorio Git |
| Versiones afectadas | Tal como las escribió la CNA | Rangos de versiones CPE | Rangos legibles por máquina en el esquema de versiones de cada ecosistema |
| Cubre avisos sin CVE | No | No | Sí, como muchos registros RUSTSEC, PYSEC y MAL |
| Más adecuado para | Dar nombre a una vulnerabilidad | Productos comerciales y de código cerrado | Dependencias de código abierto |
Como OSV se organiza por ecosistema y paquete, encaja directamente con un lockfile o con la package URL de un componente en una SBOM, sin las conjeturas de asociar un paquete a un CPE. Es más débil para productos de código cerrado y appliances, que no tienen ecosistema de paquetes y se describen en la NVD.
La API de OSV y osv-scanner
La API en https://api.osv.dev es gratuita, y su documentación no indica límites de uso. Una consulta por paquete y versión:
curl -d '{"package": {"name": "nokogiri", "ecosystem": "RubyGems"}, "version": "1.18.2"}' \
"https://api.osv.dev/v1/query"
/v1/querybatch comprueba muchos paquetes en una sola petición, y /v1/vulns/{id} devuelve un registro. La base de datos completa también puede descargarse por ecosistema.
OSV-Scanner, anunciado en diciembre de 2022, es la interfaz de línea de comandos de Google para la base de datos. Analiza lockfiles, SBOM, directorios e imágenes de contenedor e informa de los registros OSV que coinciden.
Relación con CRACI
CRACI muestra los avisos de cada paquete, con sus identificadores CVE, GHSA y otros, y su gravedad, para los componentes registrados en cada build. Para saber qué debe contener una SBOM antes de que cualquier base de datos pueda cotejarla, consulte SBOM en tiempo de build.