bbot v3.0.1

BEE·bot은 Spiderfoot에서 영감을 받은 다목적 스캐너로, Recon, 버그 바운티, ASM을 자동화하도록 설계되었습니다!

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 마이그레이션 가이드 (소스)를 확인하세요.

속도 팁: BBOT의 DNS 리졸버(blastdns)는 /etc/resolv.conf에 있는 리졸버당 여러 스레드를 실행합니다. 필터링되지 않은 리졸버를 더 추가하면 스캔 속도가 크게 향상됩니다. 자세한 내용은 샘플 resolv.conf 및 팁과 요령을 참조하세요.

예제 명령어

1) 서브도메인 찾기

수동 API 소스 및 대상별 서브도메인 변이를 이용한 재귀적 DNS 무차별 대입

# evilcorp.com의 서브도메인 찾기
bbot -t evilcorp.com -p subdomain-enum

# 수동 소스만 사용
bbot -t evilcorp.com -p subdomain-enum -rf passive

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) 웹 스파이더

# evilcorp.com을 크롤링하여 이메일 등 수집
bbot -t evilcorp.com -p spider

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) 이메일 수집기

# 무료 API + 스크래핑으로 빠른 이메일 수집
bbot -t evilcorp.com -p email-enum

# 최대 수집량을 위해 서브도메인 열거 + 웹 스파이더와 함께 사용
bbot -t evilcorp.com -p email-enum subdomain-enum spider

description: Enumerate email addresses from APIs, web crawling, etc.

flags:
  - email-enum

output_modules:
  - emails

4) 웹 스캐너

# www.evilcorp.com에 대해 가벼운 웹 스캔 실행
bbot -t www.evilcorp.com -p web

# www.evilcorp.com에 대해 무거운 웹 스캔 실행
bbot -t www.evilcorp.com -p web-heavy

description: Quick web scan

include:
  - iis-shortnames

flags:
  - web

description: Aggressive web scan

include:
  # include the web preset
  - web

flags:
  - web-heavy

5) 모든 것을 한 번에

# 모든 것을 한 번에
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

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의 내부 작동 방식을 살펴보세요.

출력 모듈

• Neo4j
• Teams
• Discord
• Slack
• Postgres
• MySQL
• SQLite
• Splunk
• Elasticsearch
• CSV
• JSON
• HTTP
• Websocket

...그 외 더 많은 기능!

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())

기능 개요

• 다중 대상 지원
• 웹 스크린샷
• 공격적인 웹 모듈 제품군
• 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

자세한 내용은 설정을 참조하세요.

모듈, 플래그 등의 전체 목록

• 모듈 전체 목록
• 플래그 전체 목록
• 프리셋 전체 목록
  • 글로벌 설정 옵션 전체 목록
  • 모듈 설정 옵션 전체 목록

문서

• 사용자 매뉴얼
  • 기초
    • 시작하기
    • 작동 방식
    • 다른 도구와의 비교
  • 스캔
    • 스캔 개요
    • 프리셋
      • 개요
      • 프리셋 목록
    • 이벤트
    • 출력
    • 팁과 요령
    • 고급 사용법
    • 설정
    • 스캔 온전성 검사
  • 모듈
    • 모듈 목록
    • 내부 모듈
    • Nuclei
    • Wayback
    • 사용자 정의 YARA 규칙
    • Lightfuzz
    • Webbrute
  • 마이그레이션
    • 2.x → 3.0 호환성 파괴 변경 사항
  • 기타
    • 기여
    • 릴리스 히스토리
    • 문제 해결
• 개발자 매뉴얼
  • 개발 개요
  • 개발 환경 설정
  • 핵심 종속성
  • BBOT 내부 아키텍처
  • BBOT 모듈 작성 방법
  • 프리셋 검증 및 검사
  • 단위 테스트
  • Discord 봇 예제
  • 코드 참조
    • Scanner
    • Presets
    • Event
    • Target
    • BaseModule
    • BBOTCore
    • 도우미
      • 개요
      • Command
      • DNS
      • Interactsh
      • 기타
      • Web
      • Word Cloud

기여

최고의 BBOT 모듈 중 일부는 커뮤니티에서 작성했습니다. BBOT는 지속적으로 개선되고 있으며, 매일 더 강력해지고 있습니다!

기여를 환영합니다. 코드뿐만 아니라 아이디어도 환영합니다! 새로운 기능에 대한 아이디어가 있다면 토론에서 알려주세요. 직접 참여하고 싶다면 기여를 참조하세요. 설정 방법과 BBOT 모듈 작성에 대한 간단한 튜토리얼이 있습니다. 또한 광범위한 개발자 문서도 제공됩니다.

BBOT에 기여해 주신 이 놀라운 분들께 감사드립니다! ❤️

특별히 감사드립니다:

• @TheTechromancer - BBOT 창시자
• @liquidsec - badsecrets 및 baddns를 포함한 BBOT의 웹 해킹 기능에 대한 광범위한 작업
• Steve Micallef (@smicallef) - Spiderfoot 창시자
• @kerrymilan - Neo4j 및 Ansible 전문성
• @domwhewell-sage - 강력한 코드 약탈 모듈 제품군
• @aconite33 및 @amiremami - 철저한 테스트
• Aleksei Kornev (@alekseiko) - bbot Pypi 저장소 소유권을 부여해주셔서 감사합니다 <3