f-76: doc: filtrage par VM, dhcp_server, diagnostic, notes 0.3.0 #76

Signed-off-by: GnomeZworc <nicolas.boufidjeline@g3e.fr>
This commit is contained in:
GnomeZworc 2026-10-25 23:13:42 +01:00
commit 296d1b6610
Signed by: nicolas.boufideline
GPG key ID: 4406BBBF8845D632
6 changed files with 68 additions and 1 deletions

View file

@ -49,6 +49,9 @@ QEMU et VM
* QEMU est lancé par ``systemd-run --scope``, **jamais** en unit transitoire : le scope est
exécuté par le processus appelant et hérite du netns posé par ``netns.Call``. Une unit
transitoire, forkée par PID 1, démarrerait dans le netns racine et ne verrait pas le tap.
* **Un tap n'existe jamais sans ses règles** : la chaîne ``pre-tap<id>`` est posée avant la
création du tap et retirée après sa suppression. Dans l'autre ordre, une VM pourrait émettre
sans filtre entre deux étapes.
* L'arrêt d'une VM ne touche **jamais** aux fichiers disque. En revanche, un ``quit`` brutal est
envoyé à l'expiration de ``times.timeout_vms_stop``. ``system_powerdown`` est renvoyé toutes les
``times.next_vms_shutdown`` : un appui ACPI arrivé avant que l'invité sache le traiter est perdu.

View file

@ -26,6 +26,7 @@ de sérialisation structurée.
vm/<name>/nic/<i>/ip → <ip>
vm/<name>/nic/<i>/mac → <mac> (fournie par l'appelant, conservée telle quelle)
vm/<name>/nic/<i>/primary → "true" (exactement une interface ; absent sur les autres)
vm/<name>/nic/<i>/dhcp_server → "true" (absent si l'interface ne sert pas le DHCP)
vm/<name>/nic/<i>/tap_id → <int> (alloué au premier démarrage, puis conservé)
vm/<name>/metadata_port → <port>
vm/<name>/disk/<dev> → <path> (une clé par disque : vda, xvda, xvdb, …)

View file

@ -145,7 +145,10 @@ Dans les deux modes, les règles de couche 2 vivent dans une table nftables ``br
du VPC. Trois chaînes de base (``prerouting``, ``forward``, ``output``) aiguillent chaque trame,
selon l'interface d'entrée ou de sortie, vers la chaîne du port concerné (``pre-<port>``,
``fwd-<port>``, ``out-<port>``) par les tables ``pre_ports``, ``fwd_ports`` et ``out_ports``.
L'agent pose ou retire toutes les règles d'un port en une seule transaction.
L'agent pose ou retire toutes les règles d'un port en une seule transaction. Les ports sont le
veth de chaque subnet (``v-<subnet>-i``, règles décrites plus haut) et le tap de chaque interface
de VM (``tap<id>``, chaîne ``pre-tap<id>`` : ce que la VM émet, voir
:doc:`/concepts/vpc-subnet-vm`).
.. note::

View file

@ -104,6 +104,30 @@ la route par défaut et le serveur de metadata. Tous les subnets d'une VM doiven
telle quelle à QEMU et à la réservation DHCP, sans en vérifier le format ni l'unicité : c'est à
l'appelant de garantir qu'elle est unique sur le segment L2.
**Filtrage.** Chaque interface ne peut émettre que depuis sa propre MAC et sa propre IP. L'agent
pose sur son tap, avant de le créer, des règles qui rejettent toute trame émise par la VM :
* dont la MAC source n'est pas celle de l'interface ;
* d'un autre type qu'IPv4, ARP ou IPv6 (une trame étiquetée VLAN par exemple) ;
* ARP, dont la MAC ou l'adresse d'émetteur n'est pas celle de l'interface, sauf l'adresse
``0.0.0.0`` d'une sonde de conflit d'adresse ;
* IPv4, dont la source n'est pas l'adresse de l'interface, sauf ``0.0.0.0`` vers le port 67 (un
client DHCP qui n'a pas encore de bail) ;
* réponse de serveur DHCP (UDP depuis le port 67).
Une VM ne peut donc ni se faire passer pour la gateway ou une autre VM, ni distribuer de baux. Une
VM qui route pour d'autres machines ou porte des adresses supplémentaires ne peut pas émettre
depuis ces adresses. L'IPv6 n'est pas filtrée (#61). Les règles sont retirées après la suppression
du tap ; le watchdog signale une interface d'une VM ``running`` dont les règles manquent ou ont
été modifiées.
**Serveur DHCP.** ``dhcp_server: true`` sur une interface lève le seul blocage des réponses DHCP,
pour cette interface. Cas d'usage : une VM d'un subnet ``bridge`` qui sert le DHCP et le PXE de
machines diskless du segment physique, avec des réservations statiques. Les autres contrôles
restent en place. L'agent applique ce champ quel que soit le mode du subnet : le réserver au mode
``bridge`` revient à l'appelant. Le serveur de la VM reçoit aussi les requêtes des VM du subnet, à
côté du DHCP de l'agent : il ne doit répondre qu'aux machines qui lui sont destinées.
**Routes.** Dans un VPC routé par ``l3vni``, chaque interface sur un subnet ``vxlan`` est annoncée
en ``/32`` dans la VRF du VPC une fois QEMU démarré, juste avant le passage en ``running``. À la
suppression, ces ``/32`` sont retirés **avant** l'arrêt de QEMU. Comme un subnet ne peut être

View file

@ -96,6 +96,25 @@ Depuis le netns d'un hôte, une VM d'un **autre** hôte ne répond qu'à l'adres
``ip netns exec <vpc> ping -I <relay_ip> <ip>``. Un ping sans ``-I`` part de la gateway et la
réponse revient à l'hôte de la VM — ce n'est pas une panne.
Une VM n'arrive pas à émettre certaines trames
----------------------------------------------
Le filtrage du tap rejette ce qu'une interface émet depuis une autre MAC ou une autre IP que les
siennes, l'ARP usurpé, les réponses DHCP et les trames d'un autre type qu'IPv4, ARP ou IPv6
(:doc:`/concepts/vpc-subnet-vm`). Causes rencontrées : une VM qui route pour d'autres machines,
porte une adresse supplémentaire, envoie des trames étiquetées VLAN, ou sert le DHCP sans
``dhcp_server: true`` sur son interface. Ce n'est pas une panne : le filtrage est voulu.
Retrouver la chaîne d'une interface par sa MAC, puis lire ses règles :
.. code-block:: bash
ip netns exec <vpc> nft list table bridge two | grep -B1 'ether saddr != <mac> drop'
ip netns exec <vpc> nft list chain bridge two pre-tap<id>
Une chaîne absente, ou une interface absente de ``pre_ports``, laisse la VM émettre sans filtre :
le watchdog le signale (``interface <i>: nftables rule missing``). Recréer la VM repose ses règles.
La VM a une adresse mais cloud-init n'applique rien
---------------------------------------------------

View file

@ -14,6 +14,20 @@
quand ses VM sont en `deleting`, et attend leur suppression jusqu'à `timeout_subnet_stop`. Le
409 reste pour une VM ni supprimée ni en `deleting`
**Filtrage au port de chaque VM (#76)**
- Chaque interface de VM ne peut émettre que depuis sa propre MAC et sa propre IP. Sont rejetés
à la sortie du tap : une MAC source étrangère, l'ARP dont la MAC ou l'adresse d'émetteur n'est
pas celle de l'interface (sauf la sonde `0.0.0.0`), l'IPv4 d'une autre source (sauf `0.0.0.0`
vers le port 67), les réponses de serveur DHCP et les trames d'un autre type qu'IPv4, ARP ou
IPv6. Une VM ne peut plus se faire passer pour la gateway, une autre VM ou un serveur DHCP
auprès de ses voisines. L'IPv6 n'est pas filtrée (#61)
- Nouveau champ `dhcp_server` d'une interface (faux par défaut, toujours renvoyé par le GET) : il
autorise cette interface à répondre en DHCP, par exemple pour servir le PXE de machines diskless
sur un subnet `bridge`
- Les règles sont posées avant la création du tap et retirées après sa suppression ; le watchdog
signale une interface d'une VM `running` dont les règles manquent ou ont été modifiées
## Correctifs
- **Chaque VRF de VPC porte une route `unreachable default` (#81).** Une recherche qui échouait
@ -45,6 +59,9 @@
`nftables` à la place d'`ebtables`. Les règles ebtables des subnets existants ne sont ni
reprises ni retirées : vider l'hyperviseur (VM, subnets, VPC) avant la mise à jour, puis les
recréer
- **Une VM ne peut plus émettre depuis une adresse qui n'est pas la sienne (#76)** : une VM qui
route pour d'autres machines, porte une adresse supplémentaire ou sert le DHCP perd ce trafic.
Pour un serveur DHCP, créer l'interface avec `dhcp_server: true`
- **`default_route: true` exige une `gateway` hors mode `bridge`** : un appel qui l'omettait en
`vxlan` reçoit désormais un 400. Les subnets existants gardent la route par défaut qu'ils
annonçaient jusqu'à leur recréation