heroku-proxy

2.1.1 • Public • Published

heroku-proxy

heroku-proxy provides a proxy to the Heroku API for express apps. It is intended for use with node-heroku-bouncer.

Install

$ npm install heroku-proxy --save

Use

heroku-proxy assumes that it has the node-heroku-bouncer middleware in front of it. See the node-heroku-bouncer README for configuration instructions.

var express     = require('express');
var herokuProxy = require('heroku-proxy');
var app         = express();
 
// ...set up heroku-bouncer
 
app.use(herokuProxy());

By default, heroku-proxy will proxy all requests to /api/* of any method to api.heroku.com via https. You can override the default options by passing an object into the function returned by the heroku-proxy module:

app.use(herokuProxy({
  hostname: 'localhost',
  port    : 5001,
  prefix  : 'heroku-api',
  protocol: 'http'
}));

Now, a request to /heroku-api/apps will be proxied to http://localhost:5001/apps.

Options

Option Effect Default
log Log request details false
hostname The hostname to proxy requests to api.heroku.com
port The port on API host 443
prefix A prefix path where your Express app will be listening for API requests api
protocol The protocol to use https
whitelistHeaders Additional headers to whitelist to pass through to the API []
headerTransforms An object of keys (from) and values (to) to transform request headers before being sent to the API {}

Test

$ npm test

Readme

Keywords

Package Sidebar

Install

npm i heroku-proxy

Weekly Downloads

8

Version

2.1.1

License

MIT

Last publish

Collaborators

  • jackca