PSIRT
Säkerhetsmeddelande: så skriver du ett, med en mall och ett genomarbetat exempel
Ett säkerhetsmeddelande (security advisory) är dokumentet som dina kunder agerar på när en sårbarhet påverkar din produkt. Ett bra meddelande svarar, utan att någon behöver öppna ett supportärende, på om de påverkas, hur allvarligt det är och vad de ska göra. Den här guiden går igenom fälten, ett komplett exempel, de maskinläsbara formaten, GitHub Security Advisories och när du ska publicera.
Uppdaterad
Vad är ett säkerhetsmeddelande?
Ett säkerhetsmeddelande är ett meddelande från leverantören av en produkt som beskriver en sårbarhet i den: vilka produkter och versioner som påverkas, hur allvarlig den är, vad en angripare skulle kunna göra och hur användarna åtgärdar eller begränsar den. Det skrivs för dem som kör produkten, och i allt högre grad även för deras verktyg.
Säkerhetsmeddelanden är den offentliga änden av samordnat offentliggörande av sårbarheter: upphittaren rapporterar i förtroende, leverantören åtgärdar, och säkerhetsmeddelandet är hur alla andra får veta. I de flesta programvaru- och enhetsföretag skrivs de av PSIRT, som en del av ett bredare produktsäkerhetsprogram.
Säkerhetsmeddelande vs säkerhetsbulletin, CVE-post, VEX och release notes
De här dokumenten överlappar, och team blandar ofta ihop dem:
| Dokument | Vem som publicerar det | Vad det omfattar | Huvudsaklig läsare |
|---|---|---|---|
| Säkerhetsmeddelande | Produktens leverantör, eller en samordnare | En sårbarhet, eller några relaterade, i dina produkter: berörda versioner, allvarlighetsgrad, rättning | Kundernas driftpersonal och säkerhetsteam |
| Säkerhetsbulletin | Leverantören, ofta enligt ett fast schema | En sammanställning av många rättningar i en release eller under en period. Androids säkerhetsbulletiner kommer till exempel ut den första måndagen varje månad. | Team som patchar i cykler |
| CVE-post | En CVE Numbering Authority (CNA) | Den globala identifieraren och en minimal beskrivning av en sårbarhet: berörd produkt, problemtyp, beskrivning och minst en offentlig referens | Sårbarhetsdatabaser och skannrar |
| VEX-uttalande | Leverantören | En maskinläsbar status per produkt och sårbarhet: påverkad, inte påverkad, åtgärdad, under utredning | Kundernas skannrar |
| Release notes | Leverantören | Allt som ändrats i en release, säkerhetsrättningar bland andra ändringar | Alla som uppgraderar |
Det vanliga mönstret: ett säkerhetsmeddelande per sårbarhet, med ett CVE-id som kopplar det till CVE-posten, länkat från release notes för varje åtgärdad version och från bulletinen om du publicerar en. "Säkerhetsbulletin" och "säkerhetsmeddelande" används ibland som synonymer; det viktiga är att varje sårbarhet har en stabil sida som kunderna kan hänvisa till.
Vad ett säkerhetsmeddelande bör innehålla
Fälten nedan är det som kunderna letar efter, och de motsvarar ett till ett de maskinläsbara formaten längre fram i guiden. CVE-programmets CNA-regler sätter golvet för CVE-posten: minst en berörd produkt och version, sårbarhetens typ eller orsak (helst som en CWE), en beskrivning i löptext och en offentlig referens. Ett användbart säkerhetsmeddelande går längre.
| Fält | Vad det anger | Vanligt misstag |
|---|---|---|
| Meddelande-id | Din egen stabila identifierare, till exempel EXC-2026-007, plus CVE-id:t |
Att bara använda CVE-id:t, som du kanske inte har ännu den dag du behöver publicera |
| Rubrik | Produkt, sårbarhetstyp och konsekvens på en rad | "Säkerhetsuppdatering för Produkt X", som inte säger något |
| Berörda produkter och versioner | Varje berörd produkt och version, som intervall per releasegren | "Versioner före 4.2.2", som felaktigt inkluderar grenar som aldrig hade buggen |
| Inte påverkade | Produkter och versioner som du har kontrollerat och funnit opåverkade | Att utelämna det, så att varje kund på en äldre version öppnar ett ärende |
| Åtgärdade versioner | Den första åtgärdade versionen på varje gren med support | Att bara nämna den senaste releasen |
| Allvarlighetsgrad | En gradering och hela CVSS-vektorn, med CVSS-versionen | En naken poäng utan vektor, som ingen kan kontrollera eller anpassa till sin miljö |
| Svaghet | CWE-id och namn | Att utelämna den; databaserna och CVE-reglerna förväntar sig den |
| Beskrivning | Vad felet är och var, tillräckligt detaljerat för att bedöma exponeringen, utan en fungerande exploit | Så vag att kunderna inte kan avgöra om deras konfiguration är exponerad |
| Konsekvens | Vad en angripare vinner, och vad hen behöver först (åtkomst, roll, position i nätverket) | Att upprepa CVSS-måtten i ord i stället för att förklara konsekvenserna |
| Tillfälliga lösningar och begränsningar | Vad du gör om du inte kan uppgradera i dag, och hur du kontrollerar om du har blivit angripen | "Inga tillfälliga lösningar" när en konfigurationsändring skulle stoppa attacken |
| Erkännanden | Vem som hittade och rapporterade sårbarheten, med personens samtycke | Att ge erkännande till någon som bett om att få vara anonym |
| Tidslinje | Rapporterad, bekräftad, åtgärdad, publicerad | Att utelämna den, vilket får långa förseningar att se dolda ut |
| Referenser | CVE-post, release notes, commit med rättningen, maskinläsbara versioner | Länkar till interna ärenden som kunderna inte kan öppna |
| Revisionshistorik | Varje ändring efter första publiceringen, med datum och version | Att i tysthet ändra de berörda versionerna |
Det svåraste fältet är de berörda versionerna. Den sårbara koden infördes vid en viss tidpunkt och åtgärdades vid en annan, och varje gren med support har sin egen rättning. Om sårbarheten kom in via en tredjepartskomponent blir frågan vilka av dina releaser som levererade den sårbara versionen av komponenten, direkt eller som ett transitivt beroende. Se hur du bedömer en ny CVE i alla dina byggen.
Ett genomarbetat exempel
Här är ett komplett säkerhetsmeddelande för en fiktiv produkt: Example Gateway, en självhostad API-gateway från Example Corp, med två grenar med support, 3.9 och 4.x. Den sårbara slutpunkten lades till i 3.9.0, så 3.8 och tidigare påverkas inte. Alla namn, id:n och datum är påhittade; CVSS 4.0-poängen är beräknad från vektorn som visas.
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 saker gör att det här säkerhetsmeddelandet fungerar:
- Intervall per gren. "4.0.0 till 4.2.1" och "3.9.0 till 3.9.6" är exakta. "Före 4.2.2" hade sagt till varje 3.8-kund att de var påverkade.
- Konsekvensen anger förutsättningen. En kund utan viewer-konton vet att den verkliga exponeringen är låg; en med hundratals konsulter i viewer-rollen vet att den inte är det.
- Den tillfälliga lösningen inkluderar uppföljningen. En uppgradering täpper till hålet men gör inte en läckt hemlighet ogjord, så säkerhetsmeddelandet säger vad som ska roteras.
En mall för säkerhetsmeddelanden som du kan kopiera
Ersätt delarna inom hakparentes. Ta bara bort ett avsnitt om det verkligen inte är tillämpligt, och säg hellre det än att lämna det tomt där kunderna förväntar sig det (till exempel "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
Människoläsbara vs maskinläsbara säkerhetsmeddelanden
En webbsida räcker för människor. Den räcker inte för en kund med tusentals enheter eller hundratals tjänster, vars verktyg behöver matcha ditt säkerhetsmeddelande mot det de kör. Tre familjer av format gör det, och de svarar mot olika behov:
| Format | Vad det är | Använd det när |
|---|---|---|
| Webbsida (och PDF) | Säkerhetsmeddelandet som människor läser det | Alltid. Alla andra format länkar tillbaka till det. |
| CSAF 2.0 | OASIS-standarden för säkerhetsmeddelanden som JSON, med ett produktträd, listor med produktstatus, åtgärder, en revisionshistorik och regler för distribution | Du säljer produkter som firmware, appliances eller företagsprogramvara till kunder som automatiserar mottagningen av säkerhetsmeddelanden, ofta industri- och företagskunder |
| OSV | Formatet Open Source Vulnerability: JSON-poster för paket i ett namngivet ekosystem, med versionsintervall. GitHub Advisory Database publicerar sina säkerhetsmeddelanden i det. | Du levererar paket med öppen källkod via npm, PyPI, Maven, Go-moduler och liknande ekosystem |
| VEX (CSAF VEX, CycloneDX VEX, OpenVEX) | Uttalanden om att en produkt påverkas eller inte påverkas av en känd sårbarhet, och varför | Kunderna skannar din SBOM och frågar om CVE:er i komponenter som inte påverkar din produkt |
I CSAF 2.0 blir det genomarbetade exemplet ett csaf_security_advisory-dokument: meddelande-id:t hamnar i
document/tracking/id, revisionshistoriken i document/tracking/revision_history, de
berörda och åtgärdade versionerna i varje sårbarhets product_status-listor, CWE:n i dess
cwe-objekt och de tillfälliga lösningarna i remediations. En hake: poäng i CSAF 2.0 tar
bara CVSS v2 och v3.x. Stöd för CVSS v4.0 kommer med CSAF 2.1, som fortfarande är ett utkast, så ett CSAF
2.0-meddelande har antingen en CVSS 3.1-vektor eller anger 4.0-vektorn i en anteckning.
Samma säkerhetsmeddelande som en OSV-post, för team som också levererar gatewayen som ett npm-paket (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" }]
}
Lägg märke till att intervallet har två par av introduced och fixed.
OSV-schemat behandlar en version som påverkad om
den ligger inom något intervall eller finns i den uttryckliga listan versions, och rekommenderar
fixed framför last_affected eftersom en last-affected-gräns kan leda till missade
träffar.
Beslutsregel: publicera alltid webbsidan och en CVE. Lägg till OSV, oftast genom att publicera via GitHub, om du levererar paket med öppen källkod. Lägg till CSAF om du säljer produkter till organisationer som efterfrågar maskinläsbara säkerhetsmeddelanden eller omfattas av EU:s Cyber Resilience Act, vars artikel 14.8 kräver ett strukturerat, maskinläsbart format där det är lämpligt när användare informeras om aktivt utnyttjade sårbarheter. Lägg till VEX när kunderna börjar skicka dig skannerutdata om dina komponenter. Generera alla format från ett och samma register så att de aldrig säger emot varandra.
GitHub Security Advisories
Om ditt projekt är ett publikt repository på GitHub ger GitHubs repository security advisories dig hela flödet på ett ställe: ett privat utkast för att diskutera sårbarheten, en tillfällig privat fork för att åtgärda den, en CVE-förfrågan och publicering. Fyra delar hänger ihop:
- Repository security advisories: utkast och publicerade säkerhetsmeddelanden som hör till ditt repository.
- Private vulnerability reporting: en knapp "Report a vulnerability" på repositoryts Advisories-sida, så att forskare kan rapportera till dig privat i stället för att öppna ett publikt issue.
- CVE-id:n från GitHub: GitHub är en CNA och kan tilldela ditt säkerhetsmeddelande ett CVE-id, såvida inte ditt projekt omfattas av en annan CNA.
- GitHub Advisory Database: för ekosystem som stöds publicerar GitHub ditt säkerhetsmeddelande där, i OSV-format, och kan använda det för att skicka Dependabot-varningar till repositories som är beroende av ditt paket.
Aktivera private vulnerability reporting
Ägare och administratörer av ett publikt repository kan aktivera det:
- Klicka på Settings på repositoryts huvudsida.
- I avsnittet Security and quality i sidofältet klickar du på Advanced Security.
- Klicka på Enable bredvid Private vulnerability reporting.
Länka sedan till det från din SECURITY.md och din policy för offentliggörande.
Skapa ett utkast till säkerhetsmeddelande
- Öppna fliken Security and quality på repositoryts huvudsida.
- I sidofältet, under Reporting, klickar du på Advisories och sedan på New draft security advisory.
- Ange en rubrik. Under CVE identifier anger du ett befintligt CVE-id eller väljer att begära ett från GitHub senare.
- Skriv beskrivningen: sårbarheten, dess konsekvens, patchar, tillfälliga lösningar och referenser.
- Under Affected products anger du ekosystem, paketnamn, berörda versioner och patchade versioner. Lägg till en produkt för varje paket.
- Ange allvarlighetsgraden, eller välj Assess severity using CVSS och fyll i kalkylatorn.
- Lägg till CWE:n under Weaknesses och rapportören under Credits.
- Klicka på Create draft security advisory.
Utkastet förblir privat. Därifrån kan du lägga till medarbetare, starta en tillfällig privat fork för att förbereda rättningen och diskutera detaljerna med rapportören.
Begär en CVE och publicera
- Öppna utkastet via Security and quality och sedan Advisories.
- Längst ned i formuläret klickar du på Request CVE. En CVE-förfrågan gör inte säkerhetsmeddelandet publikt, och GitHub uppger att förfrågningar oftast granskas inom 72 timmar, så begär tidigt.
- Släpp de åtgärdade versionerna och se till att säkerhetsmeddelandet anger dem som patchade versioner.
- Klicka på Publish advisory. Den tillfälliga privata forken raderas, GitHub publicerar CVE-uppgifterna, och för ekosystem som stöds hamnar säkerhetsmeddelandet i GitHub Advisory Database. Dependabot-varningar kan ta upp till 72 timmar.
Om du publicerar utan en patchad version varnar GitHub för att Dependabot då varnar användare utan att föreslå en säker version. GitHubs databas för säkerhetsmeddelanden stöder både CVSS 3.1 och 4.0. Stegen följer GitHub Docs per november 2026; etiketterna i GitHubs gränssnitt ändras då och då.
GitHubs säkerhetsmeddelanden passar paket med öppen källkod i de ekosystem som GitHub stöder. För firmware, appliances eller produkter med sluten källkod publicerar du på din egen webbplats, i CSAF där kunderna förväntar sig det, och får CVE:n från din egen CNA eller en vars område omfattar dig.
När du ska publicera: tidpunkt och embargo
Embargot, perioden mellan den privata rapporten och publiceringen, och hur länge det ska pågå hör hemma i din policy för offentliggörande. Säkerhetsmeddelandets uppgift är att landa vid rätt tidpunkt inom den. En typisk publiceringsdag ser ut så här:
- Före dagen: rättningarna är klara på varje gren med support, CVE-id:t är reserverat, och säkerhetsmeddelandet och alla maskinläsbara versioner är skrivna och granskade.
- Förhandsbesked, om du ger det: stora kunder, nedströmsleverantörer som bygger in din produkt och samordnare får säkerhetsmeddelandet under embargo några dagar i förväg, så att de är redo att svara sina egna kunder.
- Release: de åtgärdade versionerna släpps.
- Publicera: sidan med säkerhetsmeddelandet, CVE-posten, CSAF- eller OSV-dokumenten och posten i flödet publiceras samtidigt, helst inom samma timme som releasen.
- Informera: e-postlista och direkta meddelanden till berörda kunder.
Ordningen spelar roll. Om du publicerar rättningen först utan säkerhetsmeddelandet kan angripare jämföra releaserna medan försvararna inte vet att de ska uppgradera. Att publicera säkerhetsmeddelandet utan en rättning är rätt bara när sårbarheten redan är offentlig eller utnyttjas: publicera då det du vet med begränsningar, och uppdatera när rättningen levereras.
Enligt Cyber Resilience Act utlöser en aktivt utnyttjad sårbarhet också en separat skyldighet att rapportera till myndigheter: en tidig varning inom 24 timmar via Single Reporting Platform, därefter en anmälan och en slutrapport. Det är inte ditt säkerhetsmeddelande, och det är inte offentligt. Bilaga I till CRA kräver också att tillverkare offentliggör information om åtgärdade sårbarheter när en säkerhetsuppdatering finns tillgänglig, vilket är just vad ett säkerhetsmeddelande gör. Se vad CRA kräver.
Publicering: var säkerhetsmeddelanden finns
-
En stabil sida per säkerhetsmeddelande, på en URL som aldrig ändras, till exempel
/security/advisories/exc-2026-007, plus en indexsida som listar alla säkerhetsmeddelanden med produkter, allvarlighetsgrad och datum. - Ett flöde. Ett RSS- eller Atom-flöde av indexet låter folk prenumerera utan en e-postlista.
-
CSAF-providermetadata, om du publicerar CSAF: en
provider-metadata.json-fil och en katalog eller ett ROLIE-flöde med dokumenten, så att verktyg hittar varje säkerhetsmeddelande utan att skrapa. Se CSAF för roller och krav. -
En hänvisning i security.txt. Fältet
Policylänkar till din policy för offentliggörande, och CSAF-standarden definierar ettCSAF-fält som pekar verktygen till din providermetadata:
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
Radera aldrig ett publicerat säkerhetsmeddelande. Om det visar sig vara fel publicerar du en revision som säger vad som ändrats; om sårbarheten inte var verklig markerar du säkerhetsmeddelandet som återkallat och förklarar varför.
Informera kunderna
Att publicera är inte detsamma som att bli läst. Kunder som inte prenumererar på ditt flöde ser inte säkerhetsmeddelandet förrän deras skanner flaggar CVE:n, eller förrän någon frågar dem om den. För säkerhetsmeddelanden med hög och kritisk allvarlighetsgrad:
- Mejla kunderna som kör berörda versioner, inte hela din lista, med länken till säkerhetsmeddelandet och den enda åtgärd de behöver vidta.
- Informera dina support- och säljteam före publiceringen, med säkerhetsmeddelandet och en kort FAQ, så att deras svar stämmer med det.
- Informera nedströmsleverantörer som bygger in din produkt, så att deras egna säkerhetsmeddelanden kan följa snabbt.
- Följ upp med kunder som stannar kvar på berörda versioner.
För att bara mejla de berörda kunderna måste du veta vilka produktversioner var och en kör. För en sårbarhet i en tredjepartskomponent som drabbade många leverantörer samtidigt, se hur du svarar kunderna efter en attack mot leveranskedjan, som innehåller mallar.
Bör du bli CNA?
En CVE Numbering Authority (CNA) tilldelar CVE-id:n och publicerar CVE-poster för sårbarheter inom ett överenskommet område, oftast de egna produkterna. Som CNA bestämmer du själv när CVE-posten dyker upp, tilldelar id:n utan att dela embargouppgifter med en annan CNA och skriver posten själv.
Enligt CVE-programmet finns det ingen avgift och inget avtal. En CNA måste ha en offentlig policy för offentliggörande av sårbarheter, en offentlig källa för nya offentliggöranden av sårbarheter (din sida med säkerhetsmeddelanden) och godkänna programmets användarvillkor. Introduktionen sker via ett registreringsformulär, ett introduktionsmöte och övningsexempel. I EU fungerar ENISA som Root för organisationer inom sitt område, inklusive teknikleverantörer och projekt med öppen källkod.
- Det passar en leverantör som regelbundet publicerar CVE:er för sina egna produkter, redan driver ett PSIRT och en sida med säkerhetsmeddelanden och vill ha kontroll över tidpunkten.
- Det behöver inte vara ditt första steg om du publicerar en handfull CVE:er per år, eller om dina produkter är paket med öppen källkod på GitHub, där GitHub kan tilldela id:n som en del av säkerhetsmeddelandet.
För CVE-id:n utan att vara CNA, se samordnat offentliggörande av sårbarheter.
Var CRACI passar in: de berörda versionerna
Det mesta av ett säkerhetsmeddelande är skrivande. Fältet som kräver underlag är de berörda versionerna, och för sårbarheter i tredjepartskomponenter är det också det svåraste att få rätt: vilka av dina releaser som levererade den sårbara versionen, även som ett transitivt beroende, och sedan när.
CRACI kör dina GitHub Actions-byggen på sina egna runners och registrerar paketen som varje jobb faktiskt hämtade, inklusive transitiva beroenden och paket som återställts från CI-cachar. Varje paket visar sina säkerhetsmeddelanden (CVE, GHSA och andra id:n) med allvarlighetsgrad. Bygghistoriken visar varje tidigare bygge och dess SBOM, och vilka byggen som innehöll ett sårbart beroende, så att du vet under vilken period du var påverkad, inom din lagringstid (180 dagar som standard, anpassad på Enterprise). Säkerhetsteam triagerar fynden och skickar dem till teamen som äger rättningen, och CRACI meddelar berörda personer om en sårbarhet och dess allvarlighetsgrad. Se sårbarhetsspårning.
När en aktivt utnyttjad sårbarhet utlöser CRA:s rapporteringsskyldighet förbereder CRACI innehållet i anmälningarna (tidig varning, anmälan och slutrapport); en person i ditt företag skickar in dem via Single Reporting Platform.
När CRACI inte är svaret
- Att skriva och publicera säkerhetsmeddelandet. CRACI skriver eller publicerar inte säkerhetsmeddelanden, varken i CSAF eller i något annat format. Använd din egen webbplats, GitHub Security Advisories eller ett CSAF-verktyg för det.
- Att ta emot rapporter. CRACI tar inte emot sårbarhetsrapporter från forskare eller kunder och spårar dem inte som ärenden. Använd din inkorg för offentliggörande, GitHubs private vulnerability reporting eller ett ärendesystem.
- Sårbarheter i din egen kod. CRACI matchar säkerhetsmeddelanden mot paketen som dina byggen hämtade. Ett fel som path traversal-sårbarheten i exemplet, i din egen kod, kräver kodgranskning för att ta reda på när det infördes.
- Byggen utanför GitHub Actions. CRACI stöder GitHub Actions i dag; GitLab CI och Jenkins finns på roadmapen.
- Releaser som är äldre än din lagringstid. Bygghistoriken omfattar de byggen som CRACI har registrerat och sparat.
Säkerhetsmeddelanden: vanliga frågor
Vad är ett säkerhetsmeddelande?
Ett säkerhetsmeddelande (security advisory) är ett meddelande från en produkts leverantör som beskriver en sårbarhet i produkten: vilka produkter och versioner som påverkas, hur allvarlig den är, vad en angripare skulle kunna göra och hur den åtgärdas eller begränsas. Det har oftast ett CVE-id och publiceras när en rättning finns tillgänglig.
Vad är skillnaden mellan ett säkerhetsmeddelande och en säkerhetsbulletin?
Ett säkerhetsmeddelande omfattar oftast en sårbarhet, eller några relaterade, i detalj. En bulletin sammanställer många rättningar för en release eller en period, ofta enligt ett fast schema; Android publicerar till exempel sina säkerhetsbulletiner varje månad. Vissa leverantörer använder orden omväxlande.
Vad bör ett säkerhetsmeddelande innehålla?
Ett meddelande-id och ett CVE-id, en rubrik, berörda produkter och versioner som intervall per gren, kontrollerade produkter som inte påverkas, åtgärdade versioner, allvarlighetsgrad med hela CVSS-vektorn, CWE, en beskrivning, konsekvensen och dess förutsättningar, tillfälliga lösningar, erkännanden, en tidslinje, referenser och en revisionshistorik.
Hur skapar jag en GitHub security advisory?
I ett publikt repository öppnar du fliken Security and quality, klickar på Advisories under Reporting och sedan på New draft security advisory. Fyll i rubrik, beskrivning, berörda produkter, allvarlighetsgrad, CWE och erkännanden, och spara utkastet. När rättningen är släppt begär du en CVE om du behöver en och klickar på Publish advisory.
Kan GitHub tilldela mitt säkerhetsmeddelande ett CVE-id?
Ja, om ditt projekt inte omfattas av en annan CNA. GitHub är en CVE Numbering Authority. Begär CVE:n från utkastet till säkerhetsmeddelande; förfrågan gör inte säkerhetsmeddelandet publikt, och GitHub uppger att förfrågningar oftast granskas inom 72 timmar. GitHub publicerar CVE-uppgifterna när säkerhetsmeddelandet är publikt.
Bör säkerhetsmeddelanden vara maskinläsbara?
I allt högre grad, ja. Publicera en webbsida för människor och lägg till en maskinläsbar version för kunder som automatiserar: CSAF för produkter som säljs till företag och industri, OSV för paket med öppen källkod och VEX för att ange vilka kända sårbarheter som inte påverkar din produkt. Generera dem från samma register.
När bör ett säkerhetsmeddelande publiceras?
Samtidigt som de åtgärdade versionerna, efter eventuellt förhandsbesked under embargo till viktiga kunder och nedströmsleverantörer. Publicera tidigare, med begränsningar, bara om sårbarheten redan är offentlig eller utnyttjas, och uppdatera säkerhetsmeddelandet när rättningen levereras.
Måste jag vara CNA för att publicera ett säkerhetsmeddelande?
Nej. Vem som helst kan publicera ett säkerhetsmeddelande. Att vara CVE Numbering Authority betyder bara att du kan tilldela CVE-id:n själv. Utan det kan en CNA vars område omfattar din produkt, GitHub för projekt med öppen källkod på GitHub eller en CNA of Last Resort tilldela id:t.
Vet vilka releaser du ska ange som påverkade
Ett säkerhetsmeddelande är bara så korrekt som dess berörda versioner. Boka en demo och se vilka av dina GitHub Actions-byggen som innehöll ett sårbart paket.
Boka en demo