Aller au contenu principal

Network policies

GitGuardian Self-Hosted embarque des ressources NetworkPolicy Kubernetes intégrées qui isolent le namespace GIM du reste du cluster. Lorsqu'elles sont activées, le trafic entrant provenant de l'extérieur du namespace est refusé par défaut et seuls les namespaces que vous autorisez explicitement peuvent atteindre les pods GitGuardian.

Les network policies sont disponibles pour les installations basées sur Helm et sont configurées entièrement via les valeurs Helm sous les clés de premier niveau networkPolicy.*. Référence complète des valeurs : Helm values.

Prérequis Kubernetes

Les objets NetworkPolicy sont appliqués par votre plugin CNI (Calico, Cilium, AWS VPC CNI avec application des politiques, etc.). Assurez-vous que votre cluster dispose d'un CNI appliquant les politiques avant d'activer cette fonctionnalité — sinon les politiques sont déployées mais ignorées.

Démarrage rapide​

Le déploiement recommandé est un processus en deux étapes : déployez d'abord en mode dryrun pour valider votre configuration, puis passez en mode enforce pour activer le blocage.

1. Déployer en mode dryrun​

En mode dryrun, toutes les politiques sont appliquées mais une règle temporaire autorisant tout le trafic empêche tout blocage. Utilisez cette phase pour examiner les politiques générées et identifier chaque namespace qui doit communiquer avec GIM.

networkPolicy:
enabled: true
mode: dryrun
allowedNamespaces:
- ingress-nginx
- monitoring

Inspectez les politiques déployées et vos modèles de trafic (logs CNI, métriques de service mesh, etc.) pour confirmer qu'aucun trafic légitime ne serait bloqué.

2. Passer en mode enforce​

Une fois que vous êtes confiant, supprimez le filet de sécurité en passant en mode enforce :

networkPolicy:
enabled: true
mode: enforce
allowedNamespaces:
- ingress-nginx
- monitoring

Le trafic entrant provenant de tout namespace absent de allowedNamespaces est désormais activement bloqué.

Référence de configuration​

ValeurPar défautDescription
networkPolicy.enabledfalseActive les ressources NetworkPolicy pour le namespace GIM.
networkPolicy.modedryrundryrun : les politiques sont déployées avec un filet de sécurité autorisant tout le trafic. enforce : le filet de sécurité est supprimé et les politiques bloquent activement le trafic entrant non autorisé.
networkPolicy.allowedNamespaces[]Namespaces autorisés à atteindre les pods GIM. Incluez votre contrôleur d'ingress, votre stack de surveillance et toute autre charge de travail nécessitant un accès. Exemple : ["ingress-nginx", "monitoring"].
networkPolicy.extraPolicies[]Entrées de spécification NetworkPolicy complètes rendues aux côtés des valeurs par défaut. Utilisez ceci pour des règles d'autorisation/refus personnalisées en dehors du modèle allowedNamespaces.

Politiques personnalisées​

Utilisez networkPolicy.extraPolicies lorsque vous avez besoin de règles qui ne correspondent pas au modèle allowedNamespaces (par exemple restrictions de trafic sortant, règles basées sur des sélecteurs de pod). Chaque entrée est rendue comme une spécification NetworkPolicy complète :

networkPolicy:
enabled: true
mode: enforce
allowedNamespaces:
- ingress-nginx
extraPolicies:
- apiVersion: networking.k8s.io/v1
kind: NetworkPolicy
metadata:
name: allow-external-smtp
spec:
podSelector: {}
policyTypes:
- Egress
egress:
- to:
- ipBlock:
cidr: 10.0.0.0/24
ports:
- protocol: TCP
port: 587

Dépannage​

  • Trafic bloqué de manière inattendue : Revenez en mode: dryrun, puis ajoutez le namespace manquant à allowedNamespaces avant de repasser en enforce.
  • Politiques déployées mais non appliquées : Vérifiez que votre plugin CNI prend en charge l'application des NetworkPolicy. Exécutez kubectl get networkpolicies -n <gitguardian-namespace> pour confirmer que les ressources existent.
  • Le contrôleur d'ingress ne parvient pas à atteindre GIM : Le namespace de votre contrôleur d'ingress (par exemple ingress-nginx, istio-system) doit être listé dans allowedNamespaces.