diff --git a/docs/architecture/contraintes.rst b/docs/architecture/contraintes.rst index 5af5673..ac204dc 100644 --- a/docs/architecture/contraintes.rst +++ b/docs/architecture/contraintes.rst @@ -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`` 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. diff --git a/docs/architecture/stockage.rst b/docs/architecture/stockage.rst index 431b92b..4931e13 100644 --- a/docs/architecture/stockage.rst +++ b/docs/architecture/stockage.rst @@ -26,6 +26,7 @@ de sérialisation structurée. vm//nic//ip → vm//nic//mac → (fournie par l'appelant, conservée telle quelle) vm//nic//primary → "true" (exactement une interface ; absent sur les autres) + vm//nic//dhcp_server → "true" (absent si l'interface ne sert pas le DHCP) vm//nic//tap_id → (alloué au premier démarrage, puis conservé) vm//metadata_port → vm//disk/ → (une clé par disque : vda, xvda, xvdb, …) diff --git a/docs/concepts/modes-reseau.rst b/docs/concepts/modes-reseau.rst index 4017110..16ea561 100644 --- a/docs/concepts/modes-reseau.rst +++ b/docs/concepts/modes-reseau.rst @@ -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-``, ``fwd-``, ``out-``) 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--i``, règles décrites plus haut) et le tap de chaque interface +de VM (``tap``, chaîne ``pre-tap`` : ce que la VM émet, voir +:doc:`/concepts/vpc-subnet-vm`). .. note:: diff --git a/docs/concepts/vpc-subnet-vm.rst b/docs/concepts/vpc-subnet-vm.rst index 0c9e850..a7d8516 100644 --- a/docs/concepts/vpc-subnet-vm.rst +++ b/docs/concepts/vpc-subnet-vm.rst @@ -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 diff --git a/docs/exploitation/diagnostic.rst b/docs/exploitation/diagnostic.rst index ef8f322..f38b116 100644 --- a/docs/exploitation/diagnostic.rst +++ b/docs/exploitation/diagnostic.rst @@ -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 ping -I ``. 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 nft list table bridge two | grep -B1 'ether saddr != drop' + ip netns exec nft list chain bridge two pre-tap + +Une chaîne absente, ou une interface absente de ``pre_ports``, laisse la VM émettre sans filtre : +le watchdog le signale (``interface : nftables rule missing``). Recréer la VM repose ses règles. + La VM a une adresse mais cloud-init n'applique rien --------------------------------------------------- diff --git a/release_notes/0.3.0.md b/release_notes/0.3.0.md index a89759a..e994f0d 100644 --- a/release_notes/0.3.0.md +++ b/release_notes/0.3.0.md @@ -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