#3: Port-Security streng für eigene Ports, Netbox-Ports unangetastet #21

Merged
jochen merged 4 commits from feat/issue-3-port-security into master 2026-11-19 10:23:00 +00:00
Collaborator

Fixes #3

Hintergrund

Die OVN-Ports werden über Netbox provisioniert, und dort soll auch die Port-Security gepflegt werden. Das Plugin muss deshalb zwei Arten von Ports unterscheiden:

Port Verhalten
Von Podman angelegt oder übernommen port_security wird bei jedem Start gesetzt, gesteuert über die neue Netzoption port_security.
Außerhalb von Podman provisioniert (Netbox; freigegeben über podman-allowed=true bzw. ovn_external_ports=allow) port_security wird nie verändert. Netbox ist maßgeblich, auch für zusätzliche Adressen wie VIPs. Ist das Feld leer, gibt es nur eine Warnung (bewusst „aus“ für Router oder VRRP bleibt möglich).

Neue Netzoption port_security

  • strict (Standard): MAC und alle IPs. Ist keine IP bekannt, startet der Container nicht, bevor am Host etwas angelegt wird. Bisher wurde dann nur die MAC gefiltert, und jede Quell-IP ging durch.
  • mac-only: nur die MAC.
  • off: keine Port-Security.

Ungültige Werte werden schon bei podman network create abgelehnt.

Neu ist auch: Bei eigenen Ports, deren Adressen schon am Port standen (behaltene Ports, dynamic), wurde bisher gar keine Port-Security gesetzt. Jetzt wird sie gesetzt.

Zuordnung Container → Netbox-Port

Ab Podman 5.4 reicht --network unbekannte Schlüssel an netavark-Plugins durch:

podman run -d --network net1:lsp_name=web-01 nginx

Die README beschreibt das jetzt, samt Beispiel für einen vorbereiteten Port mit VIP.

Umsetzung

  • Die Entscheidung liegt in der reinen Funktion ports::port_security_action und ist unit-getestet.
  • PortInfo liest die Spalte port_security mit.
  • setup() entscheidet direkt nach dem Ermitteln der Adressen und wendet die Entscheidung am Ende an.

Tests

  • 32 Unit-Tests, der Integrationstest gegen eine echte NB-DB und der Unittest des Migrationsskripts: grün.
  • e2e: 7 Szenarien, alle grün.
    • Szenario 6: Ein eigener Port ohne IP wird abgelehnt, und nichts bleibt liegen. mac-only setzt nur die MAC, off leert das Feld.
    • Szenario 7: Ein Netbox-artiger Port mit Zusatz-VIP in port_security bleibt unverändert, und der Container bekommt die provisionierte Adresse. Eine leere port_security bleibt leer, mit Warnung.
    • Szenario 2 prüft zusätzlich MAC+IP am eigenen Port.
  • Gegen den bisherigen master schlagen 6 Prüfungen der neuen Szenarien fehl. Unter anderem startet dort ein Container ohne IP mit reinem MAC-Filter.
  • clippy (inkl. pedantic) und gitleaks: sauber.

Hinweis zum Verhalten nach dem Update

Netze, in denen Container ohne --ip und ohne --subnet laufen, starten mit strict nicht mehr. Abhilfe: dem Container eine IP geben oder am Netz --opt port_security=mac-only setzen. Netbox-Ports sind davon nicht betroffen.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Vh6imgDjPn5oPxMtrM1vto

Fixes #3 ## Hintergrund Die OVN-Ports werden über Netbox provisioniert, und dort soll auch die Port-Security gepflegt werden. Das Plugin muss deshalb zwei Arten von Ports unterscheiden: | Port | Verhalten | |---|---| | **Von Podman angelegt oder übernommen** | `port_security` wird bei jedem Start gesetzt, gesteuert über die neue Netzoption `port_security`. | | **Außerhalb von Podman provisioniert** (Netbox; freigegeben über `podman-allowed=true` bzw. `ovn_external_ports=allow`) | `port_security` wird **nie** verändert. Netbox ist maßgeblich, auch für zusätzliche Adressen wie VIPs. Ist das Feld leer, gibt es nur eine Warnung (bewusst „aus“ für Router oder VRRP bleibt möglich). | ## Neue Netzoption `port_security` - **`strict`** (Standard): MAC und alle IPs. Ist **keine IP bekannt**, startet der Container nicht, bevor am Host etwas angelegt wird. Bisher wurde dann nur die MAC gefiltert, und jede Quell-IP ging durch. - **`mac-only`**: nur die MAC. - **`off`**: keine Port-Security. Ungültige Werte werden schon bei `podman network create` abgelehnt. Neu ist auch: Bei eigenen Ports, deren Adressen schon am Port standen (behaltene Ports, `dynamic`), wurde bisher **gar keine** Port-Security gesetzt. Jetzt wird sie gesetzt. ## Zuordnung Container → Netbox-Port Ab Podman 5.4 reicht `--network` unbekannte Schlüssel an netavark-Plugins durch: ```sh podman run -d --network net1:lsp_name=web-01 nginx ``` Die README beschreibt das jetzt, samt Beispiel für einen vorbereiteten Port mit VIP. ## Umsetzung - Die Entscheidung liegt in der reinen Funktion `ports::port_security_action` und ist unit-getestet. - `PortInfo` liest die Spalte `port_security` mit. - `setup()` entscheidet direkt nach dem Ermitteln der Adressen und wendet die Entscheidung am Ende an. ## Tests - 32 Unit-Tests, der Integrationstest gegen eine echte NB-DB und der Unittest des Migrationsskripts: grün. - e2e: **7 Szenarien, alle grün**. - **Szenario 6:** Ein eigener Port ohne IP wird abgelehnt, und nichts bleibt liegen. `mac-only` setzt nur die MAC, `off` leert das Feld. - **Szenario 7:** Ein Netbox-artiger Port mit Zusatz-VIP in `port_security` bleibt unverändert, und der Container bekommt die provisionierte Adresse. Eine leere `port_security` bleibt leer, mit Warnung. - **Szenario 2** prüft zusätzlich MAC+IP am eigenen Port. - Gegen den **bisherigen master** schlagen 6 Prüfungen der neuen Szenarien fehl. Unter anderem startet dort ein Container ohne IP mit reinem MAC-Filter. - clippy (inkl. pedantic) und gitleaks: sauber. ## Hinweis zum Verhalten nach dem Update Netze, in denen Container ohne `--ip` und ohne `--subnet` laufen, starten mit `strict` nicht mehr. Abhilfe: dem Container eine IP geben oder am Netz `--opt port_security=mac-only` setzen. Netbox-Ports sind davon nicht betroffen. 🤖 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
jochen approved these changes 2026-11-19 07:48:26 +00:00
Dismissed
e2e: Netns per nsenter statt ip -n (sysfs-Mount im Podman-Runner verboten)
All checks were successful
ci / rust (push) Successful in 7m55s
ci / rust (pull_request) Successful in 8m5s
/ gitleaks (pull_request) Successful in 9s
ci / deb (push) Successful in 26m5s
ci / deb (pull_request) Successful in 5m44s
ci / e2e (push) Successful in 53s
ci / e2e (pull_request) Successful in 40s
d1337ad5d3
`ip -n`/`ip netns exec` legen einen eigenen Mount-Namespace an und mounten
/sys neu. In einem Podman-Container ist /sys teilweise maskiert; der Kernel
verweigert dann das neue sysfs-Mount ("mount of /sys failed: Operation not
permitted"), der Befehl läuft gar nicht und liefert eine leere Ausgabe.

- Szenario 7 schlug deshalb fehl, obwohl das Plugin die Adresse gesetzt hat.
- Szenario 1 ("nothing in the netns") war aus demselben Grund fälschlich
  grün: leere Ausgabe = 0 Interfaces. Jetzt schlägt der Check fehl, wenn
  sich die Netns nicht auslesen lässt.

nsenter --net macht nur setns() und braucht kein Mount.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6imgDjPn5oPxMtrM1vto
claude dismissed jochen's review 2026-11-19 09:04:45 +00:00
Reason:

New commits pushed, approval review dismissed automatically according to repository settings

jochen approved these changes 2026-11-19 10:22:51 +00:00
jochen merged commit 913d77f44a into master 2026-11-19 10:23:00 +00:00
jochen deleted branch feat/issue-3-port-security 2026-11-19 10:23:00 +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!21
No description provided.