forwarded-http

Forwarded HTTP

Resolves RFC 7239 (Forwarded HTTP Extension), with fallback to all legacy & special Forward headers: X-Forwarded-*, X-Real-*, Fastly-Client-IP, X-Cluster-Client-IP, and others.

Focuses on resolving to the RFC standard and providing a consistent access to HTTP Forwarded Parameters: by, for, host, proto.

Install

npm install --save forwarded-http

API

forwarded(http.IncomingMessage)

var forwarded = require('forwarded-http')

var params = forwarded(req)

// the final proxied port before hitting this server
assert(params.port === '8000')

// an object with IPs as key with matching port used as value (if applicable) 
assert(params.for === { '0.0.0.1': '8000', '0.0.0.2': '8001' })

// the final proxied protocol before hitting this server
assert(params.proto === 'https')

// the proxied host
assert(params.host === 'foo.com')

// array of ports the client is connected through
assert(params.ports === ['8000', '8001'])

// array of IP addresses the client is connected through
assert(params.ips === ['0.0.0.1', '0.0.0.2'])

Support

Donations are welcome to help support the continuous development of this project.

License

MIT © Ahmad Nassri