CVE-regels
Alle docs
Watches gaan over software die je draait. Een regel gaat over de hele stroom van nieuwe CVE's, ook voor software die Ladon niet kent. Ladon leest elke CVE uit de CVE List, en een CVE die aan de voorwaarden van een regel voldoet, gaat één keer naar de kanalen die je kiest. Een regel hoort bij een project en stuurt naar kanalen van dat project. Bijvoorbeeld: kritiek, en niet over routers, naar je Discord-server.
Waar de CVE's vandaan komen
- De CVE List van het CVE Program, de bron van elke CVE. Ladon kijkt elke twee minuten, dus een nieuwe CVE is meestal binnen een paar minuten na publicatie bij je.
- Scores van CISA. Veel CVE's komen zonder score van de partij die ze publiceert. CISA voegt bij veel van die CVE's een CVSS 3.1-score en zwakheden toe, en Ladon gebruikt die als er geen andere score is.
- Scores van NVD. Geven de publicerende partij en CISA geen score, dan gebruikt Ladon de CVSS-score van de National Vulnerability Database, elk uur bijgewerkt. Zo blijven minder CVE's zonder ernst.
- De KEV-lijst van CISA met kwetsbaarheden die actief misbruikt worden, elk uur bijgewerkt.
- EPSS, de kans dat een CVE in de komende 30 dagen misbruikt wordt, dagelijks bijgewerkt.
Elke CVE heeft een eigen pagina in Ladon met de beschrijving, score, zwakheden, of hij op de KEV-lijst staat, de EPSS-score, referenties en een link naar cve.org. Het CVE-nummer op een kwetsbaarheidspagina opent hem ook. Deze pagina's zijn openbaar, dus iedereen die een melding krijgt kan ze openen. Ingelogde leden zien ook hun eigen regels.
Een regel toevoegen
Open het tabblad CVE-monitor van een project, of kies in een project Toevoegen en dan CVE-regel. Geef de regel een naam, bouw de voorwaarden, kies de kanalen en sla op. Tijdens het bouwen laat de preview zien hoeveel CVE's van de laatste 30 dagen gepast hadden, met de nieuwste vijf en waarom ze passen. Zo zie je meteen of een woord eruit filtert wat je bedoelt.
Begin als je wilt met een voorbeeld: kritiek maar niet over routers, aanvallen via het netwerk zonder inloggen, nieuw op de KEV-lijst, of WordPress met een score vanaf 7.
Voorwaarden
Een regel past bij alle of één van zijn voorwaarden. Een voorwaarde kan ook een groep zijn met een eigen alle of één van, bijvoorbeeld: kritiek, en de titel noemt wordpress of woocommerce.
| Veld | Operatoren | Voorbeeld |
|---|---|---|
| Ernst | is een van, is geen van | Kritiek, Hoog. Nog geen score kan ook |
| CVSS-score | is minstens, is hooguit | minstens 9.0 |
| CVSS-versie | is een van, is geen van | 4.0, 3.1 |
| CVSS-vector | is een van, is geen van, per onderdeel | Aanvalsvector is Netwerk, Benodigde rechten is Geen |
| Titel, of titel of beschrijving | bevat een van, bevat alle, bevat geen van | bevat geen van router |
| Leverancier, product | bevat een van, bevat geen van | product bevat wordpress |
| Zwakheid (CWE) | is een van, is geen van | CWE-79, CWE-89 |
| Uitgegeven door (CNA) | is een van, is geen van | GitHub_M |
| Op de KEV-lijst van CISA | ja, nee | ja |
| Heeft een exploit- of patchreferentie | ja, nee | ja |
| EPSS-kans, EPSS-percentiel | is minstens, is hooguit | percentiel minstens 95% |
| Dagen sinds publicatie | is hooguit | 7 dagen |
- Woorden passen op hele woorden en zinsdelen, hoofdletters maken niet uit.
routerpast niet oprouters, dus zet ze er allebei in als je allebei bedoelt. Reguliere expressies worden niet ondersteund. - Ontbrekende gegevens passen nooit. Een CVE zonder score voldoet niet aan "score minstens 7", en ook niet aan "score hooguit 7". Kies Nog geen score bij ernst om die bewust te vangen.
- CVSS 4.0 noemt vertrouwelijkheid, integriteit en beschikbaarheid van het systeem zelf
VC,VIenVA. Een voorwaarde opC,IofAleest die ook. - Een regel mag maximaal 50 voorwaarden hebben, en een lijst maximaal 25 woorden of waarden.
Wanneer een regel een melding stuurt
Een regel meldt een CVE één keer, op het moment dat de CVE aan de voorwaarden gaat voldoen. Meestal is dat bij publicatie. Het kan ook later zijn, bijvoorbeeld als CISA een score toevoegt, of als de CVE op de KEV-lijst komt. Wijzigingen daarna sturen hem niet nog een keer.
Een CVE die al aan de regel voldeed voordat hij veranderde, blijft stil. Een nieuwe regel voor kritieke CVE's meldt dus niet elke oude kritieke CVE die een nieuwe referentie krijgt. Gevonden CVE's staan op de pagina van de regel, ook als die geen kanalen heeft.
Elke CVE die past, is een eigen bericht, ook als één update van de CVE List op veel CVE's tegelijk past. Het kanaal verstuurt ze na elkaar, in het tempo dat de chat-app toestaat. Past een update op ongewoon veel CVE's voor alle teams samen, bijvoorbeeld na een massale herscoring, dan controleert HackIndex die eerst voordat er iets verstuurd wordt.
Kanalen
Een regel stuurt naar de kanalen die je aanvinkt, van elk soort, uit de kanalen van het eigen project. Wil je dezelfde CVE's in meerdere projecten, maak dan in elk ervan een regel. De eventtypes, het ernstfilter en het tagfilter van een kanaal gelden niet voor regels: de regel bepaalt zelf wat er uitgaat. Een gepauzeerde regel past op niets tot je hem weer aanzet, en stuurt de CVE's die hij in de tussentijd miste niet na.
Op het Free-abonnement krijgen Discord-kanalen alleen meldingen van CVE-regels, nooit de software die je project volgt. Ze werken op elk abonnement, dus een CVE-regel is de manier om een gratis feed van kritieke kwetsbaarheden in een Discord-server te draaien.
Abonnementen
Elke actieve regel telt mee voor de regels in je abonnement, zie Abonnementen en limieten. Een gepauzeerde regel neemt geen plek in, en de regels die Ladon maakt voor de gewone software van een project ook niet. Een project verwijderen haalt ook de regels ervan weg.
Webhooks en de API
De melding van een regel heeft het type cve.matched, zie Events en payloads. Met de API beheer je regels met de scopes rules:read en rules:write, en lees en doorzoek je CVE's met cves:read. De voorwaarden in de API zijn dezelfde boom die de app bouwt:
{
"name": "Kritiek zonder routers",
"conditions": {
"match": "all",
"conditions": [
{ "field": "severity", "op": "in", "value": ["critical"] },
{ "field": "text", "op": "contains_none", "value": ["router"] }
]
},
"channels": ["we_01JB0C3E5G7J9L2N4Q6S8U0W1Y"]
}
De velden zijn severity, score, cvss_version, metric.AV en de andere onderdelen van de vector, text, title, vendor, product, cwe, assigner, kev, exploit, patch, epss, epss_percentile en age_days. EPSS-waarden lopen van 0 tot 1. Stuur project mee met de publieke id van een project, zoals prj_01JB8Z7R4M2N6P8Q0S2U4W6Y8A, om de regel daar te maken. Laat je het weg, dan komt de regel in het standaardproject van het team. De kanalen moeten bij dat project horen. GET /rules?project= toont de regels van één project. POST /rules/preview met dezelfde conditions geeft antwoord met wat ze de laatste 30 dagen gevonden hadden, zonder een regel op te slaan.
Gegevens en licenties
De CVE List is © The MITRE Corporation en wordt gebruikt onder de CVE Terms of Use. Scores van CISA en de KEV-lijst zijn publiek domein, EPSS komt van FIRST. Elke melding heeft de link naar het record op cve.org en deze vermeldingen bij zich. Alle licenties staan op de licentiepagina.