CloudAcademia
IT

Reti · Modulo 06 · Subnetting: suddividere e pianificare le reti IPv4

Laboratorio: progettare e validare un piano di indirizzamento

Laboratorio60 minIntermedioMarkdown

Viene mostrato il Markdown grezzo: non è stato possibile caricare il visualizzatore.

## Obiettivo
Progetti il piano di indirizzamento IPv4 di un'azienda fittizia con tre sedi, usando il VLSM dentro il blocco privato `10.20.0.0/16`. Poi lo verifichi con un piccolo script Python che individua sovrapposizioni, subnet sottodimensionate e prefissi disallineati, e correggi un piano difettoso.

## Obiettivi
- Dimensionare ogni segmento di rete con il prefisso più lungo che copre il suo numero di host.
- Allocare un piano VLSM per sede, dalla subnet più grande alla più piccola, su confini allineati.
- Scegliere un blocco per sede in modo che ogni sede possa essere annunciata come un'unica route di sintesi.
- Validare un piano automaticamente (contenimento, sovrapposizioni, capacità, spazio rimasto) e correggere i problemi trovati.
- (Facoltativo) Osservare su Linux come una maschera di sottorete errata comprometta la raggiungibilità.

## Prerequisiti
- Python 3.8 o successivo (si usa solo la libreria standard). Controlla con `python3 --version`; su Windows usa `py` al posto di `python3`.
- Un editor di testo e un terminale.
- La [lezione](lesson.it.md) di questo modulo, in particolare VLSM e riepilogo delle route.
- Solo per il Passo 8 facoltativo: una macchina Linux o VM dove puoi usare `sudo`, con iproute2 (`ip`) e `ping` installati.

> [!WARNING]
> I Passi 1–7 creano solo file in una cartella della tua home. Il Passo 8 crea network namespace e richiede `sudo`: eseguilo su una macchina di test o su una VM, non su un server di produzione. Usa l'intervallo di documentazione `198.51.100.0/24` (RFC 5737) e non tocca le tue interfacce di rete reali. Esegui sempre la sezione [Pulizia](#pulizia) alla fine.

## Architettura
Example Corp ha una sede centrale (HQ) e due filiali (BR1, BR2), collegate da collegamenti WAN punto-punto. Possiede il blocco RFC 1918 `10.20.0.0/16` per tutto il suo indirizzamento interno.

<figure class="diagram" style="--dg-w: 900px"><svg xmlns="http://www.w3.org/2000/svg" class="dg" viewBox="0 0 900 468" width="900" height="468" role="img" aria-labelledby="subnetting-lab-sites-it-title subnetting-lab-sites-it-desc" font-family="Inter, system-ui, -apple-system, Segoe UI, Roboto, sans-serif" xml:lang="it">
<title id="subnetting-lab-sites-it-title">Scenario del lab: sedi di Example Corp e collegamenti WAN</title>
<desc id="subnetting-lab-sites-it-desc">Example Corp usa 10.20.0.0/16. La sede centrale HQ ha i segmenti Personale, Voce, Ospiti, Server e Gestione. La filiale BR1 ha Personale, Voce, Ospiti e Gestione. La filiale BR2 ha Personale, Voce e Gestione. Collegamenti WAN punto-punto con prefisso /31 uniscono HQ a BR1, HQ a BR2 e BR1 a BR2 come backup.</desc>
<rect class="dg-bg" x="0.5" y="0.5" width="899" height="467" rx="16" fill="#ffffff" stroke="#e3e3dd"/>
<text x="28" y="44" font-size="15" class="dg-text" fill="#17171c" font-weight="700" font-family="JetBrains Mono, ui-monospace, Menlo, Consolas, monospace">Example Corp · 10.20.0.0/16</text>
<g class="dg-l1"><path class="dg-stroke" d="M340 224L170 284" stroke="#0369a1" stroke-width="2.5" fill="none" stroke-linecap="round" stroke-linejoin="round"/></g>
<g class="dg-l1"><path class="dg-stroke" d="M560 224L730 284" stroke="#0369a1" stroke-width="2.5" fill="none" stroke-linecap="round" stroke-linejoin="round"/></g>
<g class="dg-l1"><path class="dg-stroke" d="M300 364.0H600" stroke="#0369a1" stroke-width="2.5" fill="none" stroke-linecap="round" stroke-linejoin="round" stroke-dasharray="7 6"/></g>
<rect class="dg-card" x="320" y="64" width="260" height="160" rx="12" fill="#ffffff" stroke="#cfcfc8"/>
<g class="dg-icon-neutral" transform="translate(336 80) scale(1.2500)" fill="none" stroke="#17171c" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d="M6 22V4a2 2 0 0 1 2-2h8a2 2 0 0 1 2 2v18Z"/><path d="M6 12H4a2 2 0 0 0-2 2v6a2 2 0 0 0 2 2h2"/><path d="M18 9h2a2 2 0 0 1 2 2v9a2 2 0 0 1-2 2h-2"/><path d="M10 6h4"/><path d="M10 10h4"/><path d="M10 14h4"/><path d="M10 18h4"/></g>
<text x="378" y="101" font-size="15" class="dg-text" fill="#17171c" font-weight="700">HQ</text>
<text x="338" y="132" font-size="13" class="dg-muted" fill="#5c5c68" font-weight="500">Sede centrale</text>
<g class="dg-l7"><rect class="dg-solid" x="338" y="148" width="89" height="26" rx="13" fill="#6d28d9"/><text x="382.5" y="165.5" font-size="12" class="dg-on" fill="#ffffff" font-weight="700" text-anchor="middle">Personale</text></g>
<g class="dg-l5"><rect class="dg-solid" x="433" y="148" width="53" height="26" rx="13" fill="#be185d"/><text x="459.5" y="165.5" font-size="12" class="dg-on" fill="#ffffff" font-weight="700" text-anchor="middle">Voce</text></g>
<g class="dg-l4"><rect class="dg-solid" x="492" y="148" width="67" height="26" rx="13" fill="#c2410c"/><text x="525.5" y="165.5" font-size="12" class="dg-on" fill="#ffffff" font-weight="700" text-anchor="middle">Ospiti</text></g>
<g class="dg-l3"><rect class="dg-solid" x="338" y="180" width="67" height="26" rx="13" fill="#b45309"/><text x="371.5" y="197.5" font-size="12" class="dg-on" fill="#ffffff" font-weight="700" text-anchor="middle">Server</text></g>
<g class="dg-l1"><rect class="dg-solid" x="411" y="180" width="82" height="26" rx="13" fill="#0369a1"/><text x="452" y="197.5" font-size="12" class="dg-on" fill="#ffffff" font-weight="700" text-anchor="middle">Gestione</text></g>
<rect class="dg-card" x="40" y="284" width="260" height="160" rx="12" fill="#ffffff" stroke="#cfcfc8"/>
<g class="dg-icon-neutral" transform="translate(56 300) scale(1.2500)" fill="none" stroke="#17171c" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d="M6 22V4a2 2 0 0 1 2-2h8a2 2 0 0 1 2 2v18Z"/><path d="M6 12H4a2 2 0 0 0-2 2v6a2 2 0 0 0 2 2h2"/><path d="M18 9h2a2 2 0 0 1 2 2v9a2 2 0 0 1-2 2h-2"/><path d="M10 6h4"/><path d="M10 10h4"/><path d="M10 14h4"/><path d="M10 18h4"/></g>
<text x="98" y="321" font-size="15" class="dg-text" fill="#17171c" font-weight="700">BR1</text>
<text x="58" y="352" font-size="13" class="dg-muted" fill="#5c5c68" font-weight="500">Filiale</text>
<g class="dg-l7"><rect class="dg-solid" x="58" y="368" width="89" height="26" rx="13" fill="#6d28d9"/><text x="102.5" y="385.5" font-size="12" class="dg-on" fill="#ffffff" font-weight="700" text-anchor="middle">Personale</text></g>
<g class="dg-l5"><rect class="dg-solid" x="153" y="368" width="53" height="26" rx="13" fill="#be185d"/><text x="179.5" y="385.5" font-size="12" class="dg-on" fill="#ffffff" font-weight="700" text-anchor="middle">Voce</text></g>
<g class="dg-l4"><rect class="dg-solid" x="212" y="368" width="67" height="26" rx="13" fill="#c2410c"/><text x="245.5" y="385.5" font-size="12" class="dg-on" fill="#ffffff" font-weight="700" text-anchor="middle">Ospiti</text></g>
<g class="dg-l1"><rect class="dg-solid" x="58" y="400" width="82" height="26" rx="13" fill="#0369a1"/><text x="99" y="417.5" font-size="12" class="dg-on" fill="#ffffff" font-weight="700" text-anchor="middle">Gestione</text></g>
<rect class="dg-card" x="600" y="284" width="260" height="160" rx="12" fill="#ffffff" stroke="#cfcfc8"/>
<g class="dg-icon-neutral" transform="translate(616 300) scale(1.2500)" fill="none" stroke="#17171c" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d="M6 22V4a2 2 0 0 1 2-2h8a2 2 0 0 1 2 2v18Z"/><path d="M6 12H4a2 2 0 0 0-2 2v6a2 2 0 0 0 2 2h2"/><path d="M18 9h2a2 2 0 0 1 2 2v9a2 2 0 0 1-2 2h-2"/><path d="M10 6h4"/><path d="M10 10h4"/><path d="M10 14h4"/><path d="M10 18h4"/></g>
<text x="658" y="321" font-size="15" class="dg-text" fill="#17171c" font-weight="700">BR2</text>
<text x="618" y="352" font-size="13" class="dg-muted" fill="#5c5c68" font-weight="500">Filiale</text>
<g class="dg-l7"><rect class="dg-solid" x="618" y="368" width="89" height="26" rx="13" fill="#6d28d9"/><text x="662.5" y="385.5" font-size="12" class="dg-on" fill="#ffffff" font-weight="700" text-anchor="middle">Personale</text></g>
<g class="dg-l5"><rect class="dg-solid" x="713" y="368" width="53" height="26" rx="13" fill="#be185d"/><text x="739.5" y="385.5" font-size="12" class="dg-on" fill="#ffffff" font-weight="700" text-anchor="middle">Voce</text></g>
<g class="dg-l1"><rect class="dg-solid" x="618" y="400" width="82" height="26" rx="13" fill="#0369a1"/><text x="659" y="417.5" font-size="12" class="dg-on" fill="#ffffff" font-weight="700" text-anchor="middle">Gestione</text></g>
<g class="dg-l1"><rect class="dg-bg-plain" x="177.24" y="226" width="125.52" height="24" rx="12" fill="#ffffff"/><text x="240" y="242.5" font-size="12" class="dg-ink" fill="#0369a1" font-weight="600" text-anchor="middle">WAN HQ–BR1 · /31</text></g>
<g class="dg-l1"><rect class="dg-bg-plain" x="597.24" y="226" width="125.52" height="24" rx="12" fill="#ffffff"/><text x="660" y="242.5" font-size="12" class="dg-ink" fill="#0369a1" font-weight="600" text-anchor="middle">WAN HQ–BR2 · /31</text></g>
<g class="dg-l1"><rect class="dg-bg-plain" x="353.64" y="352" width="192.72" height="24" rx="12" fill="#ffffff"/><text x="450" y="368.5" font-size="12" class="dg-ink" fill="#0369a1" font-weight="600" text-anchor="middle">WAN BR1–BR2 · /31 · backup</text></g>
</svg></figure>

*Figura 1. Le sedi di Example Corp e i segmenti di cui ciascuna ha bisogno. I tre collegamenti WAN sono reti punto-punto /31.*

I requisiti, in host necessari oggi inclusa la crescita:

| Sede | Segmento | Host |
|---|---|---|
| HQ | Staff (personale) | 900 |
| HQ | Voice (voce) | 400 |
| HQ | Guest (ospiti) | 250 |
| HQ | Servers (server) | 200 |
| HQ | Management (gestione) | 40 |
| BR1 | Staff | 120 |
| BR1 | Voice | 60 |
| BR1 | Guest | 50 |
| BR1 | Management | 10 |
| BR2 | Staff | 55 |
| BR2 | Voice | 25 |
| BR2 | Management | 6 |
| WAN | HQ-BR1, HQ-BR2, BR1-BR2 | 2 ciascuno |

Regole di progetto:
1. Ogni sede riceve **un blocco allineato**, così il resto della rete può raggiungerla con un'unica route di sintesi.
2. Tutti i collegamenti WAN provengono da un blocco di infrastruttura, `10.20.255.0/24`, e usano prefissi /31 (RFC 3021).
3. All'interno di ogni sede, alloca i segmenti dal più grande, partendo dall'inizio del blocco della sede.

## Passaggi

### Passo 1 — Crea uno spazio di lavoro
Tieni tutti i file di questo laboratorio in un'unica cartella, così la pulizia è un solo comando.

```bash
mkdir -p ~/subnet-lab
cd ~/subnet-lab
python3 --version
```

Output atteso (va bene qualsiasi versione dalla 3.8 in su):
```text
Python 3.14.7
```

### Passo 2 — Dimensiona ogni segmento
Prima di toccare qualsiasi indirizzo, decidi la lunghezza del prefisso di ogni segmento. Usa la tabella delle potenze di due della lezione: trova il prefisso più lungo i cui host utilizzabili (2<sup>bit host</sup> − 2) coprono il fabbisogno.

Compila questa tabella su carta o in un file di testo:

| Sede | Segmento | Host | Prefisso | Dimensione del blocco |
|---|---|---|---|---|
| HQ | Staff | 900 | ? | ? |
| HQ | Voice | 400 | ? | ? |
| … | … | … | … | … |

<details>
<summary>Mostra le dimensioni</summary>

| Sede | Segmento | Host | Prefisso | Utilizzabili | Dimensione del blocco |
|---|---|---|---|---|---|
| HQ | Staff | 900 | /22 | 1022 | 1024 |
| HQ | Voice | 400 | /23 | 510 | 512 |
| HQ | Guest | 250 | /24 | 254 | 256 |
| HQ | Servers | 200 | /24 | 254 | 256 |
| HQ | Management | 40 | /26 | 62 | 64 |
| BR1 | Staff | 120 | /25 | 126 | 128 |
| BR1 | Voice | 60 | /26 | 62 | 64 |
| BR1 | Guest | 50 | /26 | 62 | 64 |
| BR1 | Management | 10 | /28 | 14 | 16 |
| BR2 | Staff | 55 | /26 | 62 | 64 |
| BR2 | Voice | 25 | /27 | 30 | 32 |
| BR2 | Management | 6 | /29 | 6 | 8 |
| WAN | ogni collegamento | 2 | /31 | 2 | 2 |

</details>

### Passo 3 — Scegli un blocco per sede
Somma le dimensioni dei blocchi di ogni sede e arrotonda alla potenza di due successiva. È il blocco più piccolo che contiene tutta la sede e che può ancora essere riassunto in una sola route.

- HQ: 1024 + 512 + 256 + 256 + 64 = 2112 indirizzi. La potenza di due successiva è 4096, un **/20**.
- BR1: 128 + 64 + 64 + 16 = 272 indirizzi. La potenza di due successiva è 512, un **/23**.
- BR2: 64 + 32 + 8 = 104 indirizzi. Il minimo è un /25 (128). Questo progetto lo arrotonda a un **/24** per lasciare margine di crescita.

Metti anche i blocchi delle sedi dal più grande, ciascuno sul proprio confine. Una scelta valida:

| Sede | Blocco | Perché è valido |
|---|---|---|
| HQ | `10.20.0.0/20` | Inizia a 0, multiplo di 16 nel terzo ottetto. |
| BR1 | `10.20.16.0/23` | 16 è un multiplo di 2. |
| BR2 | `10.20.18.0/24` | Segue direttamente BR1. |
| WAN | `10.20.255.0/24` | Stabilito dalle regole di progetto; lontano dalle sedi perché possano crescere. |

> [!TIP]
> Se vuoi blocchi di sede diversi, va bene, purché ciascuno sia allineato e non si sovrappongano. Il tuo output al Passo 6 sarà allora diverso da quello mostrato, ma dovrà comunque terminare con `PASS`.

### Passo 4 — Alloca i segmenti e scrivi il piano
Ora metti i segmenti dentro ogni blocco di sede, dal più grande. Per HQ, Staff (/22) inizia a `10.20.0.0`, quindi finisce a `10.20.3.255`. Voice (/23) inizia all'indirizzo successivo, `10.20.4.0`, e così via.

Scrivi il piano come file di valori separati da virgole (CSV, comma-separated values) chiamato `plan.csv`, con una riga per segmento e una riga `BLOCK` per sede:

```text
site,segment,prefix,hosts
HQ,BLOCK,10.20.0.0/20,
HQ,Staff,10.20.0.0/22,900
...
```

Le colonne sono:
- `site`: il nome della sede (`HQ`, `BR1`, `BR2` o `WAN`).
- `segment`: il nome del segmento, oppure `BLOCK` per il blocco di sintesi della sede.
- `prefix`: la rete in notazione CIDR.
- `hosts`: host necessari (lascia vuoto nelle righe `BLOCK`).

Prova prima da solo, poi confronta con il piano di riferimento.

<details>
<summary>Mostra il piano di riferimento</summary>

```bash
cat > plan.csv <<'EOF'
site,segment,prefix,hosts
HQ,BLOCK,10.20.0.0/20,
HQ,Staff,10.20.0.0/22,900
HQ,Voice,10.20.4.0/23,400
HQ,Guest,10.20.6.0/24,250
HQ,Servers,10.20.7.0/24,200
HQ,Management,10.20.8.0/26,40
BR1,BLOCK,10.20.16.0/23,
BR1,Staff,10.20.16.0/25,120
BR1,Voice,10.20.16.128/26,60
BR1,Guest,10.20.16.192/26,50
BR1,Management,10.20.17.0/28,10
BR2,BLOCK,10.20.18.0/24,
BR2,Staff,10.20.18.0/26,55
BR2,Voice,10.20.18.64/27,25
BR2,Management,10.20.18.96/29,6
WAN,BLOCK,10.20.255.0/24,
WAN,HQ-BR1,10.20.255.0/31,2
WAN,HQ-BR2,10.20.255.2/31,2
WAN,BR1-BR2,10.20.255.4/31,2
EOF
```

</details>

### Passo 5 — Crea il validatore
Controllare un piano a mano è lento e soggetto a errori. Questo script usa il modulo `ipaddress` della libreria standard di Python per verificare ogni regola della lezione:

- ogni prefisso è un vero indirizzo di rete (nessun bit host a 1, quindi è allineato),
- tutto è dentro `10.20.0.0/16`, e ogni segmento è dentro il blocco della sua sede,
- i blocchi di sede non si sovrappongono, e i segmenti non si sovrappongono,
- ogni segmento ha indirizzi utilizzabili a sufficienza (/31 = 2, /32 = 1, altrimenti dimensione del blocco − 2).

Stampa anche il piano come tabella con la maschera, l'intervallo di host e gli indirizzi rimasti di ogni segmento.

```bash
cat > validate_plan.py <<'EOF'
#!/usr/bin/env python3
"""Validate an IPv4 addressing plan stored in a CSV file (site,segment,prefix,hosts)."""
import csv
import ipaddress
import sys

TOP_BLOCK = ipaddress.ip_network("10.20.0.0/16")


def usable(net):
    """Usable host addresses: /32 = 1, /31 = 2 (RFC 3021), otherwise all minus network and broadcast."""
    if net.prefixlen == 32:
        return 1
    if net.prefixlen == 31:
        return 2
    return net.num_addresses - 2


def host_range(net):
    if net.prefixlen >= 31:
        return f"{net[0]} - {net[-1]}"
    return f"{net[1]} - {net[-2]}"


def main(path):
    errors = []
    sites, segments = {}, []
    with open(path, newline="") as f:
        for row in csv.DictReader(f):
            site, name, prefix = row["site"].strip(), row["segment"].strip(), row["prefix"].strip()
            try:
                net = ipaddress.ip_network(prefix)  # strict: host bits must be zero
            except ValueError:
                fixed = ipaddress.ip_network(prefix, strict=False)
                errors.append(f"{site}/{name}: {prefix} is not a network address (did you mean {fixed}?)")
                continue
            if not net.subnet_of(TOP_BLOCK):
                errors.append(f"{site}/{name}: {net} is outside {TOP_BLOCK}")
            if name == "BLOCK":
                sites[site] = net
            else:
                segments.append((site, name, net, int(row["hosts"])))

    # Site blocks must not overlap each other.
    names = sorted(sites)
    for i, a in enumerate(names):
        for b in names[i + 1:]:
            if sites[a].overlaps(sites[b]):
                errors.append(f"site blocks overlap: {a} {sites[a]} and {b} {sites[b]}")

    print(f"{'Site':<6} {'Segment':<12} {'Prefix':<17} {'Mask':<16} {'Host range':<29} {'Usable':>6} {'Need':>5} {'Spare':>6}")
    total_need = total_alloc = 0
    for site, name, net, need in sorted(segments, key=lambda s: s[2]):
        spare = usable(net) - need
        total_need += need
        total_alloc += net.num_addresses
        print(f"{site:<6} {name:<12} {str(net):<17} {str(net.netmask):<16} {host_range(net):<29} {usable(net):>6} {need:>5} {spare:>6}")
        if spare < 0:
            errors.append(f"{site}/{name}: {net} has {usable(net)} usable addresses but needs {need}")
        if site not in sites:
            errors.append(f"{site}/{name}: site {site} has no BLOCK row")
        elif not net.subnet_of(sites[site]):
            errors.append(f"{site}/{name}: {net} is outside its site block {sites[site]}")

    # No two segments may overlap.
    for i, (s1, n1, a, _) in enumerate(segments):
        for s2, n2, b, _ in segments[i + 1:]:
            if a.overlaps(b):
                errors.append(f"overlap: {s1}/{n1} {a} and {s2}/{n2} {b}")

    print()
    print(f"Addresses allocated to segments: {total_alloc} of {TOP_BLOCK.num_addresses} in {TOP_BLOCK}")
    print(f"Hosts required: {total_need}; spare addresses inside segments: {total_alloc - total_need}")
    print("Summary routes (one per site):", ", ".join(f"{s} {sites[s]}" for s in names))
    print()
    if errors:
        print(f"FAIL: {len(errors)} problem(s)")
        for err in errors:
            print("  -", err)
        return 1
    print("PASS: no overlaps, every segment fits its site block and its host count")
    return 0


if __name__ == "__main__":
    if len(sys.argv) != 2:
        sys.exit("usage: python3 validate_plan.py <plan.csv>")
    sys.exit(main(sys.argv[1]))
EOF
```

> [!NOTE]
> Gli «indirizzi rimasti dentro i segmenti» (`Spare`) contano tutti gli indirizzi delle subnet allocate che non sono host richiesti, compresi gli indirizzi di rete e di broadcast. Misurano quanto margine di crescita (o spreco) ha il piano, non quanti host puoi ancora aggiungere.

### Passo 6 — Valida il tuo piano
Esegui il validatore sul tuo piano:

```bash
python3 validate_plan.py plan.csv
```

Output atteso per il piano di riferimento:
```text
Site   Segment      Prefix            Mask             Host range                    Usable  Need  Spare
HQ     Staff        10.20.0.0/22      255.255.252.0    10.20.0.1 - 10.20.3.254         1022   900    122
HQ     Voice        10.20.4.0/23      255.255.254.0    10.20.4.1 - 10.20.5.254          510   400    110
HQ     Guest        10.20.6.0/24      255.255.255.0    10.20.6.1 - 10.20.6.254          254   250      4
HQ     Servers      10.20.7.0/24      255.255.255.0    10.20.7.1 - 10.20.7.254          254   200     54
HQ     Management   10.20.8.0/26      255.255.255.192  10.20.8.1 - 10.20.8.62            62    40     22
BR1    Staff        10.20.16.0/25     255.255.255.128  10.20.16.1 - 10.20.16.126        126   120      6
BR1    Voice        10.20.16.128/26   255.255.255.192  10.20.16.129 - 10.20.16.190       62    60      2
BR1    Guest        10.20.16.192/26   255.255.255.192  10.20.16.193 - 10.20.16.254       62    50     12
BR1    Management   10.20.17.0/28     255.255.255.240  10.20.17.1 - 10.20.17.14          14    10      4
BR2    Staff        10.20.18.0/26     255.255.255.192  10.20.18.1 - 10.20.18.62          62    55      7
BR2    Voice        10.20.18.64/27    255.255.255.224  10.20.18.65 - 10.20.18.94         30    25      5
BR2    Management   10.20.18.96/29    255.255.255.248  10.20.18.97 - 10.20.18.102         6     6      0
WAN    HQ-BR1       10.20.255.0/31    255.255.255.254  10.20.255.0 - 10.20.255.1          2     2      0
WAN    HQ-BR2       10.20.255.2/31    255.255.255.254  10.20.255.2 - 10.20.255.3          2     2      0
WAN    BR1-BR2      10.20.255.4/31    255.255.255.254  10.20.255.4 - 10.20.255.5          2     2      0

Addresses allocated to segments: 2494 of 65536 in 10.20.0.0/16
Hosts required: 2122; spare addresses inside segments: 372
Summary routes (one per site): BR1 10.20.16.0/23, BR2 10.20.18.0/24, HQ 10.20.0.0/20, WAN 10.20.255.0/24

PASS: no overlaps, every segment fits its site block and its host count
```

Leggi il risultato come farebbe un revisore:
- **Route di sintesi.** Il resto della rete ha bisogno di sole quattro route per raggiungere tutte le subnet di Example Corp.
- **Colonna Spare.** BR2 Management ha 0 indirizzi rimasti: il settimo dispositivo richiederà una rinumerazione. In un progetto reale probabilmente gli daresti un /28. C'è spazio libero subito dopo in `10.20.18.0/24`.
- **Margine di crescita.** HQ usa 2112 dei 4096 indirizzi del suo /20, quindi da `10.20.8.64` a `10.20.15.255` è ancora libero per nuovi segmenti di HQ.

### Passo 7 — Trova e correggi i guasti di un piano difettoso
Un collega ti ha mandato questo piano. Contiene diversi dei guasti della lezione. Salvalo ed esegui il validatore:

```bash
cat > broken.csv <<'EOF'
site,segment,prefix,hosts
HQ,BLOCK,10.20.0.0/20,
HQ,Staff,10.20.0.0/22,900
HQ,Voice,10.20.4.0/24,400
HQ,Guest,10.20.6.0/23,250
HQ,Servers,10.20.7.0/24,200
HQ,Management,10.20.8.0/26,40
BR1,BLOCK,10.20.16.0/23,
BR1,Staff,10.20.16.0/25,120
BR1,Voice,10.20.16.128/26,60
BR1,Guest,10.20.16.192/26,50
BR1,Management,10.20.18.0/28,10
BR2,BLOCK,10.20.18.0/24,
BR2,Staff,10.20.18.0/26,55
BR2,Voice,10.20.18.70/27,25
BR2,Management,10.20.18.96/29,6
WAN,BLOCK,10.20.255.0/24,
WAN,HQ-BR1,10.20.255.0/31,2
WAN,HQ-BR2,10.20.255.2/31,2
WAN,BR1-BR2,10.20.255.4/31,2
EOF
python3 validate_plan.py broken.csv
echo "exit code: $?"
```

Output atteso (la parte finale):
```text
FAIL: 5 problem(s)
  - BR2/Voice: 10.20.18.70/27 is not a network address (did you mean 10.20.18.64/27?)
  - HQ/Voice: 10.20.4.0/24 has 254 usable addresses but needs 400
  - BR1/Management: 10.20.18.0/28 is outside its site block 10.20.16.0/23
  - overlap: HQ/Guest 10.20.6.0/23 and HQ/Servers 10.20.7.0/24
  - overlap: BR1/Management 10.20.18.0/28 and BR2/Staff 10.20.18.0/26
exit code: 1
```

Copia il file (`cp broken.csv fixed.csv`), modifica `fixed.csv` finché `python3 validate_plan.py fixed.csv` non stampa `PASS` e, per ogni guasto, annota quale regola della lezione viola. Cambia meno righe che puoi.

> [!TIP]
> Cinque messaggi non significano sempre cinque guasti. Una sola riga sbagliata può violare due regole insieme.

<details>
<summary>Mostra le correzioni</summary>

Ci sono quattro righe sbagliate:

| Riga | Guasto | Correzione |
|---|---|---|
| `HQ,Voice,10.20.4.0/24,400` | Sottodimensionata: un /24 ha 254 host utilizzabili, ne servono 400. | `10.20.4.0/23` |
| `HQ,Guest,10.20.6.0/23,250` | Sovradimensionata: il /23 copre `10.20.6.0`–`10.20.7.255` e si sovrappone a Servers. | `10.20.6.0/24` |
| `BR1,Management,10.20.18.0/28,10` | Fuori dal blocco di BR1 (è in quello di BR2), quindi si sovrappone a BR2 Staff e rompe la route di sintesi di BR1. | `10.20.17.0/28` |
| `BR2,Voice,10.20.18.70/27,25` | Non allineata: 70 non è un multiplo di 32. | `10.20.18.64/27` |

Dopo queste quattro modifiche, `fixed.csv` è identico al `plan.csv` di riferimento, e puoi verificarlo con:

```bash
diff fixed.csv plan.csv && echo "identical"
```

</details>

### Passo 8 (facoltativo, Linux, richiede sudo) — Vedi una maschera errata compromettere la raggiungibilità
Il validatore individua gli errori sulla carta. Questo passo mostra che aspetto ha lo stesso errore su una rete reale. Crei due **network namespace** (stack di rete isolati su una stessa macchina Linux), li colleghi con un cavo Ethernet virtuale (veth) e dai a un lato una maschera errata.

Entrambi gli host dovrebbero stare in `198.51.100.0/26`. All'host B viene assegnato `/28` per errore, quindi crede che la sua subnet sia `198.51.100.32/28` (`.33`–`.46`).

<figure class="diagram" style="--dg-w: 900px"><svg xmlns="http://www.w3.org/2000/svg" class="dg" viewBox="0 0 900 350" width="900" height="350" role="img" aria-labelledby="subnetting-lab-netns-it-title subnetting-lab-netns-it-desc" font-family="Inter, system-ui, -apple-system, Segoe UI, Roboto, sans-serif" xml:lang="it">
<title id="subnetting-lab-netns-it-title">Passo facoltativo: due namespace con maschere incoerenti</title>
<desc id="subnetting-lab-netns-it-desc">Il namespace lab-a ha veth-a con 198.51.100.10/26 e il namespace lab-b ha veth-b con 198.51.100.40/28, collegati da una coppia veth. A ritiene locale da 198.51.100.0 a .63, quindi raggiunge .40. B ritiene locale solo da .32 a .47, quindi .10 sembra un indirizzo remoto senza route e B non può rispondere.</desc>
<rect class="dg-bg" x="0.5" y="0.5" width="899" height="349" rx="16" fill="#ffffff" stroke="#e3e3dd"/>
<rect class="dg-card" x="24" y="24" width="310" height="150" rx="12" fill="#ffffff" stroke="#cfcfc8"/>
<g class="dg-icon-neutral" transform="translate(40 40) scale(1.2500)" fill="none" stroke="#17171c" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d="M21 8a2 2 0 0 0-1-1.73l-7-4a2 2 0 0 0-2 0l-7 4A2 2 0 0 0 3 8v8a2 2 0 0 0 1 1.73l7 4a2 2 0 0 0 2 0l7-4A2 2 0 0 0 21 16Z"/><path d="m3.3 7 8.7 5 8.7-5"/><path d="M12 22V12"/></g>
<text x="82" y="61" font-size="15" class="dg-text" fill="#17171c" font-weight="700">Namespace lab-a</text>
<text x="42" y="92" font-size="12.5" class="dg-muted" fill="#5c5c68" font-weight="500" font-family="JetBrains Mono, ui-monospace, Menlo, Consolas, monospace">veth-a</text>
<text x="42" y="112" font-size="12.5" class="dg-text" fill="#17171c" font-weight="500" font-family="JetBrains Mono, ui-monospace, Menlo, Consolas, monospace">198.51.100.10/26</text>
<g class="dg-ok"><rect class="dg-tint" x="42" y="132" width="190" height="26" rx="13" fill="#e8f2ec" stroke="#96c6a8" stroke-width="1.2"/><text x="137" y="149.5" font-size="12" class="dg-ink" fill="#15803d" font-weight="700" text-anchor="middle">/26 · maschera corretta</text></g>
<rect class="dg-card" x="566" y="24" width="310" height="150" rx="12" fill="#ffffff" stroke="#cfcfc8"/>
<g class="dg-icon-neutral" transform="translate(582 40) scale(1.2500)" fill="none" stroke="#17171c" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d="M21 8a2 2 0 0 0-1-1.73l-7-4a2 2 0 0 0-2 0l-7 4A2 2 0 0 0 3 8v8a2 2 0 0 0 1 1.73l7 4a2 2 0 0 0 2 0l7-4A2 2 0 0 0 21 16Z"/><path d="m3.3 7 8.7 5 8.7-5"/><path d="M12 22V12"/></g>
<text x="624" y="61" font-size="15" class="dg-text" fill="#17171c" font-weight="700">Namespace lab-b</text>
<text x="584" y="92" font-size="12.5" class="dg-muted" fill="#5c5c68" font-weight="500" font-family="JetBrains Mono, ui-monospace, Menlo, Consolas, monospace">veth-b</text>
<text x="584" y="112" font-size="12.5" class="dg-text" fill="#17171c" font-weight="500" font-family="JetBrains Mono, ui-monospace, Menlo, Consolas, monospace">198.51.100.40/28</text>
<g class="dg-warn"><rect class="dg-tint" x="584" y="132" width="175" height="26" rx="13" fill="#f8e8e8" stroke="#e09999" stroke-width="1.2"/><text x="671.5" y="149.5" font-size="12" class="dg-ink" fill="#b91c1c" font-weight="700" text-anchor="middle">/28 · maschera errata</text></g>
<path class="dg-line" d="M334 99H566" stroke="#cfcfc8" stroke-width="4" fill="none" stroke-linecap="round" stroke-linejoin="round"/>
<g class="dg-icon-neutral" transform="translate(436 64) scale(1.1667)" fill="none" stroke="#17171c" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d="M17 21v-2a1 1 0 0 1-1-1v-1a2 2 0 0 1 2-2h2a2 2 0 0 1 2 2v1a1 1 0 0 1-1 1"/><path d="M19 15V6.5a1 1 0 0 0-7 0v11a1 1 0 0 1-7 0V9"/><path d="M21 21v-2h-4"/><path d="M3 5h4V3"/><path d="M7 5a1 1 0 0 1 1 1v1a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V6a1 1 0 0 1 1-1V3"/></g>
<rect class="dg-bg-plain" x="350.28" y="112" width="199.44" height="24" rx="12" fill="#ffffff"/><text x="450" y="128.5" font-size="12" class="dg-muted" fill="#5c5c68" font-weight="600" text-anchor="middle">coppia veth · cavo virtuale</text>
<text x="60" y="218" font-size="13" class="dg-text" fill="#17171c" font-weight="600">Cosa A ritiene locale: 198.51.100.0/26 (.0 – .63)</text>
<text x="60" y="280" font-size="13" class="dg-text" fill="#17171c" font-weight="600">Cosa B ritiene locale: 198.51.100.32/28 (.32 – .47). A (.10) è fuori, quindi B non può rispondere</text>
<g class="dg-ok"><rect class="dg-tint" x="60" y="226" width="780" height="26" rx="6" fill="#e3f0e8" stroke="#8ac09e"/></g>
<rect class="dg-card" x="60" y="288" width="780" height="26" rx="6" fill="#ffffff" stroke="#cfcfc8" stroke-dasharray="5 4"/>
<g class="dg-warn"><rect class="dg-tint" x="450" y="288" width="195" height="26" rx="6" fill="#f5dfdf" stroke="#d88282"/></g>
<g class="dg-ok"><path class="dg-stroke" d="M187.969 226V252" stroke="#15803d" stroke-width="2" fill="none" stroke-linecap="round" stroke-linejoin="round"/></g>
<g class="dg-ok"><circle class="dg-solid" cx="187.969" cy="239" r="9" fill="#15803d"/><text x="187.969" y="243" font-size="11" class="dg-on" fill="#ffffff" font-weight="700" text-anchor="middle">A</text></g>
<g class="dg-ok"><path class="dg-stroke" d="M187.969 288V314" stroke="#15803d" stroke-width="2" fill="none" stroke-linecap="round" stroke-linejoin="round"/></g>
<g class="dg-ok"><circle class="dg-solid" cx="187.969" cy="301" r="9" fill="#15803d"/><text x="187.969" y="305" font-size="11" class="dg-on" fill="#ffffff" font-weight="700" text-anchor="middle">A</text></g>
<g class="dg-warn"><path class="dg-stroke" d="M553.594 226V252" stroke="#b91c1c" stroke-width="2" fill="none" stroke-linecap="round" stroke-linejoin="round"/></g>
<g class="dg-warn"><circle class="dg-solid" cx="553.594" cy="239" r="9" fill="#b91c1c"/><text x="553.594" y="243" font-size="11" class="dg-on" fill="#ffffff" font-weight="700" text-anchor="middle">B</text></g>
<g class="dg-warn"><path class="dg-stroke" d="M553.594 288V314" stroke="#b91c1c" stroke-width="2" fill="none" stroke-linecap="round" stroke-linejoin="round"/></g>
<g class="dg-warn"><circle class="dg-solid" cx="553.594" cy="301" r="9" fill="#b91c1c"/><text x="553.594" y="305" font-size="11" class="dg-on" fill="#ffffff" font-weight="700" text-anchor="middle">B</text></g>
<text x="60" y="334" font-size="12" class="dg-muted" fill="#5c5c68" font-weight="500" text-anchor="middle" font-family="JetBrains Mono, ui-monospace, Menlo, Consolas, monospace">.0</text>
<path class="dg-line" d="M60 316V322" stroke="#cfcfc8" stroke-width="1.5" fill="none" stroke-linecap="round" stroke-linejoin="round"/>
<text x="255" y="334" font-size="12" class="dg-muted" fill="#5c5c68" font-weight="500" text-anchor="middle" font-family="JetBrains Mono, ui-monospace, Menlo, Consolas, monospace">.16</text>
<path class="dg-line" d="M255 316V322" stroke="#cfcfc8" stroke-width="1.5" fill="none" stroke-linecap="round" stroke-linejoin="round"/>
<text x="450" y="334" font-size="12" class="dg-muted" fill="#5c5c68" font-weight="500" text-anchor="middle" font-family="JetBrains Mono, ui-monospace, Menlo, Consolas, monospace">.32</text>
<path class="dg-line" d="M450 316V322" stroke="#cfcfc8" stroke-width="1.5" fill="none" stroke-linecap="round" stroke-linejoin="round"/>
<text x="645" y="334" font-size="12" class="dg-muted" fill="#5c5c68" font-weight="500" text-anchor="middle" font-family="JetBrains Mono, ui-monospace, Menlo, Consolas, monospace">.48</text>
<path class="dg-line" d="M645 316V322" stroke="#cfcfc8" stroke-width="1.5" fill="none" stroke-linecap="round" stroke-linejoin="round"/>
<text x="840" y="334" font-size="12" class="dg-muted" fill="#5c5c68" font-weight="500" text-anchor="middle" font-family="JetBrains Mono, ui-monospace, Menlo, Consolas, monospace">.63</text>
<path class="dg-line" d="M840 316V322" stroke="#cfcfc8" stroke-width="1.5" fill="none" stroke-linecap="round" stroke-linejoin="round"/>
</svg></figure>

*Figura 2. Lo stesso cavo, due visioni diverse della subnet. A può raggiungere B, ma B tratta l'indirizzo di A come remoto e non ha una route per rispondere.*

Crea i namespace, il cavo e gli indirizzi:

```bash
sudo ip netns add lab-a
sudo ip netns add lab-b
sudo ip link add veth-a type veth peer name veth-b
sudo ip link set veth-a netns lab-a
sudo ip link set veth-b netns lab-b
sudo ip -n lab-a addr add 198.51.100.10/26 dev veth-a
sudo ip -n lab-b addr add 198.51.100.40/28 dev veth-b
sudo ip -n lab-a link set veth-a up
sudo ip -n lab-b link set veth-b up
sudo ip -n lab-b route
```

Output atteso (la tabella di routing di `lab-b`):
```text
198.51.100.32/28 dev veth-b proto kernel scope link src 198.51.100.40
```

L'host B considera locale solo `198.51.100.32/28`. `198.51.100.10` è fuori, e B non ha altre route.

Esegui il ping nelle due direzioni:

```bash
sudo ip netns exec lab-a ping -c 2 198.51.100.40
sudo ip netns exec lab-b ping -c 2 198.51.100.10
```

Output atteso (i tempi variano):
```text
PING 198.51.100.40 (198.51.100.40) 56(84) bytes of data.
From 198.51.100.10 icmp_seq=1 Destination Host Unreachable
From 198.51.100.10 icmp_seq=2 Destination Host Unreachable

--- 198.51.100.40 ping statistics ---
2 packets transmitted, 0 received, +2 errors, 100% packet loss, time 1026ms
pipe 2
ping: connect: Network is unreachable
```

I due lati falliscono in modo diverso:
- **Da A**, `.40` sembra locale (la maschera di A è corretta), quindi A invia una richiesta ARP. B non risponde, perché non ha una route di ritorno verso `198.51.100.10`. Senza risposta ARP, A segnala `Destination Host Unreachable`.
- **Da B**, `.10` è fuori dal suo `/28` e non c'è una route predefinita, quindi il kernel si rifiuta di inviare qualsiasi cosa: `Network is unreachable`.

Ora prova a dare a B un default gateway fuori dalla sua subnet (errata):

```bash
sudo ip -n lab-b route add default via 198.51.100.1
```

Output atteso:
```text
Error: Nexthop has invalid gateway.
```

Linux rifiuta un gateway che non si trova in una subnet direttamente connessa. È il guasto del «gateway fuori dalla subnet» della lezione.

Correggi la maschera e prova di nuovo:

```bash
sudo ip -n lab-b addr del 198.51.100.40/28 dev veth-b
sudo ip -n lab-b addr add 198.51.100.40/26 dev veth-b
sudo ip netns exec lab-a ping -c 2 198.51.100.40
```

Output atteso (i tempi variano):
```text
PING 198.51.100.40 (198.51.100.40) 56(84) bytes of data.
64 bytes from 198.51.100.40: icmp_seq=1 ttl=64 time=0.040 ms
64 bytes from 198.51.100.40: icmp_seq=2 ttl=64 time=0.047 ms

--- 198.51.100.40 ping statistics ---
2 packets transmitted, 2 received, 0% packet loss, time 1034ms
rtt min/avg/max/mdev = 0.040/0.043/0.047/0.003 ms
```

> [!NOTE]
> Gli output qui sopra provengono da iproute2 6.17 e iputils 20250605. Altre versioni formulano i messaggi in modo leggermente diverso, e una locale non inglese li traduce; esegui i comandi con `LC_ALL=C` per ottenere l'output in inglese. Il comportamento del routing è lo stesso.

## Verifica
Hai completato il laboratorio quando:

1. Il tuo piano passa:
   ```bash
   python3 validate_plan.py plan.csv; echo "exit code: $?"
   ```
   L'output termina con `PASS: ...` e `exit code: 0`.
2. La tua versione corretta del piano difettoso passa:
   ```bash
   python3 validate_plan.py fixed.csv; echo "exit code: $?"
   ```
   L'output termina con `PASS: ...` e `exit code: 0`.
3. Sai indicare la regola della lezione dietro ciascuno dei quattro guasti del Passo 7.
4. (Passo 8 facoltativo) Con la maschera corretta, `sudo ip netns exec lab-a ping -c 2 198.51.100.40` mostra `0% packet loss`.

## Risoluzione dei problemi
| Sintomo | Causa probabile | Soluzione |
|---|---|---|
| `KeyError: 'segment'` (o `'site'`, `'prefix'`, `'hosts'`) | La riga di intestazione del CSV manca o è scritta male. | Fai in modo che la prima riga sia esattamente `site,segment,prefix,hosts`. |
| `ValueError: invalid literal for int() with base 10: ''` | Una riga di segmento ha la colonna `hosts` vuota. | Solo le righe `BLOCK` possono lasciare `hosts` vuoto. |
| `... is not a network address (did you mean ...?)` | Il prefisso ha bit host a 1: non inizia sul proprio confine. | Usa la rete suggerita, poi ricontrolla che non si sovrapponga a una vicina. |
| `... is outside its site block ...` | Un segmento è stato messo nel blocco di un'altra sede, oppure il blocco della sede è troppo piccolo. | Sposta il segmento nel suo blocco, oppure scegli un blocco di sede allineato più grande. |
| `RTNETLINK answers: Operation not permitted` | Hai eseguito senza `sudo` un comando `ip` che modifica la rete. | Anteponi `sudo` al comando. |
| `Cannot open network namespace "lab-a": No such file or directory` | Il namespace non esiste (un passo è stato saltato o la pulizia è già stata eseguita). | Esegui `ip netns list`, poi ripeti i comandi di creazione del Passo 8. |
| `File exists` creando un namespace o la coppia veth | Residui di un tentativo precedente. | Esegui i comandi di [Pulizia](#pulizia), poi ricomincia il Passo 8. |

## Sfida (facoltativa)
Example Corp apre una terza filiale, BR3, con Staff (200 host), Voice (100) e Management (10), più un collegamento WAN verso HQ. Aggiungila al tuo piano senza rinumerare nulla. Poi rendi il piano ancora più ordinato: scegli il blocco di BR3 in modo che **tutte le filiali** insieme (BR1, BR2 e BR3) possano essere annunciate a HQ come un'unica route di sintesi. Qual è quella route e quanto margine lascia per future filiali? Conferma con il validatore.

## Pulizia
Rimuovi i file del laboratorio:

```bash
cd ~
rm -r ~/subnet-lab
```

Se hai fatto il Passo 8, elimina i due namespace. Eliminare un namespace elimina anche l'interfaccia veth al suo interno, ed eliminare un'estremità di una coppia veth elimina l'altra.

```bash
sudo ip netns del lab-a
sudo ip netns del lab-b
ip netns list
```

Output atteso: `ip netns list` non stampa nulla (o non elenca `lab-a` né `lab-b`).

## Cosa hai imparato
- Prima dimensionare, poi collocare: il prefisso di ogni segmento deriva dal suo numero di host, e il blocco di ogni sede dalla somma dei suoi segmenti, arrotondata a una potenza di due.
- Allocare dal più grande su confini allineati impacchetta le subnet senza buchi e mantiene ogni sede riassumibile in una sola route.
- Sovrapposizioni, subnet sottodimensionate e prefissi disallineati sono facili da non vedere a occhio e facili da individuare con uno script.
- Su un host reale, una maschera errata compromette la raggiungibilità in modo asimmetrico, e Linux rifiuta un default gateway fuori dalla subnet dell'host.