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.
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
| Valeur | Par défaut | Description |
|---|---|---|
networkPolicy.enabled | false | Active les ressources NetworkPolicy pour le namespace GIM. |
networkPolicy.mode | dryrun | dryrun : 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 àallowedNamespacesavant de repasser enenforce. - Politiques déployées mais non appliquées : Vérifiez que votre plugin CNI prend en charge l'application des
NetworkPolicy. Exécutezkubectl 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é dansallowedNamespaces.