rendr-proxy-adapter

Rendr RestAdapter for proxied APIs.

Raison d'etre

For some reason, rendr thinks that, by default, request headers and cookies should be ignored when the browser hits the server via the RestAdapter.

What this is

A custom version of the traditional RestAdapter that inherits all its functionality and also adds support for keeping the header and cookie context, which is useful, for instance, when there is a proxy between the client and the API.

What this is not

A cookie store. So, any security (encryption, decryption, yada yada) or management layer should be provided via the middleware you are using or the endpoint you plan to hit.

How to use

http://rendrjs.github.io/app/#config

For cookies

You can select which cookies to proxy by providing a list of cookie names. If you're a hipster, and you're using connect-cookies you are required to do that.

var rendr = require('rendr');
var ProxyAdapter = require('rendr-proxy-adapter')

var adapter = new ProxyAdapter({
    cookies: [
        'name',
        // whatevs
    ]
});

rendr.createServer({
  dataAdapter: adapter
  // whatevs
});

For all sorts of headers

Just provide the name of the headers you want to forward, like so:

var rendr = require('rendr');
var ProxyAdapter = require('rendr-proxy-adapter')

var adapter = new ProxyAdapter({
    // forward the "Host" header
    headers: ['host']
});

rendr.createServer({
    dataAdapter: adapter
    // whatevs
});

Configure headers per API

var rendr = require('rendr');
var ProxyAdapter = require('rendr-proxy-adapter')

var adapter = new ProxyAdapter({
    default: {
    	host: 'example.com,
    	headers: ['host']
    },
    github: {
    	host: 'api.github.com,
    	cookies: ['name']
    },
    travis: {
    	host: 'api.travis-ci.com
    }
});

rendr.createServer({
    dataAdapter: adapter
    // whatevs
});

Contributions

Issues and pull requests are welcome.