PSIRT
Security advisory: come scriverne uno, con un modello e un esempio concreto
Un security advisory è il documento su cui i Suoi clienti agiscono quando una vulnerabilità colpisce il Suo prodotto. Un buon advisory risponde, senza bisogno di un ticket di supporto, se sono colpiti, quanto gravemente e che cosa fare. Questa guida tratta i campi, un esempio completo, i formati leggibili dalle macchine, le GitHub Security Advisories e quando pubblicare.
Aggiornato il
Che cos'è un security advisory?
Un security advisory è un avviso del fornitore di un prodotto che descrive una vulnerabilità al suo interno: quali prodotti e versioni sono colpiti, quanto è grave, che cosa potrebbe fare un attaccante e come gli utenti possono correggerla o mitigarla. È scritto per le persone che utilizzano il prodotto e, sempre più spesso, anche per i loro strumenti.
Gli advisory sono il punto d'arrivo pubblico della divulgazione coordinata delle vulnerabilità: chi trova la vulnerabilità la segnala in privato, il fornitore la corregge e l'advisory è il modo in cui tutti gli altri ne vengono a conoscenza. Nella maggior parte delle aziende di software e dispositivi li scrive il PSIRT, nell'ambito di un più ampio programma di sicurezza di prodotto.
Security advisory, security bulletin, record CVE, VEX e release notes a confronto
Questi documenti si sovrappongono e i team li confondono spesso:
| Documento | Chi lo pubblica | Che cosa copre | Lettore principale |
|---|---|---|---|
| Security advisory | Il fornitore del prodotto, oppure un coordinatore | Una vulnerabilità, o poche vulnerabilità correlate, nei Suoi prodotti: versioni colpite, gravità, correzione | Gli operatori e i team di sicurezza dei clienti |
| Security bulletin | Il fornitore, spesso con una cadenza fissa | Un riepilogo di molte correzioni in una release o in un periodo. I security bulletin di Android, per esempio, escono il primo lunedì di ogni mese. | I team che applicano le patch a cicli |
| Record CVE | Una CVE Numbering Authority (CNA) | L'identificatore globale e una descrizione minima di una vulnerabilità: prodotto colpito, tipo di problema, descrizione e almeno un riferimento pubblico | Database di vulnerabilità e scanner |
| Dichiarazione VEX | Il fornitore | Uno stato leggibile dalle macchine per prodotto e vulnerabilità: colpito, non colpito, corretto, in fase di analisi | Gli scanner dei clienti |
| Release notes | Il fornitore | Tutto ciò che è cambiato in una release, correzioni di sicurezza comprese tra le altre modifiche | Chiunque esegua un aggiornamento |
Lo schema abituale: un advisory per vulnerabilità, con un ID CVE che lo collega al record CVE, richiamato dalle release notes di ogni versione corretta e dal bulletin, se ne pubblica uno. "Security bulletin" e "security advisory" sono talvolta usati come sinonimi; ciò che conta è che ogni vulnerabilità abbia una pagina stabile che i clienti possano citare.
Che cosa deve includere un security advisory
I campi seguenti sono quelli che i clienti cercano, e corrispondono uno a uno ai formati leggibili dalle macchine descritti più avanti in questa guida. Le regole CNA del CVE Program fissano il minimo per il record CVE: almeno un prodotto e una versione colpiti, il tipo o la causa della vulnerabilità (preferibilmente come CWE), una descrizione testuale e un riferimento pubblico. Un advisory utile va oltre.
| Campo | Che cosa dice | Errore comune |
|---|---|---|
| ID dell'advisory | Il Suo identificatore stabile, come EXC-2026-007, più l'ID CVE |
Usare solo l'ID CVE, che potrebbe non essere ancora disponibile il giorno in cui deve pubblicare |
| Titolo | Prodotto, tipo di vulnerabilità e impatto in una riga | "Aggiornamento di sicurezza per il Prodotto X", che non dice nulla |
| Prodotti e versioni colpiti | Ogni prodotto e versione colpiti, come intervalli per ramo di release | "Versioni precedenti alla 4.2.2", che include erroneamente rami che non hanno mai avuto il bug |
| Non colpiti | Prodotti e versioni che ha verificato e trovato non colpiti | Ometterlo, così ogni cliente con una versione precedente apre un ticket |
| Versioni corrette | La prima versione corretta su ogni ramo supportato | Indicare solo l'ultima release |
| Gravità | Una valutazione e il vettore CVSS completo, con la versione di CVSS | Un punteggio senza vettore, che nessuno può verificare o adattare al proprio ambiente |
| Debolezza | L'ID e il nome della CWE | Ometterla; i database e le regole CVE se la aspettano |
| Descrizione | Che cos'è il difetto e dove si trova, con dettagli sufficienti a valutare l'esposizione, senza un exploit funzionante | Così vaga che i clienti non riescono a capire se la loro configurazione è esposta |
| Impatto | Che cosa ottiene un attaccante e che cosa gli serve prima (accesso, ruolo, posizione nella rete) | Ripetere a parole le metriche CVSS invece di spiegare le conseguenze |
| Workaround e mitigazioni | Che cosa fare se non si può aggiornare oggi, e come verificare se si è stati sfruttati | "Nessun workaround" quando una modifica di configurazione bloccherebbe l'attacco |
| Riconoscimenti | Chi l'ha trovata e segnalata, con il suo consenso | Citare qualcuno che ha chiesto di restare anonimo |
| Cronologia | Segnalazione, conferma, correzione, pubblicazione | Ometterla, il che fa sembrare nascosti i lunghi ritardi |
| Riferimenti | Record CVE, release notes, commit della correzione, versioni leggibili dalle macchine | Link a ticket interni che i clienti non possono aprire |
| Cronologia delle revisioni | Ogni modifica dopo la prima pubblicazione, con data e versione | Modificare in silenzio le versioni colpite |
Il campo più difficile sono le versioni colpite. Il codice vulnerabile è stato introdotto in un certo momento e corretto in un altro, e ogni ramo supportato ha la propria correzione. Se la vulnerabilità è arrivata tramite un componente di terze parti, la domanda diventa quali delle Sue release hanno distribuito la versione vulnerabile di quel componente, direttamente o come dipendenza transitiva. Si veda come valutare una nuova CVE su tutte le Sue build.
Un esempio concreto
Ecco un advisory completo per un prodotto fittizio: Example Gateway, un API gateway self-hosted di Example Corp, con due rami supportati, 3.9 e 4.x. L'endpoint vulnerabile è stato aggiunto nella 3.9.0, quindi la 3.8 e le precedenti non sono colpite. Tutti i nomi, gli ID e le date sono inventati; il punteggio CVSS 4.0 è calcolato dal vettore mostrato.
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
Tre elementi fanno funzionare questo advisory:
- Intervalli per ramo. "Da 4.0.0 a 4.2.1" e "da 3.9.0 a 3.9.6" sono esatti. "Prima della 4.2.2" avrebbe detto a ogni cliente della 3.8 di essere colpito.
- L'impatto indica la precondizione. Un cliente senza account viewer sa che la sua esposizione reale è bassa; uno con centinaia di collaboratori esterni con il ruolo viewer sa che non lo è.
- Il workaround include il seguito. L'aggiornamento chiude la falla ma non annulla un segreto trapelato, quindi l'advisory dice che cosa ruotare.
Un modello di security advisory da copiare
Sostituisca le parti tra parentesi quadre. Elimini una sezione solo se davvero non si applica, e lo dichiari invece di lasciarla vuota dove i clienti se la aspettano (per esempio "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
Advisory leggibili dalle persone e dalle macchine
Una pagina web basta alle persone. Non basta a un cliente con migliaia di dispositivi o centinaia di servizi, i cui strumenti devono confrontare il Suo advisory con ciò che hanno in esecuzione. Tre famiglie di formati se ne occupano, e rispondono a esigenze diverse:
| Formato | Che cos'è | Quando usarlo |
|---|---|---|
| Pagina web (e PDF) | L'advisory come lo leggono le persone | Sempre. Ogni altro formato rimanda a essa. |
| CSAF 2.0 | Lo standard OASIS per gli advisory in JSON, con un albero dei prodotti, elenchi di stato dei prodotti, rimedi, una cronologia delle revisioni e regole per la distribuzione | Vende prodotti come firmware, appliance o software enterprise a clienti che automatizzano la ricezione degli advisory, spesso acquirenti industriali ed enterprise |
| OSV | L'Open Source Vulnerability format: voci JSON per pacchetti in un ecosistema definito, con intervalli di versioni. Il GitHub Advisory Database pubblica i suoi advisory in questo formato. | Distribuisce pacchetti open source tramite npm, PyPI, Maven, moduli Go ed ecosistemi simili |
| VEX (CSAF VEX, CycloneDX VEX, OpenVEX) | Dichiarazioni che un prodotto è o non è colpito da una vulnerabilità nota, e perché | I clienti scansionano la Sua SBOM e chiedono di CVE in componenti che non colpiscono il Suo prodotto |
L'esempio in CSAF 2.0 diventa un documento csaf_security_advisory: l'ID dell'advisory va in
document/tracking/id, la cronologia delle revisioni in document/tracking/revision_history, le
versioni colpite e corrette negli elenchi product_status di ciascuna vulnerabilità, la CWE nel suo oggetto
cwe e i workaround in remediations. Un'avvertenza: i punteggi di CSAF 2.0 accettano solo CVSS
v2 e v3.x. Il supporto a CVSS v4.0 arriva con CSAF 2.1, che è ancora una bozza, quindi un advisory CSAF 2.0 riporta
un vettore CVSS 3.1 oppure indica il vettore 4.0 in una nota.
Lo stesso advisory come voce OSV, per i team che distribuiscono il gateway anche come pacchetto npm (estratto):
{
"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" }]
}
Si noti come l'intervallo contenga due coppie introduced-fixed. Lo
schema OSV considera colpita una versione se
rientra in uno qualsiasi degli intervalli o compare nell'elenco esplicito versions, e raccomanda fixed rispetto a
last_affected, perché un limite last-affected può causare corrispondenze mancate.
Regola decisionale: pubblichi sempre la pagina web e una CVE. Aggiunga OSV, di solito pubblicando tramite GitHub, se distribuisce pacchetti open source. Aggiunga CSAF se vende prodotti a organizzazioni che chiedono advisory leggibili dalle macchine o che operano nell'ambito del Cyber Resilience Act dell'UE, il cui articolo 14, paragrafo 8, chiede un formato strutturato e leggibile dalle macchine, ove opportuno, quando si informano gli utenti sulle vulnerabilità attivamente sfruttate. Aggiunga VEX quando i clienti iniziano a inviarLe output degli scanner sui Suoi componenti. Generi ogni formato da un'unica registrazione, così non saranno mai in disaccordo.
GitHub Security Advisories
Se il Suo progetto è un repository pubblico su GitHub, le repository security advisories di GitHub Le offrono l'intero flusso in un unico posto: una bozza privata per discutere la vulnerabilità, un fork privato temporaneo per correggerla, una richiesta di CVE e la pubblicazione. Quattro elementi si combinano:
- Repository security advisories: bozze e advisory pubblicati che appartengono al Suo repository.
- Private vulnerability reporting: un pulsante "Report a vulnerability" nella pagina Advisories del repository, così i ricercatori possono segnalarLe le vulnerabilità in privato invece di aprire una issue pubblica.
- ID CVE da GitHub: GitHub è una CNA e può assegnare un ID CVE al Suo advisory, a meno che il Suo progetto non sia coperto da un'altra CNA.
- Il GitHub Advisory Database: per gli ecosistemi supportati, GitHub vi pubblica il Suo advisory, in formato OSV, e può usarlo per inviare alert di Dependabot ai repository che dipendono dal Suo pacchetto.
Attivare il private vulnerability reporting
I proprietari e gli amministratori di un repository pubblico possono attivarlo:
- Nella pagina principale del repository, faccia clic su Settings.
- Nella sezione Security and quality della barra laterale, faccia clic su Advanced Security.
- Faccia clic su Enable accanto a Private vulnerability reporting.
Poi lo colleghi dal Suo SECURITY.md e dalla Sua policy di divulgazione.
Creare una bozza di advisory
- Nella pagina principale del repository, apra la scheda Security and quality.
- Nella barra laterale, sotto Reporting, faccia clic su Advisories, poi su New draft security advisory.
- Inserisca un titolo. Sotto CVE identifier, inserisca un ID CVE esistente oppure scelga di richiederne uno a GitHub in seguito.
- Scriva la descrizione: la vulnerabilità, il suo impatto, le patch, i workaround e i riferimenti.
- Sotto Affected products, imposti l'ecosistema, il nome del pacchetto, le versioni colpite e le versioni corrette. Aggiunga un prodotto per ogni pacchetto.
- Imposti la gravità, oppure selezioni Assess severity using CVSS e compili il calcolatore.
- Aggiunga la CWE sotto Weaknesses e chi ha segnalato la vulnerabilità sotto Credits.
- Faccia clic su Create draft security advisory.
La bozza resta privata. Da lì può aggiungere collaboratori, avviare un fork privato temporaneo per preparare la correzione e discutere i dettagli con chi ha segnalato la vulnerabilità.
Richiedere una CVE e pubblicare
- Apra la bozza da Security and quality, poi Advisories.
- In fondo al modulo, faccia clic su Request CVE. Richiedere una CVE non rende pubblico l'advisory, e GitHub afferma di esaminare di solito le richieste entro 72 ore, quindi la richieda per tempo.
- Rilasci le versioni corrette e si assicuri che l'advisory le indichi come versioni corrette (patched).
- Faccia clic su Publish advisory. Il fork privato temporaneo viene eliminato, GitHub pubblica i dettagli della CVE e, per gli ecosistemi supportati, l'advisory arriva nel GitHub Advisory Database. Gli alert di Dependabot possono richiedere fino a 72 ore.
Se pubblica senza una versione corretta, GitHub avverte che Dependabot avviserà gli utenti senza suggerire una versione sicura. Il database di advisory di GitHub supporta sia CVSS 3.1 sia 4.0. I passaggi seguono la documentazione GitHub aggiornata a novembre 2026; le etichette dell'interfaccia di GitHub cambiano di tanto in tanto.
Gli advisory di GitHub sono adatti ai pacchetti open source negli ecosistemi supportati da GitHub. Per firmware, appliance o prodotti closed source, pubblichi sul Suo sito, in CSAF dove i clienti se lo aspettano, e ottenga la CVE dalla Sua CNA o da una il cui ambito La copra.
Quando pubblicare: tempistiche ed embargo
L'embargo, cioè il periodo tra la segnalazione privata e la pubblicazione, e la sua durata vanno definiti nella Sua policy di divulgazione. Il compito dell'advisory è arrivare al momento giusto all'interno di esso. Una tipica giornata di pubblicazione si svolge così:
- Prima del giorno stabilito: le correzioni sono pronte su ogni ramo supportato, l'ID CVE è riservato e l'advisory e tutte le versioni leggibili dalle macchine sono scritti e revisionati.
- Preavviso, se lo concede: grandi clienti, vendor a valle che integrano il Suo prodotto e coordinatori ricevono l'advisory sotto embargo qualche giorno prima, così da essere pronti a rispondere ai propri clienti.
- Rilascio: escono le versioni corrette.
- Pubblicazione: la pagina dell'advisory, il record CVE, i documenti CSAF o OSV e la voce del feed vanno online insieme, idealmente entro la stessa ora del rilascio.
- Notifica: mailing list e avvisi diretti ai clienti colpiti.
L'ordine conta. Pubblicare prima la correzione senza l'advisory permette agli attaccanti di confrontare le release mentre i difensori non sanno di dover aggiornare. Pubblicare l'advisory senza una correzione è giusto solo quando la vulnerabilità è già pubblica o sfruttata: in tal caso pubblichi ciò che sa, con le mitigazioni, e lo aggiorni quando esce la correzione.
Ai sensi del Cyber Resilience Act, una vulnerabilità attivamente sfruttata fa scattare anche un obbligo separato di segnalazione alle autorità: un preallarme entro 24 ore tramite la Single Reporting Platform, poi una notifica e una relazione finale. Non si tratta del Suo advisory, e non è pubblica. L'allegato I del CRA chiede inoltre ai fabbricanti di divulgare pubblicamente le informazioni sulle vulnerabilità corrette una volta disponibile un aggiornamento di sicurezza, ed è ciò che fa un advisory. Si veda che cosa richiede il CRA.
Pubblicazione: dove si trovano gli advisory
-
Una pagina stabile per advisory, a un URL che non cambia mai, come
/security/advisories/exc-2026-007, più una pagina indice che elenca ogni advisory con i suoi prodotti, la gravità e le date. - Un feed. Un feed RSS o Atom dell'indice permette di iscriversi senza una mailing list.
-
I metadati del provider CSAF, se pubblica in CSAF: un file
provider-metadata.jsone una directory o un feed ROLIE dei documenti, così gli strumenti trovano ogni advisory senza scraping. Si veda CSAF per ruoli e requisiti. -
Un riferimento in security.txt. Il campo
Policyrimanda alla Sua policy di divulgazione, e lo standard CSAF definisce un campoCSAFche indirizza gli strumenti ai metadati del Suo provider:
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
Non elimini mai un advisory pubblicato. Se si rivela errato, pubblichi una revisione che dica che cosa è cambiato; se la vulnerabilità non era reale, contrassegni l'advisory come ritirato e spieghi perché.
Informare i clienti
Pubblicare non equivale a essere letti. I clienti che non sono iscritti al Suo feed non vedranno l'advisory finché il loro scanner non segnala la CVE, o finché qualcuno non chiede loro informazioni. Per gli advisory di gravità alta e critica:
- Scriva ai clienti che utilizzano versioni colpite, non all'intera lista, con il link all'advisory e l'unica azione che devono compiere.
- Informi i Suoi team di supporto e vendita prima della pubblicazione, con l'advisory e una breve FAQ, così che le loro risposte vi corrispondano.
- Avvisi i vendor a valle che integrano il Suo prodotto, così che i loro advisory possano seguire rapidamente.
- Ricontatti i clienti che restano su versioni colpite.
Scrivere solo ai clienti colpiti richiede di sapere quali versioni di prodotto utilizza ciascuno. Per una vulnerabilità in un componente di terze parti che ha colpito molti vendor contemporaneamente, si veda come rispondere ai clienti dopo un attacco alla supply chain, che include dei modelli.
Conviene diventare una CNA?
Una CVE Numbering Authority (CNA) assegna ID CVE e pubblica record CVE per le vulnerabilità in un ambito concordato, di solito i propri prodotti. Diventarlo Le permette di controllare quando compare il record CVE, assegnare ID senza condividere dettagli sotto embargo con un'altra CNA e scrivere personalmente il record.
Secondo il CVE Program, non ci sono costi né contratti. Una CNA deve avere una policy pubblica di divulgazione delle vulnerabilità, una fonte pubblica per le nuove divulgazioni di vulnerabilità (la Sua pagina degli advisory) e accettare le condizioni d'uso del programma. L'onboarding prevede un modulo di registrazione, una sessione introduttiva ed esercitazioni pratiche. Nell'UE, l'ENISA opera come Root per le organizzazioni del suo ambito, compresi vendor tecnologici e progetti open source.
- È adatto a un vendor che pubblica regolarmente CVE per i propri prodotti, gestisce già un PSIRT e una pagina di advisory, e vuole controllare le tempistiche.
- Non deve essere il Suo primo passo se pubblica poche CVE all'anno, o se i Suoi prodotti sono pacchetti open source su GitHub, dove GitHub può assegnare gli ID nell'ambito dell'advisory.
Per ottenere ID CVE senza essere una CNA, si veda divulgazione coordinata delle vulnerabilità.
Il ruolo di CRACI: le versioni colpite
Gran parte di un advisory è scrittura. Il campo che richiede evidenze sono le versioni colpite e, per le vulnerabilità nei componenti di terze parti, è anche il più difficile da compilare correttamente: quali delle Sue release hanno distribuito la versione vulnerabile, anche come dipendenza transitiva, e da quando.
CRACI esegue le Sue build di GitHub Actions sui propri runner e registra i pacchetti che ogni job ha effettivamente scaricato, comprese le dipendenze transitive e i pacchetti ripristinati dalle cache CI. Ogni pacchetto mostra i suoi advisory (CVE, GHSA e altri ID) con la gravità. La cronologia delle build mostra ogni build passata e la sua SBOM, e quali build contenevano una dipendenza vulnerabile, così sa per quale periodo è stato colpito, entro il Suo periodo di conservazione (180 giorni per impostazione predefinita, personalizzabile con Enterprise). I team di sicurezza eseguono il triage dei risultati e li inviano ai team responsabili della correzione, e CRACI notifica alle persone interessate una vulnerabilità e la sua gravità. Si veda monitoraggio delle vulnerabilità.
Quando una vulnerabilità attivamente sfruttata fa scattare l'obbligo di segnalazione del CRA, CRACI prepara il contenuto delle notifiche (preallarme, notifica e relazione finale); una persona della Sua azienda le invia tramite la Single Reporting Platform.
Quando CRACI non è la risposta
- Scrivere e pubblicare l'advisory. CRACI non scrive né pubblica security advisory, né in CSAF né in altri formati. Per questo usi il Suo sito, le GitHub Security Advisories o uno strumento CSAF.
- Ricevere le segnalazioni. CRACI non riceve segnalazioni di vulnerabilità da ricercatori o clienti e non le gestisce come casi. Usi la Sua casella per la divulgazione, il private vulnerability reporting di GitHub o un sistema di gestione dei casi.
- Vulnerabilità nel Suo codice. CRACI confronta gli advisory con i pacchetti che le Sue build hanno scaricato. Un difetto come il path traversal dell'esempio, nel Suo codice, richiede una code review per scoprire quando è stato introdotto.
- Build al di fuori di GitHub Actions. Oggi CRACI supporta GitHub Actions; GitLab CI e Jenkins sono nella roadmap.
- Release più vecchie del Suo periodo di conservazione. La cronologia delle build copre le build che CRACI ha registrato e conservato.
Security advisory: domande frequenti
Che cos'è un security advisory?
Un security advisory è un avviso del fornitore di un prodotto che descrive una vulnerabilità nel prodotto: quali prodotti e versioni sono colpiti, quanto è grave, che cosa potrebbe fare un attaccante e come correggerla o mitigarla. Di solito riporta un ID CVE e viene pubblicato quando è disponibile una correzione.
Qual è la differenza tra un security advisory e un security bulletin?
Un advisory di solito tratta in dettaglio una vulnerabilità, o poche vulnerabilità correlate. Un bulletin riepiloga molte correzioni per una release o un periodo, spesso con una cadenza fissa; Android, per esempio, pubblica i suoi security bulletin ogni mese. Alcuni vendor usano i due termini in modo intercambiabile.
Che cosa deve includere un security advisory?
Un ID dell'advisory e un ID CVE, un titolo, i prodotti e le versioni colpiti come intervalli per ramo, i prodotti verificati e non colpiti, le versioni corrette, la gravità con il vettore CVSS completo, la CWE, una descrizione, l'impatto e le sue precondizioni, i workaround, i riconoscimenti, una cronologia, i riferimenti e una cronologia delle revisioni.
Come si crea un GitHub security advisory?
In un repository pubblico, apra la scheda Security and quality, faccia clic su Advisories sotto Reporting, poi su New draft security advisory. Compili titolo, descrizione, prodotti colpiti, gravità, CWE e riconoscimenti, e salvi la bozza. Quando la correzione è rilasciata, richieda una CVE se ne ha bisogno e faccia clic su Publish advisory.
GitHub può assegnare un ID CVE al mio advisory?
Sì, se il Suo progetto non è coperto da un'altra CNA. GitHub è una CVE Numbering Authority. Richieda la CVE dalla bozza dell'advisory; la richiesta non rende pubblico l'advisory, e GitHub afferma di esaminare di solito le richieste entro 72 ore. GitHub pubblica i dettagli della CVE quando l'advisory diventa pubblico.
I security advisory devono essere leggibili dalle macchine?
Sempre più spesso, sì. Pubblichi una pagina web per le persone e aggiunga una versione leggibile dalle macchine per i clienti che automatizzano: CSAF per i prodotti venduti a imprese e industria, OSV per i pacchetti open source e VEX per indicare quali vulnerabilità note non colpiscono il Suo prodotto. Le generi tutte dalla stessa registrazione.
Quando va pubblicato un security advisory?
Contemporaneamente alle versioni corrette, dopo l'eventuale preavviso sotto embargo ai clienti principali e ai vendor a valle. Pubblichi prima, con le mitigazioni, solo se la vulnerabilità è già pubblica o viene sfruttata, e aggiorni l'advisory quando esce la correzione.
Devo essere una CNA per pubblicare un security advisory?
No. Chiunque può pubblicare un advisory. Essere una CVE Numbering Authority significa solo poter assegnare personalmente gli ID CVE. Altrimenti, l'ID può essere assegnato da una CNA il cui ambito copre il Suo prodotto, da GitHub per i progetti open source su GitHub o da una CNA of Last Resort.
Sappia quali release indicare come colpite
Un advisory è accurato solo quanto le sue versioni colpite. Prenoti una demo per vedere quali delle Sue build di GitHub Actions contenevano un pacchetto vulnerabile.
Prenota una demo