O 138% więcej zgłoszonych CVE dziennie w 2026 niż przed rokiem.Nowość: zawsze aktywne Fixboxes. Podatne zależności, naprawione i zweryfikowane.

PSIRT

Biuletyn bezpieczeństwa: jak go napisać, z szablonem i przykładem

Biuletyn bezpieczeństwa (security advisory) to dokument, na podstawie którego klienci działają, gdy podatność dotyczy Państwa produktu. Dobry biuletyn bez zgłoszenia do supportu odpowiada na pytania, czy ich to dotyczy, jak poważnie i co mają zrobić. Ten przewodnik omawia pola, kompletny przykład, formaty do odczytu maszynowego, GitHub Security Advisories i moment publikacji.

Zaktualizowano

Czym jest biuletyn bezpieczeństwa?

Biuletyn bezpieczeństwa to komunikat dostawcy produktu opisujący występującą w nim podatność: których produktów i wersji dotyczy, jak jest poważna, co mógłby zrobić atakujący i jak użytkownicy mogą ją usunąć lub ograniczyć. Jest pisany dla osób, które obsługują produkt, a coraz częściej także dla ich narzędzi.

Biuletyny to publiczne zakończenie skoordynowanego ujawniania podatności: znalazca zgłasza problem poufnie, dostawca go naprawia, a z biuletynu dowiadują się o nim wszyscy pozostali. W większości firm tworzących oprogramowanie i urządzenia piszą je zespoły PSIRT w ramach szerszego programu bezpieczeństwa produktu.

Biuletyn bezpieczeństwa a zbiorczy biuletyn, rekord CVE, VEX i informacje o wydaniu

Te dokumenty się pokrywają, a zespoły często je mylą:

Dokument Kto go publikuje Czego dotyczy Główny odbiorca
Biuletyn bezpieczeństwa (security advisory) Dostawca produktu lub koordynator Jednej podatności lub kilku powiązanych w Państwa produktach: wersje, których dotyczy, waga, poprawka Administratorzy i zespoły bezpieczeństwa klientów
Zbiorczy biuletyn (security bulletin) Dostawca, często według stałego harmonogramu Zestawienia wielu poprawek w jednym wydaniu lub okresie. Zbiorcze biuletyny bezpieczeństwa Androida ukazują się na przykład w pierwszy poniedziałek każdego miesiąca. Zespoły, które aktualizują systemy cyklicznie
Rekord CVE CVE Numbering Authority (CNA) Globalnego identyfikatora i minimalnego opisu jednej podatności: produkt, którego dotyczy, typ problemu, opis i co najmniej jeden publiczny odnośnik Bazy podatności i skanery
Oświadczenie VEX Dostawca Statusu do odczytu maszynowego dla każdego produktu i podatności: dotyczy, nie dotyczy, naprawiono, w trakcie analizy Skanery klientów
Informacje o wydaniu Dostawca Wszystkiego, co zmieniło się w wydaniu, w tym poprawek bezpieczeństwa wśród innych zmian Każdy, kto aktualizuje

Typowy układ: jeden biuletyn na podatność, z identyfikatorem CVE łączącym go z rekordem CVE, z odnośnikami z informacji o wydaniu każdej naprawionej wersji oraz ze zbiorczego biuletynu, jeśli go Państwo publikują. Pojęcia „security bulletin” i „security advisory” bywają używane zamiennie; ważne jest, by każda podatność miała stałą stronę, na którą klienci mogą się powołać.

Co powinien zawierać biuletyn bezpieczeństwa

Poniższe pola to te, których szukają klienci, i odpowiadają one jeden do jednego formatom do odczytu maszynowego omówionym dalej w tym przewodniku. Zasady CNA programu CVE wyznaczają minimum dla rekordu CVE: co najmniej jeden produkt i wersja, których dotyczy podatność, jej typ lub przyczyna (najlepiej jako CWE), opis tekstowy i publiczny odnośnik. Przydatny biuletyn idzie dalej.

Pole Co zawiera Częsty błąd
Identyfikator biuletynu Własny stały identyfikator, np. EXC-2026-007, oraz identyfikator CVE Używanie wyłącznie identyfikatora CVE, którego w dniu publikacji może jeszcze nie być
Tytuł Produkt, typ podatności i skutek w jednym wierszu „Aktualizacja bezpieczeństwa dla produktu X”, co nic nie mówi
Produkty i wersje, których dotyczy Każdy produkt i wersja, których dotyczy, jako zakresy dla każdej gałęzi wydań „Wersje wcześniejsze niż 4.2.2”, co błędnie obejmuje gałęzie, w których błędu nigdy nie było
Nie dotyczy Produkty i wersje sprawdzone i uznane za niepodatne Pominięcie tego pola, przez co każdy klient ze starszą wersją otwiera zgłoszenie
Wersje z poprawką Pierwsza naprawiona wersja w każdej wspieranej gałęzi Podanie tylko najnowszego wydania
Waga Ocena i pełny wektor CVSS z wersją CVSS Sam wynik bez wektora, którego nikt nie może sprawdzić ani dostosować do swojego środowiska
Słabość Identyfikator i nazwa CWE Pominięcie; oczekują go bazy danych i zasady CVE
Opis Na czym polega luka i gdzie występuje, wystarczająco szczegółowo, by ocenić narażenie, bez działającego exploita Opis tak ogólny, że klienci nie wiedzą, czy ich konfiguracja jest narażona
Skutek Co zyskuje atakujący i czego najpierw potrzebuje (dostęp, rola, pozycja w sieci) Powtarzanie słowami metryk CVSS zamiast wyjaśnienia konsekwencji
Obejścia i środki zaradcze Co zrobić, jeśli dziś nie można zaktualizować, i jak sprawdzić, czy doszło do wykorzystania „Brak obejść”, choć zmiana konfiguracji zablokowałaby atak
Podziękowania Kto znalazł i zgłosił podatność, za jego zgodą Wymienienie kogoś, kto prosił o anonimowość
Oś czasu Zgłoszenie, potwierdzenie, naprawa, publikacja Pominięcie, przez co długie opóźnienia wyglądają na ukrywane
Odnośniki Rekord CVE, informacje o wydaniu, commit z poprawką, wersje do odczytu maszynowego Linki do wewnętrznych zgłoszeń, których klienci nie mogą otworzyć
Historia zmian Każda zmiana po pierwszej publikacji, z datą i wersją Ciche zmienianie wersji, których dotyczy podatność

Najtrudniejszym polem są wersje, których dotyczy podatność. Podatny kod pojawił się w pewnym momencie i został naprawiony w innym, a każda wspierana gałąź ma własną poprawkę. Jeśli podatność pochodzi z komponentu zewnętrznego, pytanie brzmi: które z Państwa wydań zawierały podatną wersję tego komponentu, bezpośrednio lub jako zależność przechodnią. Zob. jak ocenić nowe CVE we wszystkich buildach.

Przykład

Oto kompletny biuletyn dla fikcyjnego produktu: Example Gateway, samodzielnie hostowanej bramy API firmy Example Corp, z dwiema wspieranymi gałęziami, 3.9 i 4.x. Podatny endpoint dodano w wersji 3.9.0, więc wersji 3.8 i wcześniejszych problem nie dotyczy. Wszystkie nazwy, identyfikatory i daty są zmyślone; wynik CVSS 4.0 wyliczono z pokazanego wektora.

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

Ten biuletyn działa dzięki trzem rzeczom:

  • Zakresy dla każdej gałęzi. „Od 4.0.0 do 4.2.1” i „od 3.9.0 do 3.9.6” są precyzyjne. „Wcześniejsze niż 4.2.2” powiedziałoby każdemu klientowi z wersją 3.8, że problem go dotyczy.
  • Opis skutku wskazuje warunek wstępny. Klient bez kont z rolą viewer wie, że jego faktyczne narażenie jest niskie; klient z setkami podwykonawców w roli viewer wie, że nie jest.
  • Obejście obejmuje dalsze kroki. Aktualizacja zamyka lukę, ale nie cofa wycieku sekretu, więc biuletyn mówi, co należy zrotować.

Szablon biuletynu bezpieczeństwa do skopiowania

Proszę zastąpić fragmenty w nawiasach kwadratowych. Sekcję należy usunąć tylko wtedy, gdy naprawdę nie ma zastosowania, a tam, gdzie klienci jej oczekują, lepiej to napisać, niż zostawić puste miejsce (na przykład „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

Biuletyny dla ludzi a biuletyny do odczytu maszynowego

Dla ludzi wystarczy strona internetowa. Nie wystarczy jednak klientowi z tysiącami urządzeń lub setkami usług, którego narzędzia muszą dopasować Państwa biuletyn do tego, co u niego działa. Służą do tego trzy rodziny formatów, odpowiadające na różne potrzeby:

Format Czym jest Kiedy go używać
Strona internetowa (i PDF) Biuletyn w postaci czytanej przez ludzi Zawsze. Każdy inny format odsyła do niej.
CSAF 2.0 Standard OASIS zapisujący biuletyny jako JSON, z drzewem produktów, listami statusów produktów, działaniami naprawczymi, historią zmian i zasadami dystrybucji Sprzedają Państwo produkty takie jak firmware, appliance'y czy oprogramowanie dla przedsiębiorstw klientom, którzy automatyzują przyjmowanie biuletynów, często odbiorcom przemysłowym i korporacyjnym
OSV Format Open Source Vulnerability: wpisy JSON dla pakietów w nazwanym ekosystemie, z zakresami wersji. W tym formacie publikuje swoje biuletyny GitHub Advisory Database. Dostarczają Państwo pakiety open source przez npm, PyPI, Maven, moduły Go i podobne ekosystemy
VEX (CSAF VEX, CycloneDX VEX, OpenVEX) Oświadczenia, że znana podatność dotyczy produktu lub go nie dotyczy, wraz z uzasadnieniem Klienci skanują Państwa SBOM i pytają o CVE w komponentach, które nie wpływają na Państwa produkt

Przykład w CSAF 2.0 staje się dokumentem csaf_security_advisory: identyfikator biuletynu trafia do document/tracking/id, historia zmian do document/tracking/revision_history, wersje, których dotyczy podatność, i wersje z poprawką do list product_status każdej podatności, CWE do jej obiektu cwe, a obejścia do remediations. Jedno zastrzeżenie: oceny w CSAF 2.0 przyjmują tylko CVSS v2 i v3.x. Obsługa CVSS v4.0 pojawia się w CSAF 2.1, który jest wciąż projektem, więc biuletyn CSAF 2.0 albo zawiera wektor CVSS 3.1, albo podaje wektor 4.0 w notatce.

Ten sam biuletyn jako wpis OSV, dla zespołów, które dostarczają bramę także jako pakiet npm (fragment):

{
  "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" }]
}

Proszę zwrócić uwagę, że zakres zawiera dwie pary introduced-fixed. Schemat OSV uznaje wersję za podatną, jeśli mieści się w którymkolwiek zakresie lub występuje na jawnej liście versions, i zaleca fixed zamiast last_affected, ponieważ granica last-affected może powodować pominięte dopasowania.

Zasada decyzyjna: zawsze publikować stronę internetową i CVE. Dodać OSV, zwykle publikując przez GitHub, jeśli dostarczają Państwo pakiety open source. Dodać CSAF, jeśli sprzedają Państwo produkty organizacjom, które oczekują biuletynów do odczytu maszynowego lub działają w ramach unijnego Cyber Resilience Act, którego art. 14 ust. 8 wymaga, w stosownych przypadkach, ustrukturyzowanego formatu do odczytu maszynowego przy informowaniu użytkowników o aktywnie wykorzystywanych podatnościach. Dodać VEX, gdy klienci zaczną przysyłać wyniki skanerów dotyczące Państwa komponentów. Generować wszystkie formaty z jednego rekordu, aby nigdy nie były ze sobą sprzeczne.

GitHub Security Advisories

Jeśli Państwa projekt jest publicznym repozytorium na GitHubie, repository security advisories GitHuba zapewniają cały proces w jednym miejscu: prywatny szkic do omówienia podatności, tymczasowy prywatny fork do jej naprawienia, wniosek o CVE i publikację. Składają się na to cztery elementy:

  • Repository security advisories: szkice i opublikowane biuletyny należące do Państwa repozytorium.
  • Private vulnerability reporting: przycisk „Report a vulnerability” na stronie Advisories repozytorium, dzięki któremu badacze mogą zgłosić problem poufnie zamiast otwierać publiczne issue.
  • Identyfikatory CVE od GitHuba: GitHub jest CNA i może nadać Państwa biuletynowi identyfikator CVE, chyba że projekt podlega innej CNA.
  • GitHub Advisory Database: w obsługiwanych ekosystemach GitHub publikuje tam Państwa biuletyn w formacie OSV i może na jego podstawie wysyłać alerty Dependabot do repozytoriów zależnych od Państwa pakietu.

Włączenie private vulnerability reporting

Właściciele i administratorzy publicznego repozytorium mogą tę funkcję włączyć:

  1. Na stronie głównej repozytorium kliknąć Settings.
  2. W sekcji Security and quality paska bocznego kliknąć Advanced Security.
  3. Kliknąć Enable obok Private vulnerability reporting.

Następnie dodać odnośnik w pliku SECURITY.md i w polityce ujawniania.

Tworzenie szkicu biuletynu

  1. Na stronie głównej repozytorium otworzyć kartę Security and quality.
  2. Na pasku bocznym, w sekcji Reporting, kliknąć Advisories, a następnie New draft security advisory.
  3. Wpisać tytuł. W polu CVE identifier podać istniejący identyfikator CVE lub wybrać późniejsze złożenie wniosku do GitHuba.
  4. Napisać opis: podatność, jej skutek, poprawki, obejścia i odnośniki.
  5. W sekcji Affected products ustawić ekosystem, nazwę pakietu, wersje podatne i wersje z poprawką. Dodać produkt dla każdego pakietu.
  6. Ustawić wagę albo wybrać Assess severity using CVSS i wypełnić kalkulator.
  7. Dodać CWE w sekcji Weaknesses, a zgłaszającego w sekcji Credits.
  8. Kliknąć Create draft security advisory.

Szkic pozostaje prywatny. Można w nim dodać współpracowników, utworzyć tymczasowy prywatny fork, aby przygotować poprawkę, i omówić szczegóły ze zgłaszającym.

Wniosek o CVE i publikacja

  1. Otworzyć szkic z Security and quality, a następnie Advisories.
  2. Na dole formularza kliknąć Request CVE. Wniosek o CVE nie upublicznia biuletynu, a GitHub podaje, że zwykle rozpatruje wnioski w ciągu 72 godzin, więc warto złożyć go wcześnie.
  3. Wydać naprawione wersje i upewnić się, że biuletyn wymienia je jako wersje z poprawką.
  4. Kliknąć Publish advisory. Tymczasowy prywatny fork zostaje usunięty, GitHub publikuje szczegóły CVE, a w obsługiwanych ekosystemach biuletyn trafia do GitHub Advisory Database. Alerty Dependabot mogą pojawić się do 72 godzin później.

Jeśli opublikują Państwo biuletyn bez wersji z poprawką, GitHub ostrzega, że Dependabot powiadomi użytkowników bez wskazania bezpiecznej wersji. Baza biuletynów GitHuba obsługuje zarówno CVSS 3.1, jak i 4.0. Kroki odpowiadają dokumentacji GitHub Docs według stanu na listopad 2026; etykiety w interfejsie GitHuba od czasu do czasu się zmieniają.

Biuletyny GitHuba pasują do pakietów open source w ekosystemach obsługiwanych przez GitHub. W przypadku firmware, appliance'ów lub produktów o zamkniętym kodzie należy publikować na własnej stronie, w CSAF tam, gdzie oczekują tego klienci, a CVE uzyskać od własnej CNA lub takiej, której zakres obejmuje Państwa produkty.

Kiedy publikować: moment publikacji i embargo

Embargo, czyli okres między poufnym zgłoszeniem a publikacją, i to, jak długo ma trwać, należą do Państwa polityki ujawniania. Zadaniem biuletynu jest ukazać się we właściwym momencie w jego ramach. Typowy dzień publikacji wygląda tak:

  1. Przed tym dniem: poprawki są gotowe w każdej wspieranej gałęzi, identyfikator CVE jest zarezerwowany, a biuletyn i wszystkie wersje do odczytu maszynowego są napisane i sprawdzone.
  2. Wcześniejsze powiadomienie, jeśli Państwo je stosują: duzi klienci, dalsi dostawcy wbudowujący Państwa produkt i koordynatorzy otrzymują biuletyn objęty embargiem kilka dni wcześniej, aby byli gotowi odpowiadać własnym klientom.
  3. Wydanie: naprawione wersje trafiają do użytkowników.
  4. Publikacja: strona biuletynu, rekord CVE, dokumenty CSAF lub OSV i wpis w kanale pojawiają się jednocześnie, najlepiej w tej samej godzinie co wydanie.
  5. Powiadomienie: lista mailingowa i bezpośrednie powiadomienia dla klientów, których problem dotyczy.

Kolejność ma znaczenie. Opublikowanie poprawki bez biuletynu pozwala atakującym porównać wydania, podczas gdy obrońcy nie wiedzą, że powinni zaktualizować. Opublikowanie biuletynu bez poprawki jest właściwe tylko wtedy, gdy podatność jest już publiczna lub wykorzystywana: wtedy należy opublikować to, co wiadomo, wraz ze środkami zaradczymi, i zaktualizować biuletyn, gdy pojawi się poprawka.

Na mocy Cyber Resilience Act aktywnie wykorzystywana podatność uruchamia też odrębny obowiązek zgłoszenia do organów: wczesne ostrzeżenie w ciągu 24 godzin przez Single Reporting Platform, następnie powiadomienie i raport końcowy. To nie jest Państwa biuletyn i nie jest to informacja publiczna. Załącznik I do CRA wymaga też od producentów publicznego ujawniania informacji o naprawionych podatnościach, gdy dostępna jest aktualizacja bezpieczeństwa, a właśnie to robi biuletyn. Zob. czego wymaga CRA.

Publikacja: gdzie umieszczać biuletyny

  • Stała strona dla każdego biuletynu pod adresem URL, który nigdy się nie zmienia, np. /security/advisories/exc-2026-007, oraz strona indeksu z listą wszystkich biuletynów, ich produktów, wag i dat.
  • Kanał. Kanał RSS lub Atom indeksu pozwala subskrybować bez listy mailingowej.
  • Metadane dostawcy CSAF, jeśli publikują Państwo CSAF: plik provider-metadata.json oraz katalog lub kanał ROLIE z dokumentami, aby narzędzia znajdowały każdy biuletyn bez scrapowania. Role i wymagania opisuje strona CSAF.
  • Odnośnik w security.txt. Pole Policy wskazuje politykę ujawniania, a standard CSAF definiuje pole CSAF, które kieruje narzędzia do metadanych dostawcy:
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

Nigdy nie należy usuwać opublikowanego biuletynu. Jeśli okaże się błędny, należy opublikować wersję poprawioną z opisem zmian; jeśli podatność okazała się nieprawdziwa, należy oznaczyć biuletyn jako wycofany i podać powód.

Powiadamianie klientów

Opublikowanie nie oznacza, że ktoś to przeczyta. Klienci, którzy nie subskrybują Państwa kanału, nie zobaczą biuletynu, dopóki ich skaner nie oznaczy CVE albo ktoś ich o nie nie zapyta. W przypadku biuletynów o wadze wysokiej i krytycznej:

  • Wysłać e-mail do klientów korzystających z wersji, których dotyczy problem, a nie do całej listy, z linkiem do biuletynu i jednym działaniem, które muszą podjąć.
  • Przed publikacją poinformować zespoły wsparcia i sprzedaży, przekazując biuletyn i krótkie FAQ, aby ich odpowiedzi były z nim zgodne.
  • Powiadomić dalszych dostawców, którzy wbudowują Państwa produkt, aby ich własne biuletyny mogły szybko się pojawić.
  • Wrócić do klientów, którzy pozostają na wersjach, których dotyczy problem.

Wysyłanie e-maili tylko do klientów, których problem dotyczy, wymaga wiedzy, jakich wersji produktu używa każdy z nich. W przypadku podatności w komponencie zewnętrznym, która dotknęła jednocześnie wielu dostawców, zob. jak odpowiadać klientom po ataku na łańcuch dostaw, z szablonami.

Czy warto zostać CNA?

CVE Numbering Authority (CNA) nadaje identyfikatory CVE i publikuje rekordy CVE dla podatności w uzgodnionym zakresie, zwykle we własnych produktach. Status CNA pozwala decydować, kiedy pojawi się rekord CVE, nadawać identyfikatory bez dzielenia się szczegółami objętymi embargiem z inną CNA i samodzielnie pisać rekord.

Według programu CVE nie ma opłat ani umowy. CNA musi mieć publiczną politykę ujawniania podatności i publiczne źródło informacji o nowo ujawnionych podatnościach (stronę z biuletynami) oraz zaakceptować warunki korzystania z programu. Proces dołączania obejmuje formularz rejestracyjny, sesję wprowadzającą i przykłady ćwiczeniowe. W UE ENISA pełni rolę Root dla organizacji ze swojego zakresu, w tym dostawców technologii i projektów open source.

  • To dobre rozwiązanie dla dostawcy, który regularnie publikuje CVE dla własnych produktów, ma już PSIRT i stronę z biuletynami oraz chce kontrolować moment publikacji.
  • Nie musi to być pierwszy krok, jeśli publikują Państwo kilka CVE rocznie albo Państwa produkty to pakiety open source na GitHubie, gdzie GitHub może nadawać identyfikatory w ramach biuletynu.

Jak uzyskać identyfikatory CVE bez statusu CNA, opisuje strona skoordynowane ujawnianie podatności.

Gdzie pasuje CRACI: wersje, których dotyczy podatność

Większość biuletynu to pisanie. Polem, które wymaga dowodów, są wersje, których dotyczy podatność, a w przypadku podatności w komponentach zewnętrznych jest ono też najtrudniejsze do ustalenia: które z Państwa wydań zawierały podatną wersję, także jako zależność przechodnią, i od kiedy.

CRACI uruchamia Państwa buildy GitHub Actions na własnych runnerach i rejestruje pakiety, które każdy job faktycznie pobrał, w tym zależności przechodnie i pakiety przywrócone z cache CI. Każdy pakiet pokazuje swoje biuletyny (CVE, GHSA i inne identyfikatory) z wagą. Historia buildów pokazuje każdy wcześniejszy build i jego SBOM oraz to, które buildy zawierały podatną zależność, dzięki czemu wiadomo, w jakim okresie problem Państwa dotyczył, w ramach okresu przechowywania danych (domyślnie 180 dni, w planie Enterprise do ustalenia indywidualnie). Zespoły bezpieczeństwa przeprowadzają triaż wyników i przekazują je zespołom odpowiedzialnym za poprawkę, a CRACI powiadamia właściwe osoby o podatności i jej wadze. Zob. śledzenie podatności.

Gdy aktywnie wykorzystywana podatność uruchamia obowiązek zgłoszenia wynikający z CRA, CRACI przygotowuje treść zgłoszeń (wczesne ostrzeżenie, powiadomienie i raport końcowy); osoba w Państwa firmie przesyła je przez Single Reporting Platform.

Kiedy CRACI nie jest odpowiedzią

  • Pisanie i publikowanie biuletynu. CRACI nie pisze ani nie publikuje biuletynów bezpieczeństwa, ani w CSAF, ani w żadnym innym formacie. Do tego służy własna strona, GitHub Security Advisories lub narzędzie CSAF.
  • Przyjmowanie zgłoszeń. CRACI nie przyjmuje zgłoszeń podatności od badaczy ani klientów i nie śledzi ich jako spraw. Do tego służy skrzynka do zgłoszeń, private vulnerability reporting na GitHubie lub system do śledzenia spraw.
  • Podatności we własnym kodzie. CRACI dopasowuje biuletyny do pakietów pobranych przez Państwa buildy. Luka taka jak path traversal z przykładu, we własnym kodzie, wymaga przeglądu kodu, aby ustalić, kiedy została wprowadzona.
  • Buildy poza GitHub Actions. CRACI obsługuje dziś GitHub Actions; GitLab CI i Jenkins są na roadmapie.
  • Wydania starsze niż okres przechowywania danych. Historia buildów obejmuje buildy, które CRACI zarejestrował i przechowuje.

Biuletyny bezpieczeństwa: najczęściej zadawane pytania

Czym jest biuletyn bezpieczeństwa?

Biuletyn bezpieczeństwa (security advisory) to komunikat dostawcy produktu opisujący występującą w nim podatność: których produktów i wersji dotyczy, jak jest poważna, co mógłby zrobić atakujący i jak ją usunąć lub ograniczyć. Zwykle zawiera identyfikator CVE i jest publikowany, gdy dostępna jest poprawka.

Czym różni się biuletyn bezpieczeństwa od zbiorczego biuletynu (security bulletin)?

Biuletyn bezpieczeństwa zwykle szczegółowo opisuje jedną podatność lub kilka powiązanych. Zbiorczy biuletyn zestawia wiele poprawek dla jednego wydania lub okresu, często według stałego harmonogramu; Android publikuje na przykład swoje biuletyny bezpieczeństwa co miesiąc. Niektórzy dostawcy używają obu pojęć zamiennie.

Co powinien zawierać biuletyn bezpieczeństwa?

Identyfikator biuletynu i identyfikator CVE, tytuł, produkty i wersje, których dotyczy, jako zakresy dla każdej gałęzi, produkty sprawdzone i niepodatne, wersje z poprawką, wagę z pełnym wektorem CVSS, CWE, opis, skutek i jego warunki wstępne, obejścia, podziękowania, oś czasu, odnośniki i historię zmian.

Jak utworzyć biuletyn bezpieczeństwa na GitHubie?

W publicznym repozytorium otworzyć kartę Security and quality, w sekcji Reporting kliknąć Advisories, a następnie New draft security advisory. Wypełnić tytuł, opis, produkty, których dotyczy podatność, wagę, CWE i podziękowania, a potem zapisać szkic. Po wydaniu poprawki w razie potrzeby złożyć wniosek o CVE i kliknąć Publish advisory.

Czy GitHub może nadać mojemu biuletynowi identyfikator CVE?

Tak, jeśli projekt nie podlega innej CNA. GitHub jest CVE Numbering Authority. Wniosek o CVE składa się ze szkicu biuletynu; nie upublicznia on biuletynu, a GitHub podaje, że zwykle rozpatruje wnioski w ciągu 72 godzin. GitHub publikuje szczegóły CVE, gdy biuletyn stanie się publiczny.

Czy biuletyny bezpieczeństwa powinny być do odczytu maszynowego?

Coraz częściej tak. Warto publikować stronę internetową dla ludzi i dodać wersję do odczytu maszynowego dla klientów, którzy automatyzują: CSAF dla produktów sprzedawanych przedsiębiorstwom i przemysłowi, OSV dla pakietów open source oraz VEX, aby wskazać, które znane podatności nie dotyczą Państwa produktu. Wszystkie należy generować z tego samego rekordu.

Kiedy należy opublikować biuletyn bezpieczeństwa?

Jednocześnie z naprawionymi wersjami, po ewentualnym wcześniejszym powiadomieniu kluczowych klientów i dalszych dostawców w ramach embarga. Wcześniej, ze środkami zaradczymi, tylko jeśli podatność jest już publiczna lub wykorzystywana, a biuletyn należy zaktualizować, gdy pojawi się poprawka.

Czy trzeba być CNA, aby opublikować biuletyn bezpieczeństwa?

Nie. Biuletyn może opublikować każdy. Status CVE Numbering Authority oznacza jedynie, że można samodzielnie nadawać identyfikatory CVE. Bez niego identyfikator może nadać CNA, której zakres obejmuje Państwa produkt, GitHub dla projektów open source na GitHubie albo CNA of Last Resort.

Wiedzieć, które wydania wymienić jako podatne

Biuletyn jest tak dokładny, jak lista wersji, których dotyczy. Proszę umówić demo i zobaczyć, które buildy GitHub Actions zawierały podatny pakiet.

Umów demo