PSIRT
Sikkerhetsadvisory: slik skriver du en, med mal og et gjennomgått eksempel
En sikkerhetsadvisory er dokumentet kundene dine handler ut fra når en sårbarhet berører produktet ditt. En god advisory svarer, uten en supportsak, på om de er berørt, hvor alvorlig det er og hva de skal gjøre. Denne guiden dekker feltene, et komplett eksempel, de maskinlesbare formatene, GitHub Security Advisories og når du bør publisere.
Oppdatert
Hva er en sikkerhetsadvisory?
En sikkerhetsadvisory er en melding fra leverandøren av et produkt som beskriver en sårbarhet i det: hvilke produkter og versjoner som er berørt, hvor alvorlig den er, hva en angriper kan gjøre, og hvordan brukerne retter eller begrenser den. Den er skrevet for dem som kjører produktet, og i økende grad også for verktøyene deres.
Advisories er den offentlige enden av koordinert offentliggjøring av sårbarheter: En finner rapporterer privat, leverandøren retter, og advisoryen er måten alle andre får vite om det på. I de fleste programvare- og enhetsselskaper er det PSIRT-et som skriver dem, som en del av et bredere produktsikkerhetsprogram.
Sikkerhetsadvisory vs. security bulletin, CVE-post, VEX og utgivelsesnotater
Disse dokumentene overlapper, og team blander dem ofte sammen:
| Dokument | Hvem publiserer det | Hva det dekker | Hovedleser |
|---|---|---|---|
| Sikkerhetsadvisory | Produktets leverandør, eller en koordinator | Én sårbarhet, eller noen få beslektede, i produktene dine: berørte versjoner, alvorlighetsgrad, retting | Kundenes driftsfolk og sikkerhetsteam |
| Security bulletin | Leverandøren, ofte etter en fast plan | En samling av mange rettinger i én utgivelse eller periode. Androids sikkerhetsbulletiner kommer for eksempel ut den første mandagen i hver måned. | Team som patcher i sykluser |
| CVE-post | En CVE Numbering Authority (CNA) | Den globale identifikatoren og en minimumsbeskrivelse av én sårbarhet: berørt produkt, problemtype, beskrivelse og minst én offentlig referanse | Sårbarhetsdatabaser og skannere |
| VEX-erklæring | Leverandøren | En maskinlesbar status per produkt og sårbarhet: berørt, ikke berørt, rettet, under undersøkelse | Kundenes skannere |
| Utgivelsesnotater | Leverandøren | Alt som er endret i en utgivelse, sikkerhetsrettinger blant andre endringer | Alle som oppgraderer |
Det vanlige mønsteret: én advisory per sårbarhet, med en CVE-ID som kobler den til CVE-posten, lenket fra utgivelsesnotatene til hver rettet versjon og fra bulletinen hvis du publiserer en. «Security bulletin» og «security advisory» brukes noen ganger som synonymer; det viktige er at hver sårbarhet har en stabil side kundene kan vise til.
Hva en sikkerhetsadvisory bør inneholde
Feltene nedenfor er det kundene ser etter, og de svarer én til én til de maskinlesbare formatene lenger ned i denne guiden. CVE-programmets CNA-regler setter minstekravet for CVE-posten: minst ett berørt produkt og én berørt versjon, sårbarhetens type eller årsak (helst som en CWE), en beskrivelse i fritekst og en offentlig referanse. En nyttig advisory går lenger.
| Felt | Hva det sier | Vanlig feil |
|---|---|---|
| Advisory-ID | Din egen stabile identifikator, for eksempel EXC-2026-007, pluss CVE-ID-en |
Å bruke bare CVE-ID-en, som du kanskje ikke har ennå den dagen du må publisere |
| Tittel | Produkt, sårbarhetstype og konsekvens på én linje | «Sikkerhetsoppdatering for produkt X», som ikke sier noe |
| Berørte produkter og versjoner | Alle berørte produkter og versjoner, som intervaller per utgivelsesgren | «Versjoner før 4.2.2», som feilaktig tar med grener som aldri hadde feilen |
| Ikke berørt | Produkter og versjoner du har sjekket og funnet ikke berørt | Å utelate det, slik at hver kunde på en eldre versjon åpner en sak |
| Rettede versjoner | Den første rettede versjonen på hver støttede gren | Å nevne bare den nyeste utgivelsen |
| Alvorlighetsgrad | En vurdering og den fullstendige CVSS-vektoren, med CVSS-versjonen | En naken poengsum uten vektor, som ingen kan kontrollere eller tilpasse sitt eget miljø |
| Svakhet | CWE-ID og navn | Å utelate den; databaser og CVE-reglene forventer den |
| Beskrivelse | Hva feilen er og hvor den sitter, detaljert nok til å vurdere eksponering, uten en fungerende exploit | Så vag at kundene ikke kan avgjøre om konfigurasjonen deres er utsatt |
| Konsekvens | Hva en angriper oppnår, og hva angriperen trenger først (tilgang, rolle, posisjon i nettverket) | Å gjenta CVSS-metrikkene med ord i stedet for å forklare konsekvensene |
| Omgåelser og avbøtende tiltak | Hva du gjør hvis du ikke kan oppgradere i dag, og hvordan du sjekker om du er blitt angrepet | «Ingen omgåelser» når en konfigurasjonsendring ville stoppet angrepet |
| Anerkjennelse | Hvem som fant og rapporterte den, med samtykke | Å kreditere noen som har bedt om å være anonym |
| Tidslinje | Rapportert, bekreftet, rettet, publisert | Å utelate den, noe som får lange forsinkelser til å se skjult ut |
| Referanser | CVE-post, utgivelsesnotater, commit med rettingen, maskinlesbare versjoner | Lenker til interne saker kundene ikke kan åpne |
| Revisjonshistorikk | Hver endring etter første publisering, med dato og versjon | Å endre de berørte versjonene i stillhet |
Det vanskeligste feltet er de berørte versjonene. Den sårbare koden ble innført på ett tidspunkt og rettet på et annet, og hver støttede gren har sin egen retting. Hvis sårbarheten kom inn via en tredjepartskomponent, blir spørsmålet hvilke av utgivelsene dine som leverte den sårbare versjonen av komponenten, direkte eller som en transitiv avhengighet. Se hvordan du vurderer en ny CVE på tvers av byggene dine.
Et gjennomgått eksempel
Her er en komplett advisory for et fiktivt produkt: Example Gateway, en selvhostet API-gateway fra Example Corp, med to støttede grener, 3.9 og 4.x. Det sårbare endepunktet ble lagt til i 3.9.0, så 3.8 og eldre er ikke berørt. Alle navn, ID-er og datoer er oppdiktet; CVSS 4.0-poengsummen er beregnet fra vektoren som vises.
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 ting gjør at denne advisoryen fungerer:
- Intervaller per gren. «4.0.0 til 4.2.1» og «3.9.0 til 3.9.6» er presise. «Før 4.2.2» ville ha fortalt alle 3.8-kunder at de var berørt.
- Konsekvensen nevner forutsetningen. En kunde uten viewer-kontoer vet at den reelle eksponeringen er lav; en kunde med hundrevis av innleide konsulenter i viewer-rollen vet at den ikke er det.
- Omgåelsen inkluderer oppfølgingen. Oppgradering tetter hullet, men gjør ikke en lekket hemmelighet ugjort, så advisoryen sier hva som må roteres.
En mal for sikkerhetsadvisories du kan kopiere
Bytt ut delene i hakeparentes. Slett en seksjon bare hvis den virkelig ikke gjelder, og si det heller enn å la den stå tom der kundene forventer den (for eksempel «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
Menneskelesbare vs. maskinlesbare advisories
En nettside er nok for mennesker. Den er ikke nok for en kunde med tusenvis av enheter eller hundrevis av tjenester, der verktøyene må sammenligne advisoryen din med det kunden kjører. Tre familier av formater gjør det, og de dekker ulike behov:
| Format | Hva det er | Bruk det når |
|---|---|---|
| Nettside (og PDF) | Advisoryen slik mennesker leser den | Alltid. Alle andre formater lenker tilbake til den. |
| CSAF 2.0 | OASIS-standarden for advisories som JSON, med et produkttre, produktstatuslister, utbedringer, en revisjonshistorikk og regler for distribusjon | Du selger produkter som fastvare, apparater eller bedriftsprogramvare til kunder som automatiserer mottaket av advisories, ofte industri- og bedriftskunder |
| OSV | Open Source Vulnerability-formatet: JSON-oppføringer for pakker i et navngitt økosystem, med versjonsintervaller. GitHub Advisory Database publiserer sine advisories i det. | Du leverer pakker med åpen kildekode gjennom npm, PyPI, Maven, Go-moduler og lignende økosystemer |
| VEX (CSAF VEX, CycloneDX VEX, OpenVEX) | Erklæringer om at et produkt er eller ikke er berørt av en kjent sårbarhet, og hvorfor | Kunder skanner SBOM-en din og spør om CVE-er i komponenter som ikke berører produktet ditt |
Det gjennomgåtte eksemplet blir i CSAF 2.0 et csaf_security_advisory-dokument: Advisory-ID-en havner i
document/tracking/id, revisjonshistorikken i document/tracking/revision_history, de
berørte og rettede versjonene i hver sårbarhets product_status-lister, CWE-en i
cwe-objektet og omgåelsene i remediations. Én hake: Poengsummer i CSAF 2.0 tar bare CVSS
v2 og v3.x. Støtte for CVSS v4.0 kommer med CSAF 2.1, som fortsatt er et utkast, så en CSAF 2.0-advisory har enten
en CVSS 3.1-vektor eller oppgir 4.0-vektoren i en note.
Den samme advisoryen som en OSV-oppføring, for team som også leverer gatewayen som en npm-pakke (utdrag):
{
"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" }]
}
Legg merke til at intervallet har to par med introduced og fixed.
OSV-skjemaet regner en versjon som berørt hvis den
faller innenfor et intervall eller står i den eksplisitte versions-listen, og anbefaler fixed fremfor
last_affected fordi en last-affected-grense kan føre til at treff blir oversett.
Beslutningsregel: Publiser alltid nettsiden og en CVE. Legg til OSV, vanligvis ved å publisere gjennom GitHub, hvis du leverer pakker med åpen kildekode. Legg til CSAF hvis du selger produkter til organisasjoner som ber om maskinlesbare advisories, eller arbeider under EUs Cyber Resilience Act, der artikkel 14(8) ber om et strukturert, maskinlesbart format der det er hensiktsmessig når brukerne informeres om aktivt utnyttede sårbarheter. Legg til VEX når kundene begynner å sende deg skannerresultater om komponentene dine. Generer alle formater fra én registrering, slik at de aldri motsier hverandre.
GitHub Security Advisories
Hvis prosjektet ditt er et offentlig repository på GitHub, gir GitHubs repository security advisories deg hele flyten på ett sted: et privat utkast for å diskutere sårbarheten, en midlertidig privat fork for å rette den, en CVE-forespørsel og publisering. Fire deler henger sammen:
- Repository security advisories: utkast og publiserte advisories som hører til repositoryet ditt.
- Private vulnerability reporting: en «Report a vulnerability»-knapp på repositoryets Advisories-side, slik at forskere kan rapportere til deg privat i stedet for å åpne en offentlig issue.
- CVE-ID-er fra GitHub: GitHub er en CNA og kan tildele advisoryen din en CVE-ID, med mindre prosjektet ditt dekkes av en annen CNA.
- GitHub Advisory Database: For støttede økosystemer publiserer GitHub advisoryen din der, i OSV-format, og kan bruke den til å sende Dependabot-varsler til repositoryer som er avhengige av pakken din.
Slå på private vulnerability reporting
Eiere og administratorer av et offentlig repository kan slå det på:
- Klikk Settings på repositoryets hovedside.
- I seksjonen Security and quality i sidepanelet klikker du Advanced Security.
- Klikk Enable ved siden av Private vulnerability reporting.
Lenk deretter til det fra SECURITY.md og fra offentliggjøringspolicyen din.
Opprett et utkast til advisory
- Åpne fanen Security and quality på repositoryets hovedside.
- I sidepanelet, under Reporting, klikker du Advisories og deretter New draft security advisory.
- Skriv inn en tittel. Under CVE identifier oppgir du en eksisterende CVE-ID eller velger å be GitHub om en senere.
- Skriv beskrivelsen: sårbarheten, konsekvensen, patcher, omgåelser og referanser.
- Under Affected products angir du økosystem, pakkenavn, berørte versjoner og patchede versjoner. Legg til et produkt for hver pakke.
- Angi alvorlighetsgraden, eller velg Assess severity using CVSS og fyll ut kalkulatoren.
- Legg til CWE-en under Weaknesses og finneren under Credits.
- Klikk Create draft security advisory.
Utkastet forblir privat. Derfra kan du legge til samarbeidspartnere, starte en midlertidig privat fork for å forberede rettingen og diskutere detaljene med finneren.
Be om en CVE og publiser
- Åpne utkastet fra Security and quality og deretter Advisories.
- Nederst i skjemaet klikker du Request CVE. En CVE-forespørsel gjør ikke advisoryen offentlig, og GitHub sier at forespørsler vanligvis behandles innen 72 timer, så be om den tidlig.
- Gi ut de rettede versjonene, og sørg for at advisoryen oppgir dem som patchede versjoner.
- Klikk Publish advisory. Den midlertidige private forken slettes, GitHub publiserer CVE-detaljene, og for støttede økosystemer havner advisoryen i GitHub Advisory Database. Dependabot-varsler kan ta opptil 72 timer.
Hvis du publiserer uten en patchet versjon, advarer GitHub om at Dependabot varsler brukerne uten å foreslå en trygg versjon. GitHubs advisory-database støtter både CVSS 3.1 og 4.0. Stegene følger GitHub Docs per november 2026; etikettene i GitHub-grensesnittet endres fra tid til annen.
GitHub-advisories passer for pakker med åpen kildekode i økosystemene GitHub støtter. For fastvare, apparater eller produkter med lukket kildekode publiserer du på ditt eget nettsted, i CSAF der kundene forventer det, og får CVE-en fra din egen CNA eller en CNA hvis ansvarsområde dekker deg.
Når du skal publisere: tidspunkt og embargo
Embargoen, perioden mellom den private rapporten og publiseringen, og hvor lenge den bør vare, hører hjemme i offentliggjøringspolicyen din. Advisoryens jobb er å komme på rett tidspunkt innenfor den. En typisk publiseringsdag ser slik ut:
- Før dagen: Rettingene er klare på alle støttede grener, CVE-ID-en er reservert, og advisoryen og alle maskinlesbare versjoner er skrevet og gjennomgått.
- Forhåndsvarsel, hvis du gir det: Store kunder, nedstrømsleverandører som bygger inn produktet ditt, og koordinatorer får advisoryen under embargo noen dager i forveien, slik at de er klare til å svare sine egne kunder.
- Utgivelse: De rettede versjonene går ut.
- Publisering: Advisory-siden, CVE-posten, CSAF- eller OSV-dokumentene og feed-oppføringen går live samtidig, helst innen samme time som utgivelsen.
- Varsling: e-postliste og direkte varsler til berørte kunder.
Rekkefølgen betyr noe. Publiserer du rettingen først uten advisoryen, kan angripere sammenligne utgivelsene mens forsvarerne ikke vet at de bør oppgradere. Å publisere advisoryen uten en retting er riktig bare når sårbarheten allerede er offentlig eller blir utnyttet: Publiser da det du vet, med avbøtende tiltak, og oppdater når rettingen kommer.
Under Cyber Resilience Act utløser en aktivt utnyttet sårbarhet også en separat plikt til å rapportere til myndighetene: et tidlig varsel innen 24 timer gjennom Single Reporting Platform, deretter en melding og en sluttrapport. Det er ikke advisoryen din, og det er ikke offentlig. Vedlegg I til CRA ber også produsenter om å offentliggjøre informasjon om rettede sårbarheter når en sikkerhetsoppdatering er tilgjengelig, og det er nettopp det en advisory gjør. Se hva CRA krever.
Publisering: hvor advisories hører hjemme
-
En stabil side per advisory, på en URL som aldri endres, for eksempel
/security/advisories/exc-2026-007, pluss en oversiktsside som lister opp alle advisories med produkter, alvorlighetsgrad og datoer. - En feed. En RSS- eller Atom-feed av oversikten lar folk abonnere uten en e-postliste.
-
CSAF-leverandørmetadata, hvis du publiserer CSAF: en
provider-metadata.json-fil og en katalog eller ROLIE-feed med dokumentene, slik at verktøy finner alle advisories uten skraping. Se CSAF for roller og krav. -
En peker i security.txt.
Policy-feltet lenker til offentliggjøringspolicyen din, og CSAF-standarden definerer etCSAF-felt som viser verktøy veien til leverandørmetadataene dine:
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
Slett aldri en publisert advisory. Viser den seg å være feil, publiserer du en revisjon som sier hva som er endret; hvis sårbarheten ikke var reell, merker du advisoryen som trukket tilbake og forklarer hvorfor.
Varsling av kunder
Å publisere er ikke det samme som å bli lest. Kunder som ikke abonnerer på feeden din, ser ikke advisoryen før skanneren deres flagger CVE-en, eller før noen spør dem om den. For advisories med høy og kritisk alvorlighetsgrad:
- Send e-post til kundene som kjører berørte versjoner, ikke til hele listen, med lenken til advisoryen og det ene tiltaket de må gjøre.
- Orienter support- og salgsteamene før publisering, med advisoryen og en kort FAQ, slik at svarene deres stemmer med den.
- Gi beskjed til nedstrømsleverandører som bygger inn produktet ditt, slik at deres egne advisories kan følge raskt.
- Følg opp kunder som blir værende på berørte versjoner.
For å sende e-post bare til de berørte kundene må du vite hvilke produktversjoner hver av dem kjører. For en sårbarhet i en tredjepartskomponent som rammet mange leverandører samtidig, se hvordan du svarer kundene etter et forsyningskjedeangrep, med maler.
Bør du bli CNA?
En CVE Numbering Authority (CNA) tildeler CVE-ID-er og publiserer CVE-poster for sårbarheter innenfor et avtalt ansvarsområde, vanligvis egne produkter. Blir du CNA, kan du styre når CVE-posten dukker opp, tildele ID-er uten å dele detaljer under embargo med en annen CNA, og skrive posten selv.
Ifølge CVE-programmet er det ingen avgift og ingen kontrakt. En CNA må ha en offentlig policy for offentliggjøring av sårbarheter, en offentlig kilde for nye offentliggjøringer av sårbarheter (advisory-siden din) og godta programmets bruksvilkår. Opptaket går via et registreringsskjema, en introduksjonsøkt og øvingseksempler. I EU fungerer ENISA som Root for organisasjoner innenfor sitt ansvarsområde, inkludert teknologileverandører og prosjekter med åpen kildekode.
- Det passer for en leverandør som jevnlig publiserer CVE-er for egne produkter, allerede driver et PSIRT og en advisory-side og vil ha kontroll over tidspunktet.
- Det trenger ikke være ditt første steg hvis du publiserer en håndfull CVE-er i året, eller hvis produktene dine er pakker med åpen kildekode på GitHub, der GitHub kan tildele ID-ene som en del av advisoryen.
For CVE-ID-er uten å være CNA, se koordinert offentliggjøring av sårbarheter.
Hvor CRACI passer inn: de berørte versjonene
Det meste av en advisory er skriving. Feltet som krever bevis, er de berørte versjonene, og for sårbarheter i tredjepartskomponenter er det også det vanskeligste å få riktig: hvilke av utgivelsene dine som leverte den sårbare versjonen, også som transitiv avhengighet, og siden når.
CRACI kjører GitHub Actions-byggene dine på egne runnere og registrerer pakkene hver jobb faktisk hentet, inkludert transitive avhengigheter og pakker gjenopprettet fra CI-cacher. Hver pakke viser sine advisories (CVE-, GHSA- og andre ID-er) med alvorlighetsgrad. Byggehistorikken viser alle tidligere bygg og SBOM-ene deres, og hvilke bygg som inneholdt en sårbar avhengighet, så du vet i hvilken periode du var berørt, innenfor lagringsperioden din (180 dager som standard, tilpasset på Enterprise). Sikkerhetsteam prioriterer funnene og sender dem til teamene som eier rettingen, og CRACI varsler de relevante personene om en sårbarhet og alvorlighetsgraden. Se sporing av sårbarheter.
Når en aktivt utnyttet sårbarhet utløser rapporteringsplikten i CRA, forbereder CRACI innholdet i meldingene (tidlig varsel, melding og sluttrapport); en person i selskapet ditt sender dem inn gjennom Single Reporting Platform.
Når CRACI ikke er svaret
- Skriving og publisering av advisoryen. CRACI skriver eller publiserer ikke sikkerhetsadvisories, verken i CSAF eller noe annet format. Bruk ditt eget nettsted, GitHub Security Advisories eller et CSAF-verktøy til det.
- Mottak av rapporter. CRACI tar ikke imot sårbarhetsrapporter fra forskere eller kunder, og følger dem ikke opp som saker. Bruk innboksen for offentliggjøring, GitHub private vulnerability reporting eller et saksverktøy.
- Sårbarheter i din egen kode. CRACI sammenligner advisories med pakkene byggene dine hentet. En feil som path traversal-feilen i eksemplet, i din egen kode, krever kodegjennomgang for å finne ut når den ble innført.
- Bygg utenfor GitHub Actions. CRACI støtter GitHub Actions i dag; GitLab CI og Jenkins står på veikartet.
- Utgivelser eldre enn lagringsperioden din. Byggehistorikken dekker byggene CRACI har registrert og tatt vare på.
Sikkerhetsadvisories: ofte stilte spørsmål
Hva er en sikkerhetsadvisory?
En sikkerhetsadvisory er en melding fra leverandøren av et produkt som beskriver en sårbarhet i produktet: hvilke produkter og versjoner som er berørt, hvor alvorlig den er, hva en angriper kan gjøre, og hvordan den rettes eller begrenses. Den har vanligvis en CVE-ID og publiseres når en retting er tilgjengelig.
Hva er forskjellen på en sikkerhetsadvisory og en security bulletin?
En advisory dekker vanligvis én sårbarhet, eller noen få beslektede, i detalj. En bulletin samler mange rettinger for én utgivelse eller periode, ofte etter en fast plan; Android publiserer for eksempel sikkerhetsbulletinene sine månedlig. Noen leverandører bruker de to ordene om hverandre.
Hva bør en sikkerhetsadvisory inneholde?
En advisory-ID og en CVE-ID, en tittel, berørte produkter og versjoner som intervaller per gren, produkter som er sjekket og ikke berørt, rettede versjoner, alvorlighetsgrad med den fullstendige CVSS-vektoren, CWE-en, en beskrivelse, konsekvensen og forutsetningene for den, omgåelser, anerkjennelse, en tidslinje, referanser og en revisjonshistorikk.
Hvordan oppretter jeg en GitHub security advisory?
I et offentlig repository åpner du fanen Security and quality, klikker Advisories under Reporting og deretter New draft security advisory. Fyll ut tittel, beskrivelse, berørte produkter, alvorlighetsgrad, CWE og anerkjennelse, og lagre utkastet. Når rettingen er gitt ut, ber du om en CVE hvis du trenger en, og klikker Publish advisory.
Kan GitHub tildele advisoryen min en CVE-ID?
Ja, hvis prosjektet ditt ikke dekkes av en annen CNA. GitHub er en CVE Numbering Authority. Be om CVE-en fra utkastet til advisory; forespørselen gjør ikke advisoryen offentlig, og GitHub sier at forespørsler vanligvis behandles innen 72 timer. GitHub publiserer CVE-detaljene når advisoryen er offentlig.
Bør sikkerhetsadvisories være maskinlesbare?
I økende grad, ja. Publiser en nettside for mennesker, og legg til en maskinlesbar versjon for kunder som automatiserer: CSAF for produkter som selges til bedrifter og industri, OSV for pakker med åpen kildekode, og VEX for å si hvilke kjente sårbarheter som ikke berører produktet ditt. Generer dem fra den samme registreringen.
Når bør en sikkerhetsadvisory publiseres?
Samtidig med de rettede versjonene, etter et eventuelt forhåndsvarsel under embargo til viktige kunder og nedstrømsleverandører. Publiser tidligere, med avbøtende tiltak, bare hvis sårbarheten allerede er offentlig eller blir utnyttet, og oppdater advisoryen når rettingen kommer.
Må jeg være CNA for å publisere en sikkerhetsadvisory?
Nei. Hvem som helst kan publisere en advisory. Å være CVE Numbering Authority betyr bare at du kan tildele CVE-ID-er selv. Uten det kan en CNA hvis ansvarsområde dekker produktet ditt, GitHub for prosjekter med åpen kildekode på GitHub, eller en CNA of Last Resort tildele ID-en.
Vit hvilke utgivelser du skal oppgi som berørt
En advisory er aldri mer presis enn de berørte versjonene. Book en demo for å se hvilke av GitHub Actions-byggene dine som inneholdt en sårbar pakke.
Book en demo