# Cilium default-deny and DNS lab / Lab Cilium default-deny et DNS

## English

This self-contained lab demonstrates Kubernetes `NetworkPolicy` enforcement by Cilium on a disposable, single-node kind cluster. It uses a fixed festival running-order HTTP response, one labelled application client, and one labelled intruder. It does not configure Hubble, VCF, VKS, or any production cluster.

### Pinned versions

| Component | Version |
|---|---|
| Docker CLI / Desktop engine | 29.9.2 / 29.9.2 (Desktop 4.97.0 on the author's run) |
| kind | 0.31.0 |
| Kubernetes node image | `kindest/node:v1.35.0` |
| kubectl | 1.35.3 |
| Helm | 3.22.0 |
| Cilium chart and agent | 1.20.4 (`sha256:20fe92e4c86641233a450098c158d2d29085f3419931ab6bf681d2485dedf16e`) |
| Workload image | `busybox:1.37.0` (`sha256:a7dbc319b1438115a207e11930dc4bb3e643dcb3ec0bdd694bb36cd8fad289ec`) |

The node image is pinned to `kindest/node:v1.35.0@sha256:4613778f3cfcd10e615029370f5786704559103cf27bef934597ba562b269661` (linux/arm64 as resolved by Docker Desktop). The BusyBox digest was captured from Docker's resolved image. Cilium 1.20.4 is the version shown by the official stable kind guide; its Helm chart pins the image digest. Helm 3.22.0 satisfies that guide's Helm >=3.13 requirement. Hubble and Envoy are disabled because this lab only tests L3/L4 policy. The script lets the kind node pull the versioned Cilium image rather than preloading it, because the host's kind image loader failed to import the multi-platform archive; the node-side pull itself succeeded during this run.

### Run

Prerequisites: Docker Desktop/Engine running, `docker`, `kind` 0.31.0, `kubectl` 1.35.3 and Helm 3.22.0 available in PATH. The scripts never use the implicit current Kubernetes context. They exclusively use `--kubeconfig /tmp/cilium-top-kubeconfig` and `kind-top-cilium`; setup refuses to overwrite that file or an existing cluster of the same name.

```sh
./setup.sh
./verify.sh
./cleanup.sh
```

Run `cleanup.sh` after either success or failure. It refuses to delete unless the dedicated kubeconfig selects `kind-top-cilium` and the `festival-policy` namespace has the lab safety label. Cleanup removes the cluster and its dedicated kubeconfig; downloaded Docker images and Helm cache are left in place. Evidence is timestamped under `./evidence/` by default; set `CILIUM_TOP_LOG_DIR` to choose another directory.

### Expected observations

1. Before policies, both clients resolve `running-order.festival-policy.svc.cluster.local` and fetch the running-order over HTTP.
2. Namespace-wide ingress and egress default deny block DNS and direct-IP HTTP.
3. The DNS allowance to CoreDNS pods labelled `k8s-app=kube-dns` on both UDP and TCP 53 restores name resolution; HTTP remains blocked.
4. The app-only egress and running-order-only ingress rules on TCP 80 allow the app and continue to deny the intruder. The running-order server also listens on port 80, so Service and pod ports align.
5. Deleting only `allow-dns` breaks lookup while the app can still reach the running-order's ClusterIP directly; reapplying that one rule restores DNS.

The checks issue new `wget` and DNS requests with bounded client timeouts. A marked command failure inside the Pod is required for a negative test; a kubectl transport error stops the run. Bounded retries allow policy convergence. Inspect the evidence log and cluster events if results differ.

## Français

Ce laboratoire autonome montre l'application des `NetworkPolicy` Kubernetes par Cilium dans un cluster kind jetable à un seul nœud. Il sert une réponse HTTP fixe de running-order, avec un client applicatif et un intrus identifiés par labels. Il ne configure ni Hubble, ni VCF/VKS, ni cluster de production.

### Versions épinglées

| Composant | Version |
|---|---|
| Docker CLI / moteur Desktop | 29.9.2 / 29.9.2 (Desktop 4.97.0 lors de l'exécution auteur) |
| kind | 0.31.0 |
| Image du nœud Kubernetes | `kindest/node:v1.35.0` |
| kubectl | 1.35.3 |
| Helm | 3.22.0 |
| Chart et agent Cilium | 1.20.4 |
| Image applicative | `busybox:1.37.0` |

Le tag de l'image du nœud est publié pour linux/arm64 et linux/amd64. La doc officielle stable kind indique Cilium 1.20.4. Helm 3.22.0 respecte le minimum 3.13 demandé par cette documentation. Les images applicatives ont un tag de version explicite et `IfNotPresent` ; pour une reproductibilité d'archive, utilisez des digests de registre vérifiés dans votre environnement.

### Exécution

Prérequis : Docker Desktop/Engine en marche, `docker`, `kind` 0.31.0, `kubectl` 1.35.3 et Helm 3.22.0 dans PATH. Les scripts n'utilisent jamais le contexte Kubernetes courant implicite. Ils ciblent exclusivement `--kubeconfig /tmp/cilium-top-kubeconfig` et `kind-top-cilium`. L'installation refuse d'écraser ce fichier ou un cluster existant du même nom.

```sh
./setup.sh
./verify.sh
./cleanup.sh
```

Lancez `cleanup.sh` après une réussite ou un échec. Le script refuse de supprimer quoi que ce soit si le kubeconfig dédié ne pointe pas vers `kind-top-cilium` ou si le namespace `festival-policy` ne porte pas son label de sécurité. Le nettoyage supprime le cluster et son kubeconfig dédié ; les images Docker et le cache Helm restent locaux. Les preuves horodatées sont enregistrées dans `./evidence/` par défaut ; `CILIUM_TOP_LOG_DIR` permet de choisir un autre dossier.

### Résultats attendus

1. Sans politiques, les deux clients résolvent `running-order.festival-policy.svc.cluster.local` et obtiennent le running-order en HTTP.
2. Le default-deny ingress/egress du namespace bloque DNS et HTTP direct par IP.
3. L'autorisation DNS vers les pods CoreDNS portant `k8s-app=kube-dns`, en UDP et TCP 53, restaure la résolution ; HTTP reste bloqué.
4. Les règles TCP 80 limitent le trafic à la sortie de l'app et à l'entrée du running-order ; l'intrus reste bloqué. Le serveur running-order écoute également sur le port 80, ce qui aligne les ports du Service et du pod.
5. La suppression de la seule règle `allow-dns` casse la résolution alors que l'app atteint encore le ClusterIP du running-order ; sa recréation restaure DNS.

Chaque vérification crée une nouvelle requête `wget` ou DNS avec un délai borné. Un échec de commande marqué à l’intérieur du Pod est requis pour un test négatif ; une erreur de transport kubectl arrête le scénario. Les tentatives sont bornées pour laisser converger les politiques. Consultez les preuves et événements si le résultat diffère.

## Sources officielles / Official sources

- [Cilium: Installation Using kind](https://docs.cilium.io/en/stable/installation/kind/)
- [Cilium: Policy Enforcement Modes](https://docs.cilium.io/en/stable/security/policy/intro/)
- [kind: Quick Start](https://kind.sigs.k8s.io/docs/user/quick-start/)
- [Helm: Installing Helm](https://helm.sh/docs/intro/install/)
