
Рекурсивный интернет-сканер для хакеров. 🧡
https://github.com/blacklanternsecurity/bbot/assets/20261699/e539e89b-92ea-46fa-b893-9cde94eebf81
Сканирование BBOT в реальном времени — визуализация с помощью VivaGraphJS
# стабильная версия
pipx install bbot
# самая свежая (ветка dev)
pipx install --pip-args '\--pre' bbot
Для других способов установки, включая Docker, см. Начало работы
Обновляетесь с 2.x? BBOT 3.0 содержит критические изменения в CLI, пресетах, модулях, событиях и Python API. Перед обновлением ознакомьтесь с Руководством по миграции 2.x → 3.0 (исходник).
Совет по скорости: DNS-резолвер BBOT (blastdns) запускает несколько потоков на каждый резолвер в
/etc/resolv.conf. Добавление дополнительных нефильтрованных резолверов значительно ускоряет сканирование. Подробнее см. в образце resolv.conf и Советах и трюках.
Пассивные API-источники плюс рекурсивный DNS-брутфорс с мутациями поддоменов, специфичными для цели.
# найти поддомены evilcorp.com
bbot -t evilcorp.com -p subdomain-enum
# только пассивные источники
bbot -t evilcorp.com -p subdomain-enum -rf passive
subdomain-enum.ymldescription: 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% больше поддоменов, чем другие инструменты. Чем больше домен, тем значительнее разница. Чтобы узнать, как это возможно, см. Как это работает.

# сканировать evilcorp.com, извлекая email и другие полезные данные
bbot -t evilcorp.com -p spider
spider.ymldescription: 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
# быстрый сбор email с помощью бесплатных API + парсинга
bbot -t evilcorp.com -p email-enum
# объединить с поиском поддоменов и веб-пауком для максимального результата
bbot -t evilcorp.com -p email-enum subdomain-enum spider
email-enum.ymldescription: Enumerate email addresses from APIs, web crawling, etc.
flags:
- email-enum
output_modules:
- emails
# лёгкое веб-сканирование www.evilcorp.com
bbot -t www.evilcorp.com -p web
# полное веб-сканирование www.evilcorp.com
bbot -t www.evilcorp.com -p web-heavy
web.ymldescription: Quick web scan
include:
- iis-shortnames
flags:
- web
web-heavy.ymldescription: Aggressive web scan
include:
# include the web preset
- web
flags:
- web-heavy
# всё везде и сразу
bbot -t evilcorp.com -p kitchen-sink
# примерно эквивалентно:
bbot -t evilcorp.com -p subdomain-enum cloud-enum code-enum email-enum spider web paramminer webbrute web-screenshots
kitchen-sink.ymldescription: 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.
...и другие!
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())
BBOT Discord-бот, который отвечает на команду /scan. Сканируйте интернет, не покидая свой Discord-сервер!

BBOT принимает неограниченное количество целей через -t. Вы можете указывать цели как непосредственно в командной строке, так и в файлах (или и так, и так!):
bbot -t evilcorp.com evilcorp.org 1.2.3.0/24 -p subdomain-enum
Цели могут быть любого из следующих типов:
evilcorp.com)1.2.3.4)1.2.3.0/24)192.168.0.1:80)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 управляет областью видимости, см. Область видимости.
Как и Amass или Subfinder, BBOT поддерживает API-ключи для различных сторонних сервисов, таких как SecurityTrails и т.д.
Стандартный способ — указать API-ключи в ~/.config/bbot/secrets.yml. Обратите внимание, что можно указать несколько ключей:
modules:
shodan_dns:
api_key: 4f41243847da693a4f356c0486114bc6
c99:
# несколько API-ключей
api_key:
- 21a270d5f59c9b05813a72bb41707266
- ea8f243d9885cf8ce9876a580224fd3c
- 5bc6ed268ab6488270e496d3183a1a27
virustotal:
api_key: dd5f0eee2e4a99b71a939bded450b246
securitytrails:
api_key: d9a05c3fd9a514497713c54b4455d0b0
При желании их также можно указать в командной строке:
bbot -c modules.virustotal.api_key=dd5f0eee2e4a99b71a939bded450b246
Подробнее см. в разделе Конфигурация.
Некоторые из лучших модулей BBOT были написаны сообществом. BBOT постоянно совершенствуется; с каждым днём он становится мощнее!
Мы приветствуем вклад. Не только код, но и идеи! Если у вас есть идея для новой функции, сообщите нам в Обсуждениях. Если хотите приложить руки к делу, см. Вклад в проект. Там вы найдёте инструкции по настройке и простой учебник по написанию модуля BBOT. У нас также есть обширная Документация для разработчиков.
Спасибо этим замечательным людям за вклад в BBOT! ❤️
Особая благодарность: