James McFadden {web developer}

Securing Elasticsearch with Nginx

Utilising Elasticsearch is a great way to provide full-text search capabilities to any application through a familiar RESTful interface. However, by default it doesn’t come with any way to enforce security, so this is left up to the developer.

There are few ways in which this can be done, including through the use of various dedicated plugins. I, along with others, feel that a more flexible and scalable approach is to use Nginx to provide a layer of authentication in front of Elasticsearch.

Thanks to some helpful posts, I managed to get a simple implementation working, so I thought I’d document it here.

Let’s begin with Nginx. Here is the configuration file in it’s simplest form. This is made available in /etc/nginx/sites-enabled/elastic (Debian/ Ubuntu):

# Block default
server {
        listen 80;
        return 301;

# Forward port <port_number> to elasticsearch
server {

    listen *:<port_number>;

    location / {
        auth_basic "Restricted";
        auth_basic_user_file /var/data/nginx-elastic/.htpasswd;

        proxy_read_timeout 90;

It’s pretty obvious whats going on here. We return a 301 for anything that hits the server on port 80. For requests made on <port_number>, we have enabled HTTP basic authentication which, upon success, will proxy to the Elasticsearch server. This can act as a good base for further configuration. We could, for example, require different levels of authentication for different Elasticsearch endpoints/ indices by providing additional location declartions. For example: location ~ ^/.*/_search$. Consult the Nginx documentation for more information.

The apache2-utils Debian package was used to generate the HTTP credentials:

$ sudo apt-get install apache2-utils
$ sudo htpasswd -c /var/data/nginx-elastic/.htpasswd myusername

# Enter password when prompted

# Restart Nginx
$ sudo service nginx restart

Check everything works so far:

# Returns a 301
$ curl <server_ip>

# Returns 401 Authorization Required
$ curl <server_ip>:<port_number>

# Returns Elasticsearch output
$ curl <username>:<password>@<server_ip>:<port_number>

The last thing to do is restrict Elasticsearch to localhost; at the moment we could still access Elasticsearch by hitting port 9200:

$ curl <ip_address>:9200

To do this, edit elasticsearch.yml and change/ insert as necessary:


# Restart Elasticsearch
$ sudo service elasticsearch restart

This will force Elasticsearch to run on the local machine only; it will not be accessible from the wild.

Let’s check that works:

# Should fail/ connection refused
$ curl <ip_address>:9200

That should be all you need for now. Of course you take this further by managing iptables to restrict ports even more if need be, but this is a good start!

comments powered by Disqus