NAME¶

Perlbal::Plugin::XFFExtras - Perlbal plugin that can optionally add an X-Forwarded-Port and/or X-Forwarded-Proto header to reverse proxied requests.

SYNOPSIS¶

    # in perlbal.conf
    LOAD XFFExtra
    CREATE POOL web
        POOL web ADD 10.0.0.1:80
    CREATE SERVICE proxy
        SET role                        = reverse_proxy
        SET listen                      = 0.0.0.0:80
        SET pool                        = web
        SET plugins             = XFFExtras
        SET send_backend_port   = yes
        SET send_backend_proto  = yes
    ENABLE proxy

DESCRIPTION¶

This plugin adds optional headers to be sent to backend servers in reverse proxy mode.

HEADERS¶

• X-Forwarded-Port

  This header will contain an integer value indicating the port that the peer connected to. This will correspond to the port number specified on the listen line of the perlbal service that initially handled the connection.

• X-Forwarded-Proto

  This header will contain a string indicating the protocol the client connected to perlbal via. Currently this will be either 'http' or 'https'.

AUTHOR¶

Jonathan Steinert, <hachi@kuiki.net>

COPYRIGHT AND LICENSE¶

Copyright (C) 2012 by Say Media Inc, <cpan@saymedia.com>

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.6 or, at your option, any later version of Perl 5 you may have available.