ACLs für Container-Ports: Port Groups (mit Erlaubnisliste) und optional allow_in #24

Open
opened 2026-11-20 16:24:38 +00:00 by claude · 0 comments
Collaborator

Ziel

Container-Ports sollen in OVN per ACL gefiltert werden können. Heute ist an einem Port nach außen alles erlaubt. Die Port-Security (#3) begrenzt nur die Quell-MAC und die Quell-IP, aber nicht, welche Dienste erreichbar sind.

Was das Plugin zur Verfügung hat

Netavark übergibt dem Plugin (NetworkPluginExec):

  • port_mappings,
  • Netz-Optionen und -Labels,
  • Optionen pro Anbindung (--network net:key=value, ab Podman 5.4),
  • Container-ID und -Name.

Keine Container-Labels oder -Annotations. Sie per Podman-API nachzuladen, während Podman den Container gerade startet, scheidet aus, weil Locks oder Hänger drohen. Alles für die ACL muss deshalb über Netz- oder Anbindungsoptionen kommen.

Bewusst nicht: ACL aus -p ableiten

Es wäre naheliegend, -p 8080:80 als „TCP 80 eingehend erlauben“ zu lesen. Das funktioniert aus drei Gründen nicht sauber:

  • Bei Rootful-Podman reserviert conmon die Host-Ports aus -p und hält sie offen. Port 8080 wäre auf dem Host also belegt, obwohl das Plugin keine Weiterleitung einrichtet und dort nie Verkehr ankommt.
  • Zwei Container mit demselben Container-Port bräuchten unterschiedliche, bedeutungslose Host-Ports.
  • Für ausgehenden Verkehr liefert -p keine Information.

-p bleibt deshalb ohne Wirkung auf die ACLs. Das README soll das ausdrücklich sagen.

Vorschlag

1. Port Groups (Grundlage)

  • Die Regeln liegen zentral als ACLs auf OVN-Port_Groups, z. B. pg_web oder pg_db. Gepflegt werden sie von Hand oder aus NetBox, nicht vom Plugin.
  • Der Container wählt seine Gruppen mit einer Option pro Anbindung, z. B. --network net1:port_groups=web,db.
  • Das Plugin trägt den Port beim Anlegen in derselben NB-Transaktion in die Gruppen ein, per mutate auf Port_Group.ports.
    • Bei einem Fehlstart rollt der vorhandene SetupGuard mit zurück.
  • Beim Löschen muss nichts aufgeräumt werden: Port_Group.ports hält schwache Referenzen, ein gelöschter Port fällt automatisch heraus.
  • Behaltene Ports (ovn_keep_ports, lsp_cleanup=keep): Die Mitgliedschaft wird bei jedem Start auf den gewünschten Stand gebracht. Das betrifft nur Gruppen, die das Plugin verwaltet (siehe Erlaubnisliste).

Erlaubnisliste am Netz (Pflicht):

  • Ohne sie könnte sich jeder Container selbst in eine privilegierte Gruppe eintragen.
  • Vorschlag: podman network create --opt ovn_port_groups=web,db .... Nur diese Gruppen darf ein Container wählen, alles andere führt zu einem Fehler beim Start.
  • Das ist dasselbe Muster wie ovn_external_ports.
  • Eine Gruppe, die in OVN nicht existiert, führt ebenfalls zu einem Fehler. Das Plugin legt keine Gruppen an.
  • Optional eine Standardgruppe am Netz für Container ohne eigene Auswahl, z. B. ovn_default_port_groups=....

2. allow_in (optional, Kurzform)

  • Für einfache Fälle ohne zentral gepflegte Gruppe: --network net1:allow_in=tcp/80,tcp/443,udp/53, auch mit Bereichen wie tcp/8000-8010.
  • Netavark reicht die Option nur durch, auf dem Host hat sie keine Wirkung (anders als -p).
  • Umsetzung:
    • Eine Port Group pro Port, z. B. pgc_<12 Zeichen Container-ID>, mit external_ids:podman-owned=true und podman-container-id.
    • Darauf to-lport-ACLs mit allow-related für die Freigaben und ein drop mit niedrigerer Priorität.
    • Teardown löscht diese Gruppe samt ACLs, als Compare-and-Swap wie bei #12.
  • Am Netz abschaltbar, z. B. ovn_allow_in=deny, wenn dort nur zentrale Gruppen gelten sollen.

Offene Punkte

  • Default-Deny: Heute ist alles erlaubt. Ein Drop für alles nicht Freigegebene ändert das Verhalten bestehender Container. Deshalb nur pro Netz oder pro Gruppe einschalten, nie global.
  • Conntrack: allow-related braucht Conntrack. Nach bisherigem Kenntnisstand läuft dann der Verkehr des ganzen Logical Switch durch Conntrack. Gegen die eingesetzte OVN-Version prüfen und im README nennen.
  • Prioritäten: einen festen Bereich für Plugin-ACLs festlegen, damit sie sich nicht mit zentral gepflegten ACLs überschneiden.
  • Ports aus NetBox: Das Plugin ändert weder ihre Gruppenzugehörigkeit noch ihre ACLs, NetBox ist führend (wie bei #3). Die Zugehörigkeit sollte netbox-ovn-sync setzen, z. B. aus NetBox-Tags. Dafür später ein eigenes Issue dort.
  • Migrationsskript: behaltene Ports aus der Zeit vor diesem Feature haben keine Gruppen. Prüfen, ob dafür ein Hinweis oder eine Ergänzung nötig ist.

Tests

  • Unit-Tests für das Parsen von port_groups, allow_in und der Erlaubnisliste.
  • Integrationstest gegen eine echte NB-DB:
    • Mitgliedschaft wird gesetzt.
    • Eine Gruppe außerhalb der Erlaubnisliste wird abgelehnt.
    • Eine fehlende Gruppe wird abgelehnt.
    • Rollback bei Fehlstart.
    • allow_in-Gruppe und ACLs entstehen und verschwinden wieder.
  • e2e mit ovn-northd und echtem Datenpfad nur, falls der Aufwand vertretbar ist. Sonst reicht die Prüfung der NB-Inhalte.
## Ziel Container-Ports sollen in OVN per ACL gefiltert werden können. Heute ist an einem Port nach außen alles erlaubt. Die Port-Security (#3) begrenzt nur die Quell-MAC und die Quell-IP, aber nicht, welche Dienste erreichbar sind. ## Was das Plugin zur Verfügung hat Netavark übergibt dem Plugin (`NetworkPluginExec`): - `port_mappings`, - Netz-Optionen und -Labels, - Optionen pro Anbindung (`--network net:key=value`, ab Podman 5.4), - Container-ID und -Name. **Keine** Container-Labels oder -Annotations. Sie per Podman-API nachzuladen, während Podman den Container gerade startet, scheidet aus, weil Locks oder Hänger drohen. Alles für die ACL muss deshalb über Netz- oder Anbindungsoptionen kommen. ## Bewusst **nicht**: ACL aus `-p` ableiten Es wäre naheliegend, `-p 8080:80` als „TCP 80 eingehend erlauben“ zu lesen. Das funktioniert aus drei Gründen nicht sauber: - Bei Rootful-Podman reserviert conmon die Host-Ports aus `-p` und hält sie offen. Port 8080 wäre auf dem Host also belegt, obwohl das Plugin keine Weiterleitung einrichtet und dort nie Verkehr ankommt. - Zwei Container mit demselben Container-Port bräuchten unterschiedliche, bedeutungslose Host-Ports. - Für ausgehenden Verkehr liefert `-p` keine Information. `-p` bleibt deshalb ohne Wirkung auf die ACLs. Das README soll das ausdrücklich sagen. ## Vorschlag ### 1. Port Groups (Grundlage) - Die Regeln liegen zentral als ACLs auf OVN-`Port_Group`s, z. B. `pg_web` oder `pg_db`. Gepflegt werden sie von Hand oder aus NetBox, nicht vom Plugin. - Der Container wählt seine Gruppen mit einer Option pro Anbindung, z. B. `--network net1:port_groups=web,db`. - Das Plugin trägt den Port beim Anlegen in derselben NB-Transaktion in die Gruppen ein, per `mutate` auf `Port_Group.ports`. - Bei einem Fehlstart rollt der vorhandene `SetupGuard` mit zurück. - Beim Löschen muss nichts aufgeräumt werden: `Port_Group.ports` hält schwache Referenzen, ein gelöschter Port fällt automatisch heraus. - Behaltene Ports (`ovn_keep_ports`, `lsp_cleanup=keep`): Die Mitgliedschaft wird bei jedem Start auf den gewünschten Stand gebracht. Das betrifft nur Gruppen, die das Plugin verwaltet (siehe Erlaubnisliste). **Erlaubnisliste am Netz (Pflicht):** - Ohne sie könnte sich jeder Container selbst in eine privilegierte Gruppe eintragen. - Vorschlag: `podman network create --opt ovn_port_groups=web,db ...`. Nur diese Gruppen darf ein Container wählen, alles andere führt zu einem Fehler beim Start. - Das ist dasselbe Muster wie `ovn_external_ports`. - Eine Gruppe, die in OVN nicht existiert, führt ebenfalls zu einem Fehler. Das Plugin legt **keine** Gruppen an. - Optional eine Standardgruppe am Netz für Container ohne eigene Auswahl, z. B. `ovn_default_port_groups=...`. ### 2. `allow_in` (optional, Kurzform) - Für einfache Fälle ohne zentral gepflegte Gruppe: `--network net1:allow_in=tcp/80,tcp/443,udp/53`, auch mit Bereichen wie `tcp/8000-8010`. - Netavark reicht die Option nur durch, auf dem Host hat sie keine Wirkung (anders als `-p`). - Umsetzung: - Eine Port Group pro Port, z. B. `pgc_<12 Zeichen Container-ID>`, mit `external_ids:podman-owned=true` und `podman-container-id`. - Darauf `to-lport`-ACLs mit `allow-related` für die Freigaben und ein `drop` mit niedrigerer Priorität. - Teardown löscht diese Gruppe samt ACLs, als Compare-and-Swap wie bei #12. - Am Netz abschaltbar, z. B. `ovn_allow_in=deny`, wenn dort nur zentrale Gruppen gelten sollen. ## Offene Punkte - **Default-Deny:** Heute ist alles erlaubt. Ein Drop für alles nicht Freigegebene ändert das Verhalten bestehender Container. Deshalb nur pro Netz oder pro Gruppe einschalten, nie global. - **Conntrack:** `allow-related` braucht Conntrack. Nach bisherigem Kenntnisstand läuft dann der Verkehr des ganzen Logical Switch durch Conntrack. Gegen die eingesetzte OVN-Version prüfen und im README nennen. - **Prioritäten:** einen festen Bereich für Plugin-ACLs festlegen, damit sie sich nicht mit zentral gepflegten ACLs überschneiden. - **Ports aus NetBox:** Das Plugin ändert weder ihre Gruppenzugehörigkeit noch ihre ACLs, NetBox ist führend (wie bei #3). Die Zugehörigkeit sollte netbox-ovn-sync setzen, z. B. aus NetBox-Tags. Dafür später ein eigenes Issue dort. - **Migrationsskript:** behaltene Ports aus der Zeit vor diesem Feature haben keine Gruppen. Prüfen, ob dafür ein Hinweis oder eine Ergänzung nötig ist. ## Tests - Unit-Tests für das Parsen von `port_groups`, `allow_in` und der Erlaubnisliste. - Integrationstest gegen eine echte NB-DB: - Mitgliedschaft wird gesetzt. - Eine Gruppe außerhalb der Erlaubnisliste wird abgelehnt. - Eine fehlende Gruppe wird abgelehnt. - Rollback bei Fehlstart. - `allow_in`-Gruppe und ACLs entstehen und verschwinden wieder. - e2e mit `ovn-northd` und echtem Datenpfad nur, falls der Aufwand vertretbar ist. Sonst reicht die Prüfung der NB-Inhalte.
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
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#24
No description provided.