Tomas Doran > Catalyst-TraitFor-Request-ProxyBase-0.000005 > Catalyst::TraitFor::Request::ProxyBase

Download:
Catalyst-TraitFor-Request-ProxyBase-0.000005.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  0
View/Report Bugs
Module Version: 0.000005   Source  

NAME ^

Catalyst::TraitFor::Request::ProxyBase - Replace request base with value passed by HTTP proxy

SYNOPSIS ^

    package MyApp;
    use Moose;
    use namespace::autoclean;

    use Catalyst;
    use CatalystX::RoleApplicator;

    extends 'Catalyst';

    __PACKAGE__->apply_request_class_roles(qw/
        Catalyst::TraitFor::Request::ProxyBase
    /);

    __PACKAGE__->setup;

DESCRIPTION ^

This module is a Moose::Role which allows you more flexibility in your application's deployment configurations when deployed behind a proxy.

The problem is that there is no standard way for a proxy to tell a backend server what the original URI for the request was, or if the request was initially SSL. (Yes, I do know about X-Forwarded-Host, but they don't do enough)

This creates an issue for someone wanting to deploy the same cluster of application servers behind various URI endpoints.

Using this module, the request base ($c->req->base) is replaced with the contents of the X-Request-Base header, which is expected to be a full URI, for example:

    http://example.com
    https://example.com
    http://other.example.com:81/foo/bar/yourapp

This value will then be used as the base for uris constructed by $c->uri_for.

In addition the request uri ($c->req->uri) will reflect the scheme and path specifed in the header.

REQUIRED METHODS ^

base
secure

WRAPPED METHODS ^

base
secure

APACHE SETUP ^

On the frontend Proxy Apache, you would want to enable a Virtualhost config somewhat like this. The backend apache config stays unchanged.

    <Virtualhost *:80>
        ProxyRequests Off

        <Location /preview>
            # You must have mod_headers enabled for that
            # RequestHeader set X-Request-Base /preview
            RequestHeader set X-Request-Base http://www.example.com/preview
        </Location>

        ProxyPass /preview http://my.vpn.host/
        ProxyPassReverse /preview http://my.vpn.host/
    </Virtualhost>

BUGS ^

Probably. Patches welcome, please fork from:

    http://github.com/bobtfish/catalyst-traitfor-request-proxybase

and send a pull request.

AUTHORS ^

Tomas Doran (t0m) <bobtfish@bobtfish.net>

CONTRIBUTORS ^

Klaus Ita (koki) <klaus@worstofall.com>

COPYRIGHT ^

This module is Copyright (c) 2009 Tomas Doran and is licensed under the same terms as perl itself.

syntax highlighting: