Recommandations et informations de sécurité
Vulnérabilités et expositions courantes
GitGuardian construit ses images Self-Hosted à partir des images Base-OS durcies de Chainguard, ce qui réduit considérablement la surface CVE des conteneurs frontend et backend et vise un objectif zéro-CVE en production.
Les images KOTS admin et Replicated SDK utilisent une image de base distroless Chainguard.
Configuration de l'image d'exécution : L'image d'exécution est basée sur l'image Python (avec une variante optionnelle compatible FIPS pour Helm), et embarque les paquets supplémentaires suivants : src-fingerprint, libxml2, libxslt, xmlsec, xmlsec-openssl et git.
Modules cryptographiques FIPS 140-3 (Helm uniquement)
Les modules cryptographiques approuvés FIPS 140-3 sont disponibles en tant que fonctionnalité facultative pour les installations basées sur Helm. Lorsqu'elle est activée, GitGuardian utilise les variantes conformes FIPS de ses images applicatives pour chiffrer les données sensibles au repos et en transit.
Pour activer FIPS dans votre installation Helm, définissez les éléments suivants dans values.yaml :
global:
fips:
enabled: true
Pour les environnements air-gapped, consultez le guide d'installation air-gap pour la liste des images spécifiques à FIPS.
Apprenez-en davantage sur le processus de validation FIPS de Chainguard et consultez l'engagement FIPS de Chainguard pour les détails relatifs à la garantie et aux modules cryptographiques certifiés.
Images GitGuardian pour le scan de CVE
Le tableau ci-dessous liste les images livrées dans la version actuelle afin que vous puissiez les alimenter dans votre scanner de CVE (Trivy, Grype, Snyk, etc.) ou votre pipeline de gestion des vulnérabilités. Les variantes FIPS ont un suffixe -fips sur le même dépôt.
Liste des images de la version actuelle
| Image Type | Repository and Image Name | 2026.10.2 |
|---|---|---|
| GitGuardian Frontend | proxy.replicated.com/proxy/gitguardian/docker.io/gitguardian/prm-static-chainguard | 2026.10.2 |
| GitGuardian Backend | proxy.replicated.com/proxy/gitguardian/docker.io/gitguardian/prm-app-chainguard | 2026.10.2 |
| Helm Tooling — preflights, support bundle, and upgrade path check (until 2026.4.0) | proxy.replicated.com/proxy/gitguardian/docker.io/gitguardian/prm-helm-tooling | 2026.10.2 |
| Replicated SDK — licensing | proxy.replicated.com/proxy/gitguardian/docker.io/replicated/replicated-sdk | 1.19.12 |
| Machine Learning | proxy.replicated.com/proxy/gitguardian/docker.io/gitguardian/ml-secret-engine-app-chainguard | 4.21.0 |
| File Scanner | proxy.replicated.com/proxy/gitguardian/ghcr.io/gitguardian/wolfi/apache-tika | 3.3 |
| Analytics | proxy.replicated.com/proxy/gitguardian/docker.io/gitguardian/basalt-onprem-analytics | 0.10.2 |
| ggscout | proxy.replicated.com/proxy/gitguardian/ghcr.io/gitguardian/ggscout/chainguard | 0.33.0 |
| MCP Server | proxy.replicated.com/proxy/gitguardian/ghcr.io/gitguardian/mcp-server | 0.7.4 |
| ClickHouse | proxy.replicated.com/proxy/gitguardian/513715405986.dkr.ecr.us-west-2.amazonaws.com/cgr.dev/gitguardian.com/clickhouse-iamguarded | 26.4 |
| ClickHouse backup sidecar | proxy.replicated.com/proxy/gitguardian/513715405986.dkr.ecr.us-west-2.amazonaws.com/cgr.dev/gitguardian.com/clickhouse-backup | 2.8.1 |
| Log collector — fluent-bit | proxy.replicated.com/proxy/gitguardian/ghcr.io/gitguardian/wolfi/fluent-bit | 4.2.4 |
| Log collector — loki | proxy.replicated.com/proxy/gitguardian/ghcr.io/gitguardian/wolfi/loki | 3.7.8 |
| Log collector — minio | proxy.replicated.com/proxy/gitguardian/ghcr.io/gitguardian/wolfi/minio | 0.20260922 |
| Bash — Custom CA and upgrade path check (starting 2026.5.0) | proxy.replicated.com/proxy/gitguardian/ghcr.io/gitguardian/wolfi/bash | 5.3 |
The MCP Server and both ClickHouse images are only needed if you enable those components (mcpServer.enabled and clickhouse.enabled, both false by default).
L'historique complet des tags publiés et la structure de répertoires du registre privé sont maintenus dans le guide d'installation air-gap.
Image Analytics : évaluation du risque CVE
L'image de la fonctionnalité Analytics (gitguardian/basalt-onprem-analytics) repose sur une pile d'analyse de données basée sur Python dont l'arbre de dépendances transitives présente des défis de correction permanents inhérents à cette catégorie de logiciels.
Le risque de sécurité est minime. L'image s'exécute en tant que CronJob Kubernetes nocturne sans serveur web, sans écouteur réseau et sans aucune connexion entrante de quelque type que ce soit. Elle n'écrit que dans les bases de données internes du cluster (PostgreSQL) et traite des métadonnées internes de GitGuardian — pas les secrets ou le code source des clients. La grande majorité des CVE de cette image décrivent des vulnérabilités qui nécessitent une interface réseau exposée ou un accès interactif pour être exploitées, dont aucune n'est présente ici.
GitGuardian surveille cette image en continu et priorisera la remédiation de toute CVE présentant un chemin d'exploitation réaliste.
Cosign pour la signature des images
GitGuardian a renforcé la sécurité de nos images grâce à la mise en œuvre de Cosign pour la signature des images, en conformité avec les normes SLSA 2. Cela garantit que toutes les images sont sécurisées de leur création à leur déploiement. Toutes les images GitGuardian peuvent être vérifiées selon la méthode décrite ci-dessous, à l'exception du Replicated SDK qui utilise un processus de vérification différent (voir Verify SDK Image Integrity).
Vous pouvez renforcer la sécurité de votre Kubernetes en utilisant le Sigstore Policy Controller. Pour plus de détails, veuillez consulter la documentation du Sigstore Policy Controller.
Avant de commencer : Téléchargez Cosign pour la vérification des images : Télécharger Cosign
Étapes de vérification :
- Enregistrez la clé publique fournie dans un fichier nommé
gg_cosign.pub.
echo "-----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEnVzZQr8D9OgkgZcf9z0v67yrd2pg
+yQtJur1OgetAwij8T8g8VH+IegI6Y+1E3ZEqMast934R35UCzOiiyIadQ==
-----END PUBLIC KEY-----" > gg_cosign.pub
- Récupérez votre License ID depuis votre fichier de licence, où il est étiqueté
licenseID. Utilisez cet ID pour vous authentifier auprès du dépôt d'images GitGuardian en exécutant les commandes ci-dessous.
printf "Enter your License ID: " && read LICENSE_ID
docker login registry.replicated.com --username "${LICENSE_ID}" --password "${LICENSE_ID}"
docker login proxy.replicated.com --username "${LICENSE_ID}" --password "${LICENSE_ID}"
- Exécutez la commande suivante, en remplaçant
<IMAGE>:<TAG>par le nom et le tag de l'image.
cosign verify --key gg_cosign.pub <IMAGE>:<TAG>
Cette commande vérifie l'image par rapport aux signatures stockées avec elle, en utilisant la clé publique fournie.
Images que vous pouvez vérifier avec Cosign
| Image Type | Repository and Image Name | 2026.10.2 |
|---|---|---|
| GitGuardian Frontend | proxy.replicated.com/proxy/gitguardian/docker.io/gitguardian/prm-static-chainguard | 2026.10.2 |
| GitGuardian Backend | proxy.replicated.com/proxy/gitguardian/docker.io/gitguardian/prm-app-chainguard | 2026.10.2 |
| Helm Tooling — preflights, support bundle, and upgrade path check (until 2026.4.0) | proxy.replicated.com/proxy/gitguardian/docker.io/gitguardian/prm-helm-tooling | 2026.10.2 |
| Replicated SDK — licensing | proxy.replicated.com/proxy/gitguardian/docker.io/replicated/replicated-sdk | 1.19.12 |
| Machine Learning | proxy.replicated.com/proxy/gitguardian/docker.io/gitguardian/ml-secret-engine-app-chainguard | 4.21.0 |
| File Scanner | proxy.replicated.com/proxy/gitguardian/ghcr.io/gitguardian/wolfi/apache-tika | 3.3 |
| Analytics | proxy.replicated.com/proxy/gitguardian/docker.io/gitguardian/basalt-onprem-analytics | 0.10.2 |
| ggscout | proxy.replicated.com/proxy/gitguardian/ghcr.io/gitguardian/ggscout/chainguard | 0.33.0 |
| MCP Server | proxy.replicated.com/proxy/gitguardian/ghcr.io/gitguardian/mcp-server | 0.7.4 |
| ClickHouse | proxy.replicated.com/proxy/gitguardian/513715405986.dkr.ecr.us-west-2.amazonaws.com/cgr.dev/gitguardian.com/clickhouse-iamguarded | 26.4 |
| ClickHouse backup sidecar | proxy.replicated.com/proxy/gitguardian/513715405986.dkr.ecr.us-west-2.amazonaws.com/cgr.dev/gitguardian.com/clickhouse-backup | 2.8.1 |
| Log collector — fluent-bit | proxy.replicated.com/proxy/gitguardian/ghcr.io/gitguardian/wolfi/fluent-bit | 4.2.4 |
| Log collector — loki | proxy.replicated.com/proxy/gitguardian/ghcr.io/gitguardian/wolfi/loki | 3.7.8 |
| Log collector — minio | proxy.replicated.com/proxy/gitguardian/ghcr.io/gitguardian/wolfi/minio | 0.20260922 |
| Bash — Custom CA and upgrade path check (starting 2026.5.0) | proxy.replicated.com/proxy/gitguardian/ghcr.io/gitguardian/wolfi/bash | 5.3 |
The MCP Server and both ClickHouse images are only needed if you enable those components (mcpServer.enabled and clickhouse.enabled, both false by default).
La structure de répertoires du registre privé pour les mêmes images se trouve dans la section Upload GitGuardian Images du guide d'installation air-gap.
Exemple :
cosign verify --key gg_cosign.pub proxy.replicated.com/proxy/gitguardian/docker.io/gitguardian/prm-app-chainguard:2026.4.0 | jq .
Verification for proxy.replicated.com/proxy/gitguardian/docker.io/gitguardian/prm-app-chainguard:2026.4.0 --
The following checks were performed on each of these signatures:
- The cosign claims were validated
- Existence of the claims in the transparency log was verified offline
- The signatures were verified against the specified public key
Sortie attendue :
[
{
'critical':
{
'identity':
{
'docker-reference': 'docker.io/gitguardian/prm-app-chainguard',
},
'image': { 'docker-manifest-digest': 'sha256:b842813ffb597a67c...' },
'type': 'cosign container image signature',
},
'optional':
{
'Bundle':
{
'SignedEntryTimestamp': '',
'Payload':
{
'body': '',
'integratedTime': 1709632488,
'logIndex': 75773529,
'logID': 'c0d23d6ad406...',
},
},
},
},
]
Documents VEX
À partir de la version 2026.10, GitGuardian publie un document VEX (Vulnerability Exploitability eXchange) pour chaque version Self-Hosted, au format CSAF 2.0 : la propre évaluation de GitGuardian indiquant quelles CVE signalées contre les images livrées les affectent réellement, avec les preuves à l'appui. Un document par image, plus un document combiné couvrant toutes les images de la version.
Vous pouvez les alimenter dans votre pipeline de gestion des vulnérabilités afin de filtrer les résultats du scanner pour ne conserver que ceux que GitGuardian confirme comme exploitables dans ses images.
Les documents VEX ne sont pas disponibles pour les versions Self-Hosted antérieures à 2026.10. Si vous en avez besoin pour une version antérieure, contactez le support GitGuardian.
Récupérer un document VEX
Les documents sont distribués via le même registre proxy Replicated que les images de conteneur, sous forme d'artefacts OCI : utilisez ORAS plutôt que docker pull pour les récupérer.
-
Installez ORAS : consultez les instructions d'installation.
-
Connectez-vous au registre proxy avec votre License ID (le même que celui utilisé pour récupérer les images ci-dessus) :
printf "Enter your License ID: " && read LICENSE_ID
oras login proxy.replicated.com --username "${LICENSE_ID}" --password "${LICENSE_ID}"
- Récupérez les documents, en remplaçant
<RELEASE>(et<IMAGE>pour une image unique) ci-dessous. Le document combiné couvre l'ensemble de la version dans un seul fichier ; un document par image limite l'évaluation à cette image uniquement :
# Combined document, every image of the release
oras pull proxy.replicated.com/proxy/gitguardian/513715405986.dkr.ecr.us-west-2.amazonaws.com/vex/gitguardian:<RELEASE> -o ./vex
# Single image
oras pull proxy.replicated.com/proxy/gitguardian/513715405986.dkr.ecr.us-west-2.amazonaws.com/vex/<IMAGE>:<RELEASE> -o ./vex
Le fichier JSON est enregistré sous le nom imposé par CSAF, gg-vex-<release>-<image>.json.
<IMAGE> correspond au dernier segment du chemin de registre propre à l'image, tel qu'indiqué dans les chemins du registre air gap. Par exemple, /gitguardian/basalt-onprem-analytics se récupère depuis vex/basalt-onprem-analytics, et /cgr.dev/gitguardian.com/clickhouse-iamguarded depuis vex/clickhouse-iamguarded. Deux exceptions :
- Les deux images
ggscout(chainguardetchainguard-bash) partagent un seul documentvex/ggscout. - Une image
-fipsest une build alternative de l'image standard déjà couverte : elle n'a pas de document VEX propre, utilisez celui de son équivalent non-FIPS.
Le tag de version pointe toujours vers la version actuelle du document : récupérer 2026.9.0 aujourd'hui vous donne l'évaluation la plus récente pour cette version, et non un instantané figé à la première publication. Ce qui a changé entre les révisions est enregistré dans le document lui-même, dans document.tracking.revision_history.
Chaque document est signé avec Cosign, de la même manière que les images de conteneur de GitGuardian. Les instructions pour vérifier la signature d'un document VEX seront publiées ici une fois que la clé de vérification disposera d'un emplacement stable et accessible publiquement. Contactez le support GitGuardian en attendant si vous devez en vérifier un.
Certificat TLS
L'application impose un accès HTTPS pour protéger les informations sensibles telles que les secrets et le code source. Un certificat TLS est requis pour démarrer l'installation.
Utilisez un certificat valide correspondant à votre nom de domaine complet (FQDN), par exemple dashboard.gitguardian.mycorp.local. Pour la configuration, consultez la configuration du certificat TLS.
Par défaut, GitGuardian propose une suite de chiffrement prenant uniquement en charge TLS 1.2 et TLS 1.3, compatible avec les navigateurs modernes. Lorsque l'option FIPS 140-3 est activée, les protocoles et chiffrements suivants sont utilisés et sont conformes à FIPS 140-3 :
- Protocoles :
TLS 1.2/TLS 1.3 - Chiffrements :
- TLS 1.3 :
TLS_AES_256_GCM_SHA384 - TLS 1.2 :
ECDHE-ECDSA-AES256-GCM-SHA384,ECDHE-RSA-AES256-GCM-SHA384
- TLS 1.3 :
Certificats auto-signés
L'utilisation d'un certificat auto-signé nécessite une gestion supplémentaire de la validation SSL pour les webhooks GitLab ou GitHub. La vérification SSL est activée par défaut et doit être désactivée lors de l'intégration avec GitLab ou GitHub via un certificat auto-signé.
Chiffrement et contrôle d'accès
Étant donné que la base de données contiendra des données sensibles (comme le code source et les fuites), nous recommandons vivement de chiffrer le système de fichiers. De plus, l'accès à l'hôte exécutant l'application doit être limité au personnel essentiel (par exemple, les gestionnaires de déploiement de l'hôte et de l'application).
Restrictions d'inscription
Par défaut, rejoindre le workspace GitGuardian nécessite une inscription via SSO ou un lien d'invitation.
Désactiver les restrictions d'inscription signifie que n'importe qui au sein du réseau de l'instance peut rejoindre votre workspace et potentiellement accéder aux secrets. Si vous choisissez de désactiver ces restrictions, assurez-vous que votre instance GitGuardian n'est accessible qu'au sein d'un réseau restreint, et non depuis Internet.