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:
- Klik op de hoofdpagina van de repository op Settings.
- Klik in de sectie Security and quality van de zijbalk op Advanced Security.
- Klik op Enable naast Private vulnerability reporting.
Link er daarna naar vanuit uw SECURITY.md en uw disclosurebeleid.
Een draft-advisory aanmaken
- Open op de hoofdpagina van de repository het tabblad Security and quality.
- Klik in de zijbalk onder Reporting op Advisories en daarna op New draft security advisory.
- Voer een titel in. Voer onder CVE identifier een bestaande CVE-ID in of kies ervoor er later een bij GitHub aan te vragen.
- Schrijf de beschrijving: de kwetsbaarheid, de impact, patches, workarounds en referenties.
- Stel onder Affected products het ecosysteem, de packagenaam, de getroffen versies en de gepatchte versies in. Voeg voor elk package een product toe.
- Stel de ernst in, of kies Assess severity using CVSS en vul de calculator in.
- Voeg de CWE toe onder Weaknesses en de melder onder Credits.
- 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
- Open de draft via Security and quality en daarna Advisories.
- 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.
- Breng de gerepareerde versies uit en zorg dat de advisory ze als gepatchte versies noemt.
- 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:
- 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.
- 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.
- Release: de gerepareerde versies gaan uit.
- Publiceren: de advisorypagina, het CVE-record, de CSAF- of OSV-documenten en het feeditem gaan samen live, idealiter binnen hetzelfde uur als de release.
- 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
Policylinkt naar uw disclosurebeleid, en de CSAF-standaard definieert een veldCSAFdat 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