ZoomEye Search - Metasploit

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

Module Overview

---

Name: ZoomEye Search
Module: auxiliary/gather/zoomeye_search
Source code: modules/auxiliary/gather/zoomeye_search.rb
Disclosure date: -
Last modification time: 2021-09-08 15:59:52 +0000
Supported architecture(s): -
Supported platform(s): -
Target service / protocol: -
Target network port(s): -
List of CVEs: -

The module use the ZoomEye API to search ZoomEye. ZoomEye is a search engine for cyberspace that lets the user find specific network components(ip, services, etc.).

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

---

msf > use auxiliary/gather/zoomeye_search
msf auxiliary(zoomeye_search) > show targets
    ... a list of targets ...
msf auxiliary(zoomeye_search) > set TARGET target-id
msf auxiliary(zoomeye_search) > show options
    ... show and set options ...
msf auxiliary(zoomeye_search) > exploit

Required Options

---

• USERNAME: The ZoomEye username

• PASSWORD: The ZoomEye password

• ZOOMEYE_DORK: The ZoomEye dork

Go back to menu.

Msfconsole Usage

---

Here is how the gather/zoomeye_search auxiliary module looks in the msfconsole:

msf6 > use auxiliary/gather/zoomeye_search

msf6 auxiliary(gather/zoomeye_search) > show info

       Name: ZoomEye Search
     Module: auxiliary/gather/zoomeye_search
    License: Metasploit Framework License (BSD)
       Rank: Normal

Provided by:
  Nixawk

Check supported:
  No

Basic options:
  Name          Current Setting  Required  Description
  ----          ---------------  --------  -----------
  MAXPAGE       1                yes       Max amount of pages to collect
  PASSWORD                       yes       The ZoomEye password
  RESOURCE      host             yes       ZoomEye Resource Type (Accepted: host, web)
  USERNAME                       yes       The ZoomEye username
  ZOOMEYE_DORK                   yes       The ZoomEye dork

Description:
  The module use the ZoomEye API to search ZoomEye. ZoomEye is a 
  search engine for cyberspace that lets the user find specific 
  network components(ip, services, etc.).

References:
  https://github.com/zoomeye/SDK
  https://www.zoomeye.org/api/doc
  https://www.zoomeye.org/help/manual

Module Options

---

This is a complete list of options available in the gather/zoomeye_search auxiliary module:

msf6 auxiliary(gather/zoomeye_search) > show options

Module options (auxiliary/gather/zoomeye_search):

   Name          Current Setting  Required  Description
   ----          ---------------  --------  -----------
   MAXPAGE       1                yes       Max amount of pages to collect
   PASSWORD                       yes       The ZoomEye password
   RESOURCE      host             yes       ZoomEye Resource Type (Accepted: host, web)
   USERNAME                       yes       The ZoomEye username
   ZOOMEYE_DORK                   yes       The ZoomEye dork

Advanced Options

---

Here is a complete list of advanced options supported by the gather/zoomeye_search auxiliary module:

msf6 auxiliary(gather/zoomeye_search) > show advanced

Module advanced options (auxiliary/gather/zoomeye_search):

   Name       Current Setting  Required  Description
   ----       ---------------  --------  -----------
   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 gather/zoomeye_search module can do:

msf6 auxiliary(gather/zoomeye_search) > show actions

Auxiliary actions:

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

Evasion Options

---

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

msf6 auxiliary(gather/zoomeye_search) > show evasion

Module evasion options:

   Name  Current Setting  Required  Description
   ----  ---------------  --------  -----------

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.

Grant Willcox

---

Here is a relevant code snippet related to the "Grant Willcox" error message:

27:	          Web search: app, header, keywords, desc, title, ip, site, city, country
28:	        },
29:	        'Author' => [
30:	          'Nixawk', # Original Author
31:	          'Yvain', # Initial improvements
32:	          'Grant Willcox' # Additional fixes to refine searches, improve quality of info saved and improve error handling.
33:	        ],
34:	        'References' => [
35:	          ['URL', 'https://github.com/zoomeye/SDK'],
36:	          ['URL', 'https://www.zoomeye.org/api/doc'],
37:	          ['URL', 'https://www.zoomeye.org/help/manual']

HTTP Connection Failed

---

Here is a relevant code snippet related to the "HTTP Connection Failed" error message:

86:	        'data' => data.to_json
87:	      })
88:	
89:	      res = @cli.send_recv(req)
90:	    rescue ::Rex::ConnectionError, Errno::ECONNREFUSED, Errno::ETIMEDOUT, Errno::ECONNRESET, Rex::ConnectionRefused
91:	      print_error('HTTP Connection Failed')
92:	      return
93:	    end
94:	
95:	    unless res
96:	      print_error('server_response_error')

server_response_error

---

Here is a relevant code snippet related to the "server_response_error" error message:

91:	      print_error('HTTP Connection Failed')
92:	      return
93:	    end
94:	
95:	    unless res
96:	      print_error('server_response_error')
97:	      return
98:	    end
99:	
100:	    records = ActiveSupport::JSON.decode(res.body)
101:	    access_token = records['access_token'] if records && records.key?('access_token')

HTTP Connection Failed

---

Here is a relevant code snippet related to the "HTTP Connection Failed" error message:

115:	        }
116:	      })
117:	
118:	      res = @cli.send_recv(req)
119:	    rescue ::Rex::ConnectionError, Errno::ECONNREFUSED, Errno::ETIMEDOUT, Errno::ECONNRESET, Rex::ConnectionRefused
120:	      print_error('HTTP Connection Failed')
121:	    end
122:	
123:	    unless res
124:	      print_error('server_response_error')
125:	      return

server_response_error

---

Here is a relevant code snippet related to the "server_response_error" error message:

119:	    rescue ::Rex::ConnectionError, Errno::ECONNREFUSED, Errno::ETIMEDOUT, Errno::ECONNRESET, Rex::ConnectionRefused
120:	      print_error('HTTP Connection Failed')
121:	    end
122:	
123:	    unless res
124:	      print_error('server_response_error')
125:	      return
126:	    end
127:	
128:	    # Invalid Token, Not enough segments
129:	    # Invalid Token, Signature has expired

401 Unauthorized. Your ZOOMEYE_APIKEY is invalid

---

Here is a relevant code snippet related to the "401 Unauthorized. Your ZOOMEYE_APIKEY is invalid" error message:

126:	    end
127:	
128:	    # Invalid Token, Not enough segments
129:	    # Invalid Token, Signature has expired
130:	    if res.body =~ /Invalid Token, /
131:	      fail_with(Failure::BadConfig, '401 Unauthorized. Your ZOOMEYE_APIKEY is invalid')
132:	    end
133:	    res.get_json_document
134:	  end
135:	
136:	  def match_records?(records)

Unable to resolve api.zoomeye.org

---

Here is a relevant code snippet related to the "Unable to resolve api.zoomeye.org" error message:

142:	    resource = datastore['RESOURCE']
143:	    maxpage = datastore['MAXPAGE']
144:	    facets = datastore['FACETS']
145:	    # check to ensure api.zoomeye.org is resolvable
146:	    unless zoomeye_resolvable?
147:	      print_error('Unable to resolve api.zoomeye.org')
148:	      return
149:	    end
150:	
151:	    @zoomeye_token = login(datastore['USERNAME'], datastore['PASSWORD'])
152:	    if @zoomeye_token.blank? || @zoomeye_token.nil?

Unable to login api.zoomeye.org

---

Here is a relevant code snippet related to the "Unable to login api.zoomeye.org" error message:

148:	      return
149:	    end
150:	
151:	    @zoomeye_token = login(datastore['USERNAME'], datastore['PASSWORD'])
152:	    if @zoomeye_token.blank? || @zoomeye_token.nil?
153:	      print_error('Unable to login api.zoomeye.org')
154:	      return
155:	    else
156:	      print_status('Logged in to zoomeye')
157:	    end
158:	

error

---

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

160:	    results = []
161:	    results[first_page] = dork_search(resource, dork, 1, facets)
162:	
163:	    if results[first_page].nil? || results[first_page]['total'].nil? || results[first_page]['total'] == 0
164:	      msg = 'No results.'
165:	      if !results[first_page]['error'].to_s.empty?
166:	        msg << " Error: #{results[first_page]['error']}"
167:	      end
168:	      print_error(msg)
169:	      return
170:	    end

Error: <VALUE>

---

Here is a relevant code snippet related to the "Error: <VALUE>" error message:

161:	    results[first_page] = dork_search(resource, dork, 1, facets)
162:	
163:	    if results[first_page].nil? || results[first_page]['total'].nil? || results[first_page]['total'] == 0
164:	      msg = 'No results.'
165:	      if !results[first_page]['error'].to_s.empty?
166:	        msg << " Error: #{results[first_page]['error']}"
167:	      end
168:	      print_error(msg)
169:	      return
170:	    end
171:	

Go back to menu.

Related Pull Requests

---

• #14696 Merged Pull Request: Zeitwerk rex folder
• #11524 Merged Pull Request: remove some random deregister_options from modules
• #8716 Merged Pull Request: Print_Status -> Print_Good (And OCD bits 'n bobs)
• #8663 Merged Pull Request: Fixed typo
• #8338 Merged Pull Request: Fix msf/core and self.class msftidy warnings

References

---

• CVE: Not available
• https://github.com/zoomeye/SDK
• https://www.zoomeye.org/api/doc
• https://www.zoomeye.org/help/manual

See Also

---

Check also the following modules related to this module:

• auxiliary/gather/browser_info
• auxiliary/gather/huawei_wifi_info
• auxiliary/gather/xymon_info
• auxiliary/scanner/afp/afp_server_info
• auxiliary/scanner/http/infovista_enum
• auxiliary/scanner/http/ntlm_info_enumeration
• auxiliary/scanner/http/wp_mobile_pack_info_disclosure
• auxiliary/scanner/kademlia/server_info
• auxiliary/scanner/misc/ib_service_mgr_info
• auxiliary/scanner/printer/printer_version_info
• auxiliary/scanner/quake/server_info
• auxiliary/scanner/sap/sap_icf_public_info
• auxiliary/scanner/sap/sap_router_info_request
• auxiliary/scanner/sap/sap_soap_rfc_system_info
• auxiliary/scanner/steam/server_info
• exploit/linux/http/dlink_dspw215_info_cgi_bof
• exploit/linux/misc/asus_infosvr_auth_bypass_exec
• exploit/linux/samba/setinfopolicy_heap
• exploit/multi/http/zpanel_information_disclosure_rce
• exploit/multi/local/magnicomp_sysinfo_mcsiwrapper_priv_esc
• exploit/windows/fileformat/adobe_collectemailinfo
• exploit/windows/games/mohaa_getinfo
• post/android/gather/sub_info
• post/hardware/automotive/getvinfo
• auxiliary/gather/censys_search
• auxiliary/gather/shodan_search
• auxiliary/gather/search_email_collector
• auxiliary/gather/searchengine_subdomains_collector
• auxiliary/scanner/elasticsearch/indices_enum
• auxiliary/scanner/http/elasticsearch_traversal
• auxiliary/scanner/upnp/ssdp_msearch

Authors

---

• Nixawk

Version

---

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

Go back to menu.