solr-proxy

solr-proxy

Reverse proxy to make a Solr instance read-only, rejecting requests that have the potential to modify the Solr index.

This is a rewrite of solr-security-proxy with some bug fixes and additional features.

Installation

For use from the command line:

npm install -g solr-proxy

For use in another application:

npm install solr-proxy

Usage

From the command-line:

solr-proxy

Options are:

Options:
  --port           Listen on this port                 [default: 8008]
  --backendPort    Solr backend port                   [default: 8983]
  --backendHost    Solr backend host                   [default: "localhost"]
  --validPaths     Allowed paths (comma delimited)     [default: "/solr/select"]
  --invalidParams  Blocked parameters (comma           [default: "qt,stream"]
                   delimited)
  --validMethods   Allowed HTTP methods (comma         [default: "GET"]
                   delimited)
  --maxRows        Maximum rows permitted in a request [default: 200]
  --maxStart       Maximum start offset permitted in a [default: 1000]
                   request
  --quiet, -q      Do not write messages to STDOUT
  --version, -v    Show version
  --help, -h       Show this message

To start the server from your application:

var SolrProxy = require('solr-proxy');
SolrProxy.start();

You can pass a port number as the first argument to start(). You may pass a falsy value (such as null or undefined) if you wish to use the port number specified specified in the listenPort property in the options object (second argument). If the port is not specified in either argument, the default value of 8008 is used.

You can pass an options object as the second argument to start().

var defaultOptions = {
  validHttpMethods: ['GET'],        // all other HTTP methods will be disallowed
  validPaths: ['/solr/select'],     // all other paths will be denied
  invalidParams: ['qt', 'stream'],  // blocks requests with params qt or stream.* (all other params are allowed)
  backend: {                        // proxy to solr at this location
    host: 'localhost',
    port: 8080
  }
};

To enable TLS for your proxy, include an ssl object within the options object.

var options = {
  ssl: {
    key: fs.readFileSync('key.pem'),
    cert: fs.readFileSync('cert.pem'),
  }
};
var proxy = SolrProxy.start(null, options);

To enable verbose logging, set environment variable DEBUG to include solr-proxy.

Default Rules

solr-proxy has the following default rules:

• Reject any request methods other than GET
• Only allow the /solr/select path
• Block requests with qt and stream.* query parameters.
• Reject requests with rows set to more than 200.
• Reject requests with start set to more than 1000.

License

MIT

Related Reading

• Why use a Solr proxy?
• Solr Security Resources

Changelog

6.0.0 (2021-05-09)

chore

• drop support for 10.x (7ba92b6)

BREAKING CHANGES

• drop support for Node.js 10.x