Repolode
beelzebub-labs

beelzebub-labs/beelzebub

기만용 SSH, HTTP, TCP, TELNET, MCP 서비스를 배포하고 공격자 상호작용을 증거로 수집하는 Go 기반 오픈소스 디셉션 프레임워크입니다.

스타
2,230
포크
221
열린 이슈
11
마지막 커밋
4일 전

어떤 프로젝트인가요?

Beelzebub은 디코이 서비스로 향하는 활동을 조사하려는 보안팀을 위한 디셉션 프레임워크입니다. 서비스, 라우트, 응답 규칙은 YAML로 정의하며, 각 응답은 정적 응답을 사용하거나 LLM provider가 생성하도록 설정할 수 있습니다. 신뢰할 수 있는 Go 플러그인을 컴파일해 서비스와 응답을 확장할 수도 있습니다.

공격자가 디코이와 상호작용하면 프로토콜에 따라 명령어, HTTP 요청 세부 정보, 세션 컨텍스트 등의 증거를 런타임에서 수집합니다. 이벤트는 로컬 로그에 기록하거나 RabbitMQ로 발행하거나 Beelzebub Platform으로 전송할 수 있으며, Prometheus 메트릭은 별도로 활성화할 수 있습니다.

SSH, HTTP, TCP, TELNET, MCP 디코이를 지원하며, MySQL, Redis, SMB, MQTT 등의 서비스를 대상으로 한 예시 설정 18개를 제공합니다. Go 바이너리로 실행하거나 Docker Compose를 사용하거나 Helm으로 Kubernetes에 배포할 수 있습니다.

핵심 기능

  • 01디코이 서비스, 라우트, 응답을 YAML로 정의합니다.
  • 02LLM provider를 사용해 상황에 맞는 응답을 생성하거나, provider 없이 정적 핸들러를 사용할 수 있습니다.
  • 03상호작용에서 명령어, HTTP 요청 세부 정보, 세션 컨텍스트를 수집합니다.
  • 04이벤트를 로컬 로그, RabbitMQ 또는 Beelzebub Platform으로 전송합니다.
  • 05MCP 디코이에서 의심스러운 에이전트 호출을 관찰할 수 있도록 미끼 도구를 제공합니다.

활용 사례

  • 격리된 실험 환경에서 공격자가 SSH, Telnet 또는 데이터베이스와 유사한 서비스를 어떻게 탐색하는지 조사합니다.
  • HTTP 또는 MCP 디코이를 배치해 의심스러운 요청이나 프롬프트 인젝션 시도에 관한 증거를 수집합니다.
  • RabbitMQ를 통해 디코이 상호작용 이벤트를 기존 로깅 또는 알림 파이프라인으로 전달합니다.

빠른 시작

  1. 1

    저장소를 클론합니다

    git clone https://github.com/beelzebub-labs/beelzebub.git
  2. 2

    프로젝트 디렉터리로 이동합니다

    cd beelzebub
  3. 3

    Docker 모드로 설치 프로그램을 실행합니다

    ./install.sh --docker
  4. 4

    포트 8080의 기본 HTTP 디코이를 테스트합니다

    curl -i http://localhost:8080/

사용 전 알아둘 점

  • GPL-3.0 라이선스가 적용됩니다. 이 카피레프트 라이선스에 따라 파생 저작물도 동일한 조건으로 배포해야 합니다.
  • 설치 프로그램은 권한이 필요한 포트에서 예제 서비스를 시작하므로, 사용 권한이 있는 격리된 실험실 호스트에서만 실행해야 합니다.
  • LLM 기반 디코이를 사용하려면 공급자가 설정되어 있어야 하며, Docker 설정에는 Compose v2가 포함된 Docker Engine이 필요합니다.

포함된 컬렉션

토픽

자주 묻는 질문

beelzebub은(는) 무엇인가요?
기만용 SSH, HTTP, TCP, TELNET, MCP 서비스를 배포하고 공격자 상호작용을 증거로 수집하는 Go 기반 오픈소스 디셉션 프레임워크입니다. Beelzebub은 디코이 서비스로 향하는 활동을 조사하려는 보안팀을 위한 디셉션 프레임워크입니다. 서비스, 라우트, 응답 규칙은 YAML로 정의하며, 각 응답은 정적 응답을 사용하거나 LLM provider가 생성하도록 설정할 수 있습니다. 신뢰할 수 있는 Go 플러그인을 컴파일해 서비스와 응답을 확장할 수도 있습니다.
beelzebub은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
beelzebub은(는) GPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
beelzebub은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. beelzebub의 마지막 커밋은 2026년 11월 3일입니다.
beelzebub은(는) 어디에 사용할 수 있나요?
격리된 실험 환경에서 공격자가 SSH, Telnet 또는 데이터베이스와 유사한 서비스를 어떻게 탐색하는지 조사합니다. HTTP 또는 MCP 디코이를 배치해 의심스러운 요청이나 프롬프트 인젝션 시도에 관한 증거를 수집합니다. RabbitMQ를 통해 디코이 상호작용 이벤트를 기존 로깅 또는 알림 파이프라인으로 전달합니다.
beelzebub는 어떻게 설치하나요?
저장소를 클론합니다: git clone https://github.com/beelzebub-labs/beelzebub.git 프로젝트 디렉터리로 이동합니다: cd beelzebub Docker 모드로 설치 프로그램을 실행합니다: ./install.sh --docker 포트 8080의 기본 HTTP 디코이를 테스트합니다: curl -i http://localhost:8080/
beelzebub은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/beelzebub-labs/beelzebub

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트