138% meer gemelde CVE's per dag in 2026 dan vorig jaar.Nieuw: altijd actieve Fixboxes. Kwetsbare afhankelijkheden, gefixt en geverifieerd.

PSIRT

Security advisory: zo schrijft u er een, met sjabloon en uitgewerkt voorbeeld

Een security advisory is het document waarop uw klanten handelen wanneer een kwetsbaarheid uw product treft. Een goede advisory beantwoordt, zonder supportticket, of ze getroffen zijn, hoe ernstig en wat ze moeten doen. Deze gids behandelt de velden, een volledig voorbeeld, de machineleesbare formaten, GitHub Security Advisories en wanneer u publiceert.

Bijgewerkt op

Wat is een security advisory?

Een security advisory is een bericht van de leverancier van een product dat een kwetsbaarheid erin beschrijft: welke producten en versies getroffen zijn, hoe ernstig ze is, wat een aanvaller zou kunnen doen, en hoe gebruikers haar oplossen of beperken. Ze is geschreven voor de mensen die het product draaien, en steeds vaker ook voor hun tools.

Advisories zijn de openbare kant van coordinated vulnerability disclosure: een vinder meldt vertrouwelijk, de leverancier repareert, en via de advisory hoort iedereen anders ervan. In de meeste software- en apparatenbedrijven schrijft het PSIRT ze, als onderdeel van een breder productbeveiligingsprogramma.

Security advisory vs security bulletin, CVE-record, VEX en release notes

Deze documenten overlappen, en teams halen ze vaak door elkaar:

Document Wie het publiceert Wat het behandelt Belangrijkste lezer
Security advisory De leverancier van het product, of een coördinator Eén kwetsbaarheid, of een paar samenhangende, in uw producten: getroffen versies, ernst, fix Beheerders en beveiligingsteams van klanten
Security bulletin De leverancier, vaak volgens een vast schema Een bundeling van veel fixes in één release of periode. De security bulletins van Android verschijnen bijvoorbeeld op de eerste maandag van elke maand. Teams die in een vaste cyclus patchen
CVE-record Een CVE Numbering Authority (CNA) De wereldwijde identificator en een minimale beschrijving van één kwetsbaarheid: getroffen product, type probleem, beschrijving en ten minste één openbare referentie Kwetsbaarheidsdatabases en scanners
VEX-verklaring De leverancier Een machineleesbare status per product en kwetsbaarheid: getroffen, niet getroffen, opgelost, in onderzoek De scanners van klanten
Release notes De leverancier Alles wat in een release is veranderd, beveiligingsfixes tussen andere wijzigingen Iedereen die upgradet

Het gebruikelijke patroon: één advisory per kwetsbaarheid, met een CVE-ID die haar aan het CVE-record koppelt, gelinkt vanuit de release notes van elke gerepareerde versie en vanuit het bulletin als u er een publiceert. "Security bulletin" en "security advisory" worden soms als synoniemen gebruikt; waar het om gaat, is dat elke kwetsbaarheid een stabiele pagina heeft die klanten kunnen aanhalen.

Wat een security advisory moet bevatten

De velden hieronder zijn waar klanten naar zoeken, en ze komen een-op-een overeen met de machineleesbare formaten verderop in deze gids. De CNA-regels van het CVE-programma leggen het minimum voor het CVE-record vast: ten minste één getroffen product en versie, het type of de oorzaak van de kwetsbaarheid (bij voorkeur als CWE), een beschrijving in tekst en een openbare referentie. Een bruikbare advisory gaat verder.

Veld Wat het zegt Veelgemaakte fout
Advisory-ID Uw eigen stabiele identificator, zoals EXC-2026-007, plus de CVE-ID Alleen de CVE-ID gebruiken, die u op de dag dat u moet publiceren misschien nog niet hebt
Titel Product, type kwetsbaarheid en impact in één regel "Beveiligingsupdate voor Product X", wat niets zegt
Getroffen producten en versies Elk getroffen product en elke getroffen versie, als bereiken per releasebranch "Versies vóór 4.2.2", wat ten onrechte branches meeneemt die de bug nooit hadden
Niet getroffen Producten en versies die u hebt gecontroleerd en niet getroffen bleken Het weglaten, zodat elke klant met een oudere versie een ticket opent
Gerepareerde versies De eerste gerepareerde versie op elke ondersteunde branch Alleen de nieuwste release noemen
Ernst Een beoordeling en de volledige CVSS-vector, met de CVSS-versie Een kale score zonder vector, die niemand kan controleren of aan zijn omgeving kan aanpassen
Zwakte De CWE-ID en -naam Hem weglaten; databases en de CVE-regels verwachten hem
Beschrijving Wat de fout is en waar, met genoeg detail om de blootstelling te beoordelen, zonder werkende exploit Zo vaag dat klanten niet kunnen zien of hun configuratie blootstaat
Impact Wat een aanvaller wint, en wat hij eerst nodig heeft (toegang, rol, netwerkpositie) De CVSS-metrics in woorden herhalen in plaats van de gevolgen uit te leggen
Workarounds en mitigaties Wat u doet als u vandaag niet kunt upgraden, en hoe u controleert of u bent aangevallen "Geen workarounds" terwijl een configuratiewijziging de aanval zou blokkeren
Credits Wie het heeft gevonden en gemeld, met diens toestemming Iemand vermelden die anoniem wilde blijven
Tijdlijn Gemeld, bevestigd, opgelost, gepubliceerd Hem weglaten, waardoor lange vertragingen verborgen lijken
Referenties CVE-record, release notes, fixcommit, machineleesbare versies Links naar interne tickets die klanten niet kunnen openen
Revisiegeschiedenis Elke wijziging na de eerste publicatie, met datum en versie Stilletjes de getroffen versies aanpassen

Het moeilijkste veld zijn de getroffen versies. De kwetsbare code is op een bepaald moment geïntroduceerd en op een ander moment gerepareerd, en elke ondersteunde branch heeft zijn eigen fix. Kwam de kwetsbaarheid binnen via een component van derden, dan wordt de vraag welke van uw releases de kwetsbare versie van dat component leverden, direct of als transitieve afhankelijkheid. Zie hoe u een nieuwe CVE over al uw builds beoordeelt.

Een uitgewerkt voorbeeld

Hier is een volledige advisory voor een fictief product: Example Gateway, een zelf gehoste API-gateway van Example Corp, met twee ondersteunde branches, 3.9 en 4.x. Het kwetsbare endpoint is toegevoegd in 3.9.0, dus 3.8 en eerder zijn niet getroffen. Alle namen, ID's en data zijn verzonnen; de CVSS 4.0-score is berekend uit de getoonde vector.

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

Drie dingen maken deze advisory goed:

  • Bereiken per branch. "4.0.0 tot en met 4.2.1" en "3.9.0 tot en met 3.9.6" zijn exact. "Vóór 4.2.2" had elke klant op 3.8 verteld dat die getroffen was.
  • De impact noemt de voorwaarde. Een klant zonder viewer-accounts weet dat zijn werkelijke blootstelling laag is; een klant met honderden externe medewerkers in de viewer-rol weet dat dat niet zo is.
  • De workaround bevat de vervolgstap. Upgraden dicht het gat, maar maakt een gelekt geheim niet ongedaan, dus de advisory zegt wat er geroteerd moet worden.

Een sjabloon voor een security advisory om te kopiëren

Vervang de delen tussen haken. Verwijder een sectie alleen als die echt niet van toepassing is, en zeg dat liever dan haar leeg te laten waar klanten haar verwachten (bijvoorbeeld "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

Leesbaar voor mensen vs machineleesbare advisories

Een webpagina volstaat voor mensen. Ze volstaat niet voor een klant met duizenden apparaten of honderden diensten, wiens tools uw advisory moeten vergelijken met wat hij draait. Drie families van formaten doen dat, en ze dienen verschillende behoeften:

Formaat Wat het is Gebruik het wanneer
Webpagina (en pdf) De advisory zoals mensen haar lezen Altijd. Elk ander formaat linkt ernaar terug.
CSAF 2.0 De OASIS-standaard voor advisories als JSON, met een productboom, lijsten met productstatussen, remediaties, een revisiegeschiedenis en regels voor distributie U verkoopt producten zoals firmware, appliances of enterprisesoftware aan klanten die de intake van advisories automatiseren, vaak industriële en zakelijke afnemers
OSV Het Open Source Vulnerability-formaat: JSON-items voor packages in een benoemd ecosysteem, met versiebereiken. De GitHub Advisory Database publiceert haar advisories in dit formaat. U levert open-sourcepackages via npm, PyPI, Maven, Go modules en vergelijkbare ecosystemen
VEX (CSAF VEX, CycloneDX VEX, OpenVEX) Verklaringen dat een product wel of niet getroffen is door een bekende kwetsbaarheid, en waarom Klanten scannen uw SBOM en vragen naar CVE's in componenten die uw product niet treffen

Het uitgewerkte voorbeeld wordt in CSAF 2.0 een csaf_security_advisory-document: de advisory-ID gaat in document/tracking/id, de revisiegeschiedenis in document/tracking/revision_history, de getroffen en gerepareerde versies in de product_status-lijsten van elke kwetsbaarheid, de CWE in het cwe-object en de workarounds in remediations. Eén addertje: scores in CSAF 2.0 ondersteunen alleen CVSS v2 en v3.x. Ondersteuning voor CVSS v4.0 komt met CSAF 2.1, dat nog een draft is, dus een CSAF 2.0-advisory bevat ofwel een CVSS 3.1-vector, ofwel geeft de 4.0-vector in een notitie.

Dezelfde advisory als OSV-item, voor teams die de gateway ook als npm-package leveren (uittreksel):

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

Merk op dat het bereik twee paren introduced-fixed bevat. Het OSV-schema beschouwt een versie als getroffen als die in een van de bereiken valt of in de expliciete versions-lijst staat, en raadt fixed aan boven last_affected, omdat een last-affected-grens tot gemiste matches kan leiden.

Beslisregel: publiceer altijd de webpagina en een CVE. Voeg OSV toe, meestal door via GitHub te publiceren, als u open-sourcepackages levert. Voeg CSAF toe als u producten verkoopt aan organisaties die om machineleesbare advisories vragen of werken onder de Europese Cyber Resilience Act, waarvan artikel 14, lid 8 vraagt om een gestructureerd, machineleesbaar formaat waar passend wanneer gebruikers worden geïnformeerd over actief misbruikte kwetsbaarheden. Voeg VEX toe zodra klanten u scanneroutput over uw componenten sturen. Genereer elk formaat uit één record, zodat ze elkaar nooit tegenspreken.

GitHub Security Advisories

Is uw project een openbare repository op GitHub, dan bieden de repository security advisories van GitHub de hele flow op één plek: een vertrouwelijke draft om de kwetsbaarheid te bespreken, een tijdelijke privéfork om haar te repareren, een CVE-aanvraag en publicatie. Vier onderdelen passen in elkaar:

  • Repository security advisories: drafts en gepubliceerde advisories die bij uw repository horen.
  • Private vulnerability reporting: een knop "Report a vulnerability" op de Advisories-pagina van de repository, zodat onderzoekers u vertrouwelijk kunnen melden in plaats van een openbare issue te openen.
  • CVE-ID's van GitHub: GitHub is een CNA en kan een CVE-ID aan uw advisory toekennen, tenzij uw project onder een andere CNA valt.
  • De GitHub Advisory Database: voor ondersteunde ecosystemen publiceert GitHub uw advisory daar, in OSV-formaat, en kan die gebruiken om Dependabot-alerts te sturen naar repositories die van uw package afhangen.

Private vulnerability reporting inschakelen

Eigenaren en beheerders van een openbare repository kunnen het inschakelen:

  1. Klik op de hoofdpagina van de repository op Settings.
  2. Klik in de sectie Security and quality van de zijbalk op Advanced Security.
  3. Klik op Enable naast Private vulnerability reporting.

Link er daarna naar vanuit uw SECURITY.md en uw disclosurebeleid.

Een draft-advisory aanmaken

  1. Open op de hoofdpagina van de repository het tabblad Security and quality.
  2. Klik in de zijbalk onder Reporting op Advisories en daarna op New draft security advisory.
  3. Voer een titel in. Voer onder CVE identifier een bestaande CVE-ID in of kies ervoor er later een bij GitHub aan te vragen.
  4. Schrijf de beschrijving: de kwetsbaarheid, de impact, patches, workarounds en referenties.
  5. Stel onder Affected products het ecosysteem, de packagenaam, de getroffen versies en de gepatchte versies in. Voeg voor elk package een product toe.
  6. Stel de ernst in, of kies Assess severity using CVSS en vul de calculator in.
  7. Voeg de CWE toe onder Weaknesses en de melder onder Credits.
  8. Klik op Create draft security advisory.

De draft blijft vertrouwelijk. Van daaruit kunt u medewerkers toevoegen, een tijdelijke privéfork starten om de fix voor te bereiden, en de details met de melder bespreken.

Een CVE aanvragen en publiceren

  1. Open de draft via Security and quality en daarna Advisories.
  2. Klik onderaan het formulier op Request CVE. Een CVE aanvragen maakt de advisory niet openbaar, en GitHub zegt aanvragen meestal binnen 72 uur te beoordelen, dus vraag op tijd aan.
  3. Breng de gerepareerde versies uit en zorg dat de advisory ze als gepatchte versies noemt.
  4. Klik op Publish advisory. De tijdelijke privéfork wordt verwijderd, GitHub publiceert de CVE-gegevens, en voor ondersteunde ecosystemen komt de advisory in de GitHub Advisory Database. Dependabot-alerts kunnen tot 72 uur duren.

Publiceert u zonder gepatchte versie, dan waarschuwt GitHub dat Dependabot gebruikers alarmeert zonder een veilige versie voor te stellen. De advisory database van GitHub ondersteunt zowel CVSS 3.1 als 4.0. De stappen volgen GitHub Docs per november 2026; labels in de GitHub-interface veranderen van tijd tot tijd.

GitHub-advisories passen bij open-sourcepackages in de ecosystemen die GitHub ondersteunt. Voor firmware, appliances of closed-sourceproducten publiceert u op uw eigen site, in CSAF waar klanten dat verwachten, en haalt u de CVE bij uw eigen CNA of een CNA waarvan de scope u dekt.

Wanneer u publiceert: timing en embargo

Het embargo, de periode tussen de vertrouwelijke melding en de publicatie, en hoe lang dat moet duren, horen in uw disclosurebeleid. De taak van de advisory is om op het juiste moment daarbinnen te verschijnen. Een typische publicatiedag verloopt zo:

  1. Vóór de dag: fixes staan klaar op elke ondersteunde branch, de CVE-ID is gereserveerd, en de advisory en elke machineleesbare versie zijn geschreven en gereviewd.
  2. Vooraankondiging, als u die geeft: grote klanten, downstream-leveranciers die uw product inbouwen en coördinatoren krijgen de advisory onder embargo een paar dagen eerder, zodat ze klaar zijn om hun eigen klanten te antwoorden.
  3. Release: de gerepareerde versies gaan uit.
  4. Publiceren: de advisorypagina, het CVE-record, de CSAF- of OSV-documenten en het feeditem gaan samen live, idealiter binnen hetzelfde uur als de release.
  5. Informeren: mailinglijst en directe berichten aan getroffen klanten.

De volgorde doet ertoe. Wie eerst de fix publiceert zonder de advisory, laat aanvallers de release diffen terwijl verdedigers niet weten dat ze moeten upgraden. Een advisory publiceren zonder fix is alleen juist als de kwetsbaarheid al openbaar is of wordt misbruikt: publiceer dan wat u weet met mitigaties, en werk de advisory bij wanneer de fix uitkomt.

Onder de Cyber Resilience Act brengt een actief misbruikte kwetsbaarheid ook een aparte plicht mee om autoriteiten te informeren: een vroegtijdige waarschuwing binnen 24 uur via het Single Reporting Platform, daarna een melding en een eindrapport. Dat is niet uw advisory, en het is niet openbaar. Bijlage I van de CRA vraagt fabrikanten ook om informatie over gerepareerde kwetsbaarheden openbaar te maken zodra er een beveiligingsupdate beschikbaar is, en dat is precies wat een advisory doet. Zie wat de CRA vereist.

Publiceren: waar advisories staan

  • Een stabiele pagina per advisory, op een URL die nooit verandert, zoals /security/advisories/exc-2026-007, plus een indexpagina die elke advisory met producten, ernst en data opsomt.
  • Een feed. Met een RSS- of Atom-feed van de index kunnen mensen zich abonneren zonder mailinglijst.
  • CSAF-providermetadata, als u CSAF publiceert: een provider-metadata.json-bestand en een directory of ROLIE-feed van de documenten, zodat tools elke advisory vinden zonder te scrapen. Zie CSAF voor de rollen en eisen.
  • Een verwijzing in security.txt. Het veld Policy linkt naar uw disclosurebeleid, en de CSAF-standaard definieert een veld CSAF dat tools naar uw providermetadata leidt:
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

Verwijder nooit een gepubliceerde advisory. Blijkt ze onjuist, publiceer dan een revisie die zegt wat er is veranderd; was de kwetsbaarheid niet echt, markeer de advisory dan als ingetrokken en zeg waarom.

Klanten informeren

Publiceren is niet hetzelfde als gelezen worden. Klanten die niet op uw feed geabonneerd zijn, zien de advisory pas wanneer hun scanner de CVE signaleert, of wanneer iemand hen ernaar vraagt. Voor advisories met ernst high en critical:

  • Mail de klanten die getroffen versies draaien, niet uw hele lijst, met de link naar de advisory en de ene actie die ze moeten nemen.
  • Bereid uw support- en salesteams voor vóór de publicatie, met de advisory en een korte FAQ, zodat hun antwoorden ermee overeenkomen.
  • Informeer downstream-leveranciers die uw product inbouwen, zodat hun eigen advisories snel kunnen volgen.
  • Volg op bij klanten die op getroffen versies blijven.

Alleen de getroffen klanten mailen vereist dat u weet welke productversies elk van hen draait. Voor een kwetsbaarheid in een component van derden die veel leveranciers tegelijk trof, zie hoe u klanten antwoordt na een supply-chainaanval, met sjablonen.

Moet u een CNA worden?

Een CVE Numbering Authority (CNA) kent CVE-ID's toe en publiceert CVE-records voor kwetsbaarheden binnen een afgesproken scope, meestal de eigen producten. Als CNA bepaalt u wanneer het CVE-record verschijnt, kent u ID's toe zonder details onder embargo met een andere CNA te delen, en schrijft u het record zelf.

Volgens het CVE-programma zijn er geen kosten en is er geen contract. Een CNA moet een openbaar disclosurebeleid hebben, een openbare bron voor nieuwe openbaarmakingen van kwetsbaarheden (uw advisorypagina) en akkoord gaan met de gebruiksvoorwaarden van het programma. De onboarding verloopt via een registratieformulier, een introductiesessie en oefenvoorbeelden. In de EU treedt ENISA op als Root voor organisaties binnen haar scope, waaronder technologieleveranciers en open-sourceprojecten.

  • Het past bij een leverancier die regelmatig CVE's voor zijn eigen producten publiceert, al een PSIRT en een advisorypagina heeft, en controle over de timing wil.
  • Het hoeft niet uw eerste stap te zijn als u een handvol CVE's per jaar publiceert, of als uw producten open-sourcepackages op GitHub zijn, waar GitHub de ID's als onderdeel van de advisory kan toekennen.

Voor CVE-ID's zonder CNA te zijn, zie coordinated vulnerability disclosure.

Waar CRACI past: de getroffen versies

Het grootste deel van een advisory is schrijfwerk. Het veld dat bewijs vraagt, zijn de getroffen versies, en bij kwetsbaarheden in componenten van derden is dat ook het moeilijkst om goed te krijgen: welke van uw releases de kwetsbare versie leverden, ook als transitieve afhankelijkheid, en sinds wanneer.

CRACI draait uw GitHub Actions-builds op eigen runners en legt de packages vast die elke job daadwerkelijk heeft opgehaald, inclusief transitieve afhankelijkheden en packages die uit CI-caches zijn hersteld. Elk package toont zijn advisories (CVE-, GHSA- en andere ID's) met ernst. De buildgeschiedenis toont elke eerdere build en de SBOM ervan, en welke builds een kwetsbare afhankelijkheid bevatten, zodat u weet in welke periode u getroffen was, binnen uw bewaartermijn (standaard 180 dagen, aanpasbaar op Enterprise). Beveiligingsteams triëren de bevindingen en sturen ze naar de teams die eigenaar zijn van de fix, en CRACI informeert de betrokken mensen over een kwetsbaarheid en de ernst ervan. Zie kwetsbaarheden volgen.

Wanneer een actief misbruikte kwetsbaarheid de meldplicht van de CRA activeert, bereidt CRACI de inhoud van de meldingen voor (vroegtijdige waarschuwing, melding en eindrapport); iemand in uw bedrijf dient ze in via het Single Reporting Platform.

Wanneer CRACI niet het antwoord is

  • De advisory schrijven en publiceren. CRACI schrijft of publiceert geen security advisories, niet in CSAF en niet in een ander formaat. Gebruik daarvoor uw eigen site, GitHub Security Advisories of een CSAF-tool.
  • Meldingen ontvangen. CRACI neemt geen kwetsbaarheidsmeldingen van onderzoekers of klanten aan en volgt ze niet als cases. Gebruik uw disclosure-inbox, private vulnerability reporting van GitHub of een casetracker.
  • Kwetsbaarheden in uw eigen code. CRACI vergelijkt advisories met de packages die uw builds hebben opgehaald. Voor een fout zoals de path traversal in het voorbeeld, in uw eigen code, is code review nodig om te vinden wanneer die is geïntroduceerd.
  • Builds buiten GitHub Actions. CRACI ondersteunt vandaag GitHub Actions; GitLab CI en Jenkins staan op de roadmap.
  • Releases ouder dan uw bewaartermijn. De buildgeschiedenis omvat de builds die CRACI heeft vastgelegd en bewaard.

Security advisories: veelgestelde vragen

Wat is een security advisory?

Een security advisory is een bericht van de leverancier van een product dat een kwetsbaarheid erin beschrijft: welke producten en versies getroffen zijn, hoe ernstig ze is, wat een aanvaller zou kunnen doen, en hoe u haar oplost of beperkt. Ze bevat meestal een CVE-ID en wordt gepubliceerd zodra er een fix beschikbaar is.

Wat is het verschil tussen een security advisory en een security bulletin?

Een advisory behandelt meestal één kwetsbaarheid, of een paar samenhangende, in detail. Een bulletin bundelt veel fixes voor één release of periode, vaak volgens een vast schema; Android publiceert zijn security bulletins bijvoorbeeld maandelijks. Sommige leveranciers gebruiken de twee woorden door elkaar.

Wat moet een security advisory bevatten?

Een advisory-ID en CVE-ID, een titel, getroffen producten en versies als bereiken per branch, gecontroleerde producten die niet getroffen zijn, gerepareerde versies, de ernst met de volledige CVSS-vector, de CWE, een beschrijving, de impact en de voorwaarden ervan, workarounds, credits, een tijdlijn, referenties en een revisiegeschiedenis.

Hoe maak ik een GitHub security advisory aan?

Open in een openbare repository het tabblad Security and quality, klik onder Reporting op Advisories en daarna op New draft security advisory. Vul de titel, beschrijving, getroffen producten, ernst, CWE en credits in en sla de draft op. Wanneer de fix is uitgebracht, vraagt u zo nodig een CVE aan en klikt u op Publish advisory.

Kan GitHub een CVE-ID aan mijn advisory toekennen?

Ja, als uw project niet onder een andere CNA valt. GitHub is een CVE Numbering Authority. Vraag de CVE aan vanuit de draft-advisory; de aanvraag maakt de advisory niet openbaar, en GitHub zegt aanvragen meestal binnen 72 uur te beoordelen. GitHub publiceert de CVE-gegevens zodra de advisory openbaar is.

Moeten security advisories machineleesbaar zijn?

Steeds vaker wel. Publiceer een webpagina voor mensen en voeg een machineleesbare versie toe voor klanten die automatiseren: CSAF voor producten die aan bedrijven en de industrie worden verkocht, OSV voor open-sourcepackages, en VEX om te zeggen welke bekende kwetsbaarheden uw product niet treffen. Genereer ze uit hetzelfde record.

Wanneer moet een security advisory worden gepubliceerd?

Tegelijk met de gerepareerde versies, na een eventuele vooraankondiging onder embargo aan belangrijke klanten en downstream-leveranciers. Publiceer alleen eerder, met mitigaties, als de kwetsbaarheid al openbaar is of wordt misbruikt, en werk de advisory bij wanneer de fix uitkomt.

Moet ik een CNA zijn om een security advisory te publiceren?

Nee. Iedereen kan een advisory publiceren. Een CVE Numbering Authority zijn betekent alleen dat u zelf CVE-ID's kunt toekennen. Zonder die status kan een CNA waarvan de scope uw product dekt, GitHub voor open-sourceprojecten op GitHub, of een CNA of Last Resort de ID toekennen.

Weet welke releases u als getroffen moet vermelden

Een advisory is zo nauwkeurig als haar getroffen versies. Plan een demo en zie welke van uw GitHub Actions-builds een kwetsbaar package bevatten.

Demo boeken