Images signées et épinglées¶
Trois garde-fous complémentaires protègent la plateforme contre une image arbitraire ou remplacée après revue.
| Niveau | Où | Effet |
|---|---|---|
Schéma challenge.yml |
import ZIP / dépôt Git, validé par CTFd | instance.image doit être sous registry.pad.internal/ctf/ et épinglée par @sha256: |
| Scénario chall-manager | apps/chall-manager-scenario (PAD_IMAGE_PREFIX) |
même règle, refus avant toute création de ressource |
Kyverno restrict-instance-images |
pods inst-*, toujours en Enforce |
refus à l'admission de toute image hors préfixe ou sans empreinte |
Kyverno verify-images / verify-images-audit |
pods inst-*, ctfd, frontend, netbird-sync |
vérification des signatures cosign, Audit par défaut puis Enforce |
Valeurs de référence : infra/contracts.yaml, bloc instances (image_prefix, image_verification).
Mode de vérification des signatures¶
Le ConfigMap kyverno/pad-image-policy (gitops/platform/kyverno/policies/image-policy-configmap.yaml) pilote deux
politiques exclusives :
mode |
Politique active | Effet |
|---|---|---|
audit (défaut) |
verify-images-audit (failurePolicy: Ignore) |
violations rapportées dans les PolicyReports, rien n'est bloqué |
enforce |
verify-images (failurePolicy: Fail) |
image non signée ou sans empreinte refusée |
Garde-fou : tant que cosign.pub contient CHANGEME, la vérification du registre interne reste en audit même si
mode: enforce, pour ne pas empêcher toutes les instances de démarrer avec une clé invalide. Les images du projet sur
ghcr.io sont vérifiées en keyless et n'utilisent pas cette clé.
failurePolicy: Fail signifie qu'un Kyverno indisponible bloque la création de pods dans inst-*, ctfd, frontend
et netbird-sync (le webhook est limité à ces namespaces par matchConditions ; kube-system et kyverno ne sont jamais
concernés). Le contrôleur d'admission Kyverno tourne en 2 réplicas sur le pool platform (PDB minAvailable: 1) : voir le runbook Kyverno.
Passer en Enforce¶
- Générer la paire de clés :
cosign generate-key-pair. La clé privée va dans SOPS (secrets de la CI du dépôt privé de challenges), jamais dans ce dépôt. - Remplacer
cosign.pubdansimage-policy-configmap.yamlpar la clé publique. - Faire signer par la CI du dépôt privé chaque image de challenge poussée dans Zot
(
cosign sign --key ... registry.pad.internal/ctf/<image>@sha256:...), sinon elle sera refusée. - Lire les rapports :
kubectl get policyreport -A -o json | jq '.items[].results[]? | select(.policy|startswith("verify-images"))'. Aucune violation attendue pour les images en cours d'utilisation. - Dans le même commit, passer
mode: enforcedans le ConfigMap etinstances.image_verification: enforcedansinfra/contracts.yaml. - Retour arrière : repasser
mode: audit. Aucune autre modification n'est nécessaire.
Images de la plateforme (ctfd, frontend, netbird-sync)¶
Les images ghcr.io/<propriétaire du dépôt>/pad-* sont construites, poussées et signées (cosign keyless, identité du workflow
images.yml) par la CI. Les manifests gitops/apps/*/deployment.yaml les référencent en tag@sha256:<empreinte>.
Flux de mise à jour (épinglage par l'opérateur) :
- Sur push
main,images.ymlconstruit, scanne, pousse et signe chaque image (ghcr.io/<propriétaire>/pad-<nom>:<sha court>) et affiche son empreinte dans le résumé du job (Résumé du digest). - Une fois toutes les images publiées, le job
pin-digestscalcule les empreintes (scripts/pin-image-digests.sh <propriétaire> <sha court>) et affiche dans le résumé du run le diff à appliquer. Il ne commite rien : le dépôt n'a qu'un auteur, l'opérateur. - L'opérateur épingle localement puis commite :
task apps:pin-digests -- <sha court> # défaut : HEAD
git diff # vérifier les références tag@sha256
git commit -am "chore(images): épingler les empreintes des images <sha court>" && git push
Le script lit l'empreinte de l'index OCI dans le registre et réécrit les références tag@sha256 de
gitops/apps/{ctfd,frontend,netbird-sync}/deployment.yaml et l'empreinte de challenges/*/challenge.yml
(registry.pad.internal/ctf/<nom> : l'empreinte est la même dans Zot si l'image y est copiée à l'identique, par exemple
crane copy ghcr.io/<propriétaire>/pad-chal-<nom>:<sha> registry.pad.internal/ctf/<nom>:<version>).
ArgoCD déploie ensuite la nouvelle version.
4. Renovate ignore ces images (règle enabled: false dans renovate.json) pour ne pas entrer en conflit avec ce flux ; il
continue de suivre les images de base et les autres dépendances.
Les packages ghcr.io/<propriétaire>/pad-* doivent être publics (ou le cluster doit disposer d'un secret de pull) :
GitHub crée un package privé par défaut. Package settings > Change visibility > Public.
Tant que l'empreinte est nulle (sha256:000…, cas de pad-frontend tant qu'il n'est pas publié), l'image ne démarre pas :
c'est volontaire. L'Application concernée reste Degraded jusqu'à la première publication, puis task apps:pin-digests l'épingle.
Points à vérifier au premier déploiement
- L'identité keyless attendue est
.github/workflows/images.ymlsurmainou un tagv*du dépôt du contrat (git.repo). Une image construite depuis une autre branche ou un fork est refusée enenforce. - L'admission controller Kyverno doit joindre ghcr.io et
*.sigstore.dev(Rekor, Fulcio, TUF) : règles ajoutées à la CiliumNetworkPolicy du namespacekyverno. Si les pods plateforme sont lents à démarrer, vérifier ce flux et le flux platform vers Internet (variableinternet_egress_zonesde la stack60-opnsense-rules). - Les nœuds challenges tirent les images de
registry.pad.internal/ctf/: la configuration de Zot (gitops/platform/zot/values.yaml) définit la règle d'accèsctf/**(écriture pour la CI, lecture pourpad-pull). Reste à fournir les identifiants depad-pullaux nœuds (configuration de registre Talos, hors Git). Marche à suivre : Actions manuelles (action 8).