Software volgen
Alle docs
Met een watch vertel je Ladon welke software een project draait en welke versies. Watches leven in je projecten: elk pakket in de lockfiles van een project en elke software die je aan een project toevoegt, krijgt er een. Open het project en het tabblad Watches om ze te zien, en om software die je zelf toevoegde te wijzigen of te verwijderen.
Elk project kan elke software één keer volgen. Dezelfde software in twee projecten is twee watches, één per project, en elk stuurt naar de kanalen van het eigen project. Voor de watches in je abonnement telt die software één keer.
Soorten software
- Plugins en themes uit de catalogus van WordPress.org, die elke 15 minuten wordt bijgewerkt.
- Premium plugins en themes die niet op WordPress.org staan. Ze komen in de catalogus zodra er een kwetsbaarheid voor bekend is. Zodra Ladon WordPress.org heeft gecontroleerd, krijgen ze het label Niet op WordPress.org.
- WordPress zelf, onder core.
- Pakketten uit de registers hieronder.
| Taal | Register | Lockfiles | Manifest | Bereiken, bijvoorbeeld |
|---|---|---|---|---|
| JavaScript | npm, ook met Yarn en pnpm | package-lock.json, npm-shrinkwrap.json, yarn.lock, pnpm-lock.yaml |
package.json |
^4.17.0, ~1.2, >=1.2 <2 |
| PHP | Packagist, zoals Composer installeert | composer.lock |
composer.json |
^10.0, ~9.5.2, 1.2.* |
| Python | PyPI, met pip, Poetry, uv, Pipenv | poetry.lock, uv.lock, Pipfile.lock, requirements.txt |
pyproject.toml |
~=4.2, >=4.2,<5.0, ==4.* |
| Ruby | RubyGems, met Bundler | Gemfile.lock |
Gemfile |
~> 7.1, >= 1.2, < 2 |
| Rust | crates.io, met Cargo | Cargo.lock |
Cargo.toml |
1.35, ^1.35, ~1.2 |
| Go | Go modules, met Go | go.mod |
>=1.9.0 <2.0.0, ^1.9 |
|
| Java | Maven Central, met Maven, Gradle | gradle.lockfile, pom.xml |
[2.17.1,3.0), (,1.5], [1.2] |
|
| GitHub | openbare repositories | >=14.0, ^15.1 |
Zoek een pakket op naam, zoals @angular/core, laravel/framework of django. Een Go-module zoek je op het modulepad, zoals github.com/gin-gonic/gin, en een Java-pakket op groupId:artifactId, zoals org.apache.logging.log4j:log4j-core. Wil je elk pakket van een repository in één keer volgen, upload dan de lockfiles als project. Voor pakketten zoekt Ladon ook de bronrepository op GitHub op en leest het de advisories die de makers daar publiceren, zie GitHub-repositories.
Software die WordPress.org heeft gesloten, bijvoorbeeld na een beveiligingsprobleem, krijgt het label Gesloten op WordPress.org. Je kunt die nog volgen, maar er komen geen updates meer om te installeren. Een pakket dat de makers niet meer onderhouden, zoals deprecated op npm, abandoned op Packagist of met elke versie yanked op crates.io, krijgt het label Niet meer onderhouden op gevolgd door het register.
GitHub-repositories
Volg een openbare repository met owner/repo of een link ernaar. Ladon volgt de releases, of de tags als er geen releases zijn, en laat weten wanneer de repository gearchiveerd wordt. Nieuwe releases staan voor repositories standaard aan, concepten en pre-releases tellen niet mee. Advisories komen van twee plekken:
- De repository zelf. Makers kunnen een security advisory in hun eigen repository publiceren. Ladon leest die rechtstreeks, vaak dagen voordat GitHub ze beoordeelt en in de GitHub Advisory Database opneemt, en soms nog voor er een CVE is. Ladon doet dat voor gevolgde repositories en voor de bronrepository van een pakket, als het register naar een repository op GitHub verwijst. Komt de beoordeelde versie later, dan werkt die dezelfde kwetsbaarheid bij in plaats van twee keer te melden, en
vulnerability.cve_assignedlaat weten wanneer het CVE-nummer volgt. - De GitHub Advisory Database. Actions zoals
tj-actions/changed-fileshebben daar eigen advisories, en een advisory voor een pakket komt ook bij de repository waar het uit gebouwd wordt.
De eerste keer dat Ladon naar een repository kijkt, worden advisories ouder dan 30 dagen opgeslagen zonder melding, zodat je niet overspoeld wordt met oud nieuws. Nieuwere geven gewoon een melding. Ladon leest hier alleen openbare gegevens, je koppelt niets. Van een privérepository leest Ladon alleen de lockfiles, via de GitHub App, zie Projecten.
Een lijst importeren
Honderd plugins één voor één toevoegen kost tijd. Kies in een project Toevoegen en dan Lijst importeren en plak wat je sites draaien, of kies de bestanden. Ladon controleert de lijst voordat er iets wordt opgeslagen en toont elke rij als In de catalogus, Toegevoegd op slug voor premium software, Toegevoegd op naam voor pakketten, Al gevolgd of Overgeslagen, plus hoeveel nieuwe watches er in je abonnement passen.
Haal de lijst op met WP-CLI. Voer dit uit in de WordPress-map van een site om de plugins en themes in één keer te krijgen:
wp plugin list --format=csv; echo '# themes'; wp theme list --format=csv
Dat geeft één regel per plugin en theme met de versie:
name,status,update,version
woocommerce,active,none,9.3.1
contact-form-7,active,available,6.0.1
# themes
name,status,update,version
astra,active,none,4.8.1
Plak dat zoals het is. WP-CLI-uitvoer zegt niet of het om plugins of themes gaat, dus alles na de regel # themes telt als theme. Plak je alleen de uitvoer van wp theme list, kies dan Themes op de importpagina. --format=json en de standaardtabel werken ook. Met WP-CLI-aliassen krijg je alle sites tegelijk:
wp @all plugin list --format=csv; echo '# themes'; wp @all theme list --format=csv
Een plugin die op meerdere sites draait, verschijnt één keer, met elke versie die je draait. Je kunt ook één slug per regel plakken, zoals woocommerce, plugin:gravityforms, theme:astra of core, met de versie erachter na een spatie of @ zoals woocommerce@9.3.1, of links naar de plugin of het theme op WordPress.org.
Elke watch begint met de standaardmeldingen, elke ernst en alle versies. Ladon maakt van de geïnstalleerde versies geen versievoorwaarde, want =2.3.1 is na de volgende update al verouderd. De preview gebruikt ze om te laten zien welke van je versies bekende kwetsbaarheden hebben, en of de nieuwste versie die oplost. Tags die je toevoegt, gelden voor elke watch die de import aanmaakt, bijvoorbeeld de klant van de sites.
Heeft de lijst meer nieuwe rijen dan er ruimte is in je abonnement, dan zijn alleen de eerste geselecteerd. Kies de belangrijkste, of upgrade het abonnement.
Manifests en lockfiles
Kies op de importpagina de taal en het manifest uit de tabel hierboven om de pakketten te volgen waar een project om vraagt. Elke afhankelijkheid wordt een watch met het bereik uit het bestand, en dev-afhankelijkheden zijn gemarkeerd. Bereiken die Ladon niet kan lezen, zoals dev-main, betekenen elke versie. Git-, lokale en privébronnen worden overgeslagen, plugins van WordPress Packagist worden WordPress-plugins, en namen van privépakketten gaan nooit naar een register. Voor Python kun je ook de regels van een requirements.txt plakken.
Kies je in plaats daarvan een lockfile, dan maakt de import er een project van: Ladon volgt dan de exacte versies, ook van de pakketten die je afhankelijkheden binnenhalen.
Versies
Kies Alle versies, of alleen de versies die je sites draaien. Ladon meldt alleen iets als een kwetsbaarheid de gekozen versies raakt.
| Je typt | Betekent |
|---|---|
2.3.1 |
Precies 2.3.1 |
>=2.0 |
2.0 en alles daarna |
>=2.0 <3.0 |
Vanaf 2.0 tot, maar niet met, 3.0. Een spatie of komma betekent "en" |
2.3.* |
Elke 2.3-release, inclusief de bèta's en release candidates |
!=2.5.0 |
Elke versie behalve 2.5.0 |
<1.5 || >=2.0 |
Een van beide bereiken. || betekent "of" |
De operators zijn =, !=, <, <=, > en >=. Een voorwaarde is maximaal 255 tekens en 32 delen. Bij WordPress-software weigeren we caret (^) en tilde (~) bewust, omdat tools het oneens zijn over wat ze betekenen. Bij pakketten werken ze wel, zie hieronder.
Versies worden vergeleken zoals WordPress en PHP dat doen: 2.3 is gelijk aan 2.3.0, en 2.3.0-beta1 komt vóór 2.3.0-rc1, die weer vóór 2.3.0 komt. Het formulier laat zien hoe Ladon je invoer begrijpt voordat je opslaat.
Pakketten
Voor pakketten typ je het bereik zoals het manifest van die taal het schrijft, dus caret, tilde en de andere operatoren van het ecosysteem werken hier. De tabel hierboven heeft voorbeelden. npm-, Rust- en Go-versies worden vergeleken als SemVer, PHP-versies zoals Composer dat doet, Python-versies volgens PEP 440, Ruby-versies zoals RubyGems dat doet en Java-versies zoals Maven dat doet. Go heeft geen eigen bereiken, dus Go-bereiken schrijf je zoals bij npm, bijvoorbeeld >=1.9.0 <2.0.0. Java-bereiken gebruiken de notatie van Maven, zoals [2.17.1,3.0), (,1.5] of [1.2], en gewone operatoren zoals >=2.17.1 werken ook.
Waarover je hoort
Welke meldingen je krijgt, bepalen de kanalen van het project, elk met eigen soorten events en een eigen ernstfilter. De watches die een project voor de lockfiles maakt, de software die je aan een project toevoegt en de gewone software ervan hebben geen eigen instellingen voor meldingen.
Een watch die je zelf maakt met Toevoegen en Software volgen, of via de API, houdt zijn eigen instellingen bovenop die van het kanaal. Per watch zet je soorten events aan of uit. Standaard krijg je nieuwe kwetsbaarheden, wijzigingen daarin, ingetrokken kwetsbaarheden, opgeloste versies die uitkomen, kwetsbaarheden die actief misbruikt worden of waarvoor een openbare exploit verschijnt, en kwaadaardige versies van npm-pakketten. Alle soorten staan in Events en payloads.
Ernst
Een watch die je zelf of via de API maakt, en elk kanaal, heeft een ernstfilter:
- Elke ernst: alle meldingen.
- Niveaus kiezen: elke combinatie van Kritiek, Hoog, Gemiddeld, Laag en Zonder score.
- CVSS-bereik: een minimale en maximale score voor CVSS 3.1 of 4.0. Scores in CVSS 3.0 tellen als 3.1.
Sommige bevindingen hebben geen echte impact op de beveiliging, zoals een ontbrekende nonce bij een onschuldige actie. Die zijn gemarkeerd als informatief en staan standaard uit. Zet bij een watch die je zelf maakte Informatieve meldingen meenemen aan om ze ook te krijgen.
Tags
Geef een watch maximaal 10 tags, bijvoorbeeld de klant waar hij bij hoort of de omgeving waarin hij draait: client-acme, production. Tags bestaan uit kleine letters, cijfers, punten, streepjes en underscores, beginnen met een letter of cijfer en zijn maximaal 32 tekens. Ladon slaat ze op in kleine letters.
Een kanaal kan alleen de meldingen van watches met een bepaalde tag krijgen, zie Kanalen. Zonder tagfilter krijgt een kanaal de meldingen van elke watch van het project, dus tags veranderen niets tot je ze in een kanaal gebruikt.
Pauzeren
Pauzeer een watch om de meldingen te stoppen zonder de instellingen kwijt te raken. Een gepauzeerde watch telt niet mee voor je abonnement, maar hervatten vraagt wel een vrije plek. Zie Abonnementen en limieten.
Kwetsbaarheidspagina's
Elke melding linkt naar een pagina met alle details: de beschrijving, getroffen en opgeloste versies, de eerste download met de oplossing, CVSS en CWE, of de CVE op de CISA-lijst met misbruikte kwetsbaarheden staat, de EPSS-score, referenties, en welke watches in je teams geraakt worden. Het CVE-nummer opent een eigen pagina in Ladon. Deze pagina's zijn openbaar, dus iedereen die een melding krijgt kan ze openen. Ingelogde leden zien ook hun eigen watches.