ShoMon은 GoLang으로 작성된 TheHive용 Shodan 알림 피더입니다. v2.0으로 더욱 강력해졌습니다!

기능

• 웹훅(Webhook) 또는 스트림(Stream) 리스너로 사용 가능

  • 웹훅 리스너는 Shodan이 알림을 보낼 RESTful API 엔드포인트를 엽니다. 즉, 이 엔드포인트를 공개 네트워크에 노출해야 합니다.
  • 스트림 리스너는 Shodan에 연결하여 알림 스트림을 가져와 파싱합니다.

• Shodan과의 상호 작용을 위해 shadowscatcher/shodan (훌륭한 작업)을 활용합니다.

• 콘솔 로그는 JSON 형식으로, 다른 로그 관리 도구에서 수집할 수 있습니다.

• Github Actions를 통한 CI/CD로 변경 로그, 아티팩트, ghcr 및 dockerhub 이미지가 포함된 적절한 릴리스가 제공됩니다.

• TheHive 및 종속성을 위한 docker-compose 파일을 제공합니다.

• 매우 빠르고 크기가 매우 작습니다.

• v2.0에서 전체 코드 리팩토링으로 더 모듈화되고 유지보수하기 쉬운 코드가 되었습니다.

• 설정 파일이나 환경 변수를 통해 태그, 유형, 알림 템플릿 등 알림 세부 사항을 동적으로 조정할 수 있습니다. 설정 파일을 참조하세요.

• 알림에 Shodan 결과물 직접 링크와 함께 전체 배너 포함 가능

  

• IP가 관측 가능 항목(observables)에 추가됨

  

사용법

• 매개변수는 conf.yaml 또는 환경 변수를 통해 제공해야 합니다. 설정 파일 및 docker-compose 파일을 참조하세요.

• 설정 또는 환경 변수 설정 후 다음 명령어 실행:

  ./shomon

참고 사항

• 알림 참조는 md5("ip:port")의 첫 6자입니다.
• 한 번에 하나의 모드만 활성화할 수 있습니다. 웹훅과 스트림 리스너를 동시에 활성화할 수 없습니다.

설정 및 컴파일 방법

릴리스에서 최신 컴파일된 바이너리 가져오기

1. 릴리스 섹션을 확인하세요.

소스 코드에서 컴파일

1. Golang 작업 공간이 작동 중인지 확인하세요.
2. go build .
   • go build -ldflags="-s -w" .를 사용하여 컴파일을 사용자 정의하고 더 작은 바이너리를 생성할 수 있습니다.

공용 컨테이너 레지스트리 사용

1. 새로운 CI/CD 통합 덕분에 최신 버전의 빌드 이미지가 ghcr, DockerHub에 푸시되며 다음을 통해 사용할 수 있습니다:
   • docker pull ghcr.io/kaansk/shomon
   • docker pull kaansk/shomon

Dockerfile 사용

1. 설정 파일을 편집하거나 아래 명령에 환경 변수를 제공하세요.
2. docker build -t shomon .
3. docker run -it shomon

docker-compose 파일 사용

1. docker-compose 파일에서 환경 변수 및 설정을 편집하세요.
2. docker-compose run -d

크레딧

• 로고는 LogoMakr.com을 통해 제작되었습니다.
• shadowscatcher/shodan
• Dockerfile 참고자료
• GoReleaser를 통한 릴리스 관리