Aller au contenu principal

IP réelle du client

Si votre application journalise la même IP interne pour plusieurs appelants, elle enregistre peut-être l'adresse de la gateway. L'IP d'origine peut pourtant être présente dans les en-têtes HTTP.

Comment l'adresse arrive à votre application​

Le trafic traverse un load balancer et une gateway Envoy avant d'atteindre votre conteneur :

Client → Load balancer → Gateway Envoy → Application

Chaque connexion a sa propre adresse source. La préservation de l'IP côté gateway et sa lecture par l'application se configurent séparément :

ConnexionTransport de l'IP clientConfiguration nécessaire
Load balancer → gatewayProtocole PROXYPréservation de l'IP client sur la gateway
Gateway → application HTTPEn-tête X-Forwarded-ForProxies de confiance dans l'application
Gateway → application TCP, comme MQTTProtocole PROXY, lorsqu'il est configuréTransmission par la gateway et listener applicatif compatible

L'option d'IP cliente de la gateway lui permet d'identifier les appelants pour ses règles d'accès et ses logs. La connexion reçue par votre conteneur provient toujours d'Envoy. En HTTP, configurez votre framework pour retrouver l'IP client à partir des en-têtes transmis par les proxies de confiance. Ce comportement est décrit dans les paramètres du protocole PROXY d'Envoy.

Applications HTTP : Express et NestJS​

Par défaut, Express utilise trust proxy: false : req.ip contient alors l'adresse de la connexion directe. Configurez les proxies de confiance avant les middlewares de journalisation et de limitation des requêtes. L'adresse résolue est accessible dans req.ip ; req.socket.remoteAddress continue d'identifier le pair direct. Voir la documentation Express sur les proxies.

Si votre application lit HTTP_TRUSTED_PROXIES, renseignez une liste d'IP ou de CIDR de proxies de confiance, séparés par des virgules, dans ses variables d'environnement. Les adresses ci-dessous sont des exemples de documentation : remplacez-les par celles des proxies autorisés pour votre gateway.

HTTP_TRUSTED_PROXIES=192.0.2.10/32,192.0.2.11/32

HTTP_TRUSTED_PROXIES est une convention applicative, pas un réglage intégré à SailOps ou Express. Ajouter la variable n'a d'effet que si votre code la lit. Voici un exemple pour Express :

const trustedProxies = (process.env.HTTP_TRUSTED_PROXIES ?? '')
.split(',')
.map(value => value.trim())
.filter(Boolean);

app.set('trust proxy', trustedProxies.length > 0 ? trustedProxies : false);

Pour NestJS avec l'adaptateur Express, utilisez la même liste et remplacez la dernière ligne par :

app.getHttpAdapter().getInstance().set(
'trust proxy',
trustedProxies.length > 0 ? trustedProxies : false,
);

Redéployez l'application après avoir modifié son environnement. Utilisez req.ip pour les logs d'IP cliente et les limites par client.

Choisir les proxies de confiance​

Utilisez les adresses des proxies côté application, pas l'adresse publique du load balancer. Incluez toutes les répliques. Les IP individuelles des pods peuvent changer lorsqu'ils sont recréés : une liste copiée depuis les pods actuels doit donc être maintenue. Contactez le support pour confirmer les adresses ou les plages dédiées adaptées à votre environnement.

Ne faites pas confiance à tout le réseau du cluster et ne passez pas trust proxy à true simplement pour changer les logs. Limitez la confiance aux proxies qui transmettent réellement les requêtes. Si un CDN ou un autre proxy est présent, vérifiez toute la chaîne avant d'élargir cette confiance.

Le groupe prédéfini uniquelocal d'Express n'inclut pas 100.64.0.0/10, où peuvent se trouver des pods de gateway. Vérifiez les adresses sources réelles plutôt que de supposer qu'un groupe d'adresses privées les couvre.

Vérifier le résultat​

  1. Envoyez des requêtes depuis deux réseaux dont les IP publiques de sortie sont différentes.
  2. Comparez req.ip, req.socket.remoteAddress et X-Forwarded-For dans les logs applicatifs de ces requêtes.
  3. Vérifiez que req.ip identifie les appelants, tandis que l'adresse de la connexion reste celle d'une gateway. Des appelants derrière le même NAT peuvent légitimement partager une IP.
ObservationVérification à effectuer
X-Forwarded-For varie, mais req.ip reste l'IP de la gatewayConfiguration des proxies de confiance, environnement chargé par l'application et prise en compte de toutes les répliques de la gateway
req.ip est correct, mais l'IP journalisée est incorrecteVérifier si le logger lit l'adresse de la socket au lieu de celle résolue par le framework
L'en-tête est absent ou ne contient qu'une adresse intermédiairePréservation de l'IP côté gateway et présence d'un CDN ou d'un proxy supplémentaire sur le trajet

Pour un diagnostic côté gateway, transmettez au support le projet, la gateway, l'horodatage et l'identifiant de requête si disponible. Comparer la même requête dans les logs de la gateway et de l'application permet de repérer où l'adresse change.

MQTT et autres protocoles TCP​

MQTT sur TCP n'a pas d'en-tête X-Forwarded-For. Le réglage des proxies de confiance HTTP n'a aucun effet sur ce trafic.

La préservation de l'adresse à l'entrée de la gateway ne couvre que la connexion entre le load balancer et la gateway. Pour transmettre l'adresse à une application TCP, Envoy doit aussi envoyer le protocole PROXY au backend, et le listener qui reçoit la connexion doit le prendre en charge et n'accepter ses informations que depuis des proxies de confiance. Envoy dispose pour cela de paramètres PROXY distincts vers le backend.

Coordonnez cette configuration avec le support et vérifiez d'abord la compatibilité de votre broker. Envoyer un en-tête PROXY à un listener qui attend immédiatement des données MQTT peut interrompre les connexions.