GitHub Advisory Database
GitHub Advisory Database to bezpłatna, publiczna baza biuletynów bezpieczeństwa GitHuba dla pakietów open source, z identyfikatorem GHSA dla każdego wpisu. Na jej danych opierają się alerty Dependabot.
Ostatnia aktualizacja: 13 listopada 2026
GitHub Advisory Database to publiczna baza biuletynów bezpieczeństwa dla oprogramowania open source, którą można przeglądać pod adresem github.com/advisories. Każdy biuletyn otrzymuje identyfikator GHSA, wskazuje podatny pakiet i zakresy wersji oraz, jeśli istnieje, pierwszą wersję z poprawką. Dependabot korzysta z niej, aby zdecydować, o których zależnościach wysłać alert. Dane są publikowane na licencji CC-BY 4.0 w repozytorium github/advisory-database, po jednym pliku na biuletyn w formacie OSV.
Trzy rodzaje biuletynów
Dokumentacja GitHuba dzieli bazę na trzy rodzaje:
| Rodzaj | Skąd pochodzi | Sprawdzany przez GitHub | Alerty Dependabot |
|---|---|---|---|
| Reviewed | Od opiekunów, z NVD i innych źródeł, przypisany do pakietu | Tak, pod kątem poprawności i kompletności | Tak |
| Unreviewed | Publikowany automatycznie z kanału NVD | Nie | Nie |
| Malware | Zespół bezpieczeństwa npm i OpenSSF Malicious Packages | Nie dotyczy; nie istnieje bezpieczna wersja | Tak, gdy alerty o malware są włączone |
Do skanowania zależności przydatny jest biuletyn reviewed: kurator GitHuba powiązał go z pakietem w obsługiwanym ekosystemie, z podatnymi zakresami i wersją z poprawką. Biuletyn unreviewed to często CVE, którego jeszcze nie przypisano do żadnego pakietu, więc narzędzia opierające się na dopasowaniu pakietów nie mogą na jego podstawie zadziałać.
Oprócz biuletynów zgłaszanych na GitHubie i NVD źródłami są m.in. npm, FriendsOfPHP, baza podatności Go, Python Packaging Advisory database, Ruby Advisory database, RustSec i wkład społeczności.
Identyfikatory GHSA
Identyfikator GHSA ma postać GHSA-xxxx-xxxx-xxxx: trzy grupy po cztery znaki ze zbioru 23456789cfghjmpqrvwx, np. GHSA-jfh8-c2jp-5v3q dla Log4Shell. W odróżnieniu od identyfikatora CVE nie zawiera roku. Większość biuletynów reviewed ma też identyfikator CVE, ale nie wszystkie: GHSA może zostać opublikowany dla podatności pakietu, która nigdy nie otrzyma CVE, a biuletyny o malware zwykle go nie mają.
Ekosystemy
Biuletyny reviewed obejmują 12 ekosystemów: Composer, Erlang, Go, GitHub Actions, Maven, npm, NuGet, pip, Pub, RubyGems, Rust i Swift. Podatność w dołączonej do projektu bibliotece C, pakiecie Debiana czy komponencie firmware wykracza poza nie; w takich przypadkach należy sprawdzać trackery dystrybucji i NVD.
Waga i oceny
Każdy biuletyn ma wagę low, moderate, high lub critical, opartą na wektorze CVSS 3.1 lub 4.0 (zaimportowane CVE mogą używać wersji 3.0). GitHub pokazuje też synchronizowaną codziennie ocenę EPSS od FIRST, która szacuje prawdopodobieństwo wykorzystania w ciągu najbliższych 30 dni (EPSS).
Jak opiekun publikuje GHSA
- Badacz zgłasza problem poufnie, przez private vulnerability reporting, jeśli repozytorium ma tę funkcję włączoną (powstaje wtedy proponowany biuletyn), albo przez kontakt podany w polityce bezpieczeństwa projektu.
- Opiekun otwiera szkic repository security advisory, omawia go poufnie i naprawia problem w tymczasowym prywatnym forku.
- Każdy, kto ma uprawnienia administratora do biuletynu, może złożyć wniosek o identyfikator CVE. GitHub jest CVE Numbering Authority i zwykle odpowiada w ciągu około trzech dni, chyba że projekt podlega innej CNA.
- Po wydaniu poprawki opiekun publikuje biuletyn.
- GitHub go przegląda, co może potrwać do trzech dni. Biuletyny po przeglądzie trafiają do GitHub Advisory Database i mogą wywołać alerty Dependabot dla każdego repozytorium zależnego od podatnej wersji.
Każdy może zaproponować poprawkę istniejącego biuletynu z jego strony lub przez pull request do repozytorium; o scaleniu decyduje zespół kuratorów GitHuba.
GitHub Advisory Database a OSV i NVD
| Baza danych | Prowadzi | Indeksowana według | Zakres |
|---|---|---|---|
| GitHub Advisory Database | GitHub | Ekosystemu i pakietu | 12 ekosystemów pakietów oraz CVE z NVD bez przeglądu |
| OSV.dev | Google, OpenSSF | Ekosystemu i pakietu, Git | Agreguje GHSA i wiele innych baz |
| NVD | NIST | Nazw CPE | Każde opublikowane CVE, dowolny rodzaj produktu |
OSV.dev importuje GitHub Advisory Database, więc GHSA pojawia się tam pod tym samym identyfikatorem. To, co dostawca publikuje o własnych produktach, opisuje strona biuletyn bezpieczeństwa; format do odczytu maszynowego to CSAF.
Związek z CRACI
CRACI pokazuje biuletyny każdego pakietu, z identyfikatorami CVE, GHSA i innymi oraz wagą, dla komponentów zarejestrowanych w każdym buildzie, a historia buildów pokazuje, które wcześniejsze buildy zawierały podatną zależność. Zob. SBOM-y z czasu buildu.