Aller au contenu principal

Proxy HTTP

GitGuardian vous permet de configurer un proxy HTTP pour le trafic sortant de l'application.

Cela inclut le trafic vers des services comme Replicated, Docker, les intégrations de messagerie et d'autres connexions externes. Pour plus de détails, consultez notre page Prérequis réseau.

attention
  • Vous devez ajouter 127.0.0.1,10.0.0.0/8 à la liste des exceptions de proxy NO_PROXY pour autoriser le trafic local et interne du cluster à travers le proxy (remplacez 10.0.0.0/8 par votre sous-réseau interne).
  • Vérifiez que les FQDN du proxy sont résolvables et accessibles au sein de votre cluster Kubernetes.
  • La spécification d'un mot de passe dans les URL de proxy est prise en charge.
  • GitGuardian peut être déployé avec des proxies HTTP et HTTPS. Pour le proxy HTTPS, il peut être nécessaire d'ajouter une autorité de certification (CA) afin que le certificat SSL du proxy soit approuvé. Ce processus garantit une communication sécurisée et fiable entre l'application et le proxy. Pour plus d'informations, veuillez consulter la section CA personnalisée.

Installation basée sur Helm​

Pour configurer un proxy pour le trafic HTTP(s) sortant, mettez à jour votre fichier Helm values en conséquence. Si vous utilisez une autorité de certification (CA) personnalisée, assurez-vous qu'elle est configurée à la fois sous replicated.privateCASecret et dans la configuration de l'application sous tls.customCa. Pour plus de détails, consultez la documentation CA personnalisée.

info

À partir de la version 2025.5.0, les URL de proxy sont toujours stockées en tant que Secret.

Utiliser un secret existant​

info

Le secret doit être présent avant l'installation de GitGuardian.

L'exemple suivant définira les clés http_proxy et https_proxy du Secret Kubernetes gim-proxy.

proxy:
noProxyHostNames:
- 127.0.0.1
- 10.0.0.0/8
existingSecret: 'gim-proxy'
existingSecretKeys:
httpProxyUrl: 'http_proxy' # Secret should contain: http://username:password@proxy.company.com:8080
httpsProxyUrl: 'https_proxy' # Secret should contain: https://username:password@proxy.company.com:8080

replicated:
privateCASecret: # optional if you are using a custom CA
name: custom-ca-secret-name
key: 'custom-ca.pem'
extraEnv:
- name: NO_PROXY
valueFrom:
configMapKeyRef:
name: gim-config
key: 'NO_PROXY'
- name: HTTP_PROXY
valueFrom:
secretKeyRef:
name: 'gim-proxy'
key: 'http_proxy' # Example: http://username:password@proxy.company.com:8080
- name: HTTPS_PROXY
valueFrom:
secretKeyRef:
name: 'gim-proxy'
key: 'https_proxy' # Example: https://username:password@proxy.company.com:8080

Utiliser des valeurs en ligne​

info

Lorsque vous utilisez cette méthode, le chart GitGuardian gérera pour vous le Secret Kubernetes contenant les URL de proxy.

proxy:
httpProxyUrl: 'http://proxy:8080'
httpsProxyUrl: 'http://proxy:8080'
noProxyHostNames:
- 127.0.0.1
- 10.0.0.0/8

Installation basée sur KOTS​

Dans la Console d'administration KOTS, vous pouvez configurer la ou les URL pour le trafic HTTP(s) sortant vers votre serveur proxy :

Services and components

Spécifique à l'embedded cluster​

Pour les installations sur embedded cluster, une configuration de proxy supplémentaire peut être requise au niveau du cluster pour gérer les récupérations d'images de conteneurs et les communications au niveau du système.

info

La configuration du proxy au niveau de l'embedded cluster gère le trafic au niveau du système (récupérations d'images de conteneurs, communications avec l'API Kubernetes), tandis que la configuration du proxy au niveau de l'application décrite ci-dessus gère le trafic de l'application GitGuardian (intégrations, notifications, etc.). Les deux peuvent être nécessaires selon votre environnement.

Pour la méthode d'installation sur embedded cluster, vous pouvez configurer les paramètres de proxy lors de l'installation.

Pour configurer un proxy HTTP sans authentification lors de l'installation :

LICENSE_ID=your_license
curl -f https://replicated.app/embedded/gitguardian/stable -H "Authorization: $LICENSE_ID" -o gitguardian.tgz
tar -xvzf gitguardian.tgz
sudo ./gitguardian install --license license.yaml \
--http-proxy http://proxy.example.com:8080 \
--https-proxy http://proxy.example.com:8080

Lorsque vous utilisez un proxy qui nécessite une authentification, vous pouvez inclure les identifiants dans l'URL du proxy :

sudo ./gitguardian install --license license.yaml \
--http-proxy http://username:password@proxy.example.com:8080 \
--https-proxy http://username:password@proxy.example.com:8080

Cependant, certains composants Kubernetes ne prennent pas en charge les proxies authentifiés. Si vous rencontrez des problèmes avec les récupérations d'images de conteneurs (comme des erreurs ImagePullBackOff), vous devrez peut-être appliquer la solution de contournement décrite ci-dessous.

Solution de contournement pour les problèmes de proxy authentifié

L'embedded cluster crée une configuration de proxy dans /etc/systemd/system/k0scontroller.service.d/http-proxy.conf. Pour contourner les problèmes d'authentification :

  1. Localisez le fichier de configuration du proxy :

    sudo cat /etc/systemd/system/k0scontroller.service.d/http-proxy.conf
  2. Modifiez le fichier pour préfixer les variables d'environnement avec CONTAINERD_ :

    sudo vi /etc/systemd/system/k0scontroller.service.d/http-proxy.conf
  3. Modifiez le fichier pour qu'il ressemble à ceci :

    [Service]
    Environment="CONTAINERD_HTTP_PROXY=http://username:password@proxy.example.com:8080"
    Environment="CONTAINERD_HTTPS_PROXY=http://username:password@proxy.example.com:8080"
    Environment="CONTAINERD_NO_PROXY=localhost,127.0.0.1,.cluster.local,.svc,10.244.0.0/16"
  4. Redémarrez le service du contrôleur k0s :

    sudo systemctl daemon-reload
    sudo systemctl restart k0scontroller
  5. Vérifiez la configuration du proxy en vous assurant que les pods peuvent récupérer les images et que la connectivité externe fonctionne :

    sudo ./gitguardian shell
    kubectl get pods -A
    kubectl run test-pod --image=curlimages/curl --rm -it --restart=Never -- curl -I https://www.gitguardian.com