#4: TLS zur OVN-Northbound-DB #22

Merged
jochen merged 5 commits from feat/issue-4-tls into master 2026-11-19 10:24:05 +00:00
Collaborator

Fixes #4

Baut auf #21 (Port-Security) auf. Bitte #21 zuerst mergen; danach zeigt dieser PR nur noch die TLS-Änderungen.

Was sich ändert

Bei ssl:-Zielen meldet sich das Plugin jetzt mit einem Client-Zertifikat an. Bisher funktionierte ssl: gar nicht, und man war praktisch auf unverschlüsseltes tcp: angewiesen.

Die drei Dateien (Schlüssel, Zertifikat, CA-Zertifikat) kommen jeweils aus

  1. external_ids:ovn-nb-private-key / ovn-nb-certificate / ovn-nb-ca-cert (NB-spezifisch), sonst
  2. der SSL-Tabelle des lokalen OVS (ovs-vsctl set-ssl). Die nutzt ovn-controller ohnehin für die Southbound-Verbindung, sodass auf vielen Hosts nichts zusätzlich konfiguriert werden muss.

Die Auflösung erfolgt pro Datei: man kann z. B. nur ein eigenes NB-Zertifikat setzen und die CA aus der SSL-Tabelle nehmen.

  • Die Optionen gehen an ovn-nbctl und ovsdb-client, sodass auch die CAS-Transaktionen aus #20 über TLS laufen.
  • Fehlt eine Datei oder ist sie nicht lesbar, bricht das Plugin mit einer Meldung ab, die die fehlende Einstellung bzw. Datei nennt. Zu dem Zeitpunkt ist noch nichts angelegt.
  • Bei tcp: warnt podman network create. Bei jedem Containerstart zu warnen wäre zu laut.
  • Kommagetrennte Zieldlisten (geclusterte NB-DB) werden berücksichtigt.
  • Das Migrationsskript löst die Dateien genauso auf, zusätzlich mit --private-key/--certificate/--ca-cert.

Umsetzung

  • Das neue Modul src/tls.rs ist eine reine Funktion resolve() mit Unit-Tests.
  • Alle drei Stellen, die die NB-Verbindung aufbauen (create, setup, teardown), laufen über connect_nb().

Tests

  • 37 Unit-Tests (5 neu für TLS), der NB-Integrationstest sowie 5 Python-Tests (3 neu, laufen ohne NB-DB): grün.
  • e2e Szenario 8 (neu): Die Test-NB-DB lauscht zusätzlich auf pssl: mit eigener Test-CA, Server- und Client-Zertifikat werden per openssl erzeugt.
    • Ohne Zertifikate wird der Start abgelehnt, mit Hinweis auf set-ssl, und nichts bleibt liegen.
    • Mit OVS-SSL-Tabelle laufen setup und teardown über TLS, inklusive Port-Security und CAS-Löschen über ovsdb-client.
    • Ein unlesbares Zertifikat in external_ids wird mit Dateinamen gemeldet.
    • Mit external_ids:ovn-nb-* laufen setup und teardown über TLS.
  • e2e insgesamt: 8 Szenarien, alle grün. Die CI-e2e installiert dafür openssl.
  • clippy (inkl. pedantic) und gitleaks: sauber. Es werden keine Zertifikate eingecheckt, die Test-CA entsteht zur Laufzeit im Temp-Verzeichnis.

Doku

Die README hat jetzt einen Abschnitt „TLS zur Northbound-DB“ und einen Hinweis unter Sicherheit: Die NB-DB kennt kein RBAC wie die Southbound-DB. Der Schutz liegt allein in der Client-CA und darin, wer den Port erreicht (Firewall).

🤖 Generated with Claude Code

https://claude.ai/code/session_01Vh6imgDjPn5oPxMtrM1vto

Fixes #4 > **Baut auf #21 (Port-Security) auf.** Bitte #21 zuerst mergen; danach zeigt dieser PR nur noch die TLS-Änderungen. ## Was sich ändert Bei `ssl:`-Zielen meldet sich das Plugin jetzt mit einem Client-Zertifikat an. Bisher funktionierte `ssl:` gar nicht, und man war praktisch auf unverschlüsseltes `tcp:` angewiesen. Die drei Dateien (Schlüssel, Zertifikat, CA-Zertifikat) kommen jeweils aus 1. `external_ids:ovn-nb-private-key` / `ovn-nb-certificate` / `ovn-nb-ca-cert` (NB-spezifisch), sonst 2. der SSL-Tabelle des lokalen OVS (`ovs-vsctl set-ssl`). Die nutzt `ovn-controller` ohnehin für die Southbound-Verbindung, sodass auf vielen Hosts nichts zusätzlich konfiguriert werden muss. Die Auflösung erfolgt pro Datei: man kann z. B. nur ein eigenes NB-Zertifikat setzen und die CA aus der SSL-Tabelle nehmen. - Die Optionen gehen an **`ovn-nbctl` und `ovsdb-client`**, sodass auch die CAS-Transaktionen aus #20 über TLS laufen. - Fehlt eine Datei oder ist sie nicht lesbar, bricht das Plugin mit einer Meldung ab, die die fehlende Einstellung bzw. Datei nennt. Zu dem Zeitpunkt ist noch nichts angelegt. - Bei `tcp:` warnt `podman network create`. Bei jedem Containerstart zu warnen wäre zu laut. - Kommagetrennte Zieldlisten (geclusterte NB-DB) werden berücksichtigt. - Das **Migrationsskript** löst die Dateien genauso auf, zusätzlich mit `--private-key`/`--certificate`/`--ca-cert`. ## Umsetzung - Das neue Modul `src/tls.rs` ist eine reine Funktion `resolve()` mit Unit-Tests. - Alle drei Stellen, die die NB-Verbindung aufbauen (create, setup, teardown), laufen über `connect_nb()`. ## Tests - 37 Unit-Tests (5 neu für TLS), der NB-Integrationstest sowie 5 Python-Tests (3 neu, laufen ohne NB-DB): grün. - **e2e Szenario 8 (neu):** Die Test-NB-DB lauscht zusätzlich auf `pssl:` mit eigener Test-CA, Server- und Client-Zertifikat werden per openssl erzeugt. - Ohne Zertifikate wird der Start abgelehnt, mit Hinweis auf `set-ssl`, und nichts bleibt liegen. - Mit OVS-SSL-Tabelle laufen setup und teardown über TLS, inklusive Port-Security und CAS-Löschen über `ovsdb-client`. - Ein unlesbares Zertifikat in `external_ids` wird mit Dateinamen gemeldet. - Mit `external_ids:ovn-nb-*` laufen setup und teardown über TLS. - e2e insgesamt: 8 Szenarien, alle grün. Die CI-e2e installiert dafür `openssl`. - clippy (inkl. pedantic) und gitleaks: sauber. Es werden keine Zertifikate eingecheckt, die Test-CA entsteht zur Laufzeit im Temp-Verzeichnis. ## Doku Die README hat jetzt einen Abschnitt „TLS zur Northbound-DB“ und einen Hinweis unter Sicherheit: Die NB-DB kennt kein RBAC wie die Southbound-DB. Der Schutz liegt allein in der Client-CA und darin, wer den Port erreicht (Firewall). 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01Vh6imgDjPn5oPxMtrM1vto
port_security eines Ports lesen; Setzen/Löschen über eine Funktion (#3)
Some checks failed
ci / rust (push) Failing after 1m42s
ci / deb (push) Has been skipped
ci / e2e (push) Has been skipped
c76f17b5fc
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6imgDjPn5oPxMtrM1vto
Port-Security: streng für eigene Ports, Netbox-Ports unangetastet (#3)
Some checks failed
ci / deb (push) Has been cancelled
ci / e2e (push) Has been cancelled
ci / rust (push) Has been cancelled
11d3f73ed6
- Neue Netzoption port_security=strict|mac-only|off (Standard strict),
  geprüft schon bei podman network create.
- Ports, die Podman gehören (angelegt, behalten, übernommen), bekommen bei
  jedem Start port_security gesetzt -- auch wenn die Adressen schon am
  Port stehen (bisher dann gar keine Port-Security).
- strict ohne bekannte IP: Start wird abgelehnt, bevor am Host etwas
  angelegt wird (bisher nur MAC-Filter, jede Quell-IP ging durch).
- Außerhalb von Podman provisionierte Ports (z. B. Netbox, freigegeben
  über podman-allowed bzw. ovn_external_ports=allow): port_security wird
  nie verändert; ist sie leer, nur eine Warnung.
- Entscheidung als reine Funktion ports::port_security_action mit
  Unit-Tests; setup() lagert veth-Anlage aus (Länge unter 100 Zeilen).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6imgDjPn5oPxMtrM1vto
e2e und README: Port-Security eigener und extern provisionierter Ports (#3)
Some checks failed
ci / rust (push) Successful in 7m49s
ci / rust (pull_request) Successful in 7m54s
/ gitleaks (pull_request) Successful in 10s
ci / deb (push) Successful in 9m18s
ci / deb (pull_request) Successful in 6m24s
ci / e2e (push) Failing after 47s
ci / e2e (pull_request) Failing after 22s
e194ac3fef
- e2e Szenario 6: eigener Port ohne IP wird abgelehnt (nichts bleibt
  liegen); mac-only setzt nur die MAC, off leert port_security.
- e2e Szenario 7: Netbox-artig vorprovisionierter Port mit Zusatz-VIP in
  port_security bleibt unverändert, Container bekommt die provisionierte
  Adresse; leere port_security bleibt leer, mit Warnung.
- Szenario 2 prüft port_security (MAC + IP) des eigenen Ports.
- README: Abschnitt Port-Security, Netzoption, Beispiel für
  vorprovisionierte Ports; Podman >= 5.4 reicht lsp_name per
  --network netz:lsp_name=... durch.

Gegen den bisherigen master: 6 Prüfungen der neuen Szenarien rot.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6imgDjPn5oPxMtrM1vto
TLS zur OVN-Northbound-DB (#4)
Some checks failed
ci / rust (push) Has been cancelled
ci / deb (push) Has been cancelled
ci / e2e (push) Has been cancelled
d345c3e966
Bei ssl:-Zielen meldet sich das Plugin mit Client-Zertifikat an. Die drei
Dateien kommen jeweils aus
  1. external_ids:ovn-nb-private-key / ovn-nb-certificate /
     ovn-nb-ca-cert (NB-spezifisch), sonst
  2. der SSL-Tabelle des lokalen OVS (ovs-vsctl set-ssl), wie sie auch
     ovn-controller nutzt,
und gehen an ovn-nbctl und ovsdb-client (--private-key, --certificate,
--ca-cert). Fehlt eine Datei oder ist sie nicht lesbar, bricht das Plugin
mit einer Meldung ab, die die fehlende Einstellung nennt.

Bei tcp: warnt podman network create (unverschlüsselt, unauthentifiziert).

Auflösung als reine Funktion tls::resolve mit Unit-Tests; alle drei Stellen,
die die NB-Verbindung aufbauen, laufen über connect_nb().

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6imgDjPn5oPxMtrM1vto
ovn-nbctl/ovsdb-client mit TLS-Optionen, connect_nb() (#4)
Some checks failed
ci / rust (push) Has been cancelled
ci / deb (push) Has been cancelled
ci / e2e (push) Has been cancelled
f6a6b0481a
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6imgDjPn5oPxMtrM1vto
Migrationsskript: TLS für ssl:-Ziele wie im Plugin (#4)
Some checks failed
ci / rust (push) Has been cancelled
ci / deb (push) Has been cancelled
ci / e2e (push) Has been cancelled
d92e1fdcb0
Schlüssel, Zertifikat und CA-Zertifikat werden wie im Plugin aufgelöst
(external_ids:ovn-nb-*, sonst OVS-SSL-Tabelle); --private-key,
--certificate und --ca-cert überschreiben. Unit-Tests ohne NB-DB.
CI-e2e installiert openssl für die Test-CA.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6imgDjPn5oPxMtrM1vto
e2e über ssl: mit Test-CA; README: TLS zur Northbound-DB (#4)
Some checks failed
ci / rust (push) Successful in 7m50s
ci / rust (pull_request) Successful in 7m58s
/ gitleaks (pull_request) Successful in 10s
ci / deb (push) Successful in 6m37s
ci / deb (pull_request) Successful in 5m36s
ci / e2e (push) Failing after 1m1s
ci / e2e (pull_request) Failing after 24s
db64b864be
- e2e Szenario 8: NB-DB lauscht zusätzlich auf pssl: (eigene Test-CA,
  Server- und Client-Zertifikat per openssl). Ohne Zertifikate bricht
  setup mit Hinweis auf set-ssl ab, nichts bleibt liegen; mit OVS-SSL-
  Tabelle bzw. external_ids:ovn-nb-* laufen setup und teardown (inkl.
  CAS-Löschen über ovsdb-client) über TLS; unlesbares Zertifikat wird
  mit Dateiname gemeldet.
- README: Abschnitt TLS zur Northbound-DB, neue external_ids,
  Sicherheitshinweis (NB-DB ohne RBAC, Schutz über Client-CA/Firewall).

Fixes #4

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6imgDjPn5oPxMtrM1vto
e2e: Netns per nsenter statt ip -n (sysfs-Mount im Podman-Runner verboten)
All checks were successful
ci / rust (push) Successful in 7m57s
ci / rust (pull_request) Successful in 7m52s
/ gitleaks (pull_request) Successful in 10s
ci / deb (push) Successful in 6m26s
ci / deb (pull_request) Successful in 5m36s
ci / e2e (push) Successful in 50s
ci / e2e (pull_request) Successful in 22s
94698458ba
Gleicher Fix wie auf feat/issue-3-port-security: `ip -n`/`ip netns exec`
mounten /sys neu, was der Kernel in einem Podman-Container mit maskiertem
/sys verweigert. Szenario 7 schlug dadurch fehl, Szenario 1 war fälschlich
grün. nsenter --net macht nur setns().

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6imgDjPn5oPxMtrM1vto
jochen approved these changes 2026-11-19 10:23:39 +00:00
jochen merged commit b1b848fdba into master 2026-11-19 10:24:05 +00:00
jochen deleted branch feat/issue-4-tls 2026-11-19 10:24:06 +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!22
No description provided.