# CPE-Zuordnung für FreeBSD-Ports — Materialsammlung

Stand 28.10.2026. Reine Informationsbeschaffung, nichts umgesetzt.
Frage: wie lassen sich den ~38.000 Ports CPE-Kennungen zuordnen, und
welche Quellen liefern dafür verwertbare Kandidaten?

Zahlen mit **(gemessen)** stammen aus eigener Auswertung an diesem Tag:
portstatus-Datenbank (VM 130) plus das vollständige NVD-CPE-Wörterbuch.
Zahlen ohne Marke sind recherchiert und mit Quelle belegt.

---

## 1. Ist-Stand

### Portsbaum (gemessen, portstatus-DB)

| | |
|---|---|
| Ports gesamt | 38.430 |
| mit CPE im Port (`USES=cpe`) | 4.231 (11,0 %) |
| mit CPE aus irgendeiner Quelle (Port, Repology, Paket) | 4.265 |
| ohne jedes CPE | 33.203 |
| mit Projekt-Homepage (`WWW`) | 38.430 (alle) |
| davon `github.com` | 11.882 |
| davon GitLab/SourceForge/Codeberg | 2.370 |

### chkcpe (decke@), Stand 28.10.2026 03:15 UTC

valid 3.042 · invalid 98 · deprecated 9 · checkneeded 1.075 ·
readytocommit 18 · **unknown 31.049**

Der Handarbeitsanteil steckt in `data/overlay.json` (gemessen): 1.569 Ports,
davon **1.188 `nomatch`** (Fehltreffer verworfen), 225 `confirmedmatch`,
164 `custommatch`. Drei Viertel der Handarbeit war also Wegwerfen falscher
Vorschläge.

Die 164 `custommatch` sind CPEs, die das Wörterbuch **nicht kennt**.

### Was chkcpe technisch tut

Gelesen in `src/Runner.php`, `src/CPE/Dictionary.php`:

1. NVD-CPE-Wörterbuch laden (`nvdcpe-2.0.tar.gz`), nur `part=a`,
   reduziert auf `vendor`/`product` plus `deprecatedBy`.
2. Ports per `make -V PORTNAME -V CPE_STR -V USES` parallel scannen.
3. Hat der Port ein `CPE_STR` → gegen das Wörterbuch prüfen
   (valid / invalid / deprecated).
4. Hat er keines → **`WHERE product = lower(PORTNAME)`**, Treffer werden
   Kandidaten (`checkneeded`).
5. Repology-CSV als zweite Kandidatenquelle.
6. `overlay.json` für Handentscheidungen.

Die einzige automatische Heuristik ist der **exakte Namensvergleich**.
Bemerkenswert: das Feld `refs` des Wörterbuchs steht als Beispiel-JSON im
Quelltext von `Runner.php`, wird aber weder gespeichert noch benutzt.

---

## 2. Das NVD-CPE-Wörterbuch — der Rahmen

Bezug als **ein** Download, kein API-Gewürge:
`https://nvd.nist.gov/feeds/json/cpe/2.0/nvdcpe-2.0.tar.gz` — 85 MB,
entpackt 906 MB in 18 JSON-Dateien, nächtlich aktualisiert, dazu
`nvdcpe-2.0.meta` mit `sha256` für den Delta-Check.
(Die API kann es auch, braucht aber 187 Requests und einen Key;
5 Requests/30 s ohne Key.)

Gemessen am Volldump:

| | |
|---|---|
| CPE-Namen gesamt | 1.864.308 |
| davon `part=a` | 1.651.277 |
| **distinkte `vendor:product`, `part=a`** | **50.300** |
| davon nicht-deprecated | 48.541 |
| mit mindestens einer Referenz-URL | 43.693 (87 %) |
| mit `github.com`-Referenz | 14.512 (29 %) |
| **von einem FreeBSD-Port belegt** | **1.816** |

Häufigste Referenz-Hosts: github.com 25.185 · wordpress.org 6.464 ·
oracle.com 2.650 · sourcecodester.com 2.495 · ibm.com 2.410 ·
play.google.com 1.727 · npmjs.com 1.531.

**Das ist die Obergrenze.** 50.300 Produkte stehen 38.430 Ports gegenüber,
und ein großer Teil der Produkte sind WordPress-Plugins (≈11 %), Android-Apps
und kommerzielle Windows-Software. Rund drei Viertel des Portsbaums haben
**keinen Eintrag im Wörterbuch** — nicht „keine Zuordnung", sondern nichts,
worauf man zeigen könnte. Das ist kein Heuristikproblem.

Nebenbefund (gemessen): **230 `vendor:product`, die Ports heute tragen,
gibt es im Wörterbuch nicht.** chkcpe meldet nur 98 `invalid` — die Differenz
sind Fälle, in denen `CPE_VENDOR`/`CPE_PRODUCT` aus dem Paket kommt. Lohnt
einen eigenen Blick.

### Referenztypen

Definiert im Schema: `Advisory`, `Change Log`, `Product`, `Project`,
`Vendor`, `Version`. `Project` ist mit 1,9 % aller Referenzen selten —
wer nur darauf filtert, verschenkt den größten Teil. Pfadgenau ausgewertet
identifiziert auch eine `Advisory`-URL unter
`github.com/owner/repo/security/...` dasselbe Repo.

**Falle:** `keywordSearch` der NVD-API durchsucht laut Doku „title or
reference links". Das stimmt nicht — Gegentest mit einem Wort, das nur in
einer Referenz-URL steht, liefert 0 Treffer. Referenzen lassen sich **nur
lokal** auswerten.

### `titles`

100 % der Produkte haben einen englischen Titel, 98,4 % enthalten den
Produktstring. Der Titel ist aber durchgängig „Vendor Product Version" in
hübscher Schreibweise, **keine Beschreibung**:

```
cpe:2.3:a:strongswan:strongswan:2.8.6   | StrongSwan strongSwan 2.8.6
cpe:2.3:a:slf4j:slf4j-api:1.7.16        | SLF4J slf4j-api 1.7.16
cpe:2.3:a:qbittorrent:qbittorrent:4.1.5 | qBittorent qBittorent 4.1.5   (Tippfehler im NVD)
```

Ein unscharfer Abgleich gegen den `COMMENT` eines Ports kann damit nicht
funktionieren — der COMMENT ist ein Funktionssatz, der Titel ein Name, kein
gemeinsames Vokabular. Brauchbar sind die Titel als **Schreibweisen-Normalisierer**
(`strongSwan` → `strongswan`).

---

## 3. Eigene Messung: was bringt welcher Abgleich

Alle Regeln gegen dieselben 38.430 Ports. Prüfmenge = Ports, die schon ein
CPE tragen und bei denen die Regel anschlägt; „richtig dabei" = das echte CPE
ist in der Kandidatenmenge.

| Regel | Ports mit Kandidat | eindeutig | Prüfmenge | richtig dabei | eindeutig **und** richtig |
|---|---|---|---|---|---|
| **A** PORTNAME exakt (chkcpe) | 3.042 | 2.411 | 1.653 | 1.503 (91 %) | 1.182 |
| **B** Repo-URL deckungsgleich | 917 | 712 | 466 | 400 (86 %) | 332 |
| **C** Host **und** Name | 968 | 906 | 756 | 705 (93 %) | 655 |
| **D** A oder B | 3.491 | 2.682 | 1.841 | 1.645 (89 %) | 1.279 |

Regel B heißt: `WWW` des Ports und eine Referenz-URL im CPE-Eintrag zeigen auf
denselben Forge-Pfad (`github.com/owner/repo`, GitLab, Codeberg, …).

### Der interessante Teil

**450 Ports ohne CPE bekommen über Regel B einen Kandidaten, 341 davon
eindeutig — und `overlay.json` von chkcpe hat davon genau einen verworfen.**
Das Feld ist praktisch unbearbeitet. Beispiele:

```
chinese/opencc        https://github.com/BYVoid/OpenCC    -> byvoid:open_chinese_convert
archivers/snappy-java https://github.com/xerial/snappy-java -> xerial:snappy-java
databases/py-redis2   https://github.com/redis/redis-py   -> redis:redis-py
audio/py-tinytag      https://github.com/tinytag/tinytag  -> tinytag:tinytag
```

`byvoid:open_chinese_convert` findet ein Namensvergleich nie.

Fehlerbild der Regel: Monorepo-Teilports. Alle `rubygem-activemodel*` zeigen
auf `github.com/rails/rails` und bekommen `rubyonrails:rails`. Muss von Hand
raus.

### Reiner Host-Abgleich taugt nicht allein

Trifft der `WWW`-Host nur als Domain (gnu.org, gnome.org, xiph.org), bekommt
man die komplette Produktliste des Dachprojekts:

```
archivers/gzip  https://www.gnu.org/software/gzip/ -> gnu:a2ps, gnu:adns, gnu:bash, ...
```

Erst die Kombination Host **und** passender Produktname (Regel C) ist mit 93 %
die präziseste Regel überhaupt — aber nur 968 Ports.

---

## 4. Fertige Fremdlisten, die man nur abholen muss

### Ravenports (bester Schnitt, weil vom Ports-Baum abstammend)

`https://raw.githubusercontent.com/Ravenports/Ravenports/master/Mk/Misc/repology.json`
— 2,7 MB, ein Request, ISC-Lizenz. Gegengeprüft (gemessen): 3.842 Ports,
**817 mit `cpe`**, 569 distinkte `vendor:product`. Jede Zeile bringt
`namebase`, `homepage` und `distfile` mit, also drei Join-Schlüssel.

Join an FreeBSD (gemessen, Name oder Homepage):

| | |
|---|---|
| Ports mit Kandidat | 1.892 |
| davon haben schon ein CPE | 1.281 — **1.173 stimmen überein (92 %)**, 108 weichen ab |
| **neu, Port hat kein CPE** | **611**, davon 548 eindeutig |

Die 108 Abweichungen sind eine fertige Fehlerliste für beide Seiten.

### scanoss/purl2cpe

`https://github.com/scanoss/purl2cpe` (MIT, täglich aus NVD, Dump 53 MB zip →
540 MB SQLite). 2.783.765 Zeilen, 40.763 distinkte purls, 22.424 distinkte
`vendor:product`. Kein `pkg:freebsd`, aber `pkg:github/owner/repo` (20.238),
deb (5.066) und rpm (5.234) joinen direkt.
Gemessener Hebel: **+726 Ports**, bei denen der Namensvergleich leer ausgeht.

**Nicht verwechseln** mit `aboutcode-org/vulnerablecode-purl2cpe` — das ist
keine Zuordnung, sondern eine Ko-Vorkommens-Tabelle je Schwachstelle, und seit
2022 tot.

### OSV `cpe_product_to_repo.json`

`https://storage.googleapis.com/cve-osv-conversion/cpe_repos/cpe_product_to_repo.json`
— Googles `cpe-repo-gen` wertet als bisher einziges produktives Werkzeug die
CPE-`refs` aus und veröffentlicht das Ergebnis: Stand 28.10.2026
**10.383 `vendor:product` → 10.927 Repo-URLs**, davon 10.694 github.com.
Invertiert ist das genau der Index für Regel B, ohne eigenen Dump.

### Gentoo, OpenWrt, SUSE, Debian

| Quelle | CPE-Einträge | getroffene Ports | Bemerkung |
|---|---|---|---|
| Gentoo `metadata.xml` `remote-id type="cpe"` | 437 Pakete / 400 v:p | 498 | handgepflegt, veraltet teils (`cpe:/a:gnu:zlib` ist deprecated) |
| OpenWrt `PKG_CPE_ID` | 563 v:p, 38,7 % Abdeckung im Feed | 318 | dichteste Quelle, steht im Paketindex (2,4 MB Textdatei) |
| SUSE `package2cpe.csv` + CSAF | 1.126 v:p | 605 | CSV eingefroren 2022, CSAF lebt (CC-BY-4.0) |
| Debian `data/CPE/list` | 2.063 v:p | 881 | **letzter Commit 2016**, Lizenz unklar |

Wertvoller als Gentoos 437 CPEs sind seine **9.389 `remote-id type="github"`**
(71 % des Baums haben irgendeine Upstream-ID) — eine fertige
Paket→Upstream-Tabelle, die über `USE_GITHUB` exakt joint.

Debians `data/CPE/aliases` (1.250 Äquivalenzgruppen, `digium:asterisk` ≡
`asterisk:asterisk`) ist für die Vendor-Entdopplung brauchbarer als die Liste
selbst.

### Repology lohnt als CPE-Quelle nicht

`repology-rules` enthält **keine** CPE-Daten; die Bindungen entstehen in den
Parsern von `repology-updater` aus Gentoo, Ravenports, OpenWrt, nix und Guix
plus einer handgepflegten Tabelle `manual_cpes`, die in keinem Git-Repo steht.
FreeBSDs eigene Daten liest Repology für CPE gar nicht ein. Abruf nur über den
täglichen 2,48-GB-Dump — die Primärquellen sind billiger und frischer.
Repologys Wert bleibt der `effname` als Scharnier zu Debian-/SUSE-Paketnamen.

### Geprüft und verworfen

Red Hat/Fedora (CPE nur auf Kanalebene) · Wolfi/Chainguard (25 Einträge,
Advisories CC-BY-NC-ND) · Alpine secdb, NetBSD `pkg-vulnerabilities`,
Ubuntu (alle ohne CPE) · GHSA (kein CPE, kein purl in den Repo-Dateien) ·
OSV-Schema (kein CPE-Feld) · GitLab gemnasium-db (nichts) ·
CycloneDX/SPDX (CPE und purl gleichrangig, keine Übersetzung) ·
purl-Spec (Mapping ausdrücklich abgelehnt, Issue #138).

---

## 5. Neue CPE-Einträge anlegen — geht nicht in Masse

Einziger dokumentierter Weg: **CPE-Dictionary-XML per Mail an
`cpe_dictionary@nist.gov`**, QA-Review durch NIST, kein Webformular, kein
Ticketsystem, keine API, kein SLA. Das FreeBSD-Wiki nennt denselben Weg.
NIST räumt auf der Statistikseite selbst Rückstand bei Einreichungen ein.

Für die 164 `custommatch` und die 230 unbekannten `vendor:product` mag das
gehen. Für tausende Ports ist es kein Verfahren — und inhaltlich fragwürdig,
weil FreeBSD nicht der Vendor ist.

---

## 6. Strategischer Rahmen: CPE erodiert

- **15.04.2026**: NVD stellt auf **risikobasiertes Enrichment** um.
  Angereichert werden nur noch CVEs in CISAs KEV, Software im
  Bundesbehörden-Einsatz und „critical software" nach EO 14028.
  Alles andere „Lowest Priority – not scheduled". Backlog vor 01.03.2026
  auf „Not Scheduled". Grund: +263 % CVE-Einreichungen 2020→2025.
- **10.12.2024**: CISA Vulnrichment fügt **keine CPE-Strings mehr** hinzu.
- **CVE 5.x**: `cpeApplicability` liegt im CNA-Container und ist bei
  10,6 % der 415.469 Records gesetzt (gemessen am Release vom 28.10.2026).
  CISA-ADP ergänzt es nicht. Mit NVD-Anreicherung lagen CVEs aus H1/2026 bei
  59 % CPE-Abdeckung — genau das wird jetzt eingeschränkt.
- **purl** ist seit CVE-Format 5.2.0 (29.10.2025) im Schema, aber optional,
  ohne Version, und die Adoption liegt real nahe null.
  Offene PR `package-url/purl-spec#496`: purl-Typ **`bsd`**,
  Form `pkg:bsd/freebsd/emacs@30.1_2?distro=14.3`.

Heißt: der Aufwand lohnt nur dort, wo das Wörterbuch schon etwas hat.
Das Wörterbuch zu füllen ist nicht FreeBSDs Aufgabe und skaliert nicht.
Für den Rest ist purl der Weg — was das OSV-Vorhaben stützt.

---

## 7. Was andere Werkzeuge heuristisch tun

| Werkzeug | Verfahren | belegte Trefferquote |
|---|---|---|
| OWASP Dependency-Check | Evidence-Collection + Lucene-Index über CPEs aus CVE-Daten, `verifyEntry()` verwirft Kandidaten ohne Beleg | keine |
| cpe-guesser (CIRCL, BSD-2) | Wortindex über das Wörterbuch, gewichtete Kandidatenliste; öffentliche API | keine; `py-pillow` leer, `pillow` trifft — Präfix-Strip Pflicht |
| cve-bin-tool (GPL-3) | **kein** Fuzzy-Matching, Binärsignaturen + purl2cpe + Mismatch-DB; 634 handkuratierte Tupel | keine |
| Syft (Apache-2) | eingebetteter Index, 7.944 Paketnamen → 8.478 CPEs; dazu `vendors_from_url.go` (GitHub-Owner → Vendor) | keine |
| OSV `cpe-repo-gen` | **wertet als einziges die `refs` aus**, validiert Repo-URLs remote | — |
| prefix-dev/purl-associator | 8 Boolean-Heuristiken mit Buckets accept/ambiguous/drop statt einer Fuzzy-Schwelle | **95,3 % ohne NVD-Match, 6 automatisch akzeptiert von 5.867** |
| GNU Guix | hat URL-Abgleich (CVE-Referenz beginnt mit Homepage) **getestet und verworfen** | „a few useless and sometimes erroneous suggestions" |
| Debian | `bin/compare-nvd-cve`: Differenzabgleich Debian-Paket je CVE vs. NVD-CPE-Produkte je CVE | — |

Kein einziges Werkzeug gleicht die CPE-`refs` gegen die **Paket-Homepage** ab.
Guix hat die schwächere Variante probiert, OSV liest die refs ohne Rückabgleich,
prefix-dev nutzt CVE-Referenzen statt CPE-refs. Das Feld ist unbesetzt.

Einzige publizierte Zahl im Feld: Wåreus & Hell, DIMVA 2020, F 0,86 — aber in
Richtung *CVE-Text → CPE*, nicht *Paket → CPE*. Für keines der Werkzeuge
existiert eine Evaluation gegen einen Goldstandard.

---

## 8. Was sich daraus als Vorgehen ableiten lässt

Nicht umgesetzt, nur sortiert nach Hebel pro Aufwand.

1. **Präfix-/Suffix-Abschälung vor dem Namensvergleich.** `py312-`, `p5-`,
   `rubygem-`, `php8x-`, `R-cran-`, `-devel`. Kostet nichts, hebt die
   Namensbasis um rund +1.770 Ports (+82 % gegenüber heute).
2. **`refs` auswerten, alle Typen, pfadgenau.** Nicht nur `Project`
   (1,9 % der Referenzen) — eine Advisory-URL auf `github.com/owner/repo/...`
   identifiziert dasselbe Repo. Liefert 450 neue Kandidaten, 341 eindeutig,
   vom Overlay in chkcpe praktisch unberührt. Startpunkt ohne eigenen Dump:
   OSVs `cpe_product_to_repo.json`.
3. **Fertige Listen einlesen**: Ravenports (611 neu), purl2cpe (+726),
   Gentoo/OpenWrt als Ergänzung.
4. **Verifikation gestuft statt einer Schwelle**, nach dem Muster von
   prefix-dev:
   - *Auto-Accept*: Namenstreffer **und** pfadgenauer Repo-Treffer stimmen
     überein, oder zwei unabhängige Fremdlisten sagen dasselbe.
   - *Prüfliste*: eindeutige Repo-Treffer ohne Namensgegenprobe, eindeutige
     Namenstreffer ohne URL-Gegenprobe. Bei ~3 min je Port sind das Wochen,
     keine Jahre.
   - *Gar nicht vorlegen*: reine Domain-Treffer auf Dachprojekt-Domains
     (gnome.org, xiph.org, nasa.gov) ohne zweites Signal — daher stammen
     fast alle Widersprüche.
5. **Negativliste pflegen wie chkcpe** — die 1.188 `nomatch` sind der
   wertvollste Teil von chkcpe und dürfen nicht verloren gehen.
6. **Was portstatus beisteuern kann**:
   eine Kandidatenliste aus 2. und 3., gegen `overlay.json` gefiltert, je
   Kandidat mit Begründung (welche Referenz-URL, welche Fremdliste) und
   Konfidenz. Alle Rohdaten dafür liegen schon in der portstatus-DB —
   `ports.www` ist für alle 38.430 Ports gefüllt.

Nicht empfohlen: `titles` gegen `COMMENT` fuzzy-matchen (belegt sinnlos),
Masseneinreichungen an NIST, Repology als CPE-Quelle.

---

## 9. Offen / nicht belegt

- Lizenz von Debians `data/CPE/list` und von NetBSDs `pkg-vulnerabilities`.
- Zeilenzahl von Repologys `project_cpe`/`manual_cpes` (nur aus dem 2,48-GB-Dump).
- Öffentlicher Anitya-DB-Dump: Wunsch liegt als Ticket vor, Existenz unbelegt.
- Ob CPE-Einträge ausschließlich über CVEs entstehen — keine explizite
  NIST-Aussage auffindbar; 45 % aller Produkte haben eine `Advisory`-Referenz.
- Exakter Netto-Zugewinn über den ganzen Baum: die chkcpe-Wiki-Listen sind
  bei 2.000 Zeilen abgeschnitten.

---

## Quellen

**FreeBSD**
- https://github.com/decke/chkcpe · https://wiki.freebsd.org/Ports/CommonPlatformEnumeration
- https://www.freebsd.org/status/report-2021-07-2021-09/cpe

**NVD / CPE**
- https://nvd.nist.gov/products/cpe · https://nvd.nist.gov/products/cpe/statistics
- https://nvd.nist.gov/feeds/json/cpe/2.0/nvdcpe-2.0.tar.gz
- https://csrc.nist.gov/schema/nvd/api/2.0/cpe_api_json_2.0.schema
- https://nvd.nist.gov/developers/products · https://nvd.nist.gov/developers/start-here
- https://cpe.mitre.org/dictionary/ · https://www.nist.gov/itl/nvd

**CVE / purl / OSV**
- https://github.com/CVEProject/cve-schema/releases/tag/v5.1.1-rc2
- https://github.com/CVEProject/cve-schema/releases/tag/v5.2.0
- https://github.com/cisagov/vulnrichment
- https://github.com/package-url/purl-spec/issues/138 · https://github.com/package-url/purl-spec/pull/496
- https://github.com/google/osv.dev/tree/master/vulnfeeds/cmd/mirrors/cpe-repo-gen
- https://storage.googleapis.com/cve-osv-conversion/cpe_repos/cpe_product_to_repo.json
- https://github.com/github/advisory-database

**Fremdlisten**
- https://raw.githubusercontent.com/Ravenports/Ravenports/master/Mk/Misc/repology.json
- https://github.com/scanoss/purl2cpe · https://github.com/aboutcode-org/vulnerablecode-purl2cpe
- https://distfiles.gentoo.org/snapshots/gentoo-latest.tar.xz · https://www.gentoo.org/glep/glep-0068.html
- https://github.com/openwrt/packages · https://downloads.openwrt.org/releases/24.10.0/packages/x86_64/packages/Packages
- https://ftp.suse.com/pub/projects/security/package2cpe.csv · https://ftp.suse.com/pub/projects/security/csaf/
- https://salsa.debian.org/security-tracker-team/security-tracker/-/raw/master/data/CPE/list
- https://salsa.debian.org/security-tracker-team/security-tracker/-/blob/master/bin/compare-nvd-cve
- https://release-monitoring.org/api/v2/packages/?distribution=CPE%20NVD%20NIST
- https://github.com/repology/repology-updater · https://dumps.repology.org/
- https://secdb.alpinelinux.org/ · https://cdn.NetBSD.org/pub/NetBSD/packages/vulns/pkg-vulnerabilities

**Werkzeuge**
- https://github.com/dependency-check/DependencyCheck
- https://github.com/cve-search/cpe-guesser · https://github.com/ossf/cve-bin-tool
- https://github.com/prefix-dev/purl-associator
- https://www.mail-archive.com/bug-guix@gnu.org/msg19378.html
- https://lup.lub.lu.se/record/55a6bc35-97e0-4b67-b7c8-a4c0c9bedf77 · https://arxiv.org/pdf/2505.13895
