# vuln-exploits – CISA KEV + FIRST EPSS

Git-Mirror der **originalen** CISA-KEV-JSON-Datei und des täglichen FIRST-EPSS-CSV (gzip).

## Installation
1. Leeres Gitea-Repository `VULN/vuln-exploits` erstellen und diese Dateien pushen.
2. `sudo install -d -o act_runner -g act_runner -m 700 /var/lib/act_runner/cache/vuln-exploits`
3. Bestehender Host-Runner mit Label `vuln-runner` und Schreibrecht des Job-Tokens.
4. Workflow `.gitea/workflows/update.yml` über Actions starten.

## Dateistruktur
- `data/cisa-kev/catalog.json`: kompletter KEV-Katalog, wird bei Änderungen ersetzt.
- `data/epss/current.csv.gz`: aktuellster vollständiger EPSS-Snapshot, täglich ersetzt.
- `state/sync.json`: Statistiken, letzter erfolgreicher Lauf.
- Optional: `EPSS_DAILY_HISTORY=1` im Workflow-Environment ergänzen, um täglich ein historisches gzip zu speichern (kostet Git-Speicher).

## Betrieb
- Täglich 16:15 UTC geplant, damit die EPSS-Tagesdatei üblicherweise veröffentlicht ist.
- Downloads werden bei jedem Lauf erneut ausgeführt. Bei EPSS ändert sich der Gesamtdatensatz täglich: Ein Git-Cache vermeidet den erneuten Download des eigenen Repositories, nicht den EPSS-Tagesdownload.
- Download und Validierung müssen erfolgreich sein, bevor Dateien ersetzt werden.

Quellen:
- https://www.cisa.gov/sites/default/files/feeds/known_exploited_vulnerabilities.json
- https://www.first.org/epss/data