138% mehr gemeldete CVEs pro Tag in 2026 als im Vorjahr.Neu: immer aktive Fixboxes. Verwundbare Abhängigkeiten, behoben und verifiziert.

PSIRT

Security Advisory: so schreiben Sie eines, mit Vorlage und durchgespieltem Beispiel

Ein Security Advisory ist das Dokument, nach dem Ihre Kunden handeln, wenn eine Schwachstelle Ihr Produkt betrifft. Ein gutes beantwortet ohne Support-Ticket, ob sie betroffen sind, wie schwer und was zu tun ist. Dieser Leitfaden behandelt die Felder, ein vollständiges Beispiel, die maschinenlesbaren Formate, GitHub Security Advisories und den Zeitpunkt der Veröffentlichung.

Aktualisiert am

Was ist ein Security Advisory?

Ein Security Advisory (Sicherheitshinweis) ist eine Mitteilung des Anbieters eines Produkts, die eine Schwachstelle darin beschreibt: welche Produkte und Versionen betroffen sind, wie schwer sie wiegt, was ein Angreifer tun könnte und wie Nutzer sie beheben oder abschwächen. Es richtet sich an die Menschen, die das Produkt betreiben, und zunehmend auch an deren Tools.

Advisories sind das öffentliche Ende der koordinierten Offenlegung von Schwachstellen: Ein Finder meldet vertraulich, der Anbieter behebt, und über das Advisory erfahren alle anderen davon. In den meisten Software- und Geräteunternehmen schreibt sie das PSIRT, als Teil eines umfassenderen Produktsicherheitsprogramms.

Security Advisory vs. Security Bulletin, CVE-Eintrag, VEX und Release Notes

Diese Dokumente überschneiden sich, und Teams verwechseln sie oft:

Dokument Wer es veröffentlicht Was es abdeckt Hauptleser
Security Advisory Der Anbieter des Produkts oder ein Koordinator Eine Schwachstelle oder einige zusammenhängende in Ihren Produkten: betroffene Versionen, Schweregrad, Fix Betriebs- und Sicherheitsteams der Kunden
Security Bulletin Der Anbieter, oft nach festem Zeitplan Eine Sammlung vieler Fixes in einem Release oder Zeitraum. Die Security Bulletins von Android erscheinen zum Beispiel am ersten Montag jedes Monats. Teams, die im Zyklus patchen
CVE-Eintrag Eine CVE Numbering Authority (CNA) Die globale Kennung und eine Mindestbeschreibung einer Schwachstelle: betroffenes Produkt, Problemtyp, Beschreibung und mindestens eine öffentliche Referenz Schwachstellendatenbanken und Scanner
VEX-Statement Der Anbieter Ein maschinenlesbarer Status pro Produkt und Schwachstelle: betroffen, nicht betroffen, behoben, in Untersuchung Die Scanner der Kunden
Release Notes Der Anbieter Alles, was sich in einem Release geändert hat, Sicherheitsfixes unter anderen Änderungen Alle, die aktualisieren

Das übliche Muster: ein Advisory pro Schwachstelle, mit einer CVE-ID, die es mit dem CVE-Eintrag verknüpft, verlinkt aus den Release Notes jeder behobenen Version und aus dem Bulletin, falls Sie eines veröffentlichen. „Security Bulletin“ und „Security Advisory“ werden manchmal synonym verwendet; wichtig ist, dass jede Schwachstelle eine stabile Seite hat, die Kunden zitieren können.

Was ein Security Advisory enthalten sollte

Die folgenden Felder sind das, wonach Kunden suchen, und sie entsprechen eins zu eins den maschinenlesbaren Formaten weiter unten in diesem Leitfaden. Die CNA-Regeln des CVE-Programms legen die Untergrenze für den CVE-Eintrag fest: mindestens ein betroffenes Produkt und eine Version, Typ oder Ursache der Schwachstelle (vorzugsweise als CWE), eine Beschreibung in Textform und eine öffentliche Referenz. Ein nützliches Advisory geht weiter.

Feld Was es aussagt Häufiger Fehler
Advisory-ID Ihre eigene stabile Kennung, etwa EXC-2026-007, plus die CVE-ID Nur die CVE-ID zu verwenden, die Sie am Tag der Veröffentlichung womöglich noch nicht haben
Titel Produkt, Schwachstellentyp und Auswirkung in einer Zeile „Sicherheitsupdate für Produkt X“, was nichts aussagt
Betroffene Produkte und Versionen Jedes betroffene Produkt und jede Version, als Bereiche pro Release-Zweig „Versionen vor 4.2.2“, was fälschlich Zweige einschließt, die den Fehler nie hatten
Nicht betroffen Produkte und Versionen, die Sie geprüft und als nicht betroffen befunden haben Das Feld wegzulassen, sodass jeder Kunde mit einer älteren Version ein Ticket öffnet
Behobene Versionen Die erste behobene Version auf jedem unterstützten Zweig Nur das neueste Release zu nennen
Schweregrad Eine Einstufung und der vollständige CVSS-Vektor, mit der CVSS-Version Ein bloßer Score ohne Vektor, den niemand prüfen oder an seine Umgebung anpassen kann
Schwäche Die CWE-ID und ihr Name Sie wegzulassen; Datenbanken und die CVE-Regeln erwarten sie
Beschreibung Was der Fehler ist und wo, detailliert genug, um die Exposition zu beurteilen, ohne funktionierenden Exploit So vage, dass Kunden nicht erkennen können, ob ihre Konfiguration exponiert ist
Auswirkung Was ein Angreifer gewinnt und was er zuerst braucht (Zugang, Rolle, Netzwerkposition) Die CVSS-Metriken in Worten wiederholen, statt die Folgen zu erklären
Workarounds und Abhilfemaßnahmen Was zu tun ist, wenn Sie heute nicht aktualisieren können, und wie Sie prüfen, ob Sie angegriffen wurden „Keine Workarounds“, obwohl eine Konfigurationsänderung den Angriff blockieren würde
Danksagung Wer die Schwachstelle gefunden und gemeldet hat, mit deren Einverständnis Jemanden zu nennen, der anonym bleiben wollte
Zeitachse Gemeldet, bestätigt, behoben, veröffentlicht Sie wegzulassen, wodurch lange Verzögerungen verschleiert wirken
Referenzen CVE-Eintrag, Release Notes, Fix-Commit, maschinenlesbare Fassungen Links auf interne Tickets, die Kunden nicht öffnen können
Revisionshistorie Jede Änderung nach der Erstveröffentlichung, mit Datum und Version Die betroffenen Versionen stillschweigend zu ändern

Das schwierigste Feld sind die betroffenen Versionen. Der verwundbare Code kam zu einem Zeitpunkt hinzu und wurde zu einem anderen behoben, und jeder unterstützte Zweig hat seinen eigenen Fix. Kam die Schwachstelle über eine Drittkomponente herein, lautet die Frage, welche Ihrer Releases die verwundbare Version dieser Komponente ausgeliefert haben, direkt oder als transitive Abhängigkeit. Siehe wie Sie eine neue CVE über Ihre Builds hinweg bewerten.

Ein durchgespieltes Beispiel

Hier ist ein vollständiges Advisory für ein fiktives Produkt: Example Gateway, ein selbst gehostetes API-Gateway von Example Corp, mit zwei unterstützten Zweigen, 3.9 und 4.x. Der verwundbare Endpunkt kam in 3.9.0 hinzu, daher sind 3.8 und älter nicht betroffen. Alle Namen, IDs und Daten sind erfunden; der CVSS-4.0-Score ist aus dem gezeigten Vektor berechnet.

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

Drei Dinge lassen dieses Advisory funktionieren:

  • Bereiche pro Zweig. „4.0.0 bis 4.2.1“ und „3.9.0 bis 3.9.6“ sind exakt. „Vor 4.2.2“ hätte jedem Kunden mit 3.8 gesagt, er sei betroffen.
  • Die Auswirkung nennt die Voraussetzung. Ein Kunde ohne Viewer-Konten weiß, dass seine tatsächliche Exposition gering ist; einer mit Hunderten externer Dienstleister in der Viewer-Rolle weiß, dass sie es nicht ist.
  • Der Workaround enthält den nächsten Schritt. Das Update schließt die Lücke, macht aber ein abgeflossenes Geheimnis nicht ungeschehen, also sagt das Advisory, was rotiert werden muss.

Eine Vorlage für Security Advisories zum Kopieren

Ersetzen Sie die Teile in eckigen Klammern. Löschen Sie einen Abschnitt nur, wenn er wirklich nicht zutrifft, und sagen Sie das, statt ihn leer zu lassen, wo Kunden ihn erwarten (zum Beispiel „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

Menschenlesbare vs. maschinenlesbare Advisories

Für Menschen reicht eine Webseite. Sie reicht nicht für einen Kunden mit Tausenden Geräten oder Hunderten Diensten, dessen Tools Ihr Advisory mit dem abgleichen müssen, was er betreibt. Drei Formatfamilien leisten das, und sie bedienen unterschiedliche Bedürfnisse:

Format Was es ist Einsetzen, wenn
Webseite (und PDF) Das Advisory, wie Menschen es lesen Immer. Jedes andere Format verlinkt darauf zurück.
CSAF 2.0 Der OASIS-Standard für Advisories als JSON, mit Produktbaum, Produktstatuslisten, Abhilfemaßnahmen, Revisionshistorie und Regeln für die Verteilung Sie verkaufen Produkte wie Firmware, Appliances oder Unternehmenssoftware an Kunden, die die Annahme von Advisories automatisieren, oft Industrie- und Unternehmenskunden
OSV Das Open-Source-Vulnerability-Format: JSON-Einträge für Pakete in einem benannten Ökosystem, mit Versionsbereichen. Die GitHub Advisory Database veröffentlicht ihre Advisories darin. Sie liefern Open-Source-Pakete über npm, PyPI, Maven, Go-Module und ähnliche Ökosysteme aus
VEX (CSAF VEX, CycloneDX VEX, OpenVEX) Aussagen, dass ein Produkt von einer bekannten Schwachstelle betroffen ist oder nicht, und warum Kunden scannen Ihre SBOM und fragen nach CVEs in Komponenten, die Ihr Produkt nicht betreffen

Das durchgespielte Beispiel wird in CSAF 2.0 zu einem csaf_security_advisory-Dokument: Die Advisory-ID kommt in document/tracking/id, die Revisionshistorie in document/tracking/revision_history, die betroffenen und behobenen Versionen in die product_status-Listen jeder Schwachstelle, die CWE in deren cwe-Objekt und die Workarounds in remediations. Ein Haken: CSAF 2.0 nimmt bei Scores nur CVSS v2 und v3.x auf. Unterstützung für CVSS v4.0 kommt mit CSAF 2.1, das noch ein Entwurf ist, daher trägt ein CSAF-2.0-Advisory entweder einen CVSS-3.1-Vektor oder nennt den 4.0-Vektor in einer Notiz.

Dasselbe Advisory als OSV-Eintrag, für Teams, die das Gateway auch als npm-Paket ausliefern (Auszug):

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

Beachten Sie, dass der Bereich zwei Paare aus introduced und fixed enthält. Das OSV-Schema behandelt eine Version als betroffen, wenn sie in einen Bereich fällt oder in der expliziten versions-Liste steht, und empfiehlt fixed statt last_affected, weil eine Last-affected-Grenze zu verpassten Treffern führen kann.

Entscheidungsregel: Veröffentlichen Sie immer die Webseite und eine CVE. Ergänzen Sie OSV, meist über eine Veröffentlichung via GitHub, wenn Sie Open-Source-Pakete ausliefern. Ergänzen Sie CSAF, wenn Sie Produkte an Organisationen verkaufen, die maschinenlesbare Advisories verlangen oder unter den Cyber Resilience Act der EU fallen, dessen Artikel 14 Absatz 8 gegebenenfalls ein strukturiertes, maschinenlesbares Format verlangt, wenn Nutzer über aktiv ausgenutzte Schwachstellen informiert werden. Ergänzen Sie VEX, sobald Kunden Ihnen Scanner-Ergebnisse zu Ihren Komponenten schicken. Erzeugen Sie jedes Format aus einem einzigen Datensatz, damit sie sich nie widersprechen.

GitHub Security Advisories

Wenn Ihr Projekt ein öffentliches Repository auf GitHub ist, bieten Ihnen die Repository Security Advisories von GitHub den gesamten Ablauf an einem Ort: einen privaten Entwurf, um die Schwachstelle zu besprechen, einen temporären privaten Fork, um sie zu beheben, eine CVE-Anfrage und die Veröffentlichung. Vier Bausteine greifen ineinander:

  • Repository Security Advisories: Entwürfe und veröffentlichte Advisories, die zu Ihrem Repository gehören.
  • Private Vulnerability Reporting: eine Schaltfläche „Report a vulnerability“ auf der Advisories-Seite des Repositorys, damit Forschende Ihnen vertraulich melden können, statt ein öffentliches Issue zu eröffnen.
  • CVE-IDs von GitHub: GitHub ist eine CNA und kann Ihrem Advisory eine CVE-ID zuweisen, sofern Ihr Projekt nicht in den Bereich einer anderen CNA fällt.
  • Die GitHub Advisory Database: Für unterstützte Ökosysteme veröffentlicht GitHub Ihr Advisory dort, im OSV-Format, und kann damit Dependabot-Alerts an Repositorys senden, die von Ihrem Paket abhängen.

Private Vulnerability Reporting aktivieren

Owner und Administratoren eines öffentlichen Repositorys können es aktivieren:

  1. Klicken Sie auf der Hauptseite des Repositorys auf Settings.
  2. Klicken Sie im Abschnitt Security and quality der Seitenleiste auf Advanced Security.
  3. Klicken Sie neben Private vulnerability reporting auf Enable.

Verlinken Sie es dann aus Ihrer SECURITY.md und Ihrer Offenlegungsrichtlinie.

Einen Advisory-Entwurf anlegen

  1. Öffnen Sie auf der Hauptseite des Repositorys den Tab Security and quality.
  2. Klicken Sie in der Seitenleiste unter Reporting auf Advisories und dann auf New draft security advisory.
  3. Geben Sie einen Titel ein. Tragen Sie unter CVE identifier eine vorhandene CVE-ID ein oder wählen Sie, später eine bei GitHub anzufragen.
  4. Schreiben Sie die Beschreibung: die Schwachstelle, ihre Auswirkung, Patches, Workarounds und Referenzen.
  5. Legen Sie unter Affected products Ökosystem, Paketnamen, betroffene Versionen und gepatchte Versionen fest. Fügen Sie für jedes Paket ein Produkt hinzu.
  6. Legen Sie den Schweregrad fest oder wählen Sie Assess severity using CVSS und füllen Sie den Rechner aus.
  7. Tragen Sie die CWE unter Weaknesses und die meldende Person unter Credits ein.
  8. Klicken Sie auf Create draft security advisory.

Der Entwurf bleibt privat. Von dort aus können Sie Mitwirkende hinzufügen, einen temporären privaten Fork für den Fix starten und die Details mit der meldenden Person besprechen.

Eine CVE anfragen und veröffentlichen

  1. Öffnen Sie den Entwurf über Security and quality und dann Advisories.
  2. Klicken Sie unten im Formular auf Request CVE. Die Anfrage macht das Advisory nicht öffentlich, und laut GitHub werden Anfragen meist innerhalb von 72 Stunden geprüft, also fragen Sie früh an.
  3. Veröffentlichen Sie die behobenen Versionen und stellen Sie sicher, dass das Advisory sie als gepatchte Versionen nennt.
  4. Klicken Sie auf Publish advisory. Der temporäre private Fork wird gelöscht, GitHub veröffentlicht die CVE-Details, und für unterstützte Ökosysteme gelangt das Advisory in die GitHub Advisory Database. Dependabot-Alerts können bis zu 72 Stunden dauern.

Wenn Sie ohne gepatchte Version veröffentlichen, warnt GitHub, dass Dependabot Nutzer benachrichtigt, ohne eine sichere Version vorzuschlagen. Die Advisory-Datenbank von GitHub unterstützt sowohl CVSS 3.1 als auch 4.0. Die Schritte folgen den GitHub Docs mit Stand November 2026; die Beschriftungen in der GitHub-Oberfläche ändern sich von Zeit zu Zeit.

GitHub-Advisories passen zu Open-Source-Paketen in den von GitHub unterstützten Ökosystemen. Für Firmware, Appliances oder Closed-Source-Produkte veröffentlichen Sie auf Ihrer eigenen Website, in CSAF, wo Kunden es erwarten, und beziehen die CVE von Ihrer eigenen CNA oder einer, in deren Bereich Sie fallen.

Wann veröffentlichen: Timing und Embargo

Das Embargo, also der Zeitraum zwischen der vertraulichen Meldung und der Veröffentlichung, und wie lange es dauern sollte, gehören in Ihre Offenlegungsrichtlinie. Die Aufgabe des Advisorys ist es, innerhalb dieses Rahmens im richtigen Moment zu erscheinen. Ein typischer Veröffentlichungstag läuft so ab:

  1. Vor dem Tag: Die Fixes sind auf jedem unterstützten Zweig fertig, die CVE-ID ist reserviert, und das Advisory sowie jede maschinenlesbare Fassung sind geschrieben und geprüft.
  2. Vorabinformation, falls Sie sie geben: Große Kunden, nachgelagerte Anbieter, die Ihr Produkt einbetten, und Koordinatoren erhalten das Advisory einige Tage früher unter Embargo, damit sie ihren eigenen Kunden antworten können.
  3. Release: Die behobenen Versionen werden ausgeliefert.
  4. Veröffentlichen: Advisory-Seite, CVE-Eintrag, CSAF- oder OSV-Dokumente und der Feed-Eintrag gehen gemeinsam live, idealerweise in derselben Stunde wie das Release.
  5. Benachrichtigen: Mailingliste und direkte Hinweise an betroffene Kunden.

Die Reihenfolge zählt. Wer zuerst den Fix ohne Advisory veröffentlicht, lässt Angreifer das Release diffen, während Verteidiger nicht wissen, dass sie aktualisieren sollten. Ein Advisory ohne Fix zu veröffentlichen ist nur richtig, wenn die Schwachstelle bereits öffentlich ist oder ausgenutzt wird: Dann veröffentlichen Sie, was Sie wissen, mit Abhilfemaßnahmen, und aktualisieren es, wenn der Fix erscheint.

Nach dem Cyber Resilience Act löst eine aktiv ausgenutzte Schwachstelle zudem eine separate Pflicht zur Meldung an Behörden aus: eine Frühwarnung innerhalb von 24 Stunden über die Single Reporting Platform, dann eine Meldung und ein Abschlussbericht. Das ist nicht Ihr Advisory, und es ist nicht öffentlich. Anhang I des CRA verlangt von Herstellern außerdem, Informationen über behobene Schwachstellen öffentlich offenzulegen, sobald ein Sicherheitsupdate verfügbar ist, und genau das leistet ein Advisory. Siehe was der CRA verlangt.

Veröffentlichung: wo Advisories zu finden sind

  • Eine stabile Seite pro Advisory, unter einer URL, die sich nie ändert, etwa /security/advisories/exc-2026-007, plus eine Übersichtsseite, die jedes Advisory mit Produkten, Schweregrad und Daten auflistet.
  • Ein Feed. Ein RSS- oder Atom-Feed der Übersicht lässt Menschen ohne Mailingliste abonnieren.
  • CSAF-Provider-Metadaten, wenn Sie CSAF veröffentlichen: eine provider-metadata.json-Datei und ein Verzeichnis oder ROLIE-Feed der Dokumente, damit Tools jedes Advisory ohne Scraping finden. Siehe CSAF für die Rollen und Anforderungen.
  • Ein Verweis in security.txt. Das Feld Policy verlinkt Ihre Offenlegungsrichtlinie, und der CSAF-Standard definiert ein Feld CSAF, das Tools auf Ihre Provider-Metadaten verweist:
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

Löschen Sie nie ein veröffentlichtes Advisory. Erweist es sich als falsch, veröffentlichen Sie eine Revision, die sagt, was sich geändert hat; war die Schwachstelle nicht echt, markieren Sie das Advisory als zurückgezogen und sagen Sie, warum.

Kunden benachrichtigen

Veröffentlicht heißt nicht gelesen. Kunden, die Ihren Feed nicht abonnieren, sehen das Advisory erst, wenn ihr Scanner die CVE meldet oder jemand sie danach fragt. Für Advisories mit hohem und kritischem Schweregrad:

  • Schreiben Sie den Kunden, die betroffene Versionen betreiben, nicht Ihrer gesamten Liste, mit dem Advisory-Link und der einen Maßnahme, die sie ergreifen müssen.
  • Informieren Sie Support und Vertrieb vor der Veröffentlichung, mit dem Advisory und einem kurzen FAQ, damit ihre Antworten dazu passen.
  • Informieren Sie nachgelagerte Anbieter, die Ihr Produkt einbetten, damit ihre eigenen Advisories schnell folgen können.
  • Haken Sie nach bei Kunden, die auf betroffenen Versionen bleiben.

Nur die betroffenen Kunden anzuschreiben setzt voraus, dass Sie wissen, welche Produktversionen jeder betreibt. Für eine Schwachstelle in einer Drittkomponente, die viele Anbieter zugleich getroffen hat, siehe wie Sie Kunden nach einem Angriff auf die Lieferkette antworten, mit Vorlagen.

Sollten Sie eine CNA werden?

Eine CVE Numbering Authority (CNA) vergibt CVE-IDs und veröffentlicht CVE-Einträge für Schwachstellen in einem vereinbarten Bereich, meist den eigenen Produkten. Als CNA bestimmen Sie, wann der CVE-Eintrag erscheint, vergeben IDs, ohne Details unter Embargo mit einer anderen CNA zu teilen, und schreiben den Eintrag selbst.

Laut dem CVE-Programm gibt es weder eine Gebühr noch einen Vertrag. Eine CNA muss eine öffentliche Richtlinie zur Offenlegung von Schwachstellen haben, eine öffentliche Quelle für neue Offenlegungen (Ihre Advisory-Seite) und den Nutzungsbedingungen des Programms zustimmen. Das Onboarding läuft über ein Registrierungsformular, eine Einführungssitzung und Übungsbeispiele. In der EU fungiert die ENISA als Root für Organisationen in ihrem Bereich, darunter Technologieanbieter und Open-Source-Projekte.

  • Es passt zu einem Anbieter, der regelmäßig CVEs für eigene Produkte veröffentlicht, bereits ein PSIRT und eine Advisory-Seite betreibt und das Timing selbst bestimmen will.
  • Es muss nicht Ihr erster Schritt sein, wenn Sie eine Handvoll CVEs pro Jahr veröffentlichen oder Ihre Produkte Open-Source-Pakete auf GitHub sind, wo GitHub die IDs im Rahmen des Advisorys vergeben kann.

Zu CVE-IDs ohne eigene CNA siehe koordinierte Offenlegung von Schwachstellen.

Wo CRACI ins Spiel kommt: die betroffenen Versionen

Der größte Teil eines Advisorys ist Schreibarbeit. Das Feld, das Nachweise braucht, sind die betroffenen Versionen, und bei Schwachstellen in Drittkomponenten ist es auch das, das am schwersten richtig zu bekommen ist: welche Ihrer Releases die verwundbare Version ausgeliefert haben, auch als transitive Abhängigkeit, und seit wann.

CRACI führt Ihre GitHub-Actions-Builds auf eigenen Runnern aus und zeichnet die Pakete auf, die jeder Job tatsächlich geladen hat, einschließlich transitiver Abhängigkeiten und Pakete, die aus CI-Caches wiederhergestellt wurden. Jedes Paket zeigt seine Advisories (CVE-, GHSA- und andere IDs) mit Schweregrad. Die Build-Historie zeigt jeden früheren Build und seine SBOM sowie, welche Builds eine verwundbare Abhängigkeit enthielten. So kennen Sie den Zeitraum, in dem Sie betroffen waren, innerhalb Ihrer Aufbewahrungsfrist (standardmäßig 180 Tage, bei Enterprise individuell). Sicherheitsteams sichten die Befunde und leiten sie an die Teams weiter, die für den Fix zuständig sind, und CRACI benachrichtigt die zuständigen Personen über eine Schwachstelle und ihren Schweregrad. Siehe Schwachstellenverfolgung.

Wenn eine aktiv ausgenutzte Schwachstelle die Meldepflicht des CRA auslöst, bereitet CRACI den Inhalt der Meldungen vor (Frühwarnung, Meldung und Abschlussbericht); eine Person in Ihrem Unternehmen reicht sie über die Single Reporting Platform ein.

Wann CRACI nicht die Antwort ist

  • Advisories schreiben und veröffentlichen. CRACI schreibt und veröffentlicht keine Security Advisories, weder in CSAF noch in einem anderen Format. Nutzen Sie dafür Ihre eigene Website, GitHub Security Advisories oder ein CSAF-Tool.
  • Meldungen annehmen. CRACI nimmt keine Schwachstellenmeldungen von Forschenden oder Kunden entgegen und verfolgt sie nicht als Fälle. Nutzen Sie Ihr Offenlegungspostfach, das Private Vulnerability Reporting von GitHub oder ein Fallmanagement-Tool.
  • Schwachstellen in Ihrem eigenen Code. CRACI gleicht Advisories mit den Paketen ab, die Ihre Builds geladen haben. Bei einem Fehler wie dem Path Traversal im Beispiel, in Ihrem eigenen Code, braucht es ein Code-Review, um herauszufinden, wann er eingeführt wurde.
  • Builds außerhalb von GitHub Actions. CRACI unterstützt heute GitHub Actions; GitLab CI und Jenkins stehen auf der Roadmap.
  • Releases, die älter sind als Ihre Aufbewahrungsfrist. Die Build-Historie umfasst die Builds, die CRACI aufgezeichnet und aufbewahrt hat.

Security Advisories: häufig gestellte Fragen

Was ist ein Security Advisory?

Ein Security Advisory ist eine Mitteilung des Anbieters eines Produkts, die eine Schwachstelle im Produkt beschreibt: welche Produkte und Versionen betroffen sind, wie schwer sie wiegt, was ein Angreifer tun könnte und wie man sie behebt oder abschwächt. Es trägt meist eine CVE-ID und wird veröffentlicht, sobald ein Fix verfügbar ist.

Was ist der Unterschied zwischen einem Security Advisory und einem Security Bulletin?

Ein Advisory behandelt meist eine Schwachstelle oder einige zusammenhängende im Detail. Ein Bulletin fasst viele Fixes für ein Release oder einen Zeitraum zusammen, oft nach festem Zeitplan; Android veröffentlicht seine Security Bulletins zum Beispiel monatlich. Manche Anbieter verwenden die beiden Begriffe synonym.

Was sollte ein Security Advisory enthalten?

Eine Advisory-ID und eine CVE-ID, einen Titel, betroffene Produkte und Versionen als Bereiche pro Zweig, geprüfte und nicht betroffene Produkte, behobene Versionen, den Schweregrad mit vollständigem CVSS-Vektor, die CWE, eine Beschreibung, die Auswirkung und ihre Voraussetzungen, Workarounds, eine Danksagung, eine Zeitachse, Referenzen und eine Revisionshistorie.

Wie erstelle ich ein GitHub Security Advisory?

Öffnen Sie in einem öffentlichen Repository den Tab Security and quality, klicken Sie unter Reporting auf Advisories und dann auf New draft security advisory. Füllen Sie Titel, Beschreibung, betroffene Produkte, Schweregrad, CWE und Credits aus und speichern Sie den Entwurf. Wenn der Fix veröffentlicht ist, fragen Sie bei Bedarf eine CVE an und klicken Sie auf Publish advisory.

Kann GitHub meinem Advisory eine CVE-ID zuweisen?

Ja, sofern Ihr Projekt nicht in den Bereich einer anderen CNA fällt. GitHub ist eine CVE Numbering Authority. Fragen Sie die CVE aus dem Advisory-Entwurf an; die Anfrage macht das Advisory nicht öffentlich, und laut GitHub werden Anfragen meist innerhalb von 72 Stunden geprüft. GitHub veröffentlicht die CVE-Details, sobald das Advisory öffentlich ist.

Sollten Security Advisories maschinenlesbar sein?

Zunehmend ja. Veröffentlichen Sie eine Webseite für Menschen und ergänzen Sie eine maschinenlesbare Fassung für Kunden, die automatisieren: CSAF für Produkte, die an Unternehmen und Industrie verkauft werden, OSV für Open-Source-Pakete und VEX, um zu sagen, welche bekannten Schwachstellen Ihr Produkt nicht betreffen. Erzeugen Sie sie aus demselben Datensatz.

Wann sollte ein Security Advisory veröffentlicht werden?

Gleichzeitig mit den behobenen Versionen, nach einer etwaigen Vorabinformation wichtiger Kunden und nachgelagerter Anbieter unter Embargo. Veröffentlichen Sie früher, mit Abhilfemaßnahmen, nur wenn die Schwachstelle bereits öffentlich ist oder ausgenutzt wird, und aktualisieren Sie das Advisory, wenn der Fix erscheint.

Muss ich eine CNA sein, um ein Security Advisory zu veröffentlichen?

Nein. Jeder kann ein Advisory veröffentlichen. Eine CVE Numbering Authority zu sein bedeutet nur, dass Sie CVE-IDs selbst vergeben können. Ohne diesen Status kann eine CNA, in deren Bereich Ihr Produkt fällt, GitHub für Open-Source-Projekte auf GitHub oder eine CNA of Last Resort die ID vergeben.

Wissen, welche Releases als betroffen gelten

Ein Advisory ist nur so genau wie seine betroffenen Versionen. Buchen Sie eine Demo und sehen Sie, welche Ihrer GitHub-Actions-Builds ein verwundbares Paket enthielten.

Demo buchen