ElasticSearch Indices Enumeration Utility - Metasploit


This page contains detailed information about how to use the auxiliary/scanner/elasticsearch/indices_enum metasploit module. For list of all metasploit modules, visit the Metasploit Module Library.

Module Overview


Name: ElasticSearch Indices Enumeration Utility
Module: auxiliary/scanner/elasticsearch/indices_enum
Source code: modules/auxiliary/scanner/elasticsearch/indices_enum.rb
Disclosure date: -
Last modification time: 2017-07-24 06:26:21 +0000
Supported architecture(s): -
Supported platform(s): -
Target service / protocol: http, https
Target network port(s): 80, 443, 3000, 8000, 8008, 8080, 8443, 8880, 8888, 9200
List of CVEs: -

This module enumerates ElasticSearch Indices. It uses the REST API in order to make it.

Module Ranking and Traits


Module Ranking:

  • normal: The exploit is otherwise reliable, but depends on a specific version and can't (or doesn't) reliably autodetect. More information about ranking can be found here.

Basic Usage


This module is a scanner module, and is capable of testing against multiple hosts.

msf > use auxiliary/scanner/elasticsearch/indices_enum
msf auxiliary(indices_enum) > show options
    ... show and set options ...
msf auxiliary(indices_enum) > set RHOSTS ip-range
msf auxiliary(indices_enum) > exploit

Other examples of setting the RHOSTS option:

Example 1:

msf auxiliary(indices_enum) > set RHOSTS 192.168.1.3-192.168.1.200 

Example 2:

msf auxiliary(indices_enum) > set RHOSTS 192.168.1.1/24

Example 3:

msf auxiliary(indices_enum) > set RHOSTS file:/tmp/ip_list.txt

Required Options


  • RHOSTS: The target host(s), range CIDR identifier, or hosts file with syntax 'file:<path>'

Knowledge Base


Description


This module identifies a list of indices which an Elasticsearch NoSQL database has. This occurs over the REST API, which on community versions is an unauthenticated API. Customers who subscribe to a support plan can add authentication to this API restricting access.

Vulnerable Application


Install Elasticsearch on Kali Linux:

With this install, we'll install the free community edition of Elasticsearch, which does not require authentication to the API. However, this is unrealistic in a production environment which will often leverage a support contract to gain authentication, a reverse proxy to add basic authentication, and/or a host firewall to restrict access to this API.

The following instructions assume you are beginning with a fresh Kali installation as the root user.

  1. useradd -M -r elasticsearch
  2. su elasticsearch
  3. cd /tmp
  4. curl -L -O https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-6.3.2.tar.gz
  5. tar -xvf elasticsearch-6.3.2.tar.gz
  6. cd elasticsearch-6.3.2/bin
  7. ./elasticsearch
  8. Open a new terminal
  9. In the new terminal, curl -X PUT http://127.0.0.1:9200/msf_test to create an index for validation purposes

Verification Steps


  1. use auxiliary/scanner/elasticsearch/indices_enum
  2. set RHOSTS [ips]
  3. set RPORT [port]
  4. run

Scenarios


Elasticsearch 6.3.2 on Kali Linux

msf > use auxiliary/scanner/elasticsearch/indices_enum
msf auxiliary(scanner/elasticsearch/indices_enum) > set RHOSTS 10.10.10.25
RHOSTS => 10.10.10.25
msf auxiliary(scanner/elasticsearch/indices_enum) > run

[+] ElasticSearch Indices found: msf_test
[*] Scanned 1 of 1 hosts (100% complete)
[*] Auxiliary module execution completed

Confirming


elasticsearch

# curl 'http://10.10.10.25:9200/_cat/indices?v'
health status index    uuid                   pri rep docs.count docs.deleted store.size pri.store.size
yellow open   msf_test W83_cAS1QlmePnczS9sLrA   5   1          0            0      1.2kb          1.2kb

Go back to menu.

Msfconsole Usage


Here is how the scanner/elasticsearch/indices_enum auxiliary module looks in the msfconsole:

msf6 > use auxiliary/scanner/elasticsearch/indices_enum

msf6 auxiliary(scanner/elasticsearch/indices_enum) > show info

       Name: ElasticSearch Indices Enumeration Utility
     Module: auxiliary/scanner/elasticsearch/indices_enum
    License: Metasploit Framework License (BSD)
       Rank: Normal

Provided by:
  Silas Cutler <[email protected]>

Check supported:
  No

Basic options:
  Name     Current Setting  Required  Description
  ----     ---------------  --------  -----------
  Proxies                   no        A proxy chain of format type:host:port[,type:host:port][...]
  RHOSTS                    yes       The target host(s), range CIDR identifier, or hosts file with syntax 'file:<path>'
  RPORT    9200             yes       The target port (TCP)
  SSL      false            no        Negotiate SSL/TLS for outgoing connections
  THREADS  1                yes       The number of concurrent threads (max one per host)
  VHOST                     no        HTTP server virtual host

Description:
  This module enumerates ElasticSearch Indices. It uses the REST API 
  in order to make it.

Module Options


This is a complete list of options available in the scanner/elasticsearch/indices_enum auxiliary module:

msf6 auxiliary(scanner/elasticsearch/indices_enum) > show options

Module options (auxiliary/scanner/elasticsearch/indices_enum):

   Name     Current Setting  Required  Description
   ----     ---------------  --------  -----------
   Proxies                   no        A proxy chain of format type:host:port[,type:host:port][...]
   RHOSTS                    yes       The target host(s), range CIDR identifier, or hosts file with syntax 'file:<path>'
   RPORT    9200             yes       The target port (TCP)
   SSL      false            no        Negotiate SSL/TLS for outgoing connections
   THREADS  1                yes       The number of concurrent threads (max one per host)
   VHOST                     no        HTTP server virtual host

Advanced Options


Here is a complete list of advanced options supported by the scanner/elasticsearch/indices_enum auxiliary module:

msf6 auxiliary(scanner/elasticsearch/indices_enum) > show advanced

Module advanced options (auxiliary/scanner/elasticsearch/indices_enum):

   Name                  Current Setting                                     Required  Description
   ----                  ---------------                                     --------  -----------
   DOMAIN                WORKSTATION                                         yes       The domain to use for Windows authentication
   DigestAuthIIS         true                                                no        Conform to IIS, should work for most servers. Only set to false for non-IIS servers
   FingerprintCheck      true                                                no        Conduct a pre-exploit fingerprint verification
   HttpClientTimeout                                                         no        HTTP connection and receive timeout
   HttpPassword                                                              no        The HTTP password to specify for authentication
   HttpRawHeaders                                                            no        Path to ERB-templatized raw headers to append to existing headers
   HttpTrace             false                                               no        Show the raw HTTP requests and responses
   HttpTraceColors       red/blu                                             no        HTTP request and response colors for HttpTrace (unset to disable)
   HttpTraceHeadersOnly  false                                               no        Show HTTP headers only in HttpTrace
   HttpUsername                                                              no        The HTTP username to specify for authentication
   SSLVersion            Auto                                                yes       Specify the version of SSL/TLS to be used (Auto, TLS and SSL23 are auto-negotiate) (Accepted: Auto, TLS, SSL23, SSL3, TLS1, TLS1.1, TLS1.2)
   ShowProgress          true                                                yes       Display progress messages during a scan
   ShowProgressPercent   10                                                  yes       The interval in percent that progress should be shown
   UserAgent             Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1)  no        The User-Agent header to use for all requests
   VERBOSE               false                                               no        Enable detailed status messages
   WORKSPACE                                                                 no        Specify the workspace for this module

Auxiliary Actions


This is a list of all auxiliary actions that the scanner/elasticsearch/indices_enum module can do:

msf6 auxiliary(scanner/elasticsearch/indices_enum) > show actions

Auxiliary actions:

   Name  Description
   ----  -----------

Evasion Options


Here is the full list of possible evasion options supported by the scanner/elasticsearch/indices_enum auxiliary module in order to evade defenses (e.g. Antivirus, EDR, Firewall, NIDS etc.):

msf6 auxiliary(scanner/elasticsearch/indices_enum) > show evasion

Module evasion options:

   Name                          Current Setting  Required  Description
   ----                          ---------------  --------  -----------
   HTTP::header_folding          false            no        Enable folding of HTTP headers
   HTTP::method_random_case      false            no        Use random casing for the HTTP method
   HTTP::method_random_invalid   false            no        Use a random invalid, HTTP method for request
   HTTP::method_random_valid     false            no        Use a random, but valid, HTTP method for request
   HTTP::pad_fake_headers        false            no        Insert random, fake headers into the HTTP request
   HTTP::pad_fake_headers_count  0                no        How many fake headers to insert into the HTTP request
   HTTP::pad_get_params          false            no        Insert random, fake query string variables into the request
   HTTP::pad_get_params_count    16               no        How many fake query string variables to insert into the request
   HTTP::pad_method_uri_count    1                no        How many whitespace characters to use between the method and uri
   HTTP::pad_method_uri_type     space            no        What type of whitespace to use between the method and uri (Accepted: space, tab, apache)
   HTTP::pad_post_params         false            no        Insert random, fake post variables into the request
   HTTP::pad_post_params_count   16               no        How many fake post variables to insert into the request
   HTTP::pad_uri_version_count   1                no        How many whitespace characters to use between the uri and version
   HTTP::pad_uri_version_type    space            no        What type of whitespace to use between the uri and version (Accepted: space, tab, apache)
   HTTP::uri_dir_fake_relative   false            no        Insert fake relative directories into the uri
   HTTP::uri_dir_self_reference  false            no        Insert self-referential directories into the uri
   HTTP::uri_encode_mode         hex-normal       no        Enable URI encoding (Accepted: none, hex-normal, hex-noslashes, hex-random, hex-all, u-normal, u-all, u-random)
   HTTP::uri_fake_end            false            no        Add a fake end of URI (eg: /%20HTTP/1.0/../../)
   HTTP::uri_fake_params_start   false            no        Add a fake start of params to the URI (eg: /%3fa=b/../)
   HTTP::uri_full_url            false            no        Use the full URL for all HTTP requests
   HTTP::uri_use_backslashes     false            no        Use back slashes instead of forward slashes in the uri
   HTTP::version_random_invalid  false            no        Use a random invalid, HTTP version for request
   HTTP::version_random_valid    false            no        Use a random, but valid, HTTP version for request

Go back to menu.

Error Messages


This module may fail with the following error messages:

Check for the possible causes from the code snippets below found in the module source code. This can often times help in identifying the root cause of the problem.

Unable to establish connection


Here is a relevant code snippet related to the "Unable to establish connection" error message:

34:	      res = send_request_raw({
35:	        'uri'     => '/_aliases',
36:	        'method'  => 'GET',
37:	      })
38:	    rescue ::Rex::ConnectionRefused, ::Rex::HostUnreachable
39:	      vprint_error("Unable to establish connection")
40:	      return
41:	    end
42:	
43:	    if res && res.code == 200 && res.body.length > 0
44:	      begin

Unable to parse JSON


Here is a relevant code snippet related to the "Unable to parse JSON" error message:

42:	
43:	    if res && res.code == 200 && res.body.length > 0
44:	      begin
45:	        json_body = JSON.parse(res.body)
46:	      rescue JSON::ParserError
47:	        vprint_error("Unable to parse JSON")
48:	        return
49:	      end
50:	    else
51:	      vprint_error("Timeout or unexpected response...")
52:	      return

Timeout or unexpected response...


Here is a relevant code snippet related to the "Timeout or unexpected response..." error message:

46:	      rescue JSON::ParserError
47:	        vprint_error("Unable to parse JSON")
48:	        return
49:	      end
50:	    else
51:	      vprint_error("Timeout or unexpected response...")
52:	      return
53:	    end
54:	
55:	    report_service(
56:	      :host  => rhost,

Go back to menu.


Go back to menu.

See Also


Check also the following modules related to this module:

Authors


  • Silas Cutler <Silas.Cutler[at]BlackListThisDomain.com>

Version


This page has been produced using Metasploit Framework version 6.2.23-dev. For more modules, visit the Metasploit Module Library.

Go back to menu.