GitHub Advisory Database
GitHub Advisory Database je bezplatná veřejná databáze GitHubu s bezpečnostními oznámeními k open source balíčkům, každé s ID GHSA. Jsou to data, ze kterých vycházejí upozornění Dependabot.
Poslední aktualizace: 13. listopadu 2026
GitHub Advisory Database je veřejná databáze bezpečnostních oznámení k open source softwaru, kterou lze procházet na github.com/advisories. Každé oznámení dostane ID GHSA, uvádí dotčený balíček a rozsahy verzí a, pokud existuje, první opravenou verzi. Dependabot podle ní rozhoduje, na které z vašich závislostí vás upozorní. Data jsou zveřejněna pod licencí CC-BY 4.0 v repozitáři github/advisory-database, jeden soubor na oznámení ve formátu OSV.
Tři druhy oznámení
Dokumentace GitHubu dělí databázi na tři druhy:
| Druh | Odkud pochází | Kontroluje GitHub | Upozornění Dependabot |
|---|---|---|---|
| Revidovaná (reviewed) | Správci, NVD a další zdroje, přiřazená k balíčku | Ano, platnost a úplnost | Ano |
| Nerevidovaná (unreviewed) | Zveřejňována automaticky z kanálu NVD | Ne | Ne |
| Malware | Bezpečnostní tým npm a OpenSSF Malicious Packages | Nepoužije se; neexistuje bezpečná verze | Ano, pokud jsou zapnutá upozornění na malware |
Pro skenování závislostí je užitečné revidované oznámení: kurátor GitHubu ho přiřadil k balíčku v podporovaném ekosystému s dotčenými rozsahy a opravenou verzí. Nerevidované oznámení je často CVE, které zatím nebylo přiřazeno k žádnému balíčku, takže nástroje, které spoléhají na párování balíčků, s ním nemohou nic dělat.
Kromě oznámení hlášených přes GitHub a NVD patří mezi zdroje npm, FriendsOfPHP, databáze zranitelností Go, Python Packaging Advisory database, Ruby Advisory database, RustSec a příspěvky komunity.
ID GHSA
ID GHSA má tvar GHSA-xxxx-xxxx-xxxx, tři skupiny po čtyřech znacích ze sady 23456789cfghjmpqrvwx, například GHSA-jfh8-c2jp-5v3q pro Log4Shell. Na rozdíl od ID CVE nenese rok. Většina revidovaných oznámení má také CVE ID, ale ne všechna: GHSA lze zveřejnit pro zranitelnost balíčku, která nikdy CVE nedostane, a oznámení o malwaru obvykle žádné nemají.
Ekosystémy
Revidovaná oznámení pokrývají 12 ekosystémů: Composer, Erlang, Go, GitHub Actions, Maven, npm, NuGet, pip, Pub, RubyGems, Rust a Swift. Zranitelnost v knihovně C, kterou vendorujete, v balíčku Debianu nebo v komponentě firmwaru stojí mimo ně; pro ty se podívejte do trackerů distribucí a do NVD.
Závažnost a skóre
Každé oznámení nese závažnost low, moderate, high nebo critical, založenou na vektoru CVSS 3.1 nebo 4.0 (importovaná CVE mohou používat 3.0). GitHub zobrazuje také skóre EPSS od FIRST, synchronizované denně, které odhaduje pravděpodobnost zneužití v příštích 30 dnech (EPSS).
Jak správce zveřejní GHSA
- Výzkumník zranitelnost nahlásí důvěrně, buď přes private vulnerability reporting, pokud ho má repozitář zapnutý, čímž vznikne navrhované oznámení, nebo přes kontakt v bezpečnostní politice projektu.
- Správce otevře koncept repository security advisory, důvěrně ho prodiskutuje a opraví v dočasném soukromém forku.
- Kdokoli s administrátorskými oprávněními k oznámení si může vyžádat CVE ID. GitHub je CVE Numbering Authority a obvykle odpoví zhruba do tří dnů, pokud projekt nepokrývá jiná CNA.
- Po vydání záplaty správce oznámení zveřejní.
- GitHub ho zreviduje, což může trvat až tři dny. Revidovaná oznámení se přidají do GitHub Advisory Database a mohou spustit upozornění Dependabot pro každý repozitář, který závisí na dotčené verzi.
Opravu existujícího oznámení může kdokoli navrhnout z jeho stránky nebo pull requestem do repozitáře; o jejím začlenění rozhoduje kurátorský tým GitHubu.
GitHub Advisory Database vs OSV vs NVD
| Databáze | Provozuje | Klíčováno podle | Rozsah |
|---|---|---|---|
| GitHub Advisory Database | GitHub | Ekosystému a balíčku | 12 ekosystémů balíčků plus nerevidovaná CVE z NVD |
| OSV.dev | Google, OpenSSF | Ekosystému a balíčku, Git | Agreguje GHSA a mnoho dalších databází |
| NVD | NIST | Názvů CPE | Každé zveřejněné CVE, jakýkoli druh produktu |
OSV.dev importuje GitHub Advisory Database, takže se tam GHSA objeví pod stejným ID. Co dodavatel zveřejňuje pro vlastní produkty, popisuje bezpečnostní oznámení; strojově čitelným formátem pro to je CSAF.
Jak s tím souvisí CRACI
CRACI zobrazuje u komponent zaznamenaných v každém buildu bezpečnostní oznámení každého balíčku s jejich ID CVE, GHSA a dalšími a se závažností a jeho historie buildů ukazuje, které dřívější buildy obsahovaly zranitelnou závislost. Viz SBOM z doby buildu.