Trusted proxies

Lorsque l'agent redirection.io est utilisé comme reverse proxy, il est généralement déployé devant un ou plusieurs serveurs backend. Il peut également arrivé qu'il soit déployé derrière un load balancer ou un CDN. Dans ces différents cas, l'agent doit être configuré pour faire confiance aux proxies en amont qui lui transmettent les requêtes, afin d'identifier correctement l'adresse IP du client et d'autres informations qui seraient sinon perdues lorsque la requête est transmise à l'agent.

Le nœud de configuration trusted_proxies permet d'ajuster précisément le comportement des proxies de confiance :  * lister les adresses IP des proxies auxquels vous souhaitez faire confiance  * spécifier s'il faut ou non faire individuellement confiance aux headers Forwarded, X-Forwarded-For, X-Forwarded-Proto et X-Forwarded-Host envoyés par les proxies, qui sont couramment utilisés pour transmettre l'adresse IP du client et d'autres informations

Par exemple, avec la configuration suivante :

instance:
    name: 'My Instance'
reverse_proxy:
    listen:
        - 'tcp://0.0.0.0:80'
    trusted_proxies:
        ips:
            - 192.168.0.0/16
            - 172.16.0.16
        forwarded: true
        x_forwarded_for: true
        x_forwarded_host: false
        x_forwarded_proto: true
    forward:
        address: 'backend:8080'
    agent:
        project_key: my-project-key

Avec cette configuration, l'agent fera confiance aux headers Forwarded et X-Forwarded-For qui pourraient être transmis par les proxies aux adresses IP 172.16.0.16 ou dans la plage CIDR 192.168.0.0/16. Il fera également confiance au header X-Forwarded-Proto, mais pas au header X-Forwarded-Host.