Perlbal::Plugin::XFFExtras(3p)

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.