#14: README, clippy::pedantic, Hardening (PATH, OVSDB-Strings, Namenskollision) #19

Merged
jochen merged 3 commits from chore/issue-14 into master 2026-11-14 19:41:28 +00:00
Collaborator

Fixes #14 – die offenen Punkte nach #15–#18.

Doku

  • README.md (deutsch): Zweck, Voraussetzungen (external_ids:ovn-nb/ovn-bridge/system-id), Installation über die Registry bzw. manuell, Netz- und Anbindungsoptionen, Adressvergabe, Port-Eigentum, Migrationsskript, Fehlerverhalten, Sicherheit, bekannte Einschränkungen, Tests/CI.
  • Das Paket enthält die README unter /usr/share/doc/netavark-ovs/.

Code-Qualität

  • cargo clippy -- -W clippy::pedantic läuft ohne Warnungen. setup() ist in benannte Schritte zerlegt (acquire_logical_port, initial_addresses, move_into_container, configure_addresses, apply_routes); das Verhalten ist unverändert.
  • prefix_and_gateway ist jetzt eine reine Funktion mit Unit-Tests.
  • In der CI ist pedantic bewusst nicht als -D aktiv: Neue pedantic-Lints in neuen Rust-Versionen würden sonst die CI ohne Codeänderung rot machen.

Hardening

  • Fester PATH für alle aufgerufenen Werkzeuge. Das Plugin läuft als root und übernimmt den PATH von netavark nicht mehr. Lokal geprüft: Mit PATH=/tmp/evil:$PATH hat die alte Version untergeschobene ip/ovs-vsctl ausgeführt, die neue nicht.
  • OVSDB-Strings werden im neuen Modul src/ovsdb.rs per JSON dekodiert, statt nur die Anführungszeichen abzuschneiden (Escapes wie \" blieben sonst stehen). Quoting und Parsing teilen sich ovs.rs und ovn.rs.
  • interface_name wird nach den Kernel-Regeln geprüft: 1–15 Zeichen, kein /, kein :, kein Leerraum.
  • Namenskollision der Host-Interfaces: veo<hash> ist nur ein 32-Bit-Hash von (Container, Netz). Seit #18 entfernt setup() einen gleichnamigen Port als Rest eines Fehlstarts. Bei einer Kollision hätte das den Port eines fremden laufenden Containers gelöscht, und teardown() ebenso.
    • Neu trägt das OVS-Interface external_ids:podman-attachment=<container>/<netz>.
    • Entfernt wird nur, was zu dieser Anbindung gehört oder tot ist (das Gerät fehlt). Ports älterer Versionen ohne Markierung gelten als eigene, wenn sie ungebunden sind oder an unseren LSP gebunden.
    • Sonst bricht setup mit einer klaren Meldung ab, teardown warnt und lässt den Port stehen.
    • Die Entscheidung liegt in der reinen Funktion ports::classify_local_port und ist unit-getestet.

Tests

  • 28 Unit-Tests, dazu der NB-Integrationstest und der Unittest des Migrationsskripts, alle grün.
  • tests/e2e.sh:
    • Szenario 2 prüft zusätzlich die Attachment-Markierung.
    • Szenario 4 prüft ausdrücklich, dass der LSP bei unerreichbarer NB-DB stehen bleibt.
    • Das neue Szenario 5 simuliert die Kollision mit einer fremden, lebenden Anbindung. Gegen den bisherigen master schlagen dort 5 Prüfungen fehl, mit diesem Branch sind alle grün.
  • gitleaks: keine Funde.

Nicht Teil dieses PRs

  • #11 ist teilweise abgedeckt (PATH, Eingabeprüfung). Ein echter OVSDB-Client statt Prozessaufrufen bleibt offen.
  • lsp_name/lsp_cleanup werden aus network_options.options gelesen. Ob Podman beliebige Schlüssel per --network net:key=value durchreicht, ist ungeklärt; die README weist darauf hin.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Vh6imgDjPn5oPxMtrM1vto

Fixes #14 – die offenen Punkte nach #15–#18. ## Doku - **README.md** (deutsch): Zweck, Voraussetzungen (`external_ids:ovn-nb/ovn-bridge/system-id`), Installation über die Registry bzw. manuell, Netz- und Anbindungsoptionen, Adressvergabe, Port-Eigentum, Migrationsskript, Fehlerverhalten, Sicherheit, bekannte Einschränkungen, Tests/CI. - Das Paket enthält die README unter `/usr/share/doc/netavark-ovs/`. ## Code-Qualität - `cargo clippy -- -W clippy::pedantic` läuft ohne Warnungen. `setup()` ist in benannte Schritte zerlegt (`acquire_logical_port`, `initial_addresses`, `move_into_container`, `configure_addresses`, `apply_routes`); das Verhalten ist unverändert. - `prefix_and_gateway` ist jetzt eine reine Funktion mit Unit-Tests. - In der CI ist pedantic bewusst **nicht** als `-D` aktiv: Neue pedantic-Lints in neuen Rust-Versionen würden sonst die CI ohne Codeänderung rot machen. ## Hardening - **Fester `PATH`** für alle aufgerufenen Werkzeuge. Das Plugin läuft als root und übernimmt den PATH von netavark nicht mehr. Lokal geprüft: Mit `PATH=/tmp/evil:$PATH` hat die alte Version untergeschobene `ip`/`ovs-vsctl` ausgeführt, die neue nicht. - **OVSDB-Strings** werden im neuen Modul `src/ovsdb.rs` per JSON dekodiert, statt nur die Anführungszeichen abzuschneiden (Escapes wie `\"` blieben sonst stehen). Quoting und Parsing teilen sich `ovs.rs` und `ovn.rs`. - **`interface_name`** wird nach den Kernel-Regeln geprüft: 1–15 Zeichen, kein `/`, kein `:`, kein Leerraum. - **Namenskollision der Host-Interfaces:** `veo<hash>` ist nur ein 32-Bit-Hash von (Container, Netz). Seit #18 entfernt `setup()` einen gleichnamigen Port als Rest eines Fehlstarts. Bei einer Kollision hätte das den Port eines **fremden laufenden** Containers gelöscht, und `teardown()` ebenso. - Neu trägt das OVS-Interface `external_ids:podman-attachment=<container>/<netz>`. - Entfernt wird nur, was zu dieser Anbindung gehört oder tot ist (das Gerät fehlt). Ports älterer Versionen ohne Markierung gelten als eigene, wenn sie ungebunden sind oder an unseren LSP gebunden. - Sonst bricht `setup` mit einer klaren Meldung ab, `teardown` warnt und lässt den Port stehen. - Die Entscheidung liegt in der reinen Funktion `ports::classify_local_port` und ist unit-getestet. ## Tests - 28 Unit-Tests, dazu der NB-Integrationstest und der Unittest des Migrationsskripts, alle grün. - `tests/e2e.sh`: - Szenario 2 prüft zusätzlich die Attachment-Markierung. - Szenario 4 prüft ausdrücklich, dass der LSP bei unerreichbarer NB-DB stehen bleibt. - Das **neue Szenario 5** simuliert die Kollision mit einer fremden, lebenden Anbindung. Gegen den bisherigen master schlagen dort 5 Prüfungen fehl, mit diesem Branch sind alle grün. - gitleaks: keine Funde. ## Nicht Teil dieses PRs - #11 ist teilweise abgedeckt (PATH, Eingabeprüfung). Ein echter OVSDB-Client statt Prozessaufrufen bleibt offen. - `lsp_name`/`lsp_cleanup` werden aus `network_options.options` gelesen. Ob Podman beliebige Schlüssel per `--network net:key=value` durchreicht, ist ungeklärt; die README weist darauf hin. 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01Vh6imgDjPn5oPxMtrM1vto
Hardening aus #14: fester PATH, OVSDB-Strings, Interface-Namenskollision
Some checks failed
ci / rust (push) Failing after 1m51s
ci / deb (push) Has been skipped
ci / e2e (push) Has been skipped
864d8f8012
- Fester PATH für alle aufgerufenen Werkzeuge (ip, nsenter, ovs-vsctl,
  ovn-nbctl): das Plugin läuft als root und darf keine Binaries aus dem
  PATH übernehmen, mit dem netavark gestartet wurde.
- Neues Modul ovsdb.rs: OVSDB-Strings werden per JSON dekodiert statt nur
  Anführungszeichen abzuschneiden (Escapes wie \" blieben sonst stehen);
  gemeinsames Quoting/Parsing für ovs.rs und ovn.rs.
- Host-Interface-Namen sind ein 32-Bit-Hash von (Container, Netz). Seit #18
  räumt setup() einen gleichnamigen OVS-Port als Rest eines Fehlstarts weg
  -- bei einer Kollision hätte das den Port eines fremden laufenden
  Containers gelöscht (und teardown ebenso). Jetzt trägt das OVS-Interface
  external_ids:podman-attachment=<container>/<netz>; entfernt wird nur, was
  nachweislich zu dieser Anbindung gehört oder tot ist (Gerät fehlt).
  Sonst bricht setup() mit klarer Meldung ab, teardown lässt den Port in
  Ruhe. Entscheidung als reine, getestete Funktion
  (ports::classify_local_port).
- interface_name aus podman wird nach Kernel-Regeln geprüft.
- clippy::pedantic sauber: setup() in benannte Schritte zerlegt
  (acquire_logical_port, initial_addresses, move_into_container,
  configure_addresses, apply_routes), prefix_and_gateway als reine Funktion
  mit Tests; Verhalten unverändert.
- Tests: 28 Unit-Tests; e2e.sh prüft zusätzlich die Attachment-Markierung
  und den Kollisionsfall (gegen den bisherigen master: 5 Prüfungen rot).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6imgDjPn5oPxMtrM1vto
setup/teardown: Kollisionsschutz, fester PATH, ifname-Prüfung, pedantic
All checks were successful
ci / rust (push) Successful in 7m52s
ci / deb (push) Successful in 5m10s
ci / e2e (push) Successful in 20s
247d5223e1
Zweiter Teil zu #14 (siehe vorheriger Commit): main.rs und ports.rs.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6imgDjPn5oPxMtrM1vto
README, e2e-Kollisionstest, README im Paket (#14)
All checks were successful
ci / rust (push) Successful in 7m55s
ci / rust (pull_request) Successful in 7m54s
/ gitleaks (pull_request) Successful in 9s
ci / deb (push) Successful in 5m12s
ci / deb (pull_request) Successful in 5m18s
ci / e2e (push) Successful in 21s
ci / e2e (pull_request) Successful in 20s
508cc888b1
- README.md (deutsch): Zweck, Voraussetzungen, Installation (Paket und
  manuell), Netz- und Anbindungsoptionen, Adressen, Ports und Eigentum,
  Umstieg aufs neue Namensschema, Fehlerverhalten, Sicherheit, bekannte
  Einschränkungen, Entwicklung/Tests/CI.
- Paket: README unter /usr/share/doc/netavark-ovs/.
- e2e.sh: prüft die podman-attachment-Markierung; Szenario 5 simuliert
  eine Hash-Kollision mit einer fremden, lebenden Anbindung (setup muss
  ablehnen, teardown darf den fremden Port nicht anfassen). Szenario 4
  prüft jetzt ausdrücklich, dass der LSP bei unerreichbarer NB-DB stehen
  bleibt, und räumt ihn danach weg.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6imgDjPn5oPxMtrM1vto
jochen approved these changes 2026-11-14 19:11:31 +00:00
jochen merged commit 50899c3a57 into master 2026-11-14 19:41:28 +00:00
jochen deleted branch chore/issue-14 2026-11-14 19:41:29 +00:00
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
jochen/netavark-ovs!19
No description provided.