Events en payloads
Alle docs
Elke melding is een event. Op deze pagina staan alle soorten events en wat erin zit. E-mail en webhooks dragen dezelfde events, webhooks als JSON.
Soorten events
| Type | Wanneer | Standaard aan |
|---|---|---|
vulnerability.created |
Een nieuwe kwetsbaarheid raakt software die je volgt | Ja |
vulnerability.updated |
De titel, beschrijving, ernst, CVE, CWE, getroffen versies of de oplossing veranderde | Ja |
vulnerability.deleted |
De bron heeft de kwetsbaarheid ingetrokken | Ja |
vulnerability.patched |
De bron meldt dat de kwetsbaarheid is opgelost | Nee |
patch.released |
De opgeloste versie is echt te downloaden | Ja |
software.version_released |
Er is een nieuwe versie van de software | Nee |
software.closed |
WordPress.org heeft de software gesloten, of het pakket is deprecated of abandoned | Nee |
software.reopened |
Gesloten software is weer beschikbaar | Nee |
package.malicious |
Een versie van een npm-pakket dat je volgt bevat malware | Ja |
project.vulnerable |
Een nieuwe lockfile van een project voegt versies met bekende kwetsbaarheden toe | Ja |
project.resolved |
Een nieuwe lockfile van een project heeft geen bekende kwetsbaarheden meer | Ja |
vulnerability.exploited |
CISA noemt de CVE van de kwetsbaarheid actief misbruikt (KEV) | Ja |
vulnerability.exploit_published |
Er verschijnt een publieke exploit of proof of concept voor de CVE | Ja |
vulnerability.cve_assigned |
Een advisory zonder CVE krijgt zijn CVE-nummer | Nee |
cve.matched |
Een nieuwe CVE voldoet aan een van je CVE-regels | Per regel |
vulnerability.patched en patch.released verschillen bewust. De eerste betekent dat een bron zegt dat er een oplossing is. De tweede komt pas als die versie te downloaden is van WordPress.org of het pakketregister, zodat je meteen kunt updaten. Voor premium software, die geen openbare downloads heeft, volgt hij op de eerste.
Ladon stuurt patch.released alleen als de oplossing uitkwam nadat Ladon de kwetsbaarheid al kende. Was de oplossing er al toen de kwetsbaarheid werd gepubliceerd, dan staat dat in vulnerability.created.
vulnerability.exploited is de sterkste reden om nu te patchen: aanvallers gebruiken het lek. Ladon stuurt het één keer per kwetsbaarheid en software, zodra de CVE voor het eerst op CISA's lijst van actief misbruikte kwetsbaarheden staat. vulnerability.exploit_published komt als er een referentie naar een publieke exploit bij komt, vaak het moment dat een aanval makkelijk wordt. vulnerability.cve_assigned helpt bij advisories die Ladon al las voordat GitHub ze reviewde: je krijgt de advisory vroeg en het CVE-nummer later, voor tickets en rapportages.
De envelope
Elke webhook heeft dezelfde buitenkant:
| Veld | Type | Betekenis |
|---|---|---|
id |
string | Unieke id van het event, begint met evt_ |
type |
string | Een van de types hierboven |
api_version |
string | Payloadversie van dit kanaal, nu 2026-11-01 |
created_at |
string | Wanneer het event gebeurde, ISO 8601 in UTC |
team |
object | id en name van het team |
data |
object | De inhoud, zie hieronder |
links |
object | dashboard: de meldingenpagina van het project |
Voorbeeld
{
"id": "evt_01JB8Z5X2C7Q4R9T6Y3W1M0N8P",
"type": "vulnerability.created",
"api_version": "2026-11-01",
"created_at": "2026-11-03T09:14:22Z",
"team": { "id": "acme", "name": "Acme" },
"data": {
"vulnerability": {
"id": "3f1c7a52-6a1b-4f2e-9d7c-0b8e4a2c9d11",
"title": "Example Forms <= 2.3.1 - Authenticated (Subscriber+) Stored Cross-Site Scripting",
"cve": "CVE-2026-12345",
"cvss": {
"score": 6.4,
"rating": "Medium",
"vector": "CVSS:3.1/AV:N/AC:L/PR:L/UI:N/S:C/C:L/I:L/A:N",
"version": "3.1"
},
"cwe": {
"id": 79,
"name": "Improper Neutralization of Input During Web Page Generation ('Cross-site Scripting')"
},
"informational": false,
"published_at": "2026-11-03T08:00:00Z",
"updated_at": "2026-11-03T08:00:00Z",
"references": ["https://example.com/advisories/example-forms-xss"],
"source": {
"url": "https://source.example/vulnerabilities/3f1c7a52-6a1b-4f2e-9d7c-0b8e4a2c9d11",
"copyrights": {
"example": {
"notice": "Copyright 2026 Example Inc.",
"license": "Example Inc. grants you a license to ..."
}
}
}
},
"software": {
"type": "plugin",
"ecosystem": "wordpress",
"slug": "example-forms",
"name": "Example Forms"
},
"affected_versions": [
{
"label": "* - 2.3.1",
"from": "*",
"from_inclusive": true,
"to": "2.3.1",
"to_inclusive": true
}
],
"patched": true,
"patched_versions": ["2.3.2"],
"remediation": "Update to version 2.3.2, or a newer patched version",
"severity": "medium",
"match": {
"watch_id": "wat_01JB0C3E5G7J9L2N4Q6S8U0W1Y",
"version_constraint": "<2.3.2",
"sites": []
}
},
"links": { "dashboard": "https://ladon.hackindex.io/teams/acme/alerts" }
}
De waarden zijn verzonnen. software.type is plugin, theme of core voor WordPress, npm, composer, pypi, gem, cargo, golang of maven voor pakketten en github voor een repository, de namen uit de package-URL-standaard. software.ecosystem is wordpress, npm, packagist, pypi, rubygems, crates.io, go, maven of github. Bij pakketten is het id van de kwetsbaarheid een GitHub-advisory-id zoals ghsa-jf85-cpcp-j695. from en to gebruiken * voor "geen grens". severity is critical, high, medium, low of null als er geen score is. match laat zien welke van je watches het event oppikte. Pikte een project het op, dan staat in match.projects elk project met id, name en de geïnstalleerde packages, elk met version, direct, dev en path. Teksten uit de bron, zoals de titel en de oplossing, zijn Engels.
Verschillen per type
| Type | Wat er anders is in data |
|---|---|
vulnerability.updated |
changes noemt de gewijzigde velden, flags bevat severity_changed, cve_assigned en affected_versions_changed, en previous de oude waarden |
vulnerability.deleted |
Alleen vulnerability.id, vulnerability.title, vulnerability.source, software en reason: "withdrawn" |
vulnerability.patched |
Zoals created, met patched: true en de nieuwe patched_versions |
patch.released |
Zoals patched, plus release met version, released_at, download_url (leeg bij premium software, de registrypagina bij pakketten) en on_wordpress_org |
software.version_released |
software en release met version, released_at en download_url |
software.closed |
software en closure met date, reason (bijvoorbeeld security-issue) en permanent |
software.reopened |
Alleen software |
package.malicious |
malicious met id (een OSV-id dat begint met MAL-) en url, software, affected_versions en severity: "critical" |
project.vulnerable |
project met id, name, kind en package_count, count, en maximaal 50 findings zoals in de project-API |
project.resolved |
project, count: 0 en lege findings |
vulnerability.exploited |
Zoals created, plus exploitation met cve, kev.added_at, epss, epss_percentile en url, de CVE-pagina in Ladon |
vulnerability.exploit_published |
Zoals created, plus exploitation met cve, de exploit-references, epss, epss_percentile en url |
vulnerability.cve_assigned |
Zoals created, met het nieuwe nummer in vulnerability.cve. Is alleen het nummer nieuw, dan komt dit in plaats van vulnerability.updated |
CVE-regels
cve.matched komt van een CVE-regel en gaat naar de kanalen van die regel, welke eventtypes het kanaal ook heeft. De data heeft geen software of match, maar:
cve:id,title,description,state,published_at,updated_at,assigner,severity(ofnullzonder score),cvssmetscore,version,vectorensource(cnaofcisa-adp),cwe_ids,vendorsenproductsin kleine letters,kevmetadded_atofnull,epssmetscoreenpercentile(0 tot 1) ofnull, maximaal 25referencesmeturlentags,urlnaar het record op cve.org, ensourcemetname,urlennotices.rule:idennamevan de regel.reasons: de voorwaarden die waar waren, in de taal van het kanaal, zoalsernst is kritiek.
links.dashboard wijst naar de pagina van de regel, links.cve naar de pagina van de CVE in Ladon. Elke CVE die past, is een eigen cve.matched-bericht, ook als één update op veel CVE's tegelijk past.
Twee types bestaan alleen als webhook: ping als je een test stuurt, met data.message, en endpoint.verify als Ladon je endpoint controleert, met data.challenge. Zie Webhooks.
Samenvattingen en bundels
Een kanaal dat een samenvatting stuurt, krijgt één bericht van type digest. Een kanaal dat meldingen bundelt, of boven zijn limiet per uur komt, krijgt één bericht van type batch. Beide hebben dezelfde vorm: data.period heeft from en to, data.count het aantal events en data.events de events zelf, elk met id, type, created_at en data. Lange samenvattingen worden verdeeld over meerdere berichten van maximaal 100 events, genummerd in data.part. Het id van het bericht begint met dig_ of bat_.
Kritieke meldingen die niet wachten, komen binnen als gewone events, niet in de samenvatting.
Bron en licenties
vulnerability.source is er altijd. Het bevat url, een link naar het record bij de bron, en copyrights, met per partij de copyrightvermelding en licentie. De licentie van de gegevens vraagt dat de link, de vermelding en de licentie bij elke kopie blijven. Laat ze staan als je een melding verder publiceert, bijvoorbeeld in een ticket of een rapport voor een klant. Alle licenties staan op de licentiepagina.
Versies van de payload
Elk kanaal staat vast op een api_version. Nieuwe velden kunnen altijd bijkomen, dus negeer velden die je niet kent. Wijzigingen die een koppeling kunnen breken, komen alleen met een nieuwe api_version en worden aangekondigd in de changelog.