Ticket #11877: patch_11877.diff

docs/ref/request-response.txt

@@ -202 +202 @@
 
    Example: ``"127.0.0.1:8000"``
 
+   Warning: The ``get_host()`` method fails when the host is behind multiple
+   proxies. Specific middleware can be used to work around this problem, like so::
+
+      class MultipleProxyMiddleware(object):
+         FORWARDED_FOR_FIELDS = [ 
+         'HTTP_X_FORWARDED_FOR',
+         'HTTP_X_FORWARDED_HOST',
+         'HTTP_X_FORWARDED_SERVER',
+         ]
+         
+         def process_request(self, request):
+            """
+            This middleware rewrites these proxy headers so that only the most
+            recent proxy is used.
+            """
+            for field in self.FORWARDED_FOR_FIELDS:
+               if field in request.META:
+                  if ',' in request.META[field]:
+                     parts = request.META[field].split(',')
+                     request.META[field] = parts[-1].strip()
+
+
 .. method:: HttpRequest.get_full_path()
 
    Returns the ``path``, plus an appended query string, if applicable.