Graham Barr > Plack-Middleware-XForwardedFor-0.103060 > Plack::Middleware::XForwardedFor

Download:
Plack-Middleware-XForwardedFor-0.103060.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.103060   Source  

NAME ^

Plack::Middleware::XForwardedFor - Plack middleware to handle X-Forwarded-For headers

VERSION ^

version 0.103060

SYNOPSIS ^

  builder {
    enable "Plack::Middleware::XForwardedFor",
      trust => [qw(127.0.0.1/8)];
  };

DESCRIPTION ^

Plack::Middleware::XForwardedFor will look for X-Forwarded-For header in the incomming request and change REMOTE_ADDR to the real client IP

PARAMETERS ^

trust

If not spcified then all addressed are trusted and REMOTE_ADDR will be set to the first IP in the X-Forwarded-For header.

If given, it should be a list of IPs or Netmasks that can be trusted. Starting with the IP of the client in REMOTE_ADDR then the IPs in the X-Forwarded-For header from right to left. The first untrusted IP found is set to be REMOTE_ADDR

SEE ALSO ^

Plack::Middleware, Net::Netmask

AUTHOR ^

Graham Barr <gbarr@cpan.org>

COPYRIGHT AND LICENSE ^

This software is copyright (c) 2010 by Graham Barr.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

syntax highlighting: