【超详细 | 钟馗之眼】ZoomEye-python命令行的使用

0x00 前言

    ZoomEye-python是一款基于 ZoomEye API 开发的 Python 库，提供了 ZoomEye 命令行模式，同时也可以作为 SDK集成到其他工具中。该库可以让技术人员更便捷地搜索、筛选、导出ZoomEye 的数据。

这里说一下ico图标搜索，因为我平时会经常用所以···

每个网站标签都有自己的ico图标

在对指定目标收集资产外围打点的时候这个会是一个很有用的点

通过搜索网站ico也会有意想不到的收获

重点是不需要高级账号也能查询

重点是不需要高级账号也能查询

重点是不需要高级账号也能查询

渗透的本质就是信息收集

在实战中你资产收集的多少决定你攻击面的大小

多了不说你细品接下来介绍一下命令行版本的ZoomEye搜索引擎

0x01 安装步骤

可直接从 pypi进行安装：

也可以通过github 进行安装：

0x02 使用cli

在成功安装ZoomEye-python 后，可以直接使用 zoomeye 命令，如下：

$ zoomeye-h

1.初始化token

在使用ZoomEye-python cli 前需要先初始化用户 token，该凭证用于验证用户身份以便从 ZoomEye 查询数据；我们提供了两种认证方式：

可以通过zoomeye init -h 查看帮助，通过 APIKEY 来进行演示：

可以通过登陆ZoomEye在个人信息中(https://www.zoomeye.org/profile)获取 APIKEY；APIKEY 不会过期，用户可根据需求在个人信息中进行重置。

除此之外，还提供了username/password 的初始化方式，通过这种方式认证后会返回 JWT-token，具有一定的时效性，失效后需要用户重新登陆。

2.查询配额

用户可以通过info 命令查询个人信息以及数据配额，如下：

3.搜索

搜索是ZoomEye-python 最核心的功能，通过 search 命令进行使用。search 命令需要指定搜索关键词(dork)，下面我们进行简单的搜索：

使用 search命令和使用浏览器在 ZoomEye 进行搜索一样简单，在默认情况下显示了较为重要的 5 个字段，可以使用这些数据了解目标信息：

在以上，使用-num参数指定了显示的数量，除此之外，search还支持以下参数(zoomeye search-h)，以便用户对数据进行处理，我们将在下文进行说明和演示：

4.数据数量

通过-num参数可以指定我们搜索和显示的数量，指定的数目即消耗的配额数量。而通过 -count 参数可以查询该 dork 在 ZoomEye 数据库的总量，如下：

需要注意一点，-num 参数消耗的配额为 20 的整数倍，这是因为 ZoomEye API 单次查询的最小数量为 20条。

5.数据聚合

我们可以通过-facet 和 -stat 进行数据的聚合统计，使用 -facet 可以查询该 dork 全量数据的聚合情况(由 ZoomEye 聚合统计后通过 API获取)，而 -stat 可以对查询到的结果集进行聚合统计。两个命令支持的聚合字段包括：

使用 -facet统计全量 telnet 设备的应用类型：

使用 -stat统计查询出来的 20 条 telnet 设备的应用类型：

6.数据筛选

使用 -filter参数可以查询数据结果集中某个字段的详情，或根据内容进行筛选，该命令支持的字段包括：

相比较默认情况下的省略显示，所以通过-filter 可以查看完整的数据，如下：

使用 -filter进行筛选时，语法为：key1,key2,key3=value，其中 key3=value 为筛选条件，而展示的内容为 key1,key2 例：

在上面的示例中：banner=Telnet为筛选的条件，而 port,app 为展示的内容。如果需要展示 banner，筛选语句则是这样

7.数据导出

-save参数可以对数据进行导出，该参数的语法和 -filter 一样，并将结果按行 json 的格式保存到文件中，如下：

如果使用 -save 但不带任何参数，则会将查询结果按照 ZoomEye API 的 json格式保存成文件，这种方式一般用于在保留元数据的情况下进行整合数据；该文件可以作为输入通过 cli 再次解析处理，如 zoomeye search"xxxxx.json"。

8. 数据图像化

-figure参数为数据图像化参数，该参数提供了 pie(饼图) 和 hist(柱状图) 两种展示方式，在没有进行指定依旧显示数据，在指定 -figure时，只会显示图形。饼图如下：

柱状图如下：

注意：仅能在 -facet 和 -stat 数据聚合的情况使用。

9. IP 历史数据查看

ZoomEye-python提供了 IP 历史设备数据查询功能，使用命令 history [ip] 便能查询 IP 设备历史数据，使用方式如下：

在默认情况下展示的是这几个字段：

使用 zoomeye history -h 可以查看 history 提供的参数。

下面对-filter 进行演示：

-filter参数支持以下几个字段的筛选：

在展示时添加了一个id 字段的展示，id 为序号，为了方便查看，并不能作为筛选的字段。

10.查询 IP 信息

可以通过zoomeye ip 命令查询指定 IP 的信息，例如：

zoomeye ip命令同样支持筛选参数 -filter, 语法和 zoomeye search 的筛选语法一致。例如：

filter参数支持的字段有:

11.清理功能

用户每天都会搜索大量的数据，这样就导致缓存文件夹所占的存储空间逐渐增大；如果用户在公共服务器上使用ZoomEye-python 可能会导致自己的 API KEY 和 ACCESS TOKEN 泄漏。为此 ZoomEye-python 提供了清理命令zoomeye clear，清理命令可以缓存数据和用户配置进行清空。使用方式如下：

12.缓存机制

ZoomEye-python在 cli 模式下提供了缓存机制，位于 ~/.config/zoomeye/cache 下，尽可能的节约用户配额；用户查询过的数据集将在本地缓存 5天，当用户查询相同的数据集时，不会消耗配额。

0x03 演示视频

在 Windows、Mac、Linux、FreeBSD 演示视频

0x04 使用SDK

1.初始化token

同样，在 SDK中也支持 username/password 和 APIKEY 两种认证方式，如下：

1.user/pass

2.APIKEY

2.SDK API

以下是 SDK提供的接口以及说明：

3.使用示例

4.数据搜索

如上示例，我们使用dork_search() 进行搜索，我们还可以设置 facets 参数，以便获得该 dork 全量数据的聚合统计结果，facets 支持的字段请参考 2.cli使用-4数据聚合。示例如下：

5.数据筛选

在 SDK 中提供了dork_filter() 函数，我们可以更加方便对数据进行筛选，提取指定的数据字段，如下：

【往期推荐】

【内网渗透】内网信息收集命令汇总

【内网渗透】域内信息收集命令汇总

【超详细 | Python】CS免杀-Shellcode Loader原理(python)

【超详细 | Python】CS免杀-分离+混淆免杀思路

【超详细】CVE-2020-14882 | Weblogic未授权命令执行漏洞复现

【超详细 | 附PoC】CVE-2021-2109 | Weblogic Server远程代码执行漏洞复现

【漏洞分析 | 附EXP】CVE-2021-21985 VMware vCenter Server 远程代码执行漏洞

【CNVD-2021-30167 | 附PoC】用友NC BeanShell远程代码执行漏洞复现

【奇淫巧技】如何成为一个合格的“FOFA”工程师

记一次HW实战笔记 | 艰难的提权爬坑

【超详细】Microsoft Exchange 远程代码执行漏洞复现【CVE-2020-17144】

【超详细】Fastjson1.2.24反序列化漏洞复现

走过路过的大佬们留个关注再走呗

往期文章有彩蛋哦

一如既往的学习，一如既往的整理，一如即往的分享。

“如侵权请私聊公众号删文”