
bbot v3.0.2
面向黑客的递归互联网扫描器。🧡
BEE·bot 是一个多功能扫描器,灵感来自 Spiderfoot,旨在自动化你的侦察、漏洞赏金和ASM!
https://github.com/blacklanternsecurity/bbot/assets/20261699/e539e89b-92ea-46fa-b893-9cde94eebf81
实时 BBOT 扫描 - 使用 VivaGraphJS 进行可视化
安装
# stable version
pipx install bbot
# bleeding edge (dev branch)
pipx install --pip-args '\--pre' bbot
从 2.x 升级? BBOT 3.0 包含对 CLI、预设、模块、事件和 Python API 的破坏性更改。升级前请参阅 2.x → 3.0 迁移指南(来源)。
提速提示: BBOT 的 DNS 解析器(blastdns)会为
/etc/resolv.conf中的每个解析器启动多个线程。添加更多无过滤的解析器可大幅加快扫描速度。详见 示例 resolv.conf 和 技巧与诀窍。
示例命令
1) 子域名发现
被动 API 源,以及使用目标特定子域名变异的递归 DNS 暴力破解。
# find subdomains of evilcorp.com
bbot -t evilcorp.com -p subdomain-enum
# passive sources only
bbot -t evilcorp.com -p subdomain-enum -rf passive
subdomain-enum.yml
description: Enumerate subdomains via APIs, brute-force
flags:
# enable every module with the subdomain-enum flag
- subdomain-enum
output_modules:
# output unique subdomains to TXT file
- subdomains
config:
dns:
threads: 25
brute_threads: 1000
# put your API keys here
# modules:
# github:
# api_key: ""
# chaos:
# api_key: ""
# securitytrails:
# api_key: ""
BBOT 始终能比其他工具多发现 20-50% 的子域名。域名越大,差异越大。想了解这是如何实现的,请参阅工作原理。

2) Web 爬虫
# crawl evilcorp.com, extracting emails and other goodies
bbot -t evilcorp.com -p spider
spider.yml
description: Recursive web spider
modules:
- http
blacklist:
# Prevent spider from invalidating sessions by logging out
- "RE:/.*(sign|log)[_-]?out"
config:
web:
# how many links to follow in a row
spider_distance: 2
# don't follow links whose directory depth is higher than 4
spider_depth: 4
# maximum number of links to follow per page
spider_links_per_page: 25
3) 邮箱收集器
# quick email enum with free APIs + scraping
bbot -t evilcorp.com -p email-enum
# pair with subdomain enum + web spider for maximum yield
bbot -t evilcorp.com -p email-enum subdomain-enum spider
email-enum.yml
description: Enumerate email addresses from APIs, web crawling, etc.
flags:
- email-enum
output_modules:
- emails
4) Web 扫描器
# run a light web scan against www.evilcorp.com
bbot -t www.evilcorp.com -p web
# run a heavy web scan against www.evilcorp.com
bbot -t www.evilcorp.com -p web-heavy
web.yml
description: Quick web scan
include:
- iis-shortnames
flags:
- web
web-heavy.yml
description: Aggressive web scan
include:
# include the web preset
- web
flags:
- web-heavy
5) 包罗万象(Everything Everywhere All at Once)
# everything everywhere all at once
bbot -t evilcorp.com -p kitchen-sink
# roughly equivalent to:
bbot -t evilcorp.com -p subdomain-enum cloud-enum code-enum email-enum spider web paramminer webbrute web-screenshots
kitchen-sink.yml
description: Everything everywhere all at once
include:
- subdomain-enum
- cloud-enum
- code-enum
- email-enum
- spider
- web
- paramminer
- webbrute
- web-screenshots
- baddns-heavy
config:
modules:
dnsbrute:
recursive_mutations: true
dnscommonsrv:
recursive_mutations: true
webbrute:
avoid_wafs: False
wayback:
urls: True
parameters: True
archive: True
工作原理
点击下方图表,探索 BBOT 的内部工作原理。
输出模块
……以及更多!
将 BBOT 用作 Python 库
同步
from bbot.scanner import Scanner
if __name__ == "__main__":
scan = Scanner("evilcorp.com", presets=["subdomain-enum"])
for event in scan.start():
print(event)
异步
from bbot.scanner import Scanner
async def main():
scan = Scanner("evilcorp.com", presets=["subdomain-enum"])
async for event in scan.async_start():
print(event.json())
if __name__ == "__main__":
import asyncio
asyncio.run(main())
功能概览
- 支持多个目标
- Web 截图
- 一系列攻击性 Web 模块
- NLP 驱动的子域名变异
- 原生输出到 Neo4j(以及更多)
- 使用 Ansible 自动安装依赖
- 使用自定义 YARA 规则搜索整个攻击面
- Python API + 开发者文档
目标
BBOT 通过 -t 接受无限数量的目标。你可以在命令行中直接指定目标,也可以在文件中指定(或两者都行!):
bbot -t evilcorp.com evilcorp.org 1.2.3.0/24 -p subdomain-enum
目标可以是以下任意类型:
- DNS 名称 (
evilcorp.com) - IP 地址 (
1.2.3.4) - IP 范围 (
1.2.3.0/24) - 开放的 TCP 端口 (
192.168.0.1:80) - URL (
https://www.evilcorp.com) - 邮箱地址 (
[email protected]) - 组织 (
ORG:evilcorp) - 用户名 (
USER:bobsmith) - 文件系统 (
FILESYSTEM:/tmp/asdf) - 移动应用 (
MOBILE_APP:https://play.google.com/store/apps/details?id=com.evilcorp.app)
更多信息,请参阅目标。要了解 BBOT 如何处理范围,请参阅范围。
API 密钥
与 Amass 或 Subfinder 类似,BBOT 支持各种第三方服务(如 SecurityTrails 等)的 API 密钥。
标准做法是在 ~/.config/bbot/secrets.yml 中输入你的 API 密钥。注意,允许多个 API 密钥:
modules:
shodan_dns:
api_key: 4f41243847da693a4f356c0486114bc6
c99:
# multiple API keys
api_key:
- 21a270d5f59c9b05813a72bb41707266
- ea8f243d9885cf8ce9876a580224fd3c
- 5bc6ed268ab6488270e496d3183a1a27
virustotal:
api_key: dd5f0eee2e4a99b71a939bded450b246
securitytrails:
api_key: d9a05c3fd9a514497713c54b4455d0b0
如果你愿意,也可以在命令行中指定它们:
bbot -c modules.virustotal.api_key=dd5f0eee2e4a99b71a939bded450b246
详细信息请参阅配置。
模块、标志等的完整列表
文档
- 用户手册
- 开发人员手册
贡献
一些最优秀的 BBOT 模块由社区编写。BBOT 在不断改进,每天都在变得更强大!
我们欢迎贡献。不仅仅是代码,也欢迎想法!如果你有新功能的想法,请到讨论区告诉我们。如果你想亲自动手,请参阅贡献。在那里你可以找到环境搭建说明和如何编写 BBOT 模块的简单教程。我们还有丰富的开发者文档。
感谢这些为 BBOT 做出贡献的了不起的人!❤️
特别感谢:
- 感谢 @TheTechromancer 创建了 BBOT
- 感谢 @liquidsec 在 BBOT 的 Web 攻击功能方面所做的广泛工作,包括 badsecrets 和 baddns
- 感谢 Steve Micallef (@smicallef) 创建了 Spiderfoot
- 感谢 @kerrymilan 在 Neo4j 和 Ansible 方面的专业知识
- 感谢 @domwhewell-sage 的系列超赞代码拾取模块
- 感谢 @aconite33 和 @amiremami 进行了严格的测试
- 感谢 Aleksei Kornev (@alekseiko) 授予我们对 bbot Pypi 仓库的所有权 <3


