PSIRT
Aviso de seguridad: cómo redactarlo, con una plantilla y un ejemplo completo
Un aviso de seguridad es el documento con el que actúan sus clientes cuando una vulnerabilidad afecta a su producto. Uno bueno responde, sin necesidad de abrir un ticket de soporte, si están afectados, en qué medida y qué deben hacer. Esta guía cubre los campos, un ejemplo completo, los formatos legibles por máquina, GitHub Security Advisories y cuándo publicar.
Actualizado el
¿Qué es un aviso de seguridad?
Un aviso de seguridad es una comunicación del proveedor de un producto que describe una vulnerabilidad en él: qué productos y versiones están afectados, qué gravedad tiene, qué podría hacer un atacante y cómo pueden corregirla o mitigarla los usuarios. Se escribe para las personas que utilizan el producto y, cada vez más, también para sus herramientas.
Los avisos son la cara pública de la divulgación coordinada de vulnerabilidades: quien la descubre la notifica en privado, el proveedor la corrige y el aviso es la forma en que se entera todo lo demás. En la mayoría de las empresas de software y de dispositivos los redacta el PSIRT, como parte de un programa más amplio de seguridad de producto.
Aviso de seguridad frente a boletín de seguridad, registro CVE, VEX y notas de la versión
Estos documentos se solapan, y los equipos los confunden a menudo:
| Documento | Quién lo publica | Qué cubre | Lector principal |
|---|---|---|---|
| Aviso de seguridad | El proveedor del producto, o un coordinador | Una vulnerabilidad, o unas pocas relacionadas, en sus productos: versiones afectadas, gravedad, corrección | Los operadores y equipos de seguridad de los clientes |
| Boletín de seguridad | El proveedor, a menudo con un calendario fijo | Un resumen de muchas correcciones de una versión o un periodo. Los boletines de seguridad de Android, por ejemplo, se publican el primer lunes de cada mes. | Equipos que aplican parches por ciclos |
| Registro CVE | Una CVE Numbering Authority (CNA) | El identificador global y una descripción mínima de una vulnerabilidad: producto afectado, tipo de problema, descripción y al menos una referencia pública | Bases de datos de vulnerabilidades y escáneres |
| Declaración VEX | El proveedor | Un estado legible por máquina por producto y vulnerabilidad: afectado, no afectado, corregido, en investigación | Los escáneres de los clientes |
| Notas de la versión | El proveedor | Todo lo que ha cambiado en una versión, con las correcciones de seguridad entre otros cambios | Cualquiera que actualice |
El patrón habitual: un aviso por vulnerabilidad, con un identificador CVE que lo enlaza con el registro CVE, enlazado desde las notas de cada versión corregida y desde el boletín si publica uno. «Boletín de seguridad» y «aviso de seguridad» se usan a veces como sinónimos; lo importante es que cada vulnerabilidad tenga una página estable que los clientes puedan citar.
Qué debe incluir un aviso de seguridad
Los campos siguientes son lo que buscan los clientes, y se corresponden uno a uno con los formatos legibles por máquina que se tratan más adelante en esta guía. Las reglas para CNA del programa CVE fijan el mínimo del registro CVE: al menos un producto y una versión afectados, el tipo o la causa de la vulnerabilidad (preferiblemente como CWE), una descripción en prosa y una referencia pública. Un aviso útil va más allá.
| Campo | Qué dice | Error habitual |
|---|---|---|
| ID del aviso | Su propio identificador estable, como EXC-2026-007, además del identificador CVE |
Usar solo el identificador CVE, que quizá aún no tenga el día en que necesita publicar |
| Título | Producto, tipo de vulnerabilidad e impacto en una línea | «Actualización de seguridad para el producto X», que no dice nada |
| Productos y versiones afectados | Todos los productos y versiones afectados, como rangos por rama de versiones | «Versiones anteriores a 4.2.2», que incluye por error ramas que nunca tuvieron el fallo |
| No afectados | Productos y versiones que ha comprobado y no están afectados | Omitirlo, de modo que cada cliente con una versión anterior abre un ticket |
| Versiones corregidas | La primera versión corregida de cada rama con soporte | Citar solo la última versión |
| Gravedad | Una calificación y el vector CVSS completo, con la versión de CVSS | Una puntuación sin vector, que nadie puede comprobar ni ajustar a su entorno |
| Debilidad | El identificador y el nombre de la CWE | Omitirla; las bases de datos y las reglas de CVE la esperan |
| Descripción | Qué es el fallo y dónde está, con detalle suficiente para juzgar la exposición, sin un exploit funcional | Tan vaga que los clientes no pueden saber si su configuración está expuesta |
| Impacto | Qué obtiene un atacante, y qué necesita antes (acceso, rol, posición en la red) | Repetir con palabras las métricas CVSS en lugar de explicar las consecuencias |
| Soluciones alternativas y mitigaciones | Qué hacer si no puede actualizar hoy, y cómo comprobar si se ha explotado | «No hay soluciones alternativas» cuando un cambio de configuración bloquearía el ataque |
| Créditos | Quién lo encontró y lo notificó, con su consentimiento | Dar crédito a alguien que pidió permanecer en el anonimato |
| Cronología | Notificado, confirmado, corregido, publicado | Omitirla, con lo que los retrasos largos parecen ocultos |
| Referencias | Registro CVE, notas de la versión, commit de la corrección, versiones legibles por máquina | Enlaces a tickets internos que los clientes no pueden abrir |
| Historial de revisiones | Cada cambio tras la primera publicación, con fecha y versión | Modificar en silencio las versiones afectadas |
El campo más difícil son las versiones afectadas. El código vulnerable se introdujo en un momento y se corrigió en otro, y cada rama con soporte tiene su propia corrección. Si la vulnerabilidad llegó a través de un componente de terceros, la pregunta pasa a ser cuáles de sus versiones distribuyeron la versión vulnerable de ese componente, directamente o como dependencia transitiva. Consulte cómo evaluar una nueva CVE en todos sus builds.
Un ejemplo completo
Este es un aviso completo para un producto ficticio: Example Gateway, un gateway de API autoalojado de Example Corp, con dos ramas con soporte, 3.9 y 4.x. El endpoint vulnerable se añadió en la 3.9.0, así que la 3.8 y anteriores no están afectadas. Todos los nombres, identificadores y fechas son inventados; la puntuación CVSS 4.0 se calcula a partir del vector indicado.
Example Corp Security Advisory EXC-2026-007
Path traversal in Example Gateway export API allows reading server files
Advisory ID: EXC-2026-007
CVE ID: CVE-2026-XXXXX
Published: 2026-09-01
Last updated: 2026-09-15 (version 1.1)
Severity: High, CVSS 4.0 base score 7.1
CVSS vector: CVSS:4.0/AV:N/AC:L/AT:N/PR:L/UI:N/VC:H/VI:N/VA:N/SC:N/SI:N/SA:N
Weakness: CWE-22, Improper Limitation of a Pathname to a
Restricted Directory ('Path Traversal')
Affected products
Example Gateway 4.x 4.0.0 up to and including 4.2.1
Example Gateway 3.9 3.9.0 up to and including 3.9.6
Fixed versions
Example Gateway 4.2.2
Example Gateway 3.9.7
Not affected
Example Gateway 3.8 and earlier (the export API was added in 3.9.0)
Example Gateway Cloud (patched on 2026-08-28; no action needed)
Description
The export endpoint of the admin API (/api/v1/export) does not
normalize the file name parameter. A request containing "../"
sequences can read any file the gateway process can read.
Impact
An authenticated user with any role, including the read-only
"viewer" role, can read files on the gateway host. These include
gateway.yaml, which holds the database password and the signing key
for admin sessions. With that key an attacker can forge an admin
session. Unauthenticated users cannot exploit this vulnerability.
Workarounds
If you cannot upgrade right away:
1. Remove the viewer role from accounts that do not need it.
2. Block requests to /api/v1/export at your reverse proxy.
After upgrading, rotate the database password and the session
signing key if untrusted users held any admin API role.
Detection
Requests to /api/v1/export with "..", "%2e%2e" or "%2f" in the
file parameter appear in the gateway access log.
Credits
Example Corp thanks A. Researcher of Example Security Lab for
reporting this vulnerability through coordinated disclosure.
Timeline
2026-08-04 Reported to [email protected]
2026-08-05 Report acknowledged
2026-08-08 Vulnerability confirmed, CVE ID requested
2026-08-28 Example Gateway Cloud patched
2026-09-01 4.2.2 and 3.9.7 released, advisory published
2026-09-15 Advisory updated (version 1.1)
References
CVE record: https://www.cve.org/CVERecord?id=CVE-2026-XXXXX
Release notes 4.2.2: https://example.com/gateway/releases/4.2.2
Release notes 3.9.7: https://example.com/gateway/releases/3.9.7
CSAF version: https://example.com/security/csaf/2026/exc-2026-007.json
Revision history
1.0 2026-09-01 Initial publication
1.1 2026-09-15 Added 3.8 and earlier as not affected; added the
reverse proxy workaround
Tres cosas hacen que este aviso funcione:
- Rangos por rama. «4.0.0 a 4.2.1» y «3.9.0 a 3.9.6» son exactos. «Anteriores a 4.2.2» habría hecho creer a todos los clientes de la 3.8 que estaban afectados.
- El impacto indica la condición previa. Un cliente sin cuentas viewer sabe que su exposición real es baja; uno con cientos de contratistas en el rol viewer sabe que no lo es.
- La solución alternativa incluye el seguimiento. Actualizar cierra el agujero pero no deshace la filtración de un secreto, así que el aviso dice qué hay que rotar.
Una plantilla de aviso de seguridad que puede copiar
Sustituya las partes entre corchetes. Elimine una sección solo si de verdad no se aplica, e indíquelo en lugar de dejarla en blanco donde los clientes la esperan (por ejemplo, «No workarounds are available»).
[Company] Security Advisory [ADVISORY-ID]
[Vulnerability type] in [product] [component] allows [impact]
Advisory ID: [ADVISORY-ID]
CVE ID: [CVE-YYYY-NNNNN, or "requested"]
Published: [YYYY-MM-DD]
Last updated: [YYYY-MM-DD] (version [1.0])
Severity: [Critical/High/Medium/Low], CVSS [4.0] base score [N.N]
CVSS vector: [CVSS:4.0/AV:_/AC:_/AT:_/PR:_/UI:_/VC:_/VI:_/VA:_/SC:_/SI:_/SA:_]
Weakness: [CWE-NNN, CWE name]
Affected products
[Product] [branch] [first affected] up to and including [last affected]
[Product] [branch] [first affected] up to and including [last affected]
Fixed versions
[Product] [fixed version]
[Product] [fixed version]
Not affected
[Products and versions checked and not affected, and why]
Description
[What the flaw is and where it is. Enough detail to judge exposure;
no exploit code.]
Impact
[What an attacker can do, and what they need first: network access,
an account, a role, user interaction, a non-default setting.]
Workarounds
[Steps to reduce risk until users can upgrade, or "No workarounds
are available." Also anything to do after upgrading, such as
rotating secrets.]
Detection
[How users can tell whether they were attacked, if known.]
Credits
[Name and affiliation of the reporter, with their consent.]
Timeline
[YYYY-MM-DD] Reported
[YYYY-MM-DD] Confirmed
[YYYY-MM-DD] Fixed versions released, advisory published
References
CVE record: [URL]
Release notes: [URL]
Machine-readable: [CSAF, OSV or VEX URL]
Disclosure policy: [URL]
Revision history
1.0 [YYYY-MM-DD] Initial publication
Avisos legibles por personas frente a avisos legibles por máquina
Una página web basta para las personas. No basta para un cliente con miles de dispositivos o cientos de servicios, cuyas herramientas necesitan cotejar su aviso con lo que ejecutan. Tres familias de formatos lo hacen, y responden a necesidades distintas:
| Formato | Qué es | Úselo cuando |
|---|---|---|
| Página web (y PDF) | El aviso tal como lo leen las personas | Siempre. Todos los demás formatos enlazan a ella. |
| CSAF 2.0 | La norma de OASIS para avisos en JSON, con un árbol de productos, listas de estado de productos, remediaciones, un historial de revisiones y reglas de distribución | Vende productos como firmware, appliances o software empresarial a clientes que automatizan la recepción de avisos, a menudo compradores industriales y empresariales |
| OSV | El formato Open Source Vulnerability: entradas JSON para paquetes de un ecosistema concreto, con rangos de versiones. La GitHub Advisory Database publica sus avisos en este formato. | Distribuye paquetes de código abierto a través de npm, PyPI, Maven, módulos de Go y ecosistemas similares |
| VEX (CSAF VEX, CycloneDX VEX, OpenVEX) | Declaraciones de que un producto está o no afectado por una vulnerabilidad conocida, y por qué | Los clientes analizan su SBOM y preguntan por CVE en componentes que no afectan a su producto |
En CSAF 2.0, el ejemplo completo se convierte en un documento csaf_security_advisory: el ID del aviso va en
document/tracking/id, el historial de revisiones en document/tracking/revision_history, las
versiones afectadas y corregidas en las listas product_status de cada vulnerabilidad, la CWE en su objeto
cwe y las soluciones alternativas en remediations. Un detalle: las puntuaciones de CSAF 2.0 solo admiten CVSS
v2 y v3.x. La compatibilidad con CVSS v4.0 llega con CSAF 2.1, que sigue siendo un borrador, así que un aviso CSAF 2.0 lleva
un vector CVSS 3.1 o indica el vector 4.0 en una nota.
El mismo aviso como entrada OSV, para equipos que también distribuyen el gateway como paquete npm (extracto):
{
"id": "EXC-2026-007",
"aliases": ["CVE-2026-XXXXX"],
"summary": "Path traversal in export API allows reading server files",
"published": "2026-09-01T09:00:00Z",
"modified": "2026-09-15T09:00:00Z",
"severity": [
{
"type": "CVSS_V4",
"score": "CVSS:4.0/AV:N/AC:L/AT:N/PR:L/UI:N/VC:H/VI:N/VA:N/SC:N/SI:N/SA:N"
}
],
"affected": [
{
"package": { "ecosystem": "npm", "name": "@example/gateway" },
"ranges": [
{
"type": "SEMVER",
"events": [
{ "introduced": "3.9.0" },
{ "fixed": "3.9.7" },
{ "introduced": "4.0.0" },
{ "fixed": "4.2.2" }
]
}
]
}
],
"credits": [{ "name": "A. Researcher", "type": "FINDER" }]
}
Observe que el rango contiene dos pares introduced-fixed. El
esquema OSV considera afectada una versión si
cae en cualquier rango o aparece en la lista explícita versions, y recomienda fixed en lugar de
last_affected porque un límite last-affected puede provocar coincidencias no detectadas.
Regla de decisión: publique siempre la página web y una CVE. Añada OSV, normalmente publicando a través de GitHub, si distribuye paquetes de código abierto. Añada CSAF si vende productos a organizaciones que piden avisos legibles por máquina o que trabajan bajo el Cyber Resilience Act de la UE, cuyo artículo 14, apartado 8, pide un formato estructurado y legible por máquina, cuando proceda, al informar a los usuarios sobre vulnerabilidades explotadas activamente. Añada VEX cuando los clientes empiecen a enviarle resultados de escáneres sobre sus componentes. Genere todos los formatos a partir de un único registro para que nunca se contradigan.
GitHub Security Advisories
Si su proyecto es un repositorio público en GitHub, los repository security advisories de GitHub le ofrecen todo el flujo en un solo lugar: un borrador privado para hablar de la vulnerabilidad, un fork privado temporal para corregirla, una solicitud de CVE y la publicación. Cuatro piezas encajan entre sí:
- Repository security advisories: borradores y avisos publicados que pertenecen a su repositorio.
- Private vulnerability reporting: un botón «Report a vulnerability» en la página Advisories del repositorio, para que los investigadores puedan notificarle en privado en lugar de abrir una issue pública.
- Identificadores CVE de GitHub: GitHub es una CNA y puede asignar un identificador CVE a su aviso, salvo que su proyecto esté cubierto por otra CNA.
- La GitHub Advisory Database: para los ecosistemas compatibles, GitHub publica allí su aviso, en formato OSV, y puede usarlo para enviar alertas de Dependabot a los repositorios que dependen de su paquete.
Active private vulnerability reporting
Los propietarios y administradores de un repositorio público pueden activarlo:
- En la página principal del repositorio, haga clic en Settings.
- En la sección Security and quality de la barra lateral, haga clic en Advanced Security.
- Haga clic en Enable junto a Private vulnerability reporting.
Después, enlácelo desde su SECURITY.md y desde su política de divulgación.
Cree un borrador de aviso
- En la página principal del repositorio, abra la pestaña Security and quality.
- En la barra lateral, en Reporting, haga clic en Advisories y después en New draft security advisory.
- Introduzca un título. En CVE identifier, introduzca un identificador CVE existente o elija solicitar uno a GitHub más adelante.
- Redacte la descripción: la vulnerabilidad, su impacto, los parches, las soluciones alternativas y las referencias.
- En Affected products, indique el ecosistema, el nombre del paquete, las versiones afectadas y las versiones corregidas. Añada un producto por cada paquete.
- Indique la gravedad, o seleccione Assess severity using CVSS y rellene la calculadora.
- Añada la CWE en Weaknesses y a quien lo notificó en Credits.
- Haga clic en Create draft security advisory.
El borrador sigue siendo privado. Desde él puede añadir colaboradores, crear un fork privado temporal para preparar la corrección y comentar los detalles con quien lo notificó.
Solicite una CVE y publique
- Abra el borrador desde Security and quality y después Advisories.
- Al final del formulario, haga clic en Request CVE. Solicitar una CVE no hace público el aviso, y GitHub indica que suele revisar las solicitudes en un plazo de 72 horas, así que solicítela pronto.
- Publique las versiones corregidas y asegúrese de que el aviso las indica como versiones corregidas.
- Haga clic en Publish advisory. El fork privado temporal se elimina, GitHub publica los detalles de la CVE y, para los ecosistemas compatibles, el aviso llega a la GitHub Advisory Database. Las alertas de Dependabot pueden tardar hasta 72 horas.
Si publica sin una versión corregida, GitHub advierte de que Dependabot alertará a los usuarios sin sugerir una versión segura. La base de datos de avisos de GitHub admite tanto CVSS 3.1 como 4.0. Los pasos siguen GitHub Docs a fecha de noviembre de 2026; las etiquetas de la interfaz de GitHub cambian de vez en cuando.
Los avisos de GitHub encajan con los paquetes de código abierto de los ecosistemas que admite GitHub. Para firmware, appliances o productos de código cerrado, publique en su propio sitio, en CSAF donde los clientes lo esperen, y obtenga la CVE de su propia CNA o de una cuyo ámbito le cubra.
Cuándo publicar: calendario y embargo
El embargo, el periodo entre el informe privado y la publicación, y cuánto debe durar corresponden a su política de divulgación. La tarea del aviso es llegar en el momento adecuado dentro de él. Un día de publicación típico es así:
- Antes del día: las correcciones están listas en todas las ramas con soporte, el identificador CVE está reservado, y el aviso y todas sus versiones legibles por máquina están redactados y revisados.
- Aviso previo, si lo da: los grandes clientes, los proveedores posteriores que integran su producto y los coordinadores reciben el aviso bajo embargo unos días antes, para estar preparados para responder a sus propios clientes.
- Lanzamiento: salen las versiones corregidas.
- Publicación: la página del aviso, el registro CVE, los documentos CSAF u OSV y la entrada del feed se publican a la vez, idealmente en la misma hora que el lanzamiento.
- Notificación: lista de correo y avisos directos a los clientes afectados.
El orden importa. Publicar primero la corrección sin el aviso permite a los atacantes comparar las versiones mientras los defensores no saben que deben actualizar. Publicar el aviso sin corrección solo es correcto cuando la vulnerabilidad ya es pública o se está explotando: en ese caso, publique lo que sabe con mitigaciones y actualícelo cuando salga la corrección.
Con el Cyber Resilience Act, una vulnerabilidad explotada activamente también activa una obligación aparte de notificar a las autoridades: una alerta temprana en un plazo de 24 horas a través de la Single Reporting Platform, y después una notificación y un informe final. Eso no es su aviso, y no es público. El anexo I del CRA también pide a los fabricantes que divulguen públicamente información sobre las vulnerabilidades corregidas una vez que haya una actualización de seguridad disponible, que es lo que hace un aviso. Consulte qué exige el CRA.
Publicación: dónde viven los avisos
-
Una página estable por aviso, en una URL que nunca cambie, como
/security/advisories/exc-2026-007, además de una página índice que enumere todos los avisos con sus productos, su gravedad y sus fechas. - Un feed. Un feed RSS o Atom del índice permite suscribirse sin una lista de correo.
-
Metadatos de proveedor CSAF, si publica CSAF: un archivo
provider-metadata.jsony un directorio o feed ROLIE con los documentos, para que las herramientas encuentren todos los avisos sin hacer scraping. Consulte CSAF para conocer los roles y requisitos. -
Una referencia en security.txt. El campo
Policyenlaza su política de divulgación, y la norma CSAF define un campoCSAFque indica a las herramientas dónde están sus metadatos de proveedor:
Contact: mailto:[email protected]
Expires: 2027-09-30T23:00:00.000Z
Policy: https://example.com/security/disclosure-policy
CSAF: https://example.com/.well-known/csaf/provider-metadata.json
No elimine nunca un aviso publicado. Si resulta ser erróneo, publique una revisión que diga qué ha cambiado; si la vulnerabilidad no era real, marque el aviso como retirado y explique por qué.
Notificar a los clientes
Publicar no es lo mismo que ser leído. Los clientes que no están suscritos a su feed no verán el aviso hasta que su escáner marque la CVE, o hasta que alguien les pregunte por ella. Para los avisos de gravedad alta y crítica:
- Envíe un correo a los clientes que usan versiones afectadas, no a toda su lista, con el enlace al aviso y la única acción que deben realizar.
- Informe a sus equipos de soporte y ventas antes de la publicación, con el aviso y unas breves preguntas frecuentes, para que sus respuestas coincidan con él.
- Avise a los proveedores posteriores que integran su producto, para que sus propios avisos puedan seguir rápidamente.
- Haga seguimiento de los clientes que se quedan en versiones afectadas.
Escribir solo a los clientes afectados exige saber qué versiones del producto utiliza cada uno. Para una vulnerabilidad en un componente de terceros que afectó a muchos proveedores a la vez, consulte cómo responder a los clientes tras un ataque a la cadena de suministro, que incluye plantillas.
¿Debería convertirse en CNA?
Una CVE Numbering Authority (CNA) asigna identificadores CVE y publica registros CVE de vulnerabilidades dentro de un ámbito acordado, normalmente sus propios productos. Convertirse en una le permite controlar cuándo aparece el registro CVE, asignar identificadores sin compartir detalles bajo embargo con otra CNA y redactar el registro usted mismo.
Según el programa CVE, no hay cuota ni contrato. Una CNA debe tener una política pública de divulgación de vulnerabilidades, una fuente pública de nuevas divulgaciones de vulnerabilidades (su página de avisos) y aceptar las condiciones de uso del programa. La incorporación pasa por un formulario de registro, una sesión introductoria y ejemplos de práctica. En la UE, ENISA actúa como Root para las organizaciones de su ámbito, incluidos fabricantes de tecnología y proyectos de código abierto.
- Encaja con un fabricante que publica CVE con regularidad para sus propios productos, ya tiene un PSIRT y una página de avisos, y quiere controlar el calendario.
- No tiene por qué ser su primer paso si publica un puñado de CVE al año, o si sus productos son paquetes de código abierto en GitHub, donde GitHub puede asignar los identificadores como parte del aviso.
Para obtener identificadores CVE sin ser CNA, consulte divulgación coordinada de vulnerabilidades.
Dónde encaja CRACI: las versiones afectadas
La mayor parte de un aviso es redacción. El campo que necesita evidencias son las versiones afectadas y, en las vulnerabilidades de componentes de terceros, también es el más difícil de acertar: cuáles de sus versiones distribuyeron la versión vulnerable, incluso como dependencia transitiva, y desde cuándo.
CRACI ejecuta sus builds de GitHub Actions en sus propios runners y registra los paquetes que cada job descargó realmente, incluidas las dependencias transitivas y los paquetes restaurados desde cachés de CI. Cada paquete muestra sus avisos (CVE, GHSA y otros identificadores) con su gravedad. El historial de builds muestra cada build anterior y su SBOM, y qué builds contenían una dependencia vulnerable, para que sepa durante qué periodo estuvo afectado, dentro de su periodo de retención (180 días por defecto, personalizado en Enterprise). Los equipos de seguridad hacen el triaje de los hallazgos y los envían a los equipos responsables de la corrección, y CRACI notifica a las personas pertinentes una vulnerabilidad y su gravedad. Consulte seguimiento de vulnerabilidades.
Cuando una vulnerabilidad explotada activamente activa la obligación de notificación del CRA, CRACI prepara el contenido de las notificaciones (alerta temprana, notificación e informe final); una persona de su empresa las presenta a través de la Single Reporting Platform.
Cuándo CRACI no es la respuesta
- Redactar y publicar el aviso. CRACI no redacta ni publica avisos de seguridad, ni en CSAF ni en ningún otro formato. Para eso, use su propio sitio, GitHub Security Advisories o una herramienta CSAF.
- Recibir informes. CRACI no recibe informes de vulnerabilidades de investigadores ni de clientes, ni los gestiona como casos. Use su buzón de divulgación, el private vulnerability reporting de GitHub o un gestor de casos.
- Vulnerabilidades en su propio código. CRACI coteja los avisos con los paquetes que descargaron sus builds. Un fallo como el path traversal del ejemplo, en su propio código, necesita una revisión de código para saber cuándo se introdujo.
- Builds fuera de GitHub Actions. CRACI es compatible con GitHub Actions hoy; GitLab CI y Jenkins están en la hoja de ruta.
- Versiones más antiguas que su periodo de retención. El historial de builds cubre los builds que CRACI ha registrado y conservado.
Avisos de seguridad: preguntas frecuentes
¿Qué es un aviso de seguridad?
Un aviso de seguridad es una comunicación del proveedor de un producto que describe una vulnerabilidad en el producto: qué productos y versiones están afectados, qué gravedad tiene, qué podría hacer un atacante y cómo corregirla o mitigarla. Suele llevar un identificador CVE y se publica cuando hay una corrección disponible.
¿Cuál es la diferencia entre un aviso de seguridad y un boletín de seguridad?
Un aviso suele tratar en detalle una vulnerabilidad, o unas pocas relacionadas. Un boletín agrupa muchas correcciones de una versión o un periodo, a menudo con un calendario fijo; Android, por ejemplo, publica sus boletines de seguridad cada mes. Algunos fabricantes usan las dos palabras indistintamente.
¿Qué debe incluir un aviso de seguridad?
Un ID de aviso y un identificador CVE, un título, los productos y versiones afectados como rangos por rama, los productos comprobados y no afectados, las versiones corregidas, la gravedad con el vector CVSS completo, la CWE, una descripción, el impacto y sus condiciones previas, las soluciones alternativas, los créditos, una cronología, las referencias y un historial de revisiones.
¿Cómo creo un aviso de seguridad en GitHub?
En un repositorio público, abra la pestaña Security and quality, haga clic en Advisories en Reporting y después en New draft security advisory. Rellene el título, la descripción, los productos afectados, la gravedad, la CWE y los créditos, y guarde el borrador. Cuando se publique la corrección, solicite una CVE si la necesita y haga clic en Publish advisory.
¿Puede GitHub asignar un identificador CVE a mi aviso?
Sí, si su proyecto no está cubierto por otra CNA. GitHub es una CVE Numbering Authority. Solicite la CVE desde el borrador del aviso; la solicitud no hace público el aviso, y GitHub indica que suele revisar las solicitudes en un plazo de 72 horas. GitHub publica los detalles de la CVE cuando el aviso se hace público.
¿Deben ser legibles por máquina los avisos de seguridad?
Cada vez más, sí. Publique una página web para las personas y añada una versión legible por máquina para los clientes que automatizan: CSAF para productos vendidos a empresas y a la industria, OSV para paquetes de código abierto y VEX para indicar qué vulnerabilidades conocidas no afectan a su producto. Genérelos a partir del mismo registro.
¿Cuándo debe publicarse un aviso de seguridad?
Al mismo tiempo que las versiones corregidas, después de cualquier aviso previo bajo embargo a los clientes clave y a los proveedores posteriores. Publique antes, con mitigaciones, solo si la vulnerabilidad ya es pública o se está explotando, y actualice el aviso cuando salga la corrección.
¿Necesito ser CNA para publicar un aviso de seguridad?
No. Cualquiera puede publicar un aviso. Ser CVE Numbering Authority solo significa que puede asignar usted mismo identificadores CVE. Sin serlo, puede asignar el identificador una CNA cuyo ámbito cubra su producto, GitHub para los proyectos de código abierto en GitHub, o una CNA of Last Resort.
Sepa qué versiones indicar como afectadas
Un aviso es tan preciso como sus versiones afectadas. Reserve una demo para ver cuáles de sus builds de GitHub Actions contenían un paquete vulnerable.
Reservar una demo