PSIRT
Sikkerhedsadvisory: sådan skriver du en, med skabelon og et gennemgået eksempel
En sikkerhedsadvisory er det dokument, dine kunder handler ud fra, når en sårbarhed rammer dit produkt. En god advisory svarer, uden en supportsag, på om de er ramt, hvor slemt, og hvad de skal gøre. Denne guide dækker felterne, et komplet eksempel, de maskinlæsbare formater, GitHub Security Advisories og hvornår du skal offentliggøre.
Opdateret
Hvad er en sikkerhedsadvisory?
En sikkerhedsadvisory er en meddelelse fra leverandøren af et produkt, der beskriver en sårbarhed i det: hvilke produkter og versioner der er ramt, hvor alvorlig den er, hvad en angriber kan gøre, og hvordan brugerne retter eller afbøder den. Den er skrevet til dem, der kører produktet, og i stigende grad også til deres værktøjer.
Advisories er den offentlige ende af koordineret offentliggørelse af sårbarheder: En finder rapporterer privat, leverandøren retter, og advisoryen er den måde, alle andre får det at vide på. I de fleste software- og enhedsvirksomheder er det PSIRT'et, der skriver dem, som en del af et bredere produktsikkerhedsprogram.
Sikkerhedsadvisory vs security bulletin, CVE-post, VEX og release notes
Disse dokumenter overlapper, og teams blander dem ofte sammen:
| Dokument | Hvem offentliggør det | Hvad det dækker | Primær læser |
|---|---|---|---|
| Sikkerhedsadvisory | Produktets leverandør eller en koordinator | Én sårbarhed, eller nogle få relaterede, i dine produkter: ramte versioner, alvorlighed, rettelse | Kundernes driftsfolk og sikkerhedsteams |
| Security bulletin | Leverandøren, ofte efter en fast plan | En samling af mange rettelser i én release eller periode. Androids security bulletins udkommer for eksempel den første mandag i hver måned. | Teams, der patcher i faste cyklusser |
| CVE-post | En CVE Numbering Authority (CNA) | Den globale identifikator og en minimumsbeskrivelse af én sårbarhed: ramt produkt, problemtype, beskrivelse og mindst én offentlig reference | Sårbarhedsdatabaser og scannere |
| VEX-erklæring | Leverandøren | En maskinlæsbar status pr. produkt og sårbarhed: ramt, ikke ramt, rettet, under undersøgelse | Kundernes scannere |
| Release notes | Leverandøren | Alt, der er ændret i en release, sikkerhedsrettelser blandt andre ændringer | Alle, der opgraderer |
Det almindelige mønster: én advisory pr. sårbarhed, med et CVE-id, der forbinder den med CVE-posten, og med links fra release notes for hver rettet version og fra bulletinen, hvis du udgiver en. "Security bulletin" og "security advisory" bruges nogle gange som synonymer; det vigtige er, at hver sårbarhed har en stabil side, kunderne kan henvise til.
Hvad en sikkerhedsadvisory bør indeholde
Felterne nedenfor er dem, kunderne leder efter, og de svarer én til én til de maskinlæsbare formater senere i denne guide. CVE-programmets CNA-regler sætter minimumskravet til CVE-posten: mindst ét ramt produkt og én ramt version, sårbarhedens type eller årsag (helst som en CWE), en beskrivelse i prosa og en offentlig reference. En nyttig advisory går videre.
| Felt | Hvad det siger | Typisk fejl |
|---|---|---|
| Advisory-id | Din egen stabile identifikator, for eksempel EXC-2026-007, plus CVE-id'et |
Kun at bruge CVE-id'et, som du måske endnu ikke har den dag, du skal offentliggøre |
| Titel | Produkt, sårbarhedstype og konsekvens på én linje | "Sikkerhedsopdatering til Produkt X", som ikke siger noget |
| Ramte produkter og versioner | Hvert ramt produkt og hver ramt version, som intervaller pr. release-gren | "Versioner før 4.2.2", som fejlagtigt omfatter grene, der aldrig havde fejlen |
| Ikke ramt | Produkter og versioner, du har kontrolleret og fundet ikke ramt | At udelade det, så hver kunde på en ældre version opretter en sag |
| Rettede versioner | Den første rettede version på hver understøttet gren | Kun at nævne den nyeste release |
| Alvorlighed | En vurdering og den fulde CVSS-vektor med CVSS-versionen | En nøgen score uden vektor, som ingen kan kontrollere eller tilpasse deres miljø |
| Svaghed | CWE-id og -navn | At udelade den; databaser og CVE-reglerne forventer den |
| Beskrivelse | Hvad fejlen er, og hvor den sidder, detaljeret nok til at vurdere eksponeringen, uden et fungerende exploit | Så vag, at kunderne ikke kan se, om deres konfiguration er eksponeret |
| Konsekvens | Hvad en angriber opnår, og hvad vedkommende skal have først (adgang, rolle, netværksposition) | At gentage CVSS-metrikkerne i ord i stedet for at forklare konsekvenserne |
| Workarounds og afbødning | Hvad du gør, hvis du ikke kan opgradere i dag, og hvordan du kontrollerer, om du er blevet angrebet | "Ingen workarounds", når en konfigurationsændring ville blokere angrebet |
| Anerkendelse | Hvem der fandt og rapporterede den, med deres samtykke | At nævne en, der bad om at forblive anonym |
| Tidslinje | Rapporteret, bekræftet, rettet, offentliggjort | At udelade den, så lange forsinkelser ser skjulte ud |
| Referencer | CVE-post, release notes, commit med rettelsen, maskinlæsbare versioner | Links til interne sager, som kunderne ikke kan åbne |
| Revisionshistorik | Hver ændring efter den første offentliggørelse, med dato og version | At ændre de ramte versioner i det stille |
Det sværeste felt er de ramte versioner. Den sårbare kode blev indført på ét tidspunkt og rettet på et andet, og hver understøttet gren har sin egen rettelse. Kom sårbarheden ind via en tredjepartskomponent, bliver spørgsmålet, hvilke af dine releases der leverede den sårbare version af komponenten, direkte eller som transitiv afhængighed. Se sådan vurderer du en ny CVE på tværs af dine builds.
Et gennemgået eksempel
Her er en komplet advisory for et fiktivt produkt: Example Gateway, en selvhostet API-gateway fra Example Corp, med to understøttede grene, 3.9 og 4.x. Det sårbare endpoint blev tilføjet i 3.9.0, så 3.8 og tidligere er ikke ramt. Alle navne, id'er og datoer er opdigtede; CVSS 4.0-scoren er beregnet ud fra den viste vektor.
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 får denne advisory til at fungere:
- Intervaller pr. gren. "4.0.0 til 4.2.1" og "3.9.0 til 3.9.6" er præcise. "Før 4.2.2" ville have fortalt hver 3.8-kunde, at de var ramt.
- Konsekvensen nævner forudsætningen. En kunde uden viewer-konti ved, at den reelle eksponering er lav; en kunde med hundredvis af konsulenter i viewer-rollen ved, at den ikke er det.
- Workarounden omfatter opfølgningen. En opgradering lukker hullet, men gør ikke en lækket hemmelighed ulækket, så advisoryen siger, hvad der skal roteres.
En skabelon til sikkerhedsadvisories, du kan kopiere
Udskift delene i kantede parenteser. Slet kun et afsnit, hvis det virkelig ikke er relevant, og skriv det hellere eksplicit end at lade det stå tomt, hvor kunderne forventer det (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
Menneskelæsbare vs maskinlæsbare advisories
En webside er nok for mennesker. Den er ikke nok for en kunde med tusindvis af enheder eller hundredvis af tjenester, hvis værktøjer skal matche din advisory mod det, de kører. Tre familier af formater gør det, og de dækker forskellige behov:
| Format | Hvad det er | Brug det, når |
|---|---|---|
| Webside (og PDF) | Advisoryen, som mennesker læser den | Altid. Alle andre formater linker tilbage til den. |
| CSAF 2.0 | OASIS-standarden for advisories som JSON, med et produkttræ, lister over produktstatus, afhjælpninger, en revisionshistorik og regler for distribution | Du sælger produkter som firmware, appliances eller enterprise-software til kunder, der automatiserer modtagelsen af advisories, ofte industrielle købere og enterprise-købere |
| OSV | Open Source Vulnerability-formatet: JSON-poster for pakker i et navngivet økosystem, med versionsintervaller. GitHub Advisory Database offentliggør sine advisories i det. | Du leverer open source-pakker via npm, PyPI, Maven, Go-moduler og lignende økosystemer |
| VEX (CSAF VEX, CycloneDX VEX, OpenVEX) | Erklæringer om, at et produkt er eller ikke er ramt af en kendt sårbarhed, og hvorfor | Kunderne scanner din SBOM og spørger om CVE'er i komponenter, der ikke påvirker dit produkt |
I CSAF 2.0 bliver det gennemgåede eksempel et csaf_security_advisory-dokument: Advisory-id'et går i
document/tracking/id, revisionshistorikken i document/tracking/revision_history, de ramte og
rettede versioner i hver sårbarheds product_status-lister, CWE'en i dens cwe-objekt og
workarounds i remediations. Én hage: Scorer i CSAF 2.0 understøtter kun CVSS v2 og v3.x. Understøttelse
af CVSS v4.0 kommer med CSAF 2.1, som stadig er et udkast, så en CSAF 2.0-advisory har enten en CVSS 3.1-vektor eller
angiver 4.0-vektoren i en note.
Den samme advisory som en OSV-post, for teams, der også leverer gatewayen som en npm-pakke (uddrag):
{
"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" }]
}
Bemærk, at intervallet indeholder to par af introduced og fixed.
OSV-skemaet behandler en version som ramt, hvis den
ligger i et af intervallerne eller står på den eksplicitte versions-liste, og anbefaler fixed
frem for last_affected, fordi en last-affected-grænse kan give oversete match.
Beslutningsregel: Offentliggør altid websiden og en CVE. Tilføj OSV, som regel ved at offentliggøre via GitHub, hvis du leverer open source-pakker. Tilføj CSAF, hvis du sælger produkter til organisationer, der beder om maskinlæsbare advisories, eller er omfattet af EU's Cyber Resilience Act, hvis artikel 14, stk. 8, kræver et struktureret, maskinlæsbart format, hvor det er relevant, når brugerne informeres om aktivt udnyttede sårbarheder. Tilføj VEX, når kunderne begynder at sende dig scanneroutput om dine komponenter. Generér alle formater ud fra én registrering, så de aldrig er uenige.
GitHub Security Advisories
Er dit projekt et offentligt repository på GitHub, giver GitHubs repository security advisories dig hele forløbet ét sted: et privat udkast til at drøfte sårbarheden, en midlertidig privat fork til at rette den, en CVE-anmodning og offentliggørelse. Fire dele hænger sammen:
- Repository security advisories: udkast og offentliggjorte advisories, der hører til dit repository.
- Private vulnerability reporting: en "Report a vulnerability"-knap på repositoryets Advisories-side, så forskere kan rapportere privat til dig i stedet for at oprette et offentligt issue.
- CVE-id'er fra GitHub: GitHub er en CNA og kan tildele din advisory et CVE-id, medmindre dit projekt er dækket af en anden CNA.
- GitHub Advisory Database: For understøttede økosystemer offentliggør GitHub din advisory der, i OSV-format, og kan bruge den til at sende Dependabot-advarsler til repositories, der afhænger af din pakke.
Slå private vulnerability reporting til
Ejere og administratorer af et offentligt repository kan slå det til:
- Klik på Settings på repositoryets hovedside.
- Klik på Advanced Security i sidepanelets afsnit Security and quality.
- Klik på Enable ud for Private vulnerability reporting.
Link derefter til det fra din SECURITY.md og din disclosure-politik.
Opret en advisory som udkast
- Åbn fanen Security and quality på repositoryets hovedside.
- Klik i sidepanelet under Reporting på Advisories og derefter på New draft security advisory.
- Indtast en titel. Under CVE identifier indtaster du et eksisterende CVE-id eller vælger at anmode GitHub om et senere.
- Skriv beskrivelsen: sårbarheden, dens konsekvens, patches, workarounds og referencer.
- Under Affected products angiver du økosystem, pakkenavn, ramte versioner og patchede versioner. Tilføj et produkt for hver pakke.
- Angiv alvorligheden, eller vælg Assess severity using CVSS, og udfyld beregneren.
- Tilføj CWE'en under Weaknesses og rapportøren under Credits.
- Klik på Create draft security advisory.
Udkastet forbliver privat. Herfra kan du tilføje samarbejdspartnere, starte en midlertidig privat fork til at forberede rettelsen og drøfte detaljerne med rapportøren.
Anmod om en CVE, og offentliggør
- Åbn udkastet fra Security and quality og derefter Advisories.
- Klik på Request CVE nederst i formularen. En CVE-anmodning gør ikke advisoryen offentlig, og GitHub oplyser, at den som regel behandler anmodninger inden for 72 timer, så anmod i god tid.
- Udgiv de rettede versioner, og sørg for, at advisoryen nævner dem som patchede versioner.
- Klik på Publish advisory. Den midlertidige private fork slettes, GitHub offentliggør CVE-detaljerne, og for understøttede økosystemer når advisoryen ud i GitHub Advisory Database. Dependabot-advarsler kan tage op til 72 timer.
Offentliggør du uden en patchet version, advarer GitHub om, at Dependabot advarer brugerne uden at foreslå en sikker version. GitHubs advisory-database understøtter både CVSS 3.1 og 4.0. Trinene følger GitHub Docs pr. november 2026; etiketterne i GitHubs brugerflade ændres fra tid til anden.
GitHub-advisories passer til open source-pakker i de økosystemer, GitHub understøtter. For firmware, appliances eller closed source-produkter offentliggør du på dit eget websted, i CSAF hvor kunderne forventer det, og får CVE'en fra din egen CNA eller en, hvis område dækker dig.
Hvornår du skal offentliggøre: timing og embargo
Embargoen, perioden mellem den private rapport og offentliggørelsen, og hvor længe den skal vare, hører hjemme i din disclosure-politik. Advisoryens opgave er at lande på det rigtige tidspunkt inden for den. En typisk offentliggørelsesdag forløber sådan:
- Før dagen: Rettelserne er klar på hver understøttet gren, CVE-id'et er reserveret, og advisoryen og alle maskinlæsbare versioner er skrevet og gennemgået.
- Forhåndsbesked, hvis du giver den: Store kunder, downstream-leverandører, der indbygger dit produkt, og koordinatorer får advisoryen under embargo nogle dage før, så de er klar til at svare deres egne kunder.
- Release: De rettede versioner udkommer.
- Offentliggørelse: Advisory-siden, CVE-posten, CSAF- eller OSV-dokumenterne og feed-posten går live samtidig, helst inden for samme time som releasen.
- Underretning: mailingliste og direkte besked til ramte kunder.
Rækkefølgen betyder noget. Udgiver du rettelsen før advisoryen, kan angribere diffe releasen, mens forsvarerne ikke ved, at de skal opgradere. At offentliggøre advisoryen uden en rettelse er kun rigtigt, når sårbarheden allerede er offentlig eller udnyttes: Offentliggør så det, du ved, med afbødende foranstaltninger, og opdater advisoryen, når rettelsen udkommer.
Under Cyber Resilience Act udløser en aktivt udnyttet sårbarhed også en separat pligt til at rapportere til myndighederne: en tidlig varsling inden for 24 timer via Single Reporting Platform, derefter en underretning og en endelig rapport. Det er ikke din advisory, og det er ikke offentligt. CRA's bilag I kræver også, at producenter offentliggør oplysninger om rettede sårbarheder, når en sikkerhedsopdatering er tilgængelig, og det er netop det, en advisory gør. Se hvad CRA kræver.
Offentliggørelse: hvor advisories bor
-
En stabil side pr. advisory på en URL, der aldrig ændres, for eksempel
/security/advisories/exc-2026-007, plus en oversigtsside, der lister hver advisory med produkter, alvorlighed og datoer. - Et feed. Et RSS- eller Atom-feed af oversigten lader folk abonnere uden en mailingliste.
-
CSAF provider metadata, hvis du offentliggør CSAF: en
provider-metadata.json-fil og en mappe eller et ROLIE-feed med dokumenterne, så værktøjer finder hver advisory uden scraping. Se CSAF for roller og krav. -
En henvisning i security.txt. Feltet
Policylinker til din disclosure-politik, og CSAF-standarden definerer etCSAF-felt, der peger værktøjer til dine provider-metadata:
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
Slet aldrig en offentliggjort advisory. Viser den sig at være forkert, så offentliggør en revision, der siger, hvad der er ændret; var sårbarheden ikke reel, så markér advisoryen som trukket tilbage, og forklar hvorfor.
Underretning af kunder
At offentliggøre er ikke det samme som at blive læst. Kunder, der ikke abonnerer på dit feed, ser ikke advisoryen, før deres scanner markerer CVE'en, eller før nogen spørger dem om den. For advisories med høj og kritisk alvorlighed:
- Send e-mail til de kunder, der kører ramte versioner, ikke hele din liste, med linket til advisoryen og den ene handling, de skal udføre.
- Brief dine support- og salgsteams før offentliggørelsen, med advisoryen og en kort FAQ, så deres svar stemmer overens med den.
- Giv besked til downstream-leverandører, der indbygger dit produkt, så deres egne advisories kan følge hurtigt efter.
- Følg op med kunder, der bliver på ramte versioner.
At sende e-mail kun til de ramte kunder kræver, at du ved, hvilke produktversioner hver enkelt kører. For en sårbarhed i en tredjepartskomponent, der ramte mange leverandører på én gang, se sådan svarer du kunderne efter et forsyningskædeangreb, med skabeloner.
Bør du blive CNA?
En CVE Numbering Authority (CNA) tildeler CVE-id'er og offentliggør CVE-poster for sårbarheder inden for et aftalt område, typisk egne produkter. Som CNA bestemmer du, hvornår CVE-posten dukker op, du kan tildele id'er uden at dele detaljer under embargo med en anden CNA, og du skriver selv posten.
Ifølge CVE-programmet er der hverken gebyr eller kontrakt. En CNA skal have en offentlig politik for offentliggørelse af sårbarheder, en offentlig kilde til nye offentliggørelser af sårbarheder (din advisory-side) og acceptere programmets brugsvilkår. Onboardingen foregår via en registreringsformular, en introduktionssession og øvelseseksempler. I EU fungerer ENISA som Root for organisationer inden for sit område, herunder teknologileverandører og open source-projekter.
- Det passer til en leverandør, der jævnligt offentliggør CVE'er for egne produkter, allerede har et PSIRT og en advisory-side og vil have kontrol over timingen.
- Det behøver ikke være dit første skridt, hvis du offentliggør en håndfuld CVE'er om året, eller hvis dine produkter er open source-pakker på GitHub, hvor GitHub kan tildele id'erne som en del af advisoryen.
For CVE-id'er uden at være CNA, se koordineret offentliggørelse af sårbarheder.
Hvor CRACI passer ind: de ramte versioner
Det meste af en advisory er skrivearbejde. Det felt, der kræver dokumentation, er de ramte versioner, og for sårbarheder i tredjepartskomponenter er det også det sværeste at få rigtigt: hvilke af dine releases der leverede den sårbare version, også som transitiv afhængighed, og siden hvornår.
CRACI kører dine GitHub Actions-builds på sine egne runnere og registrerer de pakker, hvert job faktisk hentede, inklusive transitive afhængigheder og pakker gendannet fra CI-caches. Hver pakke viser sine advisories (CVE, GHSA og andre id'er) med alvorlighed. Build-historikken viser hvert tidligere build og dets SBOM, og hvilke builds der indeholdt en sårbar afhængighed, så du ved, i hvilken periode du var ramt, inden for din opbevaringsperiode (180 dage som standard, tilpasset på Enterprise). Sikkerhedsteams triagerer fundene og sender dem til de teams, der ejer rettelsen, og CRACI underretter de relevante personer om en sårbarhed og dens alvorlighed. Se sårbarhedssporing.
Når en aktivt udnyttet sårbarhed udløser CRA's rapporteringspligt, forbereder CRACI indholdet af underretningerne (tidlig varsling, underretning og endelig rapport); en person i din virksomhed indsender dem via Single Reporting Platform.
Når CRACI ikke er svaret
- At skrive og offentliggøre advisoryen. CRACI skriver og offentliggør ikke sikkerhedsadvisories, hverken i CSAF eller i noget andet format. Brug dit eget websted, GitHub Security Advisories eller et CSAF-værktøj til det.
- Modtagelse af rapporter. CRACI tager ikke imod sårbarhedsrapporter fra forskere eller kunder og sporer dem ikke som sager. Brug din disclosure-indbakke, GitHubs private vulnerability reporting eller et sagsstyringsværktøj.
- Sårbarheder i din egen kode. CRACI matcher advisories mod de pakker, dine builds hentede. En fejl som path traversal-fejlen i eksemplet, i din egen kode, kræver kodegennemgang for at finde ud af, hvornår den blev indført.
- Builds uden for GitHub Actions. CRACI understøtter GitHub Actions i dag; GitLab CI og Jenkins er på roadmappen.
- Releases, der er ældre end din opbevaringsperiode. Build-historikken dækker de builds, CRACI har registreret og opbevaret.
Sikkerhedsadvisories: ofte stillede spørgsmål
Hvad er en sikkerhedsadvisory?
En sikkerhedsadvisory er en meddelelse fra et produkts leverandør, der beskriver en sårbarhed i produktet: hvilke produkter og versioner der er ramt, hvor alvorlig den er, hvad en angriber kan gøre, og hvordan den rettes eller afbødes. Den har som regel et CVE-id og offentliggøres, når en rettelse er tilgængelig.
Hvad er forskellen på en sikkerhedsadvisory og en security bulletin?
En advisory dækker som regel én sårbarhed, eller nogle få relaterede, i detaljer. En bulletin samler mange rettelser for én release eller periode, ofte efter en fast plan; Android udgiver for eksempel sine security bulletins hver måned. Nogle leverandører bruger de to ord i flæng.
Hvad bør en sikkerhedsadvisory indeholde?
Et advisory-id og et CVE-id, en titel, ramte produkter og versioner som intervaller pr. gren, produkter, der er kontrolleret og ikke ramt, rettede versioner, alvorlighed med den fulde CVSS-vektor, CWE'en, en beskrivelse, konsekvensen og dens forudsætninger, workarounds, anerkendelse, en tidslinje, referencer og en revisionshistorik.
Hvordan opretter jeg en GitHub security advisory?
I et offentligt repository åbner du fanen Security and quality, klikker på Advisories under Reporting og derefter på New draft security advisory. Udfyld titel, beskrivelse, ramte produkter, alvorlighed, CWE og credits, og gem udkastet. Når rettelsen er udgivet, anmoder du om en CVE, hvis du har brug for en, og klikker på Publish advisory.
Kan GitHub tildele min advisory et CVE-id?
Ja, hvis dit projekt ikke er dækket af en anden CNA. GitHub er en CVE Numbering Authority. Anmod om CVE'en fra advisory-udkastet; anmodningen gør ikke advisoryen offentlig, og GitHub oplyser, at den som regel behandler anmodninger inden for 72 timer. GitHub offentliggør CVE-detaljerne, når advisoryen er offentlig.
Bør sikkerhedsadvisories være maskinlæsbare?
I stigende grad, ja. Offentliggør en webside til mennesker, og tilføj en maskinlæsbar version til kunder, der automatiserer: CSAF for produkter, der sælges til virksomheder og industri, OSV for open source-pakker og VEX til at angive, hvilke kendte sårbarheder der ikke påvirker dit produkt. Generér dem ud fra den samme registrering.
Hvornår bør en sikkerhedsadvisory offentliggøres?
Samtidig med de rettede versioner, efter en eventuel forhåndsbesked under embargo til nøglekunder og downstream-leverandører. Offentliggør kun tidligere, med afbødende foranstaltninger, hvis sårbarheden allerede er offentlig eller udnyttes, og opdater advisoryen, når rettelsen udkommer.
Skal jeg være CNA for at offentliggøre en sikkerhedsadvisory?
Nej. Alle kan offentliggøre en advisory. At være CVE Numbering Authority betyder kun, at du selv kan tildele CVE-id'er. Uden det kan en CNA, hvis område dækker dit produkt, GitHub for open source-projekter på GitHub eller en CNA of Last Resort tildele id'et.
Vid, hvilke releases du skal angive som ramt
En advisory er kun så præcis som dens ramte versioner. Book en demo, og se, hvilke af dine GitHub Actions-builds der indeholdt en sårbar pakke.
Book en demo