PSIRT
Bezpečnostní oznámení: jak ho napsat, se šablonou a praktickým příkladem
Bezpečnostní oznámení (security advisory) je dokument, podle kterého vaši zákazníci jednají, když zranitelnost zasáhne váš produkt. Dobré oznámení bez tiketu na podporu odpoví, zda se jich týká, jak vážně a co mají dělat. Tento průvodce pokrývá pole, kompletní příklad, strojově čitelné formáty, GitHub Security Advisories a to, kdy oznámení zveřejnit.
Aktualizováno
Co je bezpečnostní oznámení?
Bezpečnostní oznámení je zpráva od dodavatele produktu, která popisuje zranitelnost v něm: kterých produktů a verzí se týká, jak je závažná, co by útočník mohl udělat a jak ji uživatelé opraví nebo zmírní. Píše se pro lidi, kteří produkt provozují, a stále častěji i pro jejich nástroje.
Bezpečnostní oznámení jsou veřejným koncem koordinovaného zveřejňování zranitelností: nálezce zranitelnost nahlásí důvěrně, dodavatel ji opraví a z oznámení se o ní dozví všichni ostatní. Ve většině softwarových firem a výrobců zařízení je píše PSIRT jako součást širšího programu bezpečnosti produktů.
Bezpečnostní oznámení vs bezpečnostní bulletin, záznam CVE, VEX a poznámky k vydání
Tyto dokumenty se překrývají a týmy si je často pletou:
| Dokument | Kdo ho zveřejňuje | Co pokrývá | Hlavní čtenář |
|---|---|---|---|
| Bezpečnostní oznámení | Dodavatel produktu nebo koordinátor | Jednu zranitelnost nebo několik souvisejících ve vašich produktech: dotčené verze, závažnost, opravu | Provozovatelé a bezpečnostní týmy zákazníků |
| Bezpečnostní bulletin | Dodavatel, často podle pevného harmonogramu | Souhrn mnoha oprav v jednom vydání nebo období. Bezpečnostní bulletiny Androidu například vycházejí první pondělí každého měsíce. | Týmy, které záplatují v cyklech |
| Záznam CVE | CVE Numbering Authority (CNA) | Globální identifikátor a minimální popis jedné zranitelnosti: dotčený produkt, typ problému, popis a alespoň jeden veřejný odkaz | Databáze zranitelností a skenery |
| Prohlášení VEX | Dodavatel | Strojově čitelný stav pro každý produkt a zranitelnost: zasažen, nezasažen, opraveno, v šetření | Skenery zákazníků |
| Poznámky k vydání | Dodavatel | Vše, co se ve vydání změnilo, bezpečnostní opravy mezi ostatními změnami | Každý, kdo aktualizuje |
Obvyklý vzor: jedno oznámení na zranitelnost s CVE ID, které ho propojuje se záznamem CVE, s odkazem z poznámek k vydání každé opravené verze a z bulletinu, pokud ho vydáváte. „Bezpečnostní bulletin“ a „bezpečnostní oznámení“ se někdy používají jako synonyma; podstatné je, aby každá zranitelnost měla stálou stránku, na kterou se zákazníci mohou odkazovat.
Co by mělo bezpečnostní oznámení obsahovat
Níže uvedená pole jsou to, co zákazníci hledají, a odpovídají jedna ku jedné strojově čitelným formátům, o kterých je řeč dále v tomto průvodci. Pravidla CNA programu CVE stanovují minimum pro záznam CVE: alespoň jeden dotčený produkt a verzi, typ nebo příčinu zranitelnosti (nejlépe jako CWE), textový popis a veřejný odkaz. Užitečné oznámení jde dál.
| Pole | Co uvádí | Častá chyba |
|---|---|---|
| ID oznámení | Váš vlastní stálý identifikátor, například EXC-2026-007, plus CVE ID |
Používat jen CVE ID, které v den, kdy potřebujete zveřejnit, ještě nemusíte mít |
| Název | Produkt, typ zranitelnosti a dopad na jednom řádku | „Bezpečnostní aktualizace pro produkt X“, což neříká nic |
| Dotčené produkty a verze | Každý dotčený produkt a verze, jako rozsahy pro každou větev vydání | „Verze před 4.2.2“, což chybně zahrnuje větve, které chybu nikdy neměly |
| Nezasaženo | Produkty a verze, které jste prověřili a zjistili, že zasaženy nejsou | Vynechat to, takže každý zákazník se starší verzí otevře tiket |
| Opravené verze | První opravená verze v každé podporované větvi | Uvést jen nejnovější vydání |
| Závažnost | Hodnocení a úplný vektor CVSS s verzí CVSS | Holé skóre bez vektoru, které nikdo nemůže ověřit ani upravit pro své prostředí |
| Slabina | ID a název CWE | Vynechat ji; databáze i pravidla CVE ji očekávají |
| Popis | O jakou chybu jde a kde, dost podrobně na posouzení ohrožení, bez funkčního exploitu | Tak vágní, že zákazníci nepoznají, zda je jejich konfigurace ohrožena |
| Dopad | Co útočník získá a co k tomu nejdřív potřebuje (přístup, roli, pozici v síti) | Opakovat metriky CVSS slovy místo vysvětlení důsledků |
| Řešení a zmírnění | Co dělat, pokud dnes nemůžete aktualizovat, a jak zjistit, zda jste byli napadeni | „Žádná náhradní řešení“, i když by útok zablokovala změna konfigurace |
| Poděkování | Kdo zranitelnost našel a nahlásil, s jeho souhlasem | Uvést jméno člověka, který požádal o anonymitu |
| Časová osa | Nahlášeno, potvrzeno, opraveno, zveřejněno | Vynechat ji, takže dlouhá zpoždění vypadají jako zatajovaná |
| Odkazy | Záznam CVE, poznámky k vydání, commit s opravou, strojově čitelné verze | Odkazy na interní tikety, které zákazníci nemohou otevřít |
| Historie revizí | Každá změna po prvním zveřejnění, s datem a verzí | Tiše upravovat dotčené verze |
Nejtěžším polem jsou dotčené verze. Zranitelný kód byl v nějakém okamžiku zaveden a v jiném opraven a každá podporovaná větev má vlastní opravu. Pokud zranitelnost přišla přes komponentu třetí strany, otázka zní, která z vašich vydání dodala zranitelnou verzi této komponenty, přímo nebo jako tranzitivní závislost. Viz jak posoudit novou CVE napříč vašimi buildy.
Praktický příklad
Zde je kompletní oznámení pro smyšlený produkt: Example Gateway, samostatně hostovanou API bránu od Example Corp se dvěma podporovanými větvemi, 3.9 a 4.x. Zranitelný endpoint byl přidán ve verzi 3.9.0, takže 3.8 a starší zasaženy nejsou. Všechny názvy, ID a data jsou vymyšlené; skóre CVSS 4.0 je vypočteno z uvedeného vektoru. Příklad je v angličtině.
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
Toto oznámení funguje díky třem věcem:
- Rozsahy pro každou větev. „4.0.0 až 4.2.1“ a „3.9.0 až 3.9.6“ jsou přesné. „Před 4.2.2“ by každému zákazníkovi s verzí 3.8 řeklo, že je zasažen.
- Dopad uvádí předpoklad. Zákazník bez účtů s rolí viewer ví, že jeho skutečné ohrožení je nízké; zákazník se stovkami externistů v roli viewer ví, že nízké není.
- Řešení zahrnuje i následné kroky. Aktualizace díru uzavře, ale nevrátí zpět uniklé tajemství, takže oznámení říká, co je třeba vyměnit.
Šablona bezpečnostního oznámení ke zkopírování
Nahraďte části v hranatých závorkách. Oddíl smažte, jen pokud se opravdu netýká, a tam, kde ho zákazníci očekávají, to raději uveďte, než abyste ho nechali prázdný (například „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
Bezpečnostní oznámení čitelná pro lidi vs strojově čitelná
Pro lidi stačí webová stránka. Nestačí ale zákazníkovi s tisíci zařízení nebo stovkami služeb, jehož nástroje potřebují porovnat vaše oznámení s tím, co provozuje. To umějí tři rodiny formátů, které odpovídají na různé potřeby:
| Formát | Co to je | Kdy ho použít |
|---|---|---|
| Webová stránka (a PDF) | Oznámení tak, jak ho čtou lidé | Vždy. Všechny ostatní formáty na ni odkazují. |
| CSAF 2.0 | Standard OASIS pro bezpečnostní oznámení ve formátu JSON se stromem produktů, seznamy stavů produktů, nápravami, historií revizí a pravidly distribuce | Prodáváte produkty jako firmware, zařízení nebo podnikový software zákazníkům, kteří automatizují příjem bezpečnostních oznámení, často průmyslovým a podnikovým odběratelům |
| OSV | Formát Open Source Vulnerability: záznamy JSON pro balíčky v pojmenovaném ekosystému s rozsahy verzí. GitHub Advisory Database v něm zveřejňuje svá oznámení. | Dodáváte open source balíčky přes npm, PyPI, Maven, Go moduly a podobné ekosystémy |
| VEX (CSAF VEX, CycloneDX VEX, OpenVEX) | Prohlášení, že produkt je nebo není zasažen známou zranitelností, a proč | Zákazníci skenují vaši SBOM a ptají se na CVE v komponentách, které váš produkt nezasahují |
Praktický příklad se v CSAF 2.0 stane dokumentem csaf_security_advisory: ID oznámení patří do
document/tracking/id, historie revizí do document/tracking/revision_history, dotčené a
opravené verze do seznamů product_status u každé zranitelnosti, CWE do jejího objektu
cwe a řešení do remediations. Jeden háček: skóre v CSAF 2.0 přijímají jen CVSS v2 a
v3.x. Podpora CVSS v4.0 přichází s CSAF 2.1, který je stále ve fázi návrhu, takže oznámení v CSAF 2.0 buď nese
vektor CVSS 3.1, nebo uvádí vektor 4.0 v poznámce.
Totéž oznámení jako záznam OSV, pro týmy, které bránu dodávají také jako balíček npm (výňatek):
{
"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" }]
}
Všimněte si, že rozsah nese dva páry introduced–fixed.
Schéma OSV považuje verzi za zasaženou, pokud
spadá do kteréhokoli rozsahu nebo je uvedena v explicitním seznamu versions, a doporučuje
fixed místo last_affected, protože hranice last-affected může způsobit vynechané shody.
Rozhodovací pravidlo: vždy zveřejněte webovou stránku a CVE. Pokud dodáváte open source balíčky, přidejte OSV, obvykle zveřejněním přes GitHub. Přidejte CSAF, pokud prodáváte produkty organizacím, které žádají strojově čitelná oznámení, nebo působíte v režimu unijního Cyber Resilience Act, jehož čl. 14 odst. 8 vyžaduje při informování uživatelů o aktivně zneužívaných zranitelnostech tam, kde je to vhodné, strukturovaný, strojově čitelný formát. Přidejte VEX, jakmile vám zákazníci začnou posílat výstupy skenerů ke komponentám. Generujte všechny formáty z jednoho záznamu, aby si nikdy neodporovaly.
GitHub Security Advisories
Pokud je váš projekt veřejným repozitářem na GitHubu, repository security advisories GitHubu vám dají celý postup na jednom místě: soukromý koncept pro diskusi o zranitelnosti, dočasný soukromý fork pro opravu, žádost o CVE a zveřejnění. Do sebe zapadají čtyři části:
- Repository security advisories: koncepty a zveřejněná oznámení, která patří k vašemu repozitáři.
- Private vulnerability reporting: tlačítko „Report a vulnerability“ na stránce Advisories repozitáře, aby vám výzkumníci mohli hlásit soukromě místo otevření veřejného issue.
- CVE ID od GitHubu: GitHub je CNA a může vašemu oznámení přidělit CVE ID, pokud váš projekt nespadá pod jinou CNA.
- GitHub Advisory Database: u podporovaných ekosystémů tam GitHub vaše oznámení zveřejní ve formátu OSV a může ho použít k zasílání upozornění Dependabot repozitářům, které na vašem balíčku závisejí.
Zapněte private vulnerability reporting
Vlastníci a správci veřejného repozitáře ho mohou zapnout:
- Na hlavní stránce repozitáře klikněte na Settings.
- V oddílu Security and quality postranního panelu klikněte na Advanced Security.
- Klikněte na Enable vedle Private vulnerability reporting.
Pak na něj odkažte ze souboru SECURITY.md a ze své politiky zveřejňování.
Vytvořte koncept oznámení
- Na hlavní stránce repozitáře otevřete kartu Security and quality.
- V postranním panelu pod Reporting klikněte na Advisories a pak na New draft security advisory.
- Zadejte název. Pod CVE identifier zadejte existující CVE ID nebo zvolte, že si ho od GitHubu vyžádáte později.
- Napište popis: zranitelnost, její dopad, záplaty, náhradní řešení a odkazy.
- Pod Affected products nastavte ekosystém, název balíčku, dotčené verze a opravené verze. Pro každý balíček přidejte produkt.
- Nastavte závažnost nebo vyberte Assess severity using CVSS a vyplňte kalkulačku.
- Přidejte CWE pod Weaknesses a oznamovatele pod Credits.
- Klikněte na Create draft security advisory.
Koncept zůstává soukromý. Z něj můžete přidat spolupracovníky, založit dočasný soukromý fork pro přípravu opravy a probrat podrobnosti s oznamovatelem.
Vyžádejte si CVE a zveřejněte
- Otevřete koncept přes Security and quality a pak Advisories.
- Dole ve formuláři klikněte na Request CVE. Žádost o CVE oznámení nezveřejní a GitHub uvádí, že žádosti obvykle posoudí do 72 hodin, takže žádejte včas.
- Vydejte opravené verze a ujistěte se, že je oznámení uvádí jako opravené (patched) verze.
- Klikněte na Publish advisory. Dočasný soukromý fork se smaže, GitHub zveřejní podrobnosti CVE a u podporovaných ekosystémů se oznámení dostane do GitHub Advisory Database. Upozornění Dependabot mohou trvat až 72 hodin.
Pokud zveřejníte bez opravené verze, GitHub upozorní, že Dependabot bude uživatele varovat, aniž by navrhl bezpečnou verzi. Databáze oznámení GitHubu podporuje CVSS 3.1 i 4.0. Kroky odpovídají GitHub Docs k listopadu 2026; popisky v rozhraní GitHubu se čas od času mění.
Oznámení na GitHubu se hodí pro open source balíčky v ekosystémech, které GitHub podporuje. U firmwaru, zařízení nebo produktů s uzavřeným kódem zveřejňujte na vlastním webu, v CSAF tam, kde to zákazníci očekávají, a CVE získejte od vlastní CNA nebo od takové, do jejíhož rozsahu spadáte.
Kdy zveřejnit: načasování a embargo
Embargo, tedy období mezi důvěrným nahlášením a zveřejněním, a jeho délka patří do vaší politiky zveřejňování. Úkolem oznámení je přijít v rámci embarga ve správný okamžik. Typický den zveřejnění probíhá takto:
- Před tímto dnem: opravy jsou připravené v každé podporované větvi, CVE ID je rezervované a oznámení i všechny jeho strojově čitelné verze jsou napsané a zrevidované.
- Předběžné upozornění, pokud ho dáváte: velcí zákazníci, navazující dodavatelé, kteří váš produkt zabudovávají, a koordinátoři dostanou oznámení pod embargem o několik dní dříve, aby byli připraveni odpovídat vlastním zákazníkům.
- Vydání: opravené verze jdou ven.
- Zveřejnění: stránka oznámení, záznam CVE, dokumenty CSAF nebo OSV a položka v kanálu se zveřejní společně, ideálně během stejné hodiny jako vydání.
- Upozornění: e-mailová konference a přímá upozornění dotčeným zákazníkům.
Na pořadí záleží. Když nejdřív zveřejníte opravu bez oznámení, útočníci mohou vydání porovnat, zatímco obránci nevědí, že mají aktualizovat. Zveřejnit oznámení bez opravy je správné jen tehdy, když je zranitelnost už veřejná nebo zneužívaná: pak zveřejněte, co víte, se zmírňujícími opatřeními a oznámení aktualizujte, až oprava vyjde.
Podle Cyber Resilience Act spouští aktivně zneužívaná zranitelnost také samostatnou povinnost hlásit ji úřadům: včasné varování do 24 hodin prostřednictvím Single Reporting Platform, poté oznámení a závěrečnou zprávu. To není vaše bezpečnostní oznámení a není to veřejné. Příloha I CRA také žádá výrobce, aby po zpřístupnění bezpečnostní aktualizace veřejně zveřejnili informace o opravených zranitelnostech, což je přesně to, co dělá bezpečnostní oznámení. Viz co CRA vyžaduje.
Zveřejňování: kde bezpečnostní oznámení žijí
-
Stálá stránka pro každé oznámení na URL, která se nikdy nemění, například
/security/advisories/exc-2026-007, plus stránka s přehledem, která uvádí každé oznámení s jeho produkty, závažností a daty. - Kanál. Kanál RSS nebo Atom z přehledu umožní lidem odběr bez e-mailové konference.
-
Metadata poskytovatele CSAF, pokud zveřejňujete CSAF: soubor
provider-metadata.jsona adresář nebo kanál ROLIE s dokumenty, aby nástroje našly každé oznámení bez scrapování. Role a požadavky popisuje stránka CSAF. -
Odkaz v security.txt. Pole
Policyodkazuje na vaši politiku zveřejňování a standard CSAF definuje poleCSAF, které nástroje navede k vašim metadatům poskytovatele:
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
Zveřejněné oznámení nikdy nemažte. Pokud se ukáže, že je chybné, zveřejněte revizi, která uvádí, co se změnilo; pokud zranitelnost nebyla skutečná, označte oznámení jako stažené a uveďte proč.
Informování zákazníků
Zveřejnit neznamená, že si to někdo přečte. Zákazníci, kteří neodebírají váš kanál, oznámení neuvidí, dokud jejich skener neoznačí CVE nebo dokud se jich na ni někdo nezeptá. U oznámení s vysokou a kritickou závažností:
- Pošlete e-mail zákazníkům, kteří provozují dotčené verze, ne celému seznamu, s odkazem na oznámení a jedním krokem, který musí udělat.
- Informujte týmy podpory a obchodu před zveřejněním, s oznámením a krátkými FAQ, aby jejich odpovědi odpovídaly oznámení.
- Upozorněte navazující dodavatele, kteří váš produkt zabudovávají, aby mohla rychle následovat jejich vlastní oznámení.
- Ozvěte se znovu zákazníkům, kteří zůstávají na dotčených verzích.
Abyste mohli poslat e-mail jen dotčeným zákazníkům, musíte vědět, které verze produktu každý z nich provozuje. U zranitelnosti v komponentě třetí strany, která zasáhla mnoho dodavatelů najednou, viz jak odpovídat zákazníkům po útoku na dodavatelský řetězec, včetně šablon.
Měli byste se stát CNA?
CVE Numbering Authority (CNA) přiděluje CVE ID a zveřejňuje záznamy CVE pro zranitelnosti v dohodnutém rozsahu, obvykle ve vlastních produktech. Pokud se jí stanete, můžete řídit, kdy se záznam CVE objeví, přidělovat ID, aniž byste sdíleli podrobnosti pod embargem s jinou CNA, a psát záznam sami.
Podle programu CVE se neplatí žádný poplatek a neuzavírá žádná smlouva. CNA musí mít veřejnou politiku zveřejňování zranitelností, veřejný zdroj pro nová zveřejnění zranitelností (vaši stránku s oznámeními) a musí souhlasit s podmínkami používání programu. Zapojení probíhá přes registrační formulář, úvodní setkání a cvičné příklady. V EU působí ENISA jako Root pro organizace ve svém rozsahu, včetně technologických dodavatelů a open source projektů.
- Hodí se pro dodavatele, který pravidelně zveřejňuje CVE pro vlastní produkty, už provozuje PSIRT a stránku s oznámeními a chce mít kontrolu nad načasováním.
- Nemusí to být váš první krok, pokud zveřejňujete jen několik CVE ročně nebo pokud jsou vaše produkty open source balíčky na GitHubu, kde GitHub může ID přidělit v rámci oznámení.
CVE ID bez statusu CNA popisuje koordinované zveřejňování zranitelností.
Kde do toho zapadá CRACI: dotčené verze
Většina oznámení je psaní. Pole, které potřebuje důkazy, jsou dotčené verze, a u zranitelností v komponentách třetích stran je také nejtěžší ho vyplnit správně: která z vašich vydání dodala zranitelnou verzi, i jako tranzitivní závislost, a od kdy.
CRACI spouští vaše buildy GitHub Actions na vlastních runnerech a zaznamenává balíčky, které každý job skutečně stáhl, včetně tranzitivních závislostí a balíčků obnovených z cache CI. Každý balíček zobrazuje svá bezpečnostní oznámení (CVE, GHSA a další ID) se závažností. Historie buildů ukazuje každý dřívější build a jeho SBOM a které buildy obsahovaly zranitelnou závislost, takže znáte období, kdy jste byli zasaženi, v rámci doby uchovávání dat (ve výchozím nastavení 180 dní, v plánu Enterprise vlastní). Bezpečnostní týmy provádějí triáž nálezů a posílají je týmům, které vlastní opravu, a CRACI upozorňuje příslušné lidi na zranitelnost a její závažnost. Viz sledování zranitelností.
Když aktivně zneužívaná zranitelnost spustí oznamovací povinnost podle CRA, CRACI připraví obsah oznámení (včasné varování, oznámení a závěrečná zpráva); podává je člověk ve vaší firmě prostřednictvím Single Reporting Platform.
Kdy CRACI není odpověď
- Psaní a zveřejňování oznámení. CRACI nepíše ani nezveřejňuje bezpečnostní oznámení, v CSAF ani v žádném jiném formátu. K tomu použijte vlastní web, GitHub Security Advisories nebo nástroj pro CSAF.
- Příjem hlášení. CRACI nepřijímá hlášení o zranitelnostech od výzkumníků ani zákazníků a nesleduje je jako případy. Použijte svou schránku pro zveřejňování, GitHub private vulnerability reporting nebo nástroj pro správu případů.
- Zranitelnosti ve vlastním kódu. CRACI porovnává bezpečnostní oznámení s balíčky, které vaše buildy stáhly. U chyby ve vlastním kódu, jako je path traversal z příkladu, je k zjištění, kdy byla zavedena, potřeba revize kódu.
- Buildy mimo GitHub Actions. CRACI dnes podporuje GitHub Actions; GitLab CI a Jenkins jsou v plánu vývoje.
- Vydání starší než doba uchovávání dat. Historie buildů pokrývá buildy, které CRACI zaznamenal a uchoval.
Bezpečnostní oznámení: často kladené otázky
Co je bezpečnostní oznámení?
Bezpečnostní oznámení je zpráva od dodavatele produktu, která popisuje zranitelnost v produktu: kterých produktů a verzí se týká, jak je závažná, co by útočník mohl udělat a jak ji opravit nebo zmírnit. Obvykle nese CVE ID a zveřejňuje se, jakmile je k dispozici oprava.
Jaký je rozdíl mezi bezpečnostním oznámením a bezpečnostním bulletinem?
Oznámení obvykle podrobně pokrývá jednu zranitelnost nebo několik souvisejících. Bulletin shrnuje mnoho oprav pro jedno vydání nebo období, často podle pevného harmonogramu; Android například vydává své bezpečnostní bulletiny měsíčně. Někteří dodavatelé tato dvě slova používají zaměnitelně.
Co by mělo bezpečnostní oznámení obsahovat?
ID oznámení a CVE ID, název, dotčené produkty a verze jako rozsahy pro každou větev, prověřené nezasažené produkty, opravené verze, závažnost s úplným vektorem CVSS, CWE, popis, dopad a jeho předpoklady, náhradní řešení, poděkování, časovou osu, odkazy a historii revizí.
Jak vytvořím bezpečnostní oznámení na GitHubu?
Ve veřejném repozitáři otevřete kartu Security and quality, pod Reporting klikněte na Advisories a pak na New draft security advisory. Vyplňte název, popis, dotčené produkty, závažnost, CWE a poděkování a koncept uložte. Až bude oprava vydána, vyžádejte si CVE, pokud ho potřebujete, a klikněte na Publish advisory.
Může GitHub mému oznámení přidělit CVE ID?
Ano, pokud váš projekt nespadá pod jinou CNA. GitHub je CVE Numbering Authority. Vyžádejte si CVE z konceptu oznámení; žádost oznámení nezveřejní a GitHub uvádí, že žádosti obvykle posoudí do 72 hodin. Podrobnosti CVE GitHub zveřejní, jakmile je oznámení veřejné.
Měla by být bezpečnostní oznámení strojově čitelná?
Čím dál častěji ano. Zveřejněte webovou stránku pro lidi a přidejte strojově čitelnou verzi pro zákazníky, kteří automatizují: CSAF pro produkty prodávané podnikům a průmyslu, OSV pro open source balíčky a VEX, abyste uvedli, které známé zranitelnosti váš produkt nezasahují. Generujte je ze stejného záznamu.
Kdy by se mělo bezpečnostní oznámení zveřejnit?
Současně s opravenými verzemi, po případném předběžném upozornění klíčových zákazníků a navazujících dodavatelů pod embargem. Dříve, se zmírňujícími opatřeními, zveřejněte jen tehdy, když je zranitelnost už veřejná nebo zneužívaná, a oznámení aktualizujte, až oprava vyjde.
Musím být CNA, abych mohl zveřejnit bezpečnostní oznámení?
Ne. Oznámení může zveřejnit kdokoli. Být CVE Numbering Authority znamená jen to, že si CVE ID můžete přidělovat sami. Bez toho může ID přidělit CNA, do jejíhož rozsahu váš produkt spadá, GitHub u open source projektů na GitHubu nebo CNA of Last Resort.
Vězte, která vydání uvést jako dotčená
Oznámení je jen tak přesné jako jeho dotčené verze. Domluvte si demo a podívejte se, které z vašich buildů GitHub Actions obsahovaly zranitelný balíček.
Rezervujte si demo