paste.proxy – Proxy WSGI requests to HTTP requests

An application that proxies WSGI requests to a remote server.

TODO:

  • Send Via header? It’s not clear to me this is a Via in the style of a typical proxy.

  • Other headers or metadata? I put in X-Forwarded-For, but that’s it.

  • Signed data of non-HTTP keys? This would be for things like REMOTE_USER.

  • Something to indicate what the original URL was? The original host, scheme, and base path.

  • Rewriting Location headers? mod_proxy does this.

  • Rewriting body? (Probably not on this one – that can be done with a different middleware that wraps this middleware)

  • Example:

    use = egg:Paste#proxy
    address = http://server3:8680/exist/rest/db/orgs/sch/config/
    allowed_request_methods = GET

Module Contents

class paste.proxy.Proxy(address, allowed_request_methods=(), suppress_http_headers=())
paste.proxy.make_proxy(global_conf, address, allowed_request_methods='', suppress_http_headers='')

Make a WSGI application that proxies to another address:

address
the full URL ending with a trailing /
allowed_request_methods:
a space seperated list of request methods (e.g., GET POST)
suppress_http_headers
a space seperated list of http headers (lower case, without the leading http_) that should not be passed on to target host
class paste.proxy.TransparentProxy(force_host=None, force_scheme='http')

A proxy that sends the request just as it was given, including respecting HTTP_HOST, wsgi.url_scheme, etc.

This is a way of translating WSGI requests directly to real HTTP requests. All information goes in the environment; modify it to modify the way the request is made.

If you specify force_host (and optionally force_scheme) then HTTP_HOST won’t be used to determine where to connect to; instead a specific host will be connected to, but the Host header in the request will remain intact.

paste.proxy.make_transparent_proxy(global_conf, force_host=None, force_scheme='http')

Create a proxy that connects to a specific host, but does absolutely no other filtering, including the Host header.