Subnets IPv6 dual-stack en SLAAC, RA émises par le serveur DHCP intégré #63

Open
opened 2026-10-12 13:04:01 +00:00 by nicolas.boufideline · 6 comments

Objectif

Subnets dual-stack : un subnet garde son IPv4 et gagne un préfixe IPv6. L'underlay reste en
IPv4 (VTEP, router-id, route reflectors, RD) — EVPN transporte des routes IPv6 sur un underlay
IPv4.

Décisions (2026-10-12)

  • Dual-stack, pas de subnet IPv6 seul pour commencer : métadonnées (169.254.169.254) et
    cloud-init restent en IPv4.
  • SLAAC : l'adresse IPv6 d'une VM = préfixe du subnet + EUI-64 de sa MAC. Elle est calculée
    par two (et rendue par l'API), pas choisie par l'appelant.
  • Les annonces de routeur (RA) sont émises par le serveur DHCP intégré (backend two) ;
    pas d'IPv6 sur le backend dnsmasq (retrait prévu, #49).

Prérequis

  • MAC fournie à la création de la VM (#62) — l'adresse SLAAC en découle.
  • Filtrage des RA / DHCPv6 émis par les VM (#61).

Inventaire (IPv4 codé en dur, 2026-10-12)

  • Modèle : un seul cidr/interface_ip par subnet, un cidr par VPC, une ip par NIC → ajouter
    cidr6, interface_ip6 (subnet), cidr6 (VPC) ; ip6 calculée par NIC.
  • netif.AddrAdd (masque /32 en dur), TableRoutesVia et GetDefaultGateway (FAMILY_V4).
  • Netns : adresse IPv6 de la gateway, net.ipv6.conf.*.forwarding.
  • dhcpd : DHCPv4 seulement → ajouter l'émetteur de RA (RA périodique + réponse aux RS ; préfixe
    avec drapeau A ; durée de vie de routeur seulement si default_route ; RDNSS). Bibliothèque
    ICMPv6/ND à choisir (insomniacslk/dhcp ne fait pas de RA).
  • ebtables : équivalents IPv6 de DropARPToGateway (ND vers la gateway, à étudier avec #57).
  • L3VNI : FRR address-family ipv6 unicast, advertise ipv6 unicast, ipv6 prefix-list … le 128,
    transit IPv6 (aujourd'hui 169.254.0.0/30), exports /128 des VM ; watchdog (/32 et To4 en
    dur dans check_l3.go).
  • API : format: ipv4 dans api/agent.yaml.
  • e2e : helpers ip -4 de test/e2e/lib/node.sh.

À vérifier en lab avant de s'engager

Les images invitées doivent former leur adresse SLAAC en EUI-64 (et non en « stable privacy »,
RFC 7217), sans quoi l'agent ne connaît pas l'adresse de la VM — indispensable à l'export /128
dans le L3VNI.

Critère de clôture

Scénario e2e dual-stack : VM sur deux hôtes, deux subnets, ping IPv6 dans le subnet et entre
subnets (avec et sans L3VNI), adresse SLAAC conforme à l'EUI-64 de la MAC, IPv4 inchangé.

## Objectif Subnets **dual-stack** : un subnet garde son IPv4 et gagne un préfixe IPv6. L'underlay reste en IPv4 (VTEP, router-id, route reflectors, RD) — EVPN transporte des routes IPv6 sur un underlay IPv4. ## Décisions (2026-10-12) - **Dual-stack**, pas de subnet IPv6 seul pour commencer : métadonnées (`169.254.169.254`) et cloud-init restent en IPv4. - **SLAAC** : l'adresse IPv6 d'une VM = préfixe du subnet + EUI-64 de sa MAC. Elle est calculée par two (et rendue par l'API), pas choisie par l'appelant. - Les **annonces de routeur (RA)** sont émises par le **serveur DHCP intégré** (backend `two`) ; pas d'IPv6 sur le backend dnsmasq (retrait prévu, #49). ## Prérequis - MAC fournie à la création de la VM (#62) — l'adresse SLAAC en découle. - Filtrage des RA / DHCPv6 émis par les VM (#61). ## Inventaire (IPv4 codé en dur, 2026-10-12) - Modèle : un seul `cidr`/`interface_ip` par subnet, un `cidr` par VPC, une `ip` par NIC → ajouter `cidr6`, `interface_ip6` (subnet), `cidr6` (VPC) ; `ip6` calculée par NIC. - `netif.AddrAdd` (masque /32 en dur), `TableRoutesVia` et `GetDefaultGateway` (`FAMILY_V4`). - Netns : adresse IPv6 de la gateway, `net.ipv6.conf.*.forwarding`. - `dhcpd` : DHCPv4 seulement → ajouter l'émetteur de RA (RA périodique + réponse aux RS ; préfixe avec drapeau A ; durée de vie de routeur seulement si `default_route` ; RDNSS). Bibliothèque ICMPv6/ND à choisir (`insomniacslk/dhcp` ne fait pas de RA). - ebtables : équivalents IPv6 de `DropARPToGateway` (ND vers la gateway, à étudier avec #57). - L3VNI : FRR `address-family ipv6 unicast`, `advertise ipv6 unicast`, `ipv6 prefix-list … le 128`, transit IPv6 (aujourd'hui `169.254.0.0/30`), exports `/128` des VM ; watchdog (`/32` et `To4` en dur dans `check_l3.go`). - API : `format: ipv4` dans `api/agent.yaml`. - e2e : helpers `ip -4` de `test/e2e/lib/node.sh`. ## À vérifier en lab avant de s'engager Les images invitées doivent former leur adresse SLAAC en **EUI-64** (et non en « stable privacy », RFC 7217), sans quoi l'agent ne connaît pas l'adresse de la VM — indispensable à l'export `/128` dans le L3VNI. ## Critère de clôture Scénario e2e dual-stack : VM sur deux hôtes, deux subnets, ping IPv6 dans le subnet et entre subnets (avec et sans L3VNI), adresse SLAAC conforme à l'EUI-64 de la MAC, IPv4 inchangé.
Author
Owner

SLAAC EUI-64 décrit dans le network-config (constats de #73)

Depuis #73 (branche feature-73), two sert un network-config par VM, une entrée par NIC visée par sa MAC. Le format v2 permet d'y décrire la méthode IPv6 voulue ici :

version: 2
ethernets:
  eth0:
    match: {macaddress: "52:54:00:49:01:0c"}
    dhcp4: true
    dhcp4-overrides: {route-metric: 100}
    accept-ra: true
    ipv6-address-generation: eui64
    ipv6-privacy: false
  • accept-ra: true : RA émises par le serveur DHCP intégré (décision du 2026-10-12) ;
  • ipv6-address-generation: eui64 : adresse = préfixe + EUI-64 de la MAC fournie par l'appelant (#62), donc calculable par two ; sans cette clé, systemd-networkd et NetworkManager prennent par défaut une adresse stable-privacy, stable mais non prévisible (point « EUI-64 vs stable-privacy » de ce ticket) ;
  • ipv6-privacy: false : pas d'adresses temporaires.

Limites constatées en lab sur #73 (commentaires 1164, 1166, 1170) :

  • le network-config n'est lu que par les images récentes (cloud-init 25.1.4 de Debian 13 oui ; 22.4.2 de Debian 12 jamais) ;
  • même lu, il n'est appliqué qu'au premier démarrage d'une instance (source seedfrom HTTP, lue après le repli d'init-local) ; aux démarrages suivants, le repli de cloud-init (première NIC, IPv6 selon ses défauts) le remplace, sauf si cloud-init est désactivé après le premier démarrage ou si l'événement boot est autorisé.

À vérifier : prise en compte de ces trois clés selon le renderer de cloud-init (netplan les reçoit tels quels ; conversion vers network-manager et networkd à confirmer) — vérification hors ligne en cours.

## SLAAC EUI-64 décrit dans le `network-config` (constats de #73) Depuis #73 (branche `feature-73`), two sert un `network-config` par VM, une entrée par NIC visée par sa MAC. Le format v2 permet d'y décrire la méthode IPv6 voulue ici : ```yaml version: 2 ethernets: eth0: match: {macaddress: "52:54:00:49:01:0c"} dhcp4: true dhcp4-overrides: {route-metric: 100} accept-ra: true ipv6-address-generation: eui64 ipv6-privacy: false ``` - `accept-ra: true` : RA émises par le serveur DHCP intégré (décision du 2026-10-12) ; - `ipv6-address-generation: eui64` : adresse = préfixe + EUI-64 de la MAC fournie par l'appelant (#62), donc calculable par two ; sans cette clé, systemd-networkd et NetworkManager prennent par défaut une adresse `stable-privacy`, stable mais non prévisible (point « EUI-64 vs stable-privacy » de ce ticket) ; - `ipv6-privacy: false` : pas d'adresses temporaires. Limites constatées en lab sur #73 (commentaires 1164, 1166, 1170) : - le `network-config` n'est lu que par les images récentes (cloud-init 25.1.4 de Debian 13 oui ; 22.4.2 de Debian 12 jamais) ; - même lu, il n'est appliqué qu'au premier démarrage d'une instance (source `seedfrom` HTTP, lue après le repli d'init-local) ; aux démarrages suivants, le repli de cloud-init (première NIC, IPv6 selon ses défauts) le remplace, sauf si cloud-init est désactivé après le premier démarrage ou si l'événement `boot` est autorisé. À vérifier : prise en compte de ces trois clés selon le renderer de cloud-init (netplan les reçoit tels quels ; conversion vers network-manager et networkd à confirmer) — vérification hors ligne en cours.
Author
Owner

Clés IPv6 du network-config selon le renderer de cloud-init (vérification hors ligne, 2026-10-20)

Méthode : cloud-init devel net-convert dans des conteneurs (Debian 13 : cloud-init 25.1.4, netplan 1.1.2, systemd 257, NetworkManager 1.52 ; Rocky 10.2 : cloud-init 24.4-7.el10_2.1, NetworkManager 1.56), puis netplan generate et relecture des keyfiles par libnm. Aucune VM démarrée : conclusions tirées des fichiers générés, du code de cloud-init et des pages man installées.

Entrée : accept-ra: true, ipv6-address-generation: eui64, ipv6-privacy: false par NIC.

netplan → networkd (Debian 13) renderer networkd renderer network-manager (Rocky 10 par défaut ; Debian si NM)
accept-ra IPv6AcceptRA=yes IPv6AcceptRA=True ignorée ; RA acceptées par défaut (method=auto)
ipv6-address-generation: eui64 rien d'écrit (défaut de networkd) jetée jetée ; conf.d/30-cloud-init-ip6-addr-gen-mode.conf (ipv6.addr-gen-mode=0) écrit par cloud-init dans tous les cas
ipv6-privacy: false rien d'écrit (défaut de networkd : no) jetée jetée ; repli sur use_tempaddr du noyau
SLAAC globale en EUI-64 oui (défaut [IPv6AcceptRA] Token=) oui (même défaut) oui, uniquement grâce au fichier conf.d de cloud-init ; sans lui, stable-privacy
adresses temporaires non (défaut) non (défaut) non en pratique (use_tempaddr = 0 attendu, non vérifié sur un noyau d'image)

Cause : cloudinit/net/network_state.py:755 ne recopie d'une entrée ethernets v2 que mtu, match, wakeonlan, accept-ra, optional : ipv6-address-generation et ipv6-privacy sont perdues sans avertissement pour tout renderer autre que netplan (qui reçoit le YAML tel quel) ; network_manager.py ne lit pas accept-ra.

Contre-test netplan : stable-privacy + ipv6-privacy: true produisent IPv6Token=prefixstable et IPv6PrivacyExtensions=yes — netplan traduit bien ces clés ; il n'écrit rien pour les valeurs par défaut.

Conséquences pour ce ticket

  • Sur les deux distributions visées, l'EUI-64 et l'absence d'adresses temporaires viennent des défauts (systemd-networkd, ou réglage global posé par cloud-init pour NetworkManager), pas des clés servies par two. Les clés restent utiles avec netplan, mais ne protègent pas contre un défaut modifié dans l'image.
  • Exigence d'image à documenter : SLAAC en EUI-64 et pas d'extensions de confidentialité IPv6 (vérifier addr-gen-mode global de NetworkManager, Token/IPv6PrivacyExtensions de networkd, use_tempaddr).
  • Rappel (#73) : le network-config n'est lu que par les images récentes et appliqué au premier démarrage seulement.
## Clés IPv6 du `network-config` selon le renderer de cloud-init (vérification hors ligne, 2026-10-20) Méthode : `cloud-init devel net-convert` dans des conteneurs (Debian 13 : cloud-init 25.1.4, netplan 1.1.2, systemd 257, NetworkManager 1.52 ; Rocky 10.2 : cloud-init 24.4-7.el10_2.1, NetworkManager 1.56), puis `netplan generate` et relecture des keyfiles par libnm. Aucune VM démarrée : conclusions tirées des fichiers générés, du code de cloud-init et des pages man installées. Entrée : `accept-ra: true`, `ipv6-address-generation: eui64`, `ipv6-privacy: false` par NIC. | | netplan → networkd (Debian 13) | renderer networkd | renderer network-manager (Rocky 10 par défaut ; Debian si NM) | |---|---|---|---| | `accept-ra` | `IPv6AcceptRA=yes` | `IPv6AcceptRA=True` | ignorée ; RA acceptées par défaut (`method=auto`) | | `ipv6-address-generation: eui64` | rien d'écrit (défaut de networkd) | jetée | jetée ; `conf.d/30-cloud-init-ip6-addr-gen-mode.conf` (`ipv6.addr-gen-mode=0`) écrit par cloud-init dans tous les cas | | `ipv6-privacy: false` | rien d'écrit (défaut de networkd : `no`) | jetée | jetée ; repli sur `use_tempaddr` du noyau | | **SLAAC globale en EUI-64** | oui (défaut `[IPv6AcceptRA] Token=`) | oui (même défaut) | oui, **uniquement** grâce au fichier conf.d de cloud-init ; sans lui, `stable-privacy` | | **adresses temporaires** | non (défaut) | non (défaut) | non en pratique (`use_tempaddr` = 0 attendu, non vérifié sur un noyau d'image) | Cause : `cloudinit/net/network_state.py:755` ne recopie d'une entrée `ethernets` v2 que `mtu`, `match`, `wakeonlan`, `accept-ra`, `optional` : `ipv6-address-generation` et `ipv6-privacy` sont perdues sans avertissement pour tout renderer autre que netplan (qui reçoit le YAML tel quel) ; `network_manager.py` ne lit pas `accept-ra`. Contre-test netplan : `stable-privacy` + `ipv6-privacy: true` produisent `IPv6Token=prefixstable` et `IPv6PrivacyExtensions=yes` — netplan traduit bien ces clés ; il n'écrit rien pour les valeurs par défaut. ### Conséquences pour ce ticket - Sur les deux distributions visées, l'EUI-64 et l'absence d'adresses temporaires viennent **des défauts** (systemd-networkd, ou réglage global posé par cloud-init pour NetworkManager), pas des clés servies par two. Les clés restent utiles avec netplan, mais ne protègent pas contre un défaut modifié dans l'image. - Exigence d'image à documenter : SLAAC en EUI-64 et pas d'extensions de confidentialité IPv6 (vérifier `addr-gen-mode` global de NetworkManager, `Token`/`IPv6PrivacyExtensions` de networkd, `use_tempaddr`). - Rappel (#73) : le `network-config` n'est lu que par les images récentes et appliqué au premier démarrage seulement.
Author
Owner

Décision (2026-10-20)

Les clés IPv6 ne sont pas servies dans le network-config : hors netplan, cloud-init les jette (1177), et elles ne valent qu'au premier démarrage. two définit à la place des règles d'image et une mesure de sécurité côté agent.

Règles d'image (à documenter)

  • SLAAC en EUI-64 uniquement : adresse = préfixe annoncé + EUI-64 de la MAC fournie par l'appelant (#62), donc calculable par two (pas de stable-privacy).
  • Extensions de confidentialité IPv6 désactivées : pas d'adresses temporaires.
  • RA acceptées.

Défauts constatés (1177) : systemd-networkd respecte ces trois règles par défaut ; NetworkManager les respecte grâce au réglage global que cloud-init dépose (ipv6.addr-gen-mode=0) et à use_tempaddr = 0 — à vérifier dans chaque image.

Sécurité côté agent

  • Contrôle que la VM n'émet que son propre trafic sur un subnet public : source IPv6 = son adresse EUI-64 (et sa link-local), MAC source = la sienne ; rien d'autre ne sort de son port. À rapprocher de #61 (filtrage des RA, DHCPv6 et NDP émis par les VM) et de #76 (filtrage IPv4 au port).
  • IPv6 « privé » (subnets non publics) : pas encore décidé.
## Décision (2026-10-20) Les clés IPv6 ne sont pas servies dans le `network-config` : hors netplan, cloud-init les jette (1177), et elles ne valent qu'au premier démarrage. two définit à la place des **règles d'image** et une **mesure de sécurité côté agent**. ### Règles d'image (à documenter) - **SLAAC en EUI-64 uniquement** : adresse = préfixe annoncé + EUI-64 de la MAC fournie par l'appelant (#62), donc calculable par two (pas de `stable-privacy`). - **Extensions de confidentialité IPv6 désactivées** : pas d'adresses temporaires. - **RA acceptées.** Défauts constatés (1177) : systemd-networkd respecte ces trois règles par défaut ; NetworkManager les respecte grâce au réglage global que cloud-init dépose (`ipv6.addr-gen-mode=0`) et à `use_tempaddr` = 0 — à vérifier dans chaque image. ### Sécurité côté agent - **Contrôle que la VM n'émet que son propre trafic sur un subnet public** : source IPv6 = son adresse EUI-64 (et sa link-local), MAC source = la sienne ; rien d'autre ne sort de son port. À rapprocher de #61 (filtrage des RA, DHCPv6 et NDP émis par les VM) et de #76 (filtrage IPv4 au port). - IPv6 « privé » (subnets non publics) : pas encore décidé.
Author
Owner

Hypothèse (2026-10-20) — IPv6 public routé par adresse

Ce n'est qu'une hypothèse de travail, rien n'est décidé. Elle découle de l'hypothèse posée sur #31 (subnet public routé par adresse) ; si celle-ci change, ce commentaire est à revoir.

  • Un seul /64 public pour tout l'orchestrateur (un /48 en contient 65 536 ; un seul suffit en capacité) : l'adresse d'une VM doit rester stable quand elle change d'hôte, de cluster ou de zone, ce qu'un /64 par cluster empêcherait.
  • Adresse = /64 public + EUI-64 de la MAC fournie par l'appelant (#62), pool de MAC unique pour toute l'infra (préfixe proposé 02:12, #71). Exemple : MAC 02:12:aa:bb:cc:dd → identifiant 0012:aaff:febb:ccdd (insertion de ff:fe, bit universel/local inversé), adresse <préfixe>:12:aaff:febb:ccdd. Seuls 2⁴⁸ identifiants du /64 sont de la forme EUI-64, 2³² dans le pool : sans limite pratique, l'unicité découle de celle de la MAC.
  • Routage : /128 de chaque VM annoncé en EVPN type 5 dans une VRF publique depuis l'hôte qui la porte ; gateway anycast sur chaque hôte ; pas de L2 étendu.
  • RA émises par le serveur DHCP intégré : préfixe en A=1 (SLAAC) et L=0 (non sur le lien), pour que la VM envoie tout à sa gateway, y compris vers une autre VM du même /64.
  • Vigilance : EUI-64 + préfixe de MAC connu + allocation croissante → adresses énumérables (voir #31).
  • IPv6 « privé » toujours non décidé (piste : ULA fd00::/8, RFC 4193, sortie par NPTv6/NAT66, lien avec #42).
## Hypothèse (2026-10-20) — IPv6 public routé par adresse > **Ce n'est qu'une hypothèse de travail, rien n'est décidé.** Elle découle de l'hypothèse posée sur #31 (subnet public routé par adresse) ; si celle-ci change, ce commentaire est à revoir. - **Un seul /64 public** pour tout l'orchestrateur (un /48 en contient 65 536 ; un seul suffit en capacité) : l'adresse d'une VM doit rester stable quand elle change d'hôte, de cluster ou de zone, ce qu'un /64 par cluster empêcherait. - **Adresse** = /64 public + EUI-64 de la MAC fournie par l'appelant (#62), pool de MAC unique pour toute l'infra (préfixe proposé `02:12`, #71). Exemple : MAC `02:12:aa:bb:cc:dd` → identifiant `0012:aaff:febb:ccdd` (insertion de `ff:fe`, bit universel/local inversé), adresse `<préfixe>:12:aaff:febb:ccdd`. Seuls 2⁴⁸ identifiants du /64 sont de la forme EUI-64, 2³² dans le pool : sans limite pratique, l'unicité découle de celle de la MAC. - **Routage** : `/128` de chaque VM annoncé en EVPN type 5 dans une VRF publique depuis l'hôte qui la porte ; gateway anycast sur chaque hôte ; pas de L2 étendu. - **RA émises par le serveur DHCP intégré** : préfixe en **A=1** (SLAAC) et **L=0** (non sur le lien), pour que la VM envoie tout à sa gateway, y compris vers une autre VM du même /64. - **Vigilance** : EUI-64 + préfixe de MAC connu + allocation croissante → adresses énumérables (voir #31). - IPv6 « privé » toujours non décidé (piste : ULA `fd00::/8`, RFC 4193, sortie par NPTv6/NAT66, lien avec #42).
Author
Owner

L'hypothèse « IPv6 public routé » est caduque (2026-10-25)

#31 garde le L2 sur le VNI 66001 et écarte le routage par adresse (#31, décision du 2026-10-25). Le commentaire 1204 ne tient plus : ni /128 en type 5 dans une VRF publique, ni gateway sur chaque hôte, ni L=0. L'IPv6 public est à redéfinir dans le modèle L2. Les décisions du 2026-10-12 (dual-stack, SLAAC EUI-64, RA par le serveur intégré) et du 2026-10-20 (règles d'image, contrôle au port) restent valables.

## L'hypothèse « IPv6 public routé » est caduque (2026-10-25) #31 garde le L2 sur le VNI 66001 et écarte le routage par adresse (#31, décision du 2026-10-25). Le commentaire 1204 ne tient plus : ni /128 en type 5 dans une VRF publique, ni gateway sur chaque hôte, ni L=0. L'IPv6 public est à redéfinir dans le modèle L2. Les décisions du 2026-10-12 (dual-stack, SLAAC EUI-64, RA par le serveur intégré) et du 2026-10-20 (règles d'image, contrôle au port) restent valables.
Author
Owner

Note de #81 (2026-10-25) : #81 pose une route unreachable default IPv4 dans la table de chaque VRF de VPC, pour qu'une recherche manquée ne retombe pas dans la table main de l'hôte (fuite vers l'underlay mesurée, #81 commentaire 1162). Le même mécanisme vaut en IPv6 (la documentation VRF du noyau recommande les deux familles) : à ajouter ici dès que le netns envoie du trafic IPv6 vers la VRF, avec le contrôle watchdog correspondant.

Note de #81 (2026-10-25) : #81 pose une route `unreachable default` **IPv4** dans la table de chaque VRF de VPC, pour qu'une recherche manquée ne retombe pas dans la table `main` de l'hôte (fuite vers l'underlay mesurée, #81 commentaire 1162). Le même mécanisme vaut en IPv6 (la documentation VRF du noyau recommande les deux familles) : à ajouter ici dès que le netns envoie du trafic IPv6 vers la VRF, avec le contrôle watchdog correspondant.
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
syonad/two#63
No description provided.