Intégrer Red Hat Quay
Sécurisez vos applications conteneurisées en surveillant Red Hat Quay à la recherche de secrets exposés dans les images de conteneurs.
Red Hat Quay prend en charge à la fois les déploiements SaaS (quay.io) et Self-Hosted. Cette intégration fonctionne avec les deux variantes.
Pourquoi surveiller Red Hat Quay ?
Red Hat Quay sert de registre d'images de conteneurs conforme à OCI et de niveau entreprise pour les images de conteneurs prêtes pour la production de votre organisation. Ces images contiennent souvent des identifiants de bases de données de production, des clés d'API d'entreprise et des tokens de services internes qui, une fois exposés, peuvent compromettre des applications métier critiques et fournir un accès non autorisé à des systèmes propriétaires et à des données clients sensibles.
Fonctionnalités
| Fonctionnalité | Prise en charge | Détails |
|---|---|---|
| Scan historique | ✅ (Pris en charge) | Analyser les images existantes et leurs couches |
| Scan incrémental | ✅ (Pris en charge) | Scan régulier planifié pour les nouveaux contenus |
| Périmètre surveillé | ✅ (Pris en charge) | Surveillance granulaire de vos dépôts |
| Périmètre d'équipe | ✅ (Pris en charge) | Contrôle d'accès basé sur les équipes |
| Vérification de présence | ❌ (Non pris en charge) | Toutes les occurrences considérées comme présentes |
| Visibilité de la source | ❌ (Non pris en charge) | Toutes les sources sont considérées comme privées |
| Pièces jointes | N/A | Non applicable pour les registres de conteneurs |
Ce que nous scannons :
- Toutes les couches d'images de conteneurs
- Les Dockerfiles et configurations de build
- Les variables d'environnement dans les métadonnées des images
Cette intégration scanne automatiquement vos dépôts surveillés, en téléchargeant les images de conteneurs, ce qui peut entraîner des coûts de bande passante. Pour optimiser les coûts et réduire les faux positifs, sélectionnez soigneusement les sources à surveiller et utilisez notre fonctionnalité d'exclusion de chemins de fichiers.
Prérequis de plan : Disponible pour le plan GitGuardian Enterprise. Essayez-le gratuitement avec une période d'essai de 30 jours - tous les incidents détectés restent accessibles après la fin de l'essai.
Couverture des détecteurs : Pour minimiser les faux positifs, Generic High Entropy Secret et Generic Password sont désactivés. Tous les autres détecteurs sont activés.
Comprendre les capacités de scan
Scan historique
Découvrez votre dette de secrets : lors de votre première intégration de cette source, GitGuardian effectue un scan complet de l'intégralité de l'historique de votre contenu, en fonction de votre périmètre personnalisé. Cela révèle des secrets qui ont pu être exposés il y a des semaines, des mois, voire des années — vous aidant ainsi à traiter votre dette de sécurité existante.
Comment déclencher un scan historique : rendez-vous sur votre page de périmètre, sélectionnez les sources que vous souhaitez scanner, puis cliquez sur Scan dans la barre d'actions groupées. Consultez Gérer votre périmètre surveillé pour connaître les limites de taille selon votre plan, la gestion des erreurs et tous les détails.
Scan incrémental
Restez protégé grâce à une surveillance régulière : une fois intégrée, GitGuardian assure une protection continue grâce à des scans automatisés planifiés de votre contenu. Le contenu nouveau et modifié est surveillé de manière systématique à intervalles réguliers, garantissant une couverture complète et une détection rapide de toute exposition de secret. Votre source reste sous la protection de GitGuardian, vous donnant l'assurance qu'aucun secret ne passera inaperçu.
Configurer votre intégration Red Hat Quay
Prérequis :
- Compte Owner ou Manager sur votre Dashboard GitGuardian
- Permissions Admin sur une organisation Red Hat Quay pour créer une OAuth Application
- Connectivité réseau entre GitGuardian et vos services self-hosted. Découvrez GitGuardian Bridge pour permettre des connexions sécurisées entre GitGuardian SaaS et vos services self-hosted dans des réseaux privés.
GitGuardian s'intègre à Red Hat Quay via OAuth2 avec un accès en lecture seule à vos dépôts.
Chaque installation couvre une instance Red Hat Quay, telle que quay.io ou votre Quay Self-Hosted. GitGuardian surveille les organisations que le compte qui l'autorise peut voir :
- Superutilisateur global en lecture seule (
GLOBAL_READONLY_SUPER_USERSouLDAP_GLOBAL_READONLY_SUPERUSER_FILTERdans la configuration de Quay) : toutes les organisations de l'instance - Tout autre compte, y compris un superutilisateur normal : les organisations dont il est membre d'équipe. GitGuardian se rabat également sur celles-ci lorsque l'API de superutilisateur est désactivée, ce qui est toujours le cas sur quay.io.
Un superutilisateur normal (SUPER_USERS ou LDAP_SUPERUSER_FILTER) ne donne pas à GitGuardian l'accès à l'ensemble de l'instance : Quay limite son token OAuth aux appartenances d'équipe du compte lui-même, et refuse de récupérer les images privées d'autres organisations.
Quay refuse l'autorisation à moins que le compte ne soit membre direct d'une équipe admin (par exemple, owners) de l'organisation propriétaire de l'OAuth Application. Cela s'applique également aux superutilisateurs globaux en lecture seule.
Les installations Red Hat Quay couvraient auparavant une seule organisation. Les nouvelles installations couvrent une instance entière, et vos installations d'organisations existantes continuent de fonctionner comme avant.
Si vous installez une instance où certaines organisations ont déjà leur propre installation, elles y restent : la nouvelle installation d'instance les ignore et ne surveille que les autres organisations.
Étape 1 : Créer une OAuth Application dans Quay
- Connectez-vous à votre instance Red Hat Quay (quay.io ou votre Quay Self-Hosted)
- Naviguez vers une Organization que vous administrez et allez dans Applications (sous Organization Settings)
- Cliquez sur Create New Application
- Donnez-lui un nom (par exemple,
GitGuardian) - Après la création, cliquez sur l'application pour la modifier
- Définissez la Homepage URL sur l'URL de votre dashboard GitGuardian (par exemple,
https://dashboard.gitguardian.com) - Définissez le Redirect/Callback URL Prefix sur :
Le formulaire d'installation de GitGuardian affiche l'URL exacte pour votre workspace.https://dashboard.gitguardian.com/api/v1/red-hat-quay-v2/install/callback/

- Enregistrez l'application et notez le Client ID et le Client Secret
Une OAuth Application créée auparavant peut encore utiliser /api/v1/red-hat-quay/install/callback/ comme préfixe. Mettez-la à jour avec l'URL ci-dessus avant d'installer ou de réautoriser : Quay refuse de rediriger vers toute autre URL.
Étape 2 : Connecter Red Hat Quay à GitGuardian
Connectez-vous d'abord à Red Hat Quay dans votre navigateur, avec le compte dont vous souhaitez surveiller les organisations (un superutilisateur global en lecture seule pour surveiller l'ensemble de l'instance). Ce compte doit être membre direct d'une équipe admin de l'organisation propriétaire de l'OAuth Application, même s'il s'agit d'un superutilisateur. Sinon, Quay affiche une page d'erreur au lieu de la page d'autorisation.
-
Dans la plateforme GitGuardian, naviguez vers la page intégration Sources
-
Cliquez sur Install à côté de Red Hat Quay dans la section Container registries
-
Sur la page intégration Red Hat Quay, le formulaire d'installation s'ouvre. Si vous avez déjà des installations, cliquez sur Install pour ajouter une autre instance.
-
Saisissez votre Instance URL, sans aucun chemin (par exemple,
https://quay.ioouhttps://quay.example.com) -
Collez l'OAuth Client ID de l'OAuth Application que vous avez créée
-
Collez l'OAuth Client Secret de l'OAuth Application que vous avez créée
-
Cochez I am signed in to Red Hat Quay in this browser
-
Cliquez sur Authorize
-
Dans la fenêtre modale Customize the monitored perimeter, choisissez ce que vous souhaitez surveiller et cliquez sur Ok, got it! :
- Monitor specific Red Hat Quay repositories (Recommandé)
- Aucun dépôt n'est surveillé par défaut, vous devrez les sélectionner manuellement.
- Les dépôts nouvellement créés ne seront pas surveillés par défaut. Vous pouvez ajuster ce paramètre à tout moment.
- Monitor the entire Red Hat Quay instance
- Tous les dépôts sont surveillés par défaut avec un scan historique complet déclenché automatiquement.
- Les dépôts nouvellement créés seront surveillés par défaut. Vous pouvez ajuster ce paramètre à tout moment.
- Monitor specific Red Hat Quay repositories (Recommandé)
-
Quay vous demande d'autoriser l'application, avec les permissions
View all visible repositoriesetRead User Information. Cliquez sur Authorize Application : Quay vous redirige vers GitGuardian.
C'est tout ! Votre instance Red Hat Quay est maintenant installée, et GitGuardian surveille toutes les images de conteneurs de vos dépôts sélectionnés à la recherche de secrets.
Personnaliser votre périmètre surveillé
Pour personnaliser les dépôts surveillés, naviguez vers vos paramètres Red Hat Quay.
- Dans le tableau Sources, sélectionnez les dépôts à inclure ou à exclure
- Cliquez sur Monitor ou Unmonitor
Les dépôts sont regroupés par organisation, puis par namespace : team/app/api se trouve dans le dossier team > app. Si vous déplacez un dépôt vers un autre namespace dans Quay, GitGuardian le voit comme une nouvelle source. L'ancienne source est retirée de votre périmètre mais conserve ses incidents.
Surveillance automatique des dépôts
Vous pouvez activer ou désactiver l'ajout automatique des dépôts nouvellement créés à votre périmètre surveillé avec le bouton bascule Automatically monitor new repositories dans vos paramètres Red Hat Quay.
Dépanner une installation
Le tableau Installations dans vos paramètres Red Hat Quay affiche le Status de chaque installation. Lorsqu'une installation est défectueuse, cliquez sur Troubleshoot pour en voir la cause, puis :
- Cliquez sur Check again pour les problèmes temporaires, tels qu'une instance ou un GitGuardian Bridge inaccessible, une limitation de débit, ou une erreur serveur
- Autorisez à nouveau GitGuardian lorsque Quay refuse son token, par exemple après la suppression de l'OAuth Application, ou lorsque le token ne voit plus aucune organisation. Saisissez l'OAuth Client ID et l'OAuth Client Secret, cochez I am signed in to Red Hat Quay in this browser, et cliquez sur Authorize. Pour une installation d'organisation, le formulaire affiche sa Namespace URL au lieu de l'Instance URL. Assurez-vous d'abord que l'application utilise la callback URL ci-dessus.
Gérer votre intégration
Surveillance de la santé et maintenance
Si vous devez modifier les paramètres de votre intégration ou résoudre des problèmes de connectivité, accédez à l'interface de gestion via Sources integration.
Désinstaller l'intégration
Bien que notre objectif soit de vous aider à maintenir une couverture de sécurité complète, vous pouvez désinstaller l'intégration chaque fois que nécessaire :
- Naviguez vers Sources integration
- Cliquez sur Edit à côté du nom de l'intégration
- Cliquez sur Configure
- Cliquez sur l'icône delete à côté de votre ressource
- Confirmez la suppression
Note : la suppression de l'intégration préserve votre historique d'incidents, mais arrête les analyses futures et les vérifications de présence pour les intégrations qui le supportent.
Chemins exclus
GitGuardian exclut automatiquement les fichiers de l'analyse si leurs chemins contiennent l'une de ces expressions régulières :
/__pypackages__/
/\.venv/
/\.tox/
/site-packages/
/venv/
distutils/command/register\.py
python.*/awscli/examples/
python.*/dulwich/(tests|contrib/test_)
python.*/hgext/bugzilla\.py
python.*/mercurial/util\.py
python.*/test/certdata/
python.*/urllib/request\.py
python.*/pygments/lexers/
/cryptography.+/tests/.+(fixtures|test)_.+\.py
/python.+pygpgme.+/tests/
botocore/data/.+/(examples|service)-.+\.json
usr(/local)?/lib/python.+/dist-packages
/libevent.+/info/test/test/
/conda-.+-py.+/info/test/tests.+/test_.+\.py
/python[^/]+/test/
/man/man5/kdc\.conf\.5
erlang.*(inets|ssl).*/examples/
/gems/.*httpclient.*/(test|sample)/
/gems/.*faraday.*/
/vendor/bundle/
/\.gem/
ruby-[^/]+/test/openssl/
/(g|G)o/src/cmd/go/internal/.*_test\.go
/(g|G)o/src/cmd/go/internal/.*/testdata/
/(g|G)o/src/cmd/go/testdata/
/(g|G)o/src/crypto/x509/platform_root_key\.pem
/(G|g)o/src/crypto/(tls|x509)/.*_test\.go
/(g|G)o/src/net/(url|http)/.*_test\.go
src/github.com/DataDog/datadog-agent/.*test.*\.go
google/internal/.*_test\.go
golang.org.*oauth2@.*/.*\.go
/flutter/.*/packages/flutter_tools/test/data/
/flutter/.*/examples/image_list/lib
/\.pub-cache
etc/ssl/private/ssl-cert-snakeoil\.key
perl.*Cwd\.pm
ansible/.*/tests/(integration|unit)/
ansible/.*/test/awx
ansible/collections/ansible_collections/.*/plugins/
/curl/.*/(tests|docs|lib/url\.c)
/doc/wget.+/NEWS
dist/awscli/examples/
usr(/local)?/lib/aws-cli/examples/
/google-cloud-sdk/(lib|platform)/
\.git/modules/third[-_]?party/
\.git/modules/external/
/\.npm/_cacache
/node_modules/
/\.parcel-cache/
/\.yarn/cache/
/\.m2/
/\.ivy2/cache/
/\.mix/
/\.hex/
/composer/cache/
/\.nuget/packages/
/libgpg-error/errorref\.txt
/Homebrew/Library/Taps/
/tcl[^/]+/http-.+\.tm
/tcl[^/]+/[^/]+/http-.+\.tm
usr/share/lua/[^/]+/posix/init\.lua
openssl/openssl-[^/]+/test/recipes/
usr/share/doc/libssl-doc/demos/
boringssl/src/third_party/[^/]+test[^/]+/[^/]+_test\.json
Considérations supplémentaires pour Self-Hosted
Pour les instances GitGuardian Self-Hosted, la fréquence de scan peut être configurée dans l'Admin Area :
- Unité d'intervalle de temps : secondes
- Valeur par défaut : 86400 (1 jour)
- Valeur minimale : 1800 (30 minutes)
Confidentialité et conformité
Gestion des données
GitGuardian traite vos données uniquement pour détecter les secrets exposés :
- Accès en lecture seule : nous ne demandons jamais l'accès en écriture sauf s'il est limité à la création de webhooks pour recevoir et traiter les événements en temps réel
- Rétention minimale des données : nous ne stockons que les données et métadonnées nécessaires à la gestion des incidents
- Chiffrement : toutes les données en transit et au repos sont chiffrées
- Conformité : nous suivons les mêmes standards de protection des données que nos autres intégrations
Considérations régionales
GitGuardian héberge ses services dans deux régions AWS : eu-central-1 (Francfort) et us-west-2 (Oregon). Assurez-vous que votre région de déploiement GitGuardian s'aligne avec vos exigences de résidence des données. Contactez le support si vous avez besoin de conseils sur la conformité aux réglementations locales.
Notification des utilisateurs
Les lois et réglementations spécifiques à chaque pays peuvent vous obliger à informer vos utilisateurs que vos dépôts sont scannés à la recherche de secrets. Voici une suggestion de message que vous pourriez utiliser :
Dans le cadre de notre processus interne de sécurité de l'information, l'entreprise scanne ses dépôts à la recherche de fuites potentielles de secrets à l'aide de GitGuardian. Toutes les données collectées seront traitées dans le but de détecter d'éventuelles fuites. Pour en savoir plus sur la façon dont nous gérons vos données personnelles et pour exercer vos droits, veuillez vous référer à notre notice de confidentialité pour les employés/partenaires.
Veuillez noter que seuls les dépôts relatifs à l'activité et aux affaires de l'entreprise peuvent être surveillés et que les utilisateurs doivent s'abstenir de partager des données personnelles ou sensibles non pertinentes pour l'objectif du dépôt.