Shodan
本文档介绍了如何将 Shodan 与 Google SecOps 集成。
配置 Shodan 集成以与 Google Security Operations 搭配使用
如需获取 API 密钥，请完成以下步骤：
登录您的 Shodan 账号。
您可以在 Shodan 界面的账号概览部分中找到您的 API 密钥。
在 Google SecOps 中配置 Shodan 集成
有关如何在 Google SecOps 中配置集成的详细说明，请参阅配置集成。
操作
DNS 解析
说明
查找所提供的主机名列表的 IP 地址。
参数
不适用
Run On
此操作在 Hostname 实体上运行。
操作执行结果
实体扩充
| 扩充项字段名称 | 逻辑 - 应用场景 |
|---|---|
| google.com | 如果存在于 JSON 结果中，则返回 |
| bing.com | 如果存在于 JSON 结果中，则返回 |
数据分析
不适用
脚本结果
| 脚本结果名称 | 值选项 | 示例 |
|---|---|---|
| is_success | True/False | is_success:False |
JSON 结果
{
"google.com": "1.1.1.1",
"bing.com": "1.1.1.1"
}
DNS 反向
说明
查找已为指定 IP 地址列表定义的主机名。
参数
不适用
Run On
此操作在 IP 地址实体上运行。
操作执行结果
实体扩充
| 扩充项字段名称 | 逻辑 - 应用场景 |
|---|---|
| 146.125.10.5 | 如果存在于 JSON 结果中，则返回 |
| 8.8.8.8 | 如果存在于 JSON 结果中，则返回 |
数据分析
不适用
脚本结果
| 脚本结果名称 | 值选项 | 示例 |
|---|---|---|
| is_success | True/False | is_success:False |
JSON 结果
{
"146.125.10.5": null,
"8.8.8.8": [
"google-public-dns-a.google.com"
]
}
获取 API 信息
说明
返回有关指定 API 密钥所属 API 方案的信息。
参数
不适用
Run On
此操作会针对所有实体运行。
操作执行结果
实体扩充
不适用
数据分析
不适用
脚本结果
| 脚本结果名称 | 值选项 | 示例 |
|---|---|---|
| is_success | True/False | is_success:False |
JSON 结果
{
"https": false,
"unlocked": false,
"unlocked_left": 0,
"telnet": false,
"scan_credits": 0,
"plan": "oss",
"query_credits": 0
}
获取 IP 信息
说明
获取有关 IP 的所有可用信息。
参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 返回历史横幅 | 布尔值 | false | 如果应返回所有历史横幅，则为 true。 |
| 设置缩减大小 | 布尔值 | false | 如果为 true，则仅返回端口列表和一般主机信息，不返回横幅。 |
Run On
此操作在 IP 地址实体上运行。
操作执行结果
实体扩充
| 扩充项字段名称 | 逻辑 - 应用场景 |
|---|---|
| 数据 | 如果存在于 JSON 结果中，则返回 |
| _shodan | 如果存在于 JSON 结果中，则返回 |
| id | 如果存在于 JSON 结果中，则返回 |
| 爬虫 | 如果存在于 JSON 结果中，则返回 |
| 选项 | 如果存在于 JSON 结果中，则返回 |
| module | 如果存在于 JSON 结果中，则返回 |
| ptr | 如果存在于 JSON 结果中，则返回 |
| hash | 如果存在于 JSON 结果中，则返回 |
| opts | 如果存在于 JSON 结果中，则返回 |
| raw | 如果存在于 JSON 结果中，则返回 |
| isp | 如果存在于 JSON 结果中，则返回 |
| 端口 | 如果存在于 JSON 结果中，则返回 |
| 主机名 | 如果存在于 JSON 结果中，则返回 |
| 位置 | 如果存在于 JSON 结果中，则返回 |
| city | 如果存在于 JSON 结果中，则返回 |
| country_name | 如果存在于 JSON 结果中，则返回 |
| region_code | 如果存在于 JSON 结果中，则返回 |
| area_code | 如果存在于 JSON 结果中，则返回 |
| dma_code | 如果存在于 JSON 结果中，则返回 |
| country_code3 | 如果存在于 JSON 结果中，则返回 |
| postal_code | 如果存在于 JSON 结果中，则返回 |
| longitude | 如果存在于 JSON 结果中，则返回 |
| country_code | 如果存在于 JSON 结果中，则返回 |
| 纬度 | 如果存在于 JSON 结果中，则返回 |
| resolver_hostname | 如果存在于 JSON 结果中，则返回 |
| recursive | 如果存在于 JSON 结果中，则返回 |
| resolver_id | 如果存在于 JSON 结果中，则返回 |
| 软件 | 如果存在于 JSON 结果中，则返回 |
| 时间戳 | 如果存在于 JSON 结果中，则返回 |
| 网域 | 如果存在于 JSON 结果中，则返回 |
| org | 如果存在于 JSON 结果中，则返回 |
| os | 如果存在于 JSON 结果中，则返回 |
| asn | 如果存在于 JSON 结果中，则返回 |
| transport | 如果存在于 JSON 结果中，则返回 |
| ip_str | 如果存在于 JSON 结果中，则返回 |
数据分析
不适用
脚本结果
| 脚本结果名称 | 值选项 | 示例 |
|---|---|---|
| is_success | True/False | is_success:False |
JSON 结果
[
{
"EntityResult": {
"data": [
{
"_shodan": {
"id": "d670bfbb-4821-4320-969d-0590789ab502",
"crawler": "545144fc95e7a7ef13ece5dbceb98ee386b37950",
"options": {},
"module": "dns-udp",
"ptr": true
},
"hash": -553166942,
"opts": {
"raw": "34ef818200010000000000000756455253494f4e0442494e440000100003"
},
"ip": 134744072,
"isp": "Google",
"data": "nRecursion: enabled",
"port": 53,
"hostnames": ["google-public-dns-a.google.com"],
"location": {
"city": null,
"region_code": null,
"area_code": null,
"dma_code": null,
"country_code3": "USA",
"country_name": "United States",
"postal_code": null,
"longitude": -97.822,
"country_code": "US",
"latitude": 37.751000000000005
},
"dns": {
"resolver_hostname": null,
"recursive": true,
"resolver_id": null,
"software": null
},
"timestamp": "2019-01-29T12:36:09.300695",
"domains": ["google.com"],
"org": "Google",
"os": null,
"asn": "AS15169",
"transport": "udp",
"ip_str": "1.1.1.1"
}
],
"city": null,
"region_code": null,
"tags": [],
"ip": 134744072,
"isp": "Google",
"area_code": null,
"dma_code": null,
"last_update": "2019-01-29T12:36:09.300695",
"country_code3": "USA",
"country_name": "United States",
"hostnames": ["google-public-dns-a.google.com"],
"postal_code": null,
"longitude": -97.822,
"country_code": "US",
"ip_str": "1.1.1.1",
"latitude": 37.751000000000005,
"org": "Google",
"os": null,
"asn": "AS15169",
"ports": [53]
},
"Entity": "1.1.1.1"
}
]
Ping
说明
验证用户是否通过自己的设备连接到 Shodan。
参数
不适用
Run On
此操作会针对所有实体运行。
操作执行结果
实体扩充
不适用
数据分析
不适用
脚本结果
| 脚本结果名称 | 值选项 | 示例 |
|---|---|---|
| is_connected | True/False | is_connected:False |
JSON 结果
N/A
扫描网络
说明
使用 Shodan 扫描网络。Shodan 至少每月会抓取整个互联网一次，但如果您想请求 Shodan 立即扫描某个网络，可以使用 API 的按需扫描功能。
参数
不适用
Run On
此操作会针对所有实体运行。
操作执行结果
实体扩充
不适用
数据分析
不适用
脚本结果
| 脚本结果名称 | 值选项 | 示例 |
|---|---|---|
| is_success | True/False | is_success:False |
JSON 结果
N/A
启用用户
说明
更新用户属性 - 启用用户。
参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 用户名 | 整数 | 不适用 | CyberArkVault 中存在的完整用户名。 |
Run On
此操作在 IP 地址实体上运行。
操作执行结果
实体扩充
不适用
数据分析
不适用
脚本结果
| 脚本结果名称 | 值选项 | 示例 |
|---|---|---|
| success_scan | True/False | success_scan:False |
JSON 结果
N/A
搜索
说明
搜索 Shodan 数据库。
参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 搜索查询 | 0 | 不适用 | 搜索查询；语法与网站相同。例如，查找位于德国的 Apache 网络服务器（apache country:'DE', city:'Berlin'）。 |
| 分面 | 0 | 不适用 | 要获取摘要信息的房源的英文逗号分隔列表。属性名称也可以采用“property:count”格式。（即国家/地区：100，城市：5）。如需了解详情，请访问 https://developer.shodan.io/api。 |
| 设置缩减大小 | 1 | false | 是否缩减横幅大小并仅返回重要数据。 |
Run On
此操作会针对所有实体运行。
操作执行结果
实体扩充
不适用
数据分析
不适用
脚本结果
| 脚本结果名称 | 值选项 | 示例 |
|---|---|---|
| is_success | True/False | is_success:False |
JSON 结果
{
"matches": [
{
"timestamp": "2014-01-15T05: 49: 56.283713",
"isp": "Vivacom",
"data": "@PJL INFO STATUS CODE=35078 DISPLAY=Power Saver ONLINE=TRUE",
"port": 9100,
"hostnames": [],
"location": {
"city": null,
"region_code": null,
"area_code": null,
"longitude": 25,
"country_code3": "BGR",
"country_name": "Bulgaria",
"postal_code": null,
"dma_code": null,
"country_code": "BG",
"latitude": 43
},
"ip": 3579573318,
"domains": [],
"org": "Vivacom",
"os": null,
"asn": "AS8866",
"ip_str": "1.1.1.1"
}
],
"facets": {
"org": [
{
"count": 107,
"value": "UniversityofMinnesota"
}
]
},
"total": 12039
}
搜索漏洞
说明
搜索各种数据源中的漏洞，并使用过滤条件获取摘要信息。
参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 搜索查询 | 字符串 | 不适用 | 用于搜索已知漏洞数据库的搜索查询。 |
| 分面 | 字符串 | 不适用 | 要获取摘要信息的房源的英文逗号分隔列表。（例如，端口、来源、作者）。如需了解详情，请访问 https://developer.shodan.io/api。 |
| 页面 | 字符串 | 不适用 | 用于对结果进行分页的页码，每次分页 100 个结果。 |
Run On
此操作会针对所有实体运行。
操作执行结果
实体扩充
不适用
数据分析
不适用
脚本结果
| 脚本结果名称 | 值选项 | 示例 |
|---|---|---|
| is_success | True/False | is_success:False |
JSON 结果
{
"matches": [
{
"cve": "CVE-2011-2064",
"description": "Cisco IOS 12.4MDA before 12.4(24)MDA5 on the Cisco Content Services Gateway - Second Generation (CSG2) allows remote attackers to cause a denial of service (device reload) via crafted ICMP packets, aka Bug ID CSCtl79577.",
"osvdb": [73657],
"bid": [48581],
"source": "CVE",
"_id": "2011-2064",
"msb": []}],
"facets": {
"type": [
{
"count": 1,
"value": "remote"
}
]
},
"total": 4
}