Vuonna 2026 raportoitiin päivässä 138% enemmän CVE:itä kuin edellisenä vuonna.Uutta: aina päällä olevat Fixboxit. Haavoittuvat riippuvuudet korjattuina ja varmistettuina.

PSIRT

Tietoturvatiedote: näin kirjoitat sen, pohja ja esimerkki mukana

Tietoturvatiedote on dokumentti, jonka perusteella asiakkaasi toimivat, kun haavoittuvuus koskee tuotettasi. Hyvä tiedote kertoo ilman tukipyyntöä, koskeeko haavoittuvuus heitä, kuinka vakavasti ja mitä heidän pitää tehdä. Tämä opas käy läpi kentät, täydellisen esimerkin, koneluettavat muodot, GitHub Security Advisoriesin ja julkaisun ajoituksen.

Päivitetty

Mikä on tietoturvatiedote?

Tietoturvatiedote (security advisory) on tuotteen toimittajan julkaisema ilmoitus, joka kuvaa tuotteen haavoittuvuuden: mihin tuotteisiin ja versioihin se vaikuttaa, kuinka vakava se on, mitä hyökkääjä voisi tehdä ja miten käyttäjät korjaavat tai lieventävät sen. Se kirjoitetaan tuotetta käyttäville ihmisille ja yhä useammin myös heidän työkaluilleen.

Tietoturvatiedotteet ovat koordinoidun haavoittuvuuksien julkistamisen julkinen pää: löytäjä ilmoittaa luottamuksellisesti, toimittaja korjaa, ja tiedotteesta kaikki muut saavat tietää asiasta. Useimmissa ohjelmisto- ja laiteyrityksissä ne kirjoittaa PSIRT osana laajempaa tuoteturvallisuusohjelmaa.

Tietoturvatiedote vs. tietoturvakooste, CVE-tietue, VEX ja julkaisutiedot

Nämä dokumentit menevät osittain päällekkäin, ja tiimit sekoittavat ne usein:

Dokumentti Kuka sen julkaisee Mitä se kattaa Pääasiallinen lukija
Tietoturvatiedote (security advisory) Tuotteen toimittaja tai koordinaattori Yksi haavoittuvuus tai muutama toisiinsa liittyvä tuotteissasi: haavoittuvat versiot, vakavuus, korjaus Asiakkaiden ylläpitäjät ja tietoturvatiimit
Tietoturvakooste (security bulletin) Toimittaja, usein kiinteän aikataulun mukaan Yhteenveto useista korjauksista yhdessä julkaisussa tai jaksossa. Esimerkiksi Androidin security bulletinit julkaistaan kunkin kuukauden ensimmäisenä maanantaina. Tiimit, jotka paikkaavat syklin mukaan
CVE-tietue CVE Numbering Authority (CNA) Maailmanlaajuinen tunniste ja vähimmäiskuvaus yhdestä haavoittuvuudesta: haavoittuva tuote, ongelman tyyppi, kuvaus ja vähintään yksi julkinen viite Haavoittuvuustietokannat ja skannerit
VEX-lausunto Toimittaja Koneluettava tila tuotteittain ja haavoittuvuuksittain: affected, not affected, fixed, under investigation Asiakkaiden skannerit
Julkaisutiedot (release notes) Toimittaja Kaikki julkaisun muutokset, tietoturvakorjaukset muiden muutosten joukossa Kaikki päivittäjät

Tavallinen käytäntö: yksi tietoturvatiedote haavoittuvuutta kohden, CVE-tunnisteella, joka yhdistää sen CVE-tietueeseen, ja siihen linkitetään jokaisen korjatun version julkaisutiedoista sekä koosteesta, jos julkaiset sellaisen. Termejä ”security bulletin” ja ”security advisory” käytetään joskus synonyymeinä; olennaista on, että jokaisella haavoittuvuudella on pysyvä sivu, johon asiakkaat voivat viitata.

Mitä tietoturvatiedotteeseen pitää sisältyä

Alla olevia kenttiä asiakkaat etsivät, ja ne vastaavat yksi yhteen tämän oppaan myöhemmin esittelemiä koneluettavia muotoja. CVE-ohjelman CNA-säännöt asettavat CVE-tietueelle vähimmäistason: vähintään yksi haavoittuva tuote ja versio, haavoittuvuuden tyyppi tai syy (mieluiten CWE:nä), sanallinen kuvaus ja julkinen viite. Hyödyllinen tietoturvatiedote menee pidemmälle.

Kenttä Mitä se kertoo Yleinen virhe
Tiedotteen tunniste Oma pysyvä tunnisteesi, kuten EXC-2026-007, sekä CVE-tunniste Pelkkä CVE-tunniste, jota sinulla ei ehkä vielä ole sinä päivänä, kun sinun pitää julkaista
Otsikko Tuote, haavoittuvuuden tyyppi ja vaikutus yhdellä rivillä ”Tietoturvapäivitys tuotteelle X”, joka ei kerro mitään
Haavoittuvat tuotteet ja versiot Jokainen haavoittuva tuote ja versio, vaihteluväleinä julkaisuhaaroittain ”Versiot ennen 4.2.2:ta”, mikä virheellisesti sisältää haarat, joissa vikaa ei koskaan ollut
Ei haavoittuvat Tuotteet ja versiot, jotka tarkistit ja totesit, ettei haavoittuvuus koske niitä Kentän pois jättäminen, jolloin jokainen vanhemman version asiakas avaa tukipyynnön
Korjatut versiot Ensimmäinen korjattu versio jokaisessa tuetussa haarassa Vain uusimman julkaisun mainitseminen
Vakavuus Luokitus ja koko CVSS-vektori CVSS-versioineen Pelkkä pistemäärä ilman vektoria, jota kukaan ei voi tarkistaa tai sovittaa omaan ympäristöönsä
Heikkous CWE-tunniste ja -nimi Sen pois jättäminen; tietokannat ja CVE-säännöt odottavat sitä
Kuvaus Mikä vika on ja missä, riittävän tarkasti altistumisen arvioimiseksi, ilman toimivaa hyökkäyskoodia Niin epämääräinen, etteivät asiakkaat pysty päättelemään, onko heidän kokoonpanonsa alttiina
Vaikutus Mitä hyökkääjä saa ja mitä hän tarvitsee ensin (pääsy, rooli, sijainti verkossa) CVSS-mittareiden toistaminen sanoin seurausten selittämisen sijaan
Kiertotiet ja lievennykset Mitä tehdä, jos et voi päivittää tänään, ja miten tarkistaa, onko haavoittuvuutta hyödynnetty ”Ei kiertoteitä”, vaikka kokoonpanomuutos estäisi hyökkäyksen
Kiitokset Kuka löysi ja ilmoitti haavoittuvuuden, hänen suostumuksellaan Kiitos henkilölle, joka pyysi pysyä nimettömänä
Aikajana Ilmoitettu, vahvistettu, korjattu, julkaistu Sen pois jättäminen, jolloin pitkät viiveet näyttävät salatuilta
Viitteet CVE-tietue, julkaisutiedot, korjaus-commit, koneluettavat versiot Linkit sisäisiin tiketteihin, joita asiakkaat eivät voi avata
Muutoshistoria Jokainen muutos ensimmäisen julkaisun jälkeen päivämäärineen ja versioineen Haavoittuvien versioiden muuttaminen hiljaa

Vaikein kenttä on haavoittuvat versiot. Haavoittuva koodi tuli mukaan jossain vaiheessa ja korjattiin toisessa, ja jokaisella tuetulla haaralla on oma korjauksensa. Jos haavoittuvuus tuli kolmannen osapuolen komponentin mukana, kysymykseksi muuttuu, missä julkaisuissasi komponentin haavoittuva versio toimitettiin, suoraan tai transitiivisena riippuvuutena. Katso miten uusi CVE arvioidaan kaikissa buildeissasi.

Esimerkki

Tässä on täydellinen tietoturvatiedote kuvitteellisesta tuotteesta: Example Gateway, Example Corpin itse ylläpidettävä API-yhdyskäytävä, jolla on kaksi tuettua haaraa, 3.9 ja 4.x. Haavoittuva päätepiste lisättiin versiossa 3.9.0, joten haavoittuvuus ei koske versiota 3.8 ja sitä vanhempia. Kaikki nimet, tunnisteet ja päivämäärät ovat keksittyjä; CVSS 4.0 -pisteet on laskettu esitetystä vektorista.

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

Kolme asiaa tekee tästä tiedotteesta toimivan:

  • Vaihteluvälit haaroittain. ”4.0.0–4.2.1” ja ”3.9.0–3.9.6” ovat tarkkoja. ”Ennen 4.2.2:ta” olisi kertonut jokaiselle 3.8-asiakkaalle, että haavoittuvuus koskee heitä.
  • Vaikutus nimeää ennakkoehdon. Asiakas, jolla ei ole viewer-tilejä, tietää todellisen altistumisensa olevan pieni; asiakas, jolla on satoja alihankkijoita viewer-roolissa, tietää, ettei se ole.
  • Kiertotie sisältää jatkotoimet. Päivitys sulkee aukon, mutta ei peru vuotanutta salaisuutta, joten tiedote kertoo, mitä pitää vaihtaa.

Kopioitava tietoturvatiedotepohja

Korvaa hakasulkeissa olevat osat. Poista osio vain, jos se ei todella koske tapausta, ja kerro se mieluummin kuin jätät kohdan tyhjäksi siellä, missä asiakkaat sitä odottavat (esimerkiksi ”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

Ihmisluettavat vs. koneluettavat tietoturvatiedotteet

Verkkosivu riittää ihmisille. Se ei riitä asiakkaalle, jolla on tuhansia laitteita tai satoja palveluja ja jonka työkalujen on verrattava tiedotettasi siihen, mitä he ajavat. Sen tekee kolme muotoperhettä, ja ne vastaavat eri tarpeisiin:

Muoto Mikä se on Käytä, kun
Verkkosivu (ja PDF) Tietoturvatiedote sellaisena kuin ihmiset sen lukevat Aina. Jokainen muu muoto linkittää siihen.
CSAF 2.0 OASIS-standardi tietoturvatiedotteille JSON-muodossa: tuotepuu, tuotteiden tilaluettelot, korjaustoimet, muutoshistoria ja jakelusäännöt Myyt tuotteita, kuten laiteohjelmistoja, laitteita tai yritysohjelmistoja, asiakkaille, jotka automatisoivat tietoturvatiedotteiden vastaanoton, usein teollisuuden ja suuryritysten ostajille
OSV Open Source Vulnerability -muoto: JSON-merkinnät nimetyn ekosysteemin paketeille versiovälien kanssa. GitHub Advisory Database julkaisee tiedotteensa tässä muodossa. Toimitat avoimen lähdekoodin paketteja npm:n, PyPI:n, Mavenin, Go-moduulien ja vastaavien ekosysteemien kautta
VEX (CSAF VEX, CycloneDX VEX, OpenVEX) Lausunnot siitä, koskeeko tunnettu haavoittuvuus tuotetta vai ei, ja miksi Asiakkaat skannaavat SBOMisi ja kysyvät CVE:istä komponenteissa, jotka eivät vaikuta tuotteeseesi

CSAF 2.0:ssa esimerkistä tulee csaf_security_advisory-dokumentti: tiedotteen tunniste menee kenttään document/tracking/id, muutoshistoria kenttään document/tracking/revision_history, haavoittuvat ja korjatut versiot kunkin haavoittuvuuden product_status-luetteloihin, CWE sen cwe-objektiin ja kiertotiet kenttään remediations. Yksi sudenkuoppa: CSAF 2.0:n pisteet hyväksyvät vain CVSS v2:n ja v3.x:n. CVSS v4.0 -tuki tulee CSAF 2.1:ssä, joka on vielä luonnos, joten CSAF 2.0 -tiedotteessa on joko CVSS 3.1 -vektori tai 4.0-vektori huomautuksessa.

Sama tiedote OSV-merkintänä tiimeille, jotka toimittavat yhdyskäytävän myös npm-pakettina (ote):

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

Huomaa, että vaihteluvälissä on kaksi introduced–fixed-paria. OSV-skeema pitää versiota haavoittuvana, jos se osuu mihin tahansa väliin tai on eksplisiittisessä versions-luettelossa, ja suosittelee kenttää fixed kentän last_affected sijaan, koska viimeiseen haavoittuvaan versioon perustuva raja voi jättää osumia huomaamatta.

Päätössääntö: julkaise aina verkkosivu ja CVE. Lisää OSV, yleensä julkaisemalla GitHubin kautta, jos toimitat avoimen lähdekoodin paketteja. Lisää CSAF, jos myyt tuotteita organisaatioille, jotka pyytävät koneluettavia tietoturvatiedotteita, tai toimit EU:n kyberkestävyyssäädöksen (Cyber Resilience Act, CRA) alaisena; sen 14 artiklan 8 kohta edellyttää tarvittaessa jäsenneltyä, koneluettavaa muotoa, kun käyttäjille tiedotetaan aktiivisesti hyödynnetyistä haavoittuvuuksista. Lisää VEX, kun asiakkaat alkavat lähettää sinulle skannerituloksia komponenteistasi. Tuota kaikki muodot yhdestä kirjauksesta, jotta ne eivät koskaan ole ristiriidassa.

GitHub Security Advisories

Jos projektisi on julkinen repositorio GitHubissa, GitHubin repository security advisories -toiminto tarjoaa koko kulun yhdessä paikassa: yksityisen luonnoksen haavoittuvuuden käsittelyyn, väliaikaisen yksityisen forkin sen korjaamiseen, CVE-pyynnön ja julkaisun. Neljä osaa sopii yhteen:

  • Repository security advisories: repositorioosi kuuluvat luonnokset ja julkaistut tietoturvatiedotteet.
  • Private vulnerability reporting: ”Report a vulnerability” -painike repositorion Advisories-sivulla, jotta tutkijat voivat ilmoittaa sinulle luottamuksellisesti julkisen issuen avaamisen sijaan.
  • CVE-tunnisteet GitHubilta: GitHub on CNA ja voi myöntää tiedotteellesi CVE-tunnisteen, ellei projektisi kuulu jonkin toisen CNA:n vastuualueeseen.
  • GitHub Advisory Database: tuetuissa ekosysteemeissä GitHub julkaisee tiedotteesi siellä OSV-muodossa ja voi käyttää sitä Dependabot-hälytysten lähettämiseen repositorioille, jotka riippuvat paketistasi.

Ota private vulnerability reporting käyttöön

Julkisen repositorion omistajat ja ylläpitäjät voivat ottaa sen käyttöön:

  1. Napsauta repositorion pääsivulla Settings.
  2. Napsauta sivupalkin Security and quality -osiossa Advanced Security.
  3. Napsauta Enable kohdan Private vulnerability reporting vieressä.

Linkitä siihen sitten SECURITY.md-tiedostostasi ja julkistamiskäytännöstäsi.

Luo tiedoteluonnos

  1. Avaa repositorion pääsivulla Security and quality -välilehti.
  2. Napsauta sivupalkissa kohdan Reporting alla Advisories ja sitten New draft security advisory.
  3. Kirjoita otsikko. Syötä kohtaan CVE identifier olemassa oleva CVE-tunniste tai valitse, että pyydät sen GitHubilta myöhemmin.
  4. Kirjoita kuvaus: haavoittuvuus, sen vaikutus, korjaukset, kiertotiet ja viitteet.
  5. Aseta kohdassa Affected products ekosysteemi, paketin nimi, haavoittuvat versiot ja korjatut versiot. Lisää tuote jokaiselle paketille.
  6. Aseta vakavuus tai valitse Assess severity using CVSS ja täytä laskuri.
  7. Lisää CWE kohtaan Weaknesses ja ilmoittaja kohtaan Credits.
  8. Napsauta Create draft security advisory.

Luonnos pysyy yksityisenä. Siitä voit lisätä yhteistyökumppaneita, aloittaa väliaikaisen yksityisen forkin korjauksen valmisteluun ja käydä yksityiskohdat läpi ilmoittajan kanssa.

Pyydä CVE ja julkaise

  1. Avaa luonnos kohdasta Security and quality ja sitten Advisories.
  2. Napsauta lomakkeen alareunassa Request CVE. CVE:n pyytäminen ei tee tiedotteesta julkista, ja GitHubin mukaan se käsittelee pyynnöt yleensä 72 tunnin kuluessa, joten pyydä ajoissa.
  3. Julkaise korjatut versiot ja varmista, että tiedote nimeää ne korjattuina versioina.
  4. Napsauta Publish advisory. Väliaikainen yksityinen fork poistetaan, GitHub julkaisee CVE:n tiedot, ja tuetuissa ekosysteemeissä tiedote päätyy GitHub Advisory Databaseen. Dependabot-hälytyksissä voi kestää jopa 72 tuntia.

Jos julkaiset ilman korjattua versiota, GitHub varoittaa, että Dependabot hälyttää käyttäjille ehdottamatta turvallista versiota. GitHubin tietoturvatiedotetietokanta tukee sekä CVSS 3.1:tä että 4.0:aa. Vaiheet noudattavat GitHub Docsia marraskuun 2026 tilanteen mukaan; GitHubin käyttöliittymän nimikkeet muuttuvat ajoittain.

GitHubin tietoturvatiedotteet sopivat avoimen lähdekoodin paketeille GitHubin tukemissa ekosysteemeissä. Laiteohjelmistoissa, laitteissa ja suljetun lähdekoodin tuotteissa julkaise omalla sivustollasi, CSAF-muodossa siellä, missä asiakkaat sitä odottavat, ja hanki CVE omalta CNA:ltasi tai sellaiselta, jonka vastuualue kattaa sinut.

Milloin julkaista: ajoitus ja embargo

Embargo eli ajanjakso luottamuksellisesta ilmoituksesta julkaisuun, ja se, kuinka kauan sen pitäisi kestää, kuuluvat julkistamiskäytäntöösi. Tietoturvatiedotteen tehtävä on osua sen sisällä oikeaan hetkeen. Tyypillinen julkaisupäivä etenee näin:

  1. Ennen julkaisupäivää: korjaukset ovat valmiina jokaisessa tuetussa haarassa, CVE-tunniste on varattu, ja tiedote sekä jokainen koneluettava versio on kirjoitettu ja tarkistettu.
  2. Ennakkoilmoitus, jos annat sellaisen: suuret asiakkaat, tuotettasi omiinsa sisällyttävät jatkojalostavat toimittajat ja koordinaattorit saavat tiedotteen embargon alaisena muutamaa päivää etukäteen, jotta he ovat valmiita vastaamaan omille asiakkailleen.
  3. Julkaisu: korjatut versiot julkaistaan.
  4. Tiedottaminen: tiedotesivu, CVE-tietue, CSAF- tai OSV-dokumentit ja syötteen merkintä julkaistaan yhdessä, mieluiten saman tunnin sisällä julkaisusta.
  5. Ilmoittaminen: postituslista ja suorat ilmoitukset asiakkaille, joita haavoittuvuus koskee.

Järjestyksellä on väliä. Jos korjaus julkaistaan ensin ilman tiedotetta, hyökkääjät voivat verrata julkaisua edelliseen, kun taas puolustajat eivät tiedä päivittää. Tiedotteen julkaiseminen ilman korjausta on oikein vain, kun haavoittuvuus on jo julkinen tai sitä hyödynnetään: julkaise silloin se, mitä tiedät, lievennyksineen, ja päivitä tiedote, kun korjaus julkaistaan.

Kyberkestävyyssäädöksen nojalla aktiivisesti hyödynnetty haavoittuvuus käynnistää myös erillisen ilmoitusvelvollisuuden viranomaisille: ennakkovaroitus 24 tunnin kuluessa keskitetyn raportointialustan (Single Reporting Platform) kautta, sitten ilmoitus ja loppuraportti. Se ei ole tietoturvatiedotteesi, eikä se ole julkinen. CRA:n liite I edellyttää myös, että valmistajat julkistavat tiedot korjatuista haavoittuvuuksista, kun tietoturvapäivitys on saatavilla, ja juuri sen tietoturvatiedote tekee. Katso mitä CRA vaatii.

Julkaiseminen: missä tietoturvatiedotteet sijaitsevat

  • Pysyvä sivu jokaiselle tiedotteelle osoitteessa, joka ei koskaan muutu, kuten /security/advisories/exc-2026-007, sekä hakemistosivu, joka luettelee jokaisen tiedotteen tuotteineen, vakavuuksineen ja päivämäärineen.
  • Syöte. Hakemiston RSS- tai Atom-syötteen avulla ihmiset voivat tilata tiedotteet ilman postituslistaa.
  • CSAF-tarjoajan metatiedot, jos julkaiset CSAF:ää: provider-metadata.json-tiedosto ja dokumenttien hakemisto tai ROLIE-syöte, jotta työkalut löytävät jokaisen tiedotteen ilman haravointia. Katso roolit ja vaatimukset sivulta CSAF.
  • Viittaus security.txt-tiedostossa. Policy-kenttä linkittää julkistamiskäytäntöösi, ja CSAF-standardi määrittelee CSAF-kentän, joka ohjaa työkalut tarjoajan metatietoihisi:
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ä koskaan poista julkaistua tietoturvatiedotetta. Jos se osoittautuu virheelliseksi, julkaise uusi versio, joka kertoo, mikä muuttui; jos haavoittuvuus ei ollut todellinen, merkitse tiedote peruutetuksi ja kerro miksi.

Asiakkaille ilmoittaminen

Julkaiseminen ei tarkoita, että tiedote luetaan. Asiakkaat, jotka eivät tilaa syötettäsi, eivät näe tiedotetta ennen kuin heidän skannerinsa liputtaa CVE:n tai joku kysyy heiltä siitä. Korkean ja kriittisen vakavuuden tiedotteissa:

  • Lähetä sähköpostia asiakkaille, jotka ajavat haavoittuvia versioita, älä koko listallesi, tiedotteen linkin ja sen yhden toimenpiteen kanssa, joka heidän on tehtävä.
  • Perehdytä tuki- ja myyntitiimisi ennen julkaisua tiedotteella ja lyhyellä UKK:lla, jotta heidän vastauksensa vastaavat sitä.
  • Kerro jatkojalostaville toimittajille, jotka sisällyttävät tuotteesi omiinsa, jotta heidän omat tiedotteensa voivat seurata nopeasti.
  • Seuraa asiakkaita, jotka jäävät haavoittuviin versioihin.

Sähköpostin lähettäminen vain asiakkaille, joita haavoittuvuus koskee, edellyttää tietoa siitä, mitä tuoteversioita kukin heistä ajaa. Kolmannen osapuolen komponentin haavoittuvuudesta, joka osui moneen toimittajaan kerralla, kerrotaan sivulla miten vastata asiakkaille toimitusketjuhyökkäyksen jälkeen, jossa on myös pohjia.

Kannattaako sinun ryhtyä CNA:ksi?

CVE Numbering Authority (CNA) myöntää CVE-tunnisteita ja julkaisee CVE-tietueita sovitun vastuualueen, yleensä omien tuotteidensa, haavoittuvuuksista. CNA:na päätät itse, milloin CVE-tietue ilmestyy, voit myöntää tunnisteita jakamatta embargon alaisia yksityiskohtia toiselle CNA:lle ja kirjoitat tietueen itse.

CVE-ohjelman mukaan maksua tai sopimusta ei ole. CNA:lla on oltava julkinen haavoittuvuuksien julkistamiskäytäntö, julkinen lähde uusille haavoittuvuusjulkistuksille (tietoturvatiedotesivusi), ja sen on hyväksyttävä ohjelman käyttöehdot. Mukaan tulo etenee rekisteröitymislomakkeen, perehdytystilaisuuden ja harjoitustehtävien kautta. EU:ssa ENISA toimii Rootina vastuualueensa organisaatioille, mukaan lukien teknologiatoimittajat ja avoimen lähdekoodin projektit.

  • Se sopii toimittajalle, joka julkaisee säännöllisesti CVE:itä omista tuotteistaan, jolla on jo PSIRT ja tietoturvatiedotesivu ja joka haluaa päättää ajoituksesta.
  • Sen ei tarvitse olla ensimmäinen askeleesi, jos julkaiset vuodessa kourallisen CVE:itä tai jos tuotteesi ovat avoimen lähdekoodin paketteja GitHubissa, jossa GitHub voi myöntää tunnisteet osana tiedotetta.

CVE-tunnisteiden saamisesta ilman CNA-asemaa kerrotaan sivulla koordinoitu haavoittuvuuksien julkistaminen.

Missä CRACI auttaa: haavoittuvat versiot

Suurin osa tietoturvatiedotteesta on kirjoittamista. Näyttöä vaativa kenttä on haavoittuvat versiot, ja kolmansien osapuolten komponenttien haavoittuvuuksissa se on myös vaikein saada oikein: missä julkaisuissasi haavoittuva versio toimitettiin, myös transitiivisena riippuvuutena, ja mistä lähtien.

CRACI ajaa GitHub Actions -buildisi omilla runnereillaan ja tallentaa paketit, jotka kukin jobi todella haki, mukaan lukien transitiiviset riippuvuudet ja CI-välimuisteista palautetut paketit. Jokainen paketti näyttää tietoturvatiedotteensa (CVE-, GHSA- ja muut tunnisteet) vakavuuksineen. Buildihistoria näyttää jokaisen aiemman buildin ja sen SBOMin sekä sen, missä buildeissa oli haavoittuva riippuvuus, joten tiedät jakson, jolloin haavoittuvuus koski teitä, säilytysaikasi puitteissa (oletuksena 180 päivää, Enterprise-tilauksessa mukautettava). Tietoturvatiimit tekevät löydöksille triagen ja lähettävät ne korjauksesta vastaaville tiimeille, ja CRACI ilmoittaa haavoittuvuudesta ja sen vakavuudesta asianomaisille henkilöille. Katso haavoittuvuuksien seuranta.

Kun aktiivisesti hyödynnetty haavoittuvuus käynnistää CRA:n ilmoitusvelvollisuuden, CRACI valmistelee ilmoitusten sisällön (ennakkovaroitus, ilmoitus ja loppuraportti); yrityksesi edustaja lähettää ne keskitetyn raportointialustan kautta.

Milloin CRACI ei ole oikea ratkaisu

  • Tietoturvatiedotteen kirjoittaminen ja julkaiseminen. CRACI ei kirjoita eikä julkaise tietoturvatiedotteita CSAF- tai missään muussakaan muodossa. Käytä siihen omaa sivustoasi, GitHub Security Advisoriesia tai CSAF-työkalua.
  • Ilmoitusten vastaanotto. CRACI ei ota vastaan haavoittuvuusilmoituksia tutkijoilta tai asiakkailta eikä seuraa niitä tapauksina. Käytä julkistamiskäytäntösi postilaatikkoa, GitHubin private vulnerability reporting -toimintoa tai tapausten seurantatyökalua.
  • Haavoittuvuudet omassa koodissasi. CRACI vertaa tietoturvatiedotteita paketteihin, jotka buildisi hakivat. Esimerkin kaltainen vika omassa koodissasi, kuten polkujen läpikulku (path traversal), vaatii koodikatselmointia sen selvittämiseksi, milloin se tuli mukaan.
  • Buildit GitHub Actionsin ulkopuolella. CRACI tukee tällä hetkellä GitHub Actionsia; GitLab CI ja Jenkins ovat tiekartalla.
  • Säilytysaikaa vanhemmat julkaisut. Buildihistoria kattaa buildit, jotka CRACI on tallentanut ja säilyttänyt.

Tietoturvatiedotteet: usein kysytyt kysymykset

Mikä on tietoturvatiedote?

Tietoturvatiedote on tuotteen toimittajan julkaisema ilmoitus, joka kuvaa tuotteen haavoittuvuuden: mihin tuotteisiin ja versioihin se vaikuttaa, kuinka vakava se on, mitä hyökkääjä voisi tehdä ja miten se korjataan tai sitä lievennetään. Siinä on yleensä CVE-tunniste, ja se julkaistaan, kun korjaus on saatavilla.

Mitä eroa on tietoturvatiedotteella (security advisory) ja tietoturvakoosteella (security bulletin)?

Tietoturvatiedote käsittelee yleensä yhtä haavoittuvuutta tai muutamaa toisiinsa liittyvää yksityiskohtaisesti. Kooste kokoaa useita korjauksia yhdestä julkaisusta tai jaksosta, usein kiinteän aikataulun mukaan; esimerkiksi Android julkaisee security bulletininsa kuukausittain. Jotkut toimittajat käyttävät termejä toistensa synonyymeinä.

Mitä tietoturvatiedotteeseen pitää sisältyä?

Tiedotteen tunniste ja CVE-tunniste, otsikko, haavoittuvat tuotteet ja versiot vaihteluväleinä haaroittain, tarkistetut tuotteet, joita haavoittuvuus ei koske, korjatut versiot, vakavuus koko CVSS-vektorin kanssa, CWE, kuvaus, vaikutus ja sen ennakkoehdot, kiertotiet, kiitokset, aikajana, viitteet ja muutoshistoria.

Miten luon GitHub security advisoryn?

Avaa julkisessa repositoriossa Security and quality -välilehti, napsauta kohdan Reporting alla Advisories ja sitten New draft security advisory. Täytä otsikko, kuvaus, haavoittuvat tuotteet, vakavuus, CWE ja kiitokset, ja tallenna luonnos. Kun korjaus on julkaistu, pyydä tarvittaessa CVE ja napsauta Publish advisory.

Voiko GitHub myöntää tiedotteelleni CVE-tunnisteen?

Kyllä, jos projektisi ei kuulu toisen CNA:n vastuualueeseen. GitHub on CVE Numbering Authority. Pyydä CVE tiedoteluonnoksesta; pyyntö ei tee tiedotteesta julkista, ja GitHubin mukaan se käsittelee pyynnöt yleensä 72 tunnin kuluessa. GitHub julkaisee CVE:n tiedot, kun tiedote on julkinen.

Pitäisikö tietoturvatiedotteiden olla koneluettavia?

Yhä useammin kyllä. Julkaise verkkosivu ihmisille ja lisää koneluettava versio asiakkaille, jotka automatisoivat: CSAF yrityksille ja teollisuudelle myytäville tuotteille, OSV avoimen lähdekoodin paketeille ja VEX kertomaan, mitkä tunnetut haavoittuvuudet eivät koske tuotettasi. Tuota ne samasta kirjauksesta.

Milloin tietoturvatiedote pitäisi julkaista?

Samaan aikaan korjattujen versioiden kanssa, kun mahdolliset ennakkoilmoitukset tärkeimmille asiakkaille ja jatkojalostaville toimittajille on annettu embargon alaisina. Julkaise aiemmin, lievennysten kanssa, vain jos haavoittuvuus on jo julkinen tai sitä hyödynnetään, ja päivitä tiedote, kun korjaus julkaistaan.

Pitääkö minun olla CNA julkaistakseni tietoturvatiedotteen?

Ei. Kuka tahansa voi julkaista tietoturvatiedotteen. CVE Numbering Authorityna oleminen tarkoittaa vain, että voit myöntää CVE-tunnisteet itse. Muussa tapauksessa tunnisteen voi myöntää CNA, jonka vastuualue kattaa tuotteesi, GitHub GitHubissa oleville avoimen lähdekoodin projekteille tai CNA of Last Resort.

Tiedä, mitkä julkaisut merkitä haavoittuviksi

Tietoturvatiedote on vain niin tarkka kuin sen haavoittuvat versiot. Varaa demo ja näe, missä GitHub Actions -buildeissasi oli haavoittuva paketti.

Varaa demo