Public Monitoring pour les installations auto-hébergées
Public Monitoring est disponible sur les installations GitGuardian auto-hébergées à partir de la version 2026.7. Cette page explique comment la fonctionnalité fonctionne sur une instance auto-hébergée, comment l'activer et les prérequis réseau qu'elle introduit.
Public Monitoring est une fonctionnalité business qui nécessite une licence spécifique. Contactez-nous pour obtenir des informations sur sa disponibilité et ses tarifs.
Pour une introduction générale à la fonctionnalité, consultez les concepts fondamentaux de Public Monitoring.
Fonctionnement de Public Monitoring en Self-Hosted
Contrairement à la plupart des capacités de GitGuardian, Public Monitoring ne scanne pas les sources publiques depuis votre propre instance. Les sources publiques (GitHub public, DockerHub et autres) sont scannées en continu par le service Public Monitoring hébergé par GitGuardian. Votre instance Self-Hosted se connecte à ce service pour récupérer les incidents de secrets publics qui correspondent au périmètre public de votre entreprise.
Deux conséquences découlent de ce modèle :
- Votre périmètre public est défini et stocké du côté de GitGuardian, au sein du service Public Monitoring hébergé, et non sur votre instance Self-Hosted. L'instance récupère les incidents qui y correspondent.
- La connexion est toujours sortante et initiée par votre instance. GitGuardian n'initie jamais de connexion vers votre instance Self-Hosted.
Public Monitoring repose sur des connexions sortantes vers le service Public Monitoring de GitGuardian. Votre instance doit pouvoir atteindre les domaines répertoriés dans Prérequis réseau. Une installation totalement isolée qui ne peut pas les atteindre ne peut pas utiliser Public Monitoring.
Activer Public Monitoring en Self-Hosted
Activer Public Monitoring sur une instance Self-Hosted se déroule en trois étapes : GitGuardian l'active sur votre licence, vous redéployez l'application pour que le worker Public Monitoring démarre, puis un administrateur termine la configuration depuis la zone Admin.
1. Demander l'activation et synchroniser votre licence
Public Monitoring est contrôlé par un champ de licence dédié qui est désactivé par défaut. Pour l'activer, contactez votre représentant GitGuardian ou support@gitguardian.com.
Une fois que GitGuardian a activé le champ, assurez-vous que la licence de l'application est synchronisée en conséquence. Après la synchronisation, une page Public monitoring devient disponible dans la zone Admin, sous Settings.
2. Redéployer l'application pour démarrer le worker Public Monitoring
Les incidents de secrets publics sont récupérés par un worker dédié, worker-public-monitoring, qui n'est déployé que lorsque le champ de licence est activé. Synchroniser la licence ne suffit pas : le worker est créé lors du prochain déploiement de l'application, vous devez donc redéployer après la mise à jour de la licence.
-
Installation basée sur Helm : exécutez
helm upgradeavec la version actuellement installée, afin d'éviter une mise à niveau non souhaitée. Utilisezhelm lspour trouver le nom et la version de votre release.helm upgrade <release-name> -n <namespace> oci://registry.replicated.com/gitguardian/gitguardian --version <installed-version> -f local-values.yaml -
Installation basée sur KOTS : ouvrez la console Admin et déployez la version en attente, comme décrit dans Gestion des licences.
Pour confirmer que le worker est en cours d'exécution, allez dans Tasks > Worker Tasks dans la zone Admin et vérifiez qu'au moins un worker est attaché aux files d'attente public_monitoring. Consultez Scaling pour dimensionner ce worker.
Si vous sautez cette étape, la configuration de la zone Admin se termine sans erreur mais aucun incident de secret public n'est jamais créé, car aucun worker ne traite les files d'attente Public Monitoring.
3. Configurer la connexion
GitGuardian vous fournit une paire d'identifiants (un Client ID et un Client secret) que votre instance utilise pour s'authentifier auprès du service Public Monitoring hébergé.
- Ouvrez la zone Admin de votre dashboard GitGuardian (droits d'administration requis).
- Allez dans Settings > Public monitoring.
- Cliquez sur Edit, saisissez le Client ID et le Client secret fournis par GitGuardian, puis cliquez sur Confirm.
Une fois les identifiants enregistrés, un message de confirmation apparaît et votre instance commence à récupérer les incidents de secrets publics qui correspondent à votre périmètre.
Vérifications de santé
Votre instance vérifie en continu que l'intégration est correctement configurée et accessible. Ces vérifications apparaissent sur la page Health Checks dans la zone Admin :
- Credentials : confirme que les identifiants Public Monitoring sont définis.
- Connectivity : confirme que les identifiants sont valides et que le service Public Monitoring hébergé est accessible.
Utilisez ces vérifications pour confirmer que l'intégration est saine après la configuration, et pour la diagnostiquer ultérieurement si les incidents cessent d'être récupérés.
Dépannage
La configuration s'est terminée mais aucun incident de secret public n'apparaît. Dans la zone Admin, allez dans Tasks > Worker Tasks et regardez les files d'attente public_monitoring. Si aucun worker n'y est attaché, l'application n'a pas été redéployée après la mise à jour de la licence : suivez l'étape 2 ci-dessus. Si un worker est en cours d'exécution, vérifiez la page Health Checks et assurez-vous que les domaines répertoriés dans Prérequis réseau sont accessibles depuis l'instance.
La page Public monitoring est absente de la zone Admin. La licence est mise en cache jusqu'à 10 minutes sur l'instance, la page peut donc prendre quelques minutes à apparaître après la mise à jour de la licence. Si elle est toujours absente après ce délai, contactez GitGuardian pour confirmer que le champ de licence est activé.
Afficher et masquer le module
Une fois Public Monitoring configuré, vous pouvez masquer le module de votre workspace à l'aide de l'option Deactivate Public Monitoring dans le produit. Lorsque le module est masqué, la synchronisation des incidents se poursuit en arrière-plan afin qu'aucune donnée ne soit perdue, mais le module est retiré de votre workspace et les notifications Public Monitoring sont mises en pause. Vous pouvez réafficher le module à tout moment.
Prérequis réseau
Public Monitoring nécessite que votre instance effectue des requêtes HTTPS sortantes (port 443) vers les domaines suivants. Ceux-ci doivent être autorisés dans votre pare-feu et, le cas échéant, dans votre proxy HTTP. Consultez Prérequis réseau pour le modèle réseau général du Self-Hosted.
| Protocole | Port | Source | Destination | Description |
|---|---|---|---|---|
| TCP | 443 | Tous les nœuds K8S | enterprise.gitguardian.com | API GitGuardian Public Monitoring |
| TCP | 443 | Tous les nœuds K8S | gitguardian.auth0.com | Authentification |
| TCP | 443 | Tous les nœuds K8S | gg-gpm-incidents-prod.s3.amazonaws.com | Récupération des incidents de secrets publics |