AI 기반 위협 인텔리전스 플랫폼으로, 자동화된 CVE/랜섬웨어 모니터링, 도메인 감시, 데이터 유출 탐지 및 MISP/TheHive 연동을 통한 사고 대응을 제공합니다.
<p align="center">
<img alt="Watcher Logo" src="https://assets.kitploit.com/production/public/readmes/6816/e4e489f04c6ba2eb88f27dbbcd3924b06658a7fe314c331215fbe7d20d160654.png" height="270" width="270">
</p>
<p align="center">
<strong>AI 기반 자동화 사이버 보안 위협 탐지 플랫폼</strong>
</p>
<p align="center">
<a href="https://thalesgroup-cert.github.io/Watcher/README.html">
<img src="https://img.shields.io/badge/Install-Guide-informational?style=for-the-badge&logo=docker" alt="Install">
</a>
<a href="https://thalesgroup-cert.github.io/Watcher/">
<img src="https://img.shields.io/badge/Documentation-Read-informational?style=for-the-badge&logo=readthedocs" alt="Documentation">
</a>
<a href="https://github.com/thalesgroup-cert/Watcher">
<img src="https://img.shields.io/github/stars/thalesgroup-cert/Watcher?style=for-the-badge&logo=github" alt="Stars">
</a>
<a href="https://github.com/thalesgroup-cert/Watcher/issues?q=is%3Aissue+is%3Aclosed">
<img src="https://img.shields.io/github/issues-closed-raw/thalesgroup-cert/Watcher?style=for-the-badge&logo=github" alt="Closed Issues">
</a>
<a href="https://github.com/thalesgroup-cert/watcher/blob/master/LICENSE">
<img src="https://img.shields.io/github/license/thalesgroup-cert/Watcher?style=for-the-badge&logo=opensourceinitiative&logoColor=white" alt="License">
</a>
<a href="https://hub.docker.com/r/felix83000/watcher/tags">
<img src="https://img.shields.io/docker/pulls/felix83000/watcher?style=for-the-badge&logo=docker" alt="Docker Pulls">
</a>
</p>
<p align="center">
<a href="https://trendshift.io/repositories/15680?utm_source=repository-badge&utm_medium=badge&utm_campaign=badge-repository-15680" target="_blank" rel="noopener noreferrer">
<img src="https://trendshift.io/api/badge/repositories/15680" alt="thalesgroup-cert/Watcher | Trendshift" width="250" height="55"/>
</a>
<a href="https://trendshift.io/repositories/15680?utm_source=trendshift-badge&utm_medium=badge&utm_campaign=badge-trendshift-15680" target="_blank" rel="noopener noreferrer">
<img src="https://trendshift.io/api/badge/trendshift/repositories/15680/daily?language=JavaScript" alt="thalesgroup-cert/Watcher | Trendshift" width="250" height="55"/>
</a>
</p>
Watcher는 **AI 기반 위협 인텔리전스 분석**을 통해 새롭게 부상하는 사이버 보안 위협을 탐지하고 모니터링하도록 설계된 Django & React JS 플랫폼입니다. 웹서버에 배포하거나 Docker를 통해 빠르게 실행할 수 있습니다.
## Watcher 기능
Watcher는 포괄적인 위협 탐지 및 모니터링으로 보안 운영을 강화합니다:
- **AI 기반 위협 인텔리전스** - 원시 위협 데이터를 실행 가능한 인텔리전스로 전환합니다. 상위 5개 트렌드 사이버 보안 주제에 대한 자동 주간 다이제스트, 위협이 발생할 때의 실시간 속보 알림, 관련 CVE 및 위협 행위자 세부 정보를 포함한 모든 보안 키워드에 대한 온디맨드 요약을 제공합니다.
- **CVE & 랜섬웨어 인텔리전스** - 외부 위협 데이터를 지속적으로 수집, 상호 연관시키고 표시합니다: [cve.circl.lu](https://cve.circl.lu)의 CVE, [ransomware.live](https://ransomware.live) 및 [ransomlook.io](https://ransomlook.io)의 랜섬웨어 피해자 및 그룹. 키워드 기반 Watch Rules를 정의하여 특정 위협이 조직의 상황과 일치할 때 알림을 받을 수 있습니다.
- **신규 위협 탐지** - CERT-FR(www.cert.ssi.gouv.fr), CERT-EU(www.cert.europa.eu), US-CERT(www.us-cert.gov), 호주 사이버 보안 센터(www.cyber.gov.au) 등의 RSS 피드를 통해 사이버 보안 동향을 모니터링합니다. 새로운 취약점, 악성코드 캠페인 및 위협 권고가 나타나는 대로 추적합니다.
- **합법 도메인 관리** - 만료, 재구매 상태, 등록기관 정보 및 연락처를 포함한 중앙 집중식 승인 도메인 관리. 모니터링 중인 악성 도메인을 손쉽게 합법 도메인으로 전환합니다. 자동화된 UDRP 사례 추적.
- **정보 유출 모니터링** - Pastebin, StackOverflow, GitHub, GitLab, Bitbucket, APKMirror, npm 레지스트리 및 기타 플랫폼을 포함한 웹 전반에서 민감한 데이터 노출을 탐지합니다. 유출된 자격 증명, API 키 및 기밀 정보를 조기에 포착합니다.
- **악성 도메인 감시** - 악성 도메인의 IP 주소, 메일/MX 레코드, 웹 콘텐츠 변경을 모니터링합니다. [TLSH](https://github.com/trendmicro/tlsh) 퍼지 해싱을 사용하여 변경 사항을 탐지합니다. 등록기관 및 만료 알림과 함께 자동 RDAP/WHOIS 검사를 수행합니다.
- **의심스러운 도메인 탐지** - 다음을 통해 조직을 대상으로 하는 잠재적 악성 도메인을 식별합니다:
- [dnstwist](https://github.com/elceef/dnstwist)를 사용한 **도메인 생성 알고리즘 탐지**로 타이포스쿼팅, 호모그래프 공격 및 유사 도메인 변형을 찾습니다
- [certstream](https://github.com/CaliDog/certstream-python)을 통한 **인증서 투명성 모니터링**으로 새로 등록된 의심스러운 도메인을 실시간으로 포착합니다
## 추가 기능
강력한 통합 및 관리 도구로 Watcher의 기능을 확장하세요:
- **TheHive 전체 동기화** - 자동 경고 생성, 스마트 케이스 관리, IOC 보강, 즉시 사용 가능한 Cortex Analyzer 및 Responder를 갖춘 [TheHive](https://thehive-project.org/) 통합. 자세한 구성은 [여기](https://thalesgroup-cert.github.io/Watcher/README.html#thehive-export) 문서에서 확인할 수 있습니다.
- **MISP 통합** - 스마트 UUID 추적, 자동 객체 생성, 수동 속성 업데이트를 통해 침해 지표(IOC)를 [MISP](https://www.misp-project.org/)로 원활하게 내보내 협업 위협 인텔리전스를 공유합니다
- **SSO / OpenID Connect** - PKCE 및 Knox 토큰 발급을 지원하는 모든 OIDC 제공자(Keycloak, Azure AD 등)를 통한 연합 로그인. `.env`를 통해 인스턴스별로 구성 가능
- **일괄 추가 및 일괄 작업** - *한 줄에 항목 하나* 토글(쓰기 없는 미리보기 및 항목별 생성/건너뜀/오류 요약 포함)로 여러 항목을 한 번에 추가하거나, 모든 테이블에서 행을 선택하여 한 번에 편집, 삭제 또는 내보내기(합법 도메인 또는 MISP로)할 수 있습니다
- **유연한 인증** - LDAP, 로컬, SSO/OIDC 인증 시스템 지원
- **커넥터 대시보드** - 슈퍼유저 전용 `/connectors` 페이지에서 모든 외부 통합(SMTP, Slack, Citadel, TheHive, MISP, CyberWatch 피드 등)을 한 곳에서 보고, 편집하고, 테스트할 수 있으며, 암호화된 자격 증명 저장 및 커넥터별 상태 검사를 제공합니다.
- **스마트 알림** - CyberWatch 및 UDRP 결정을 포함한 모든 모듈에서 중요한 발견 사항 및 임계값 위반에 대해 이메일, Slack 또는 Citadel 경고를 수신합니다
- **대화형 API 문서** - drf-spectacular 기반으로 `/api/docs/`에서 자동 생성된 Swagger UI와 `/api/schema/`에서 OpenAPI 3 스키마를 제공합니다
- **티켓팅 시스템 통합** - 보안 발견 사항을 티켓팅 시스템에 자동으로 전달합니다
- **포괄적인 관리자 인터페이스** - Django의 강력한 관리자 패널을 통해 Watcher의 모든 측면을 관리합니다
- **고급 액세스 제어** - 팀 협업을 위한 세분화된 사용자 권한 및 그룹 관리
- **현대적인 UI 경험** - 사용자 정의 가능한 테마, 크기 조정 가능한 대시보드 패널, 저장된 필터 세트를 통한 고급 필터링, 지속적인 사용자 기본 설정을 갖춘 현대적인 인터페이스
## 관련 종속성
Watcher는 오픈 소스 도구와 라이브러리를 활용합니다:
- [**Hugging Face Transformers**](https://huggingface.co/docs/transformers) - 위협 인텔리전스 요약 및 엔터티 추출을 지원하는 AI/ML 프레임워크
- [**google/flan-t5-base**](https://huggingface.co/google/flan-t5-base) - AI 기반 위협 요약을 위한 텍스트-투-텍스트 생성 모델
- [**dslim/bert-base-NER**](https://huggingface.co/dslim/bert-base-NER) - 자동 IOC 추출을 위한 개체명 인식
- [**certstream**](https://github.com/CaliDog/certstream-python) - 인증서 투명성 모니터링
- [**dnstwist**](https://github.com/elceef/dnstwist) - 도메인 이름 순열 엔진
- [**SearxNG**](https://github.com/searxng/searxng) - 프라이버시를 존중하는 메타검색 엔진
- [**PyMISP**](https://github.com/MISP/PyMISP) - MISP 위협 인텔리전스 플랫폼 통합
- [**TLSH**](https://github.com/trendmicro/tlsh) - 콘텐츠 유사성 탐지를 위한 퍼지 해싱
- [**mozilla-django-oidc**](https://github.com/mozilla/mozilla-django-oidc) - OpenID Connect 인증 백엔드
- [**drf-spectacular**](https://github.com/tfranzel/drf-spectacular) - OpenAPI 3 스키마 생성 및 Swagger UI
- [**deck.gl**](https://deck.gl/) - WebGL 기반 지리공간 시각화 (WorldMap)
- [**MUI (Material UI)**](https://mui.com/) - KPI 카드 및 차트를 위한 React 컴포넌트 라이브러리
- [**shadow-useragent**](https://github.com/lobstrio/shadow-useragent) - User-Agent 로테이션 라이브러리
- [**NLTK**](https://www.nltk.org/) - 텍스트 처리를 위한 자연어 툴킷
## 앱 미리보기
아래의 모든 스크린샷은 가상의 데이터(가상의 회사 "Altair Dynamics")를 사용합니다.
### 개요
<p align="center">
<img alt="Watcher overview" src="https://assets.kitploit.com/production/public/readmes/6816/889d64658ee29d7353793743d722d13bd2b5f58a142bb5efc6b7c7ec03603597/812c719e0184976df24e7c7d019304746e93926ca563d1e771a383ef94ec2a0d-display-v1.webp" width="90%">
</p>
플랫폼 투어: AI 주간 보고서 및 속보, 위협 대시보드, 정상 및 의심스러운 도메인, DNS 위협, 데이터 유출 및 Cyber Watch.
### 위협 탐지
<p align="center">
<img alt="Threats Watcher" src="https://assets.kitploit.com/production/public/readmes/6816/62c2f6d7e36b9834c3213b656e0f76d338c672917d34bd9f310c41f012a9eb9d.gif" width="90%">
</p>
### AI 기반 주간 요약 및 속보
<p align="center">
<img alt="Weekly Summary & Breaking News" src="https://assets.kitploit.com/production/public/readmes/6816/32b2deddcff921f71a0b2ec64f84a1f0cd09af4bdeff954bacb8abd403dc0c56.gif" width="90%">
</p>
### 의심스러운 도메인 이름 탐지
<p align="center">
<img alt="Suspicious domain names detection" src="https://assets.kitploit.com/production/public/readmes/6816/4fc4e63889f7ef887c38112c7a452f3cb48c45fb15fb797cb49f007389ce8bdd.gif" width="90%">
</p>
### 정상 도메인 목록
<p align="center">
<img alt="Legitimate Domain" src="https://assets.kitploit.com/production/public/readmes/6816/a1db0ca561dc515642311ad9c57e0c4a13d739ce7d7ea383b5edbb267408954e.gif" width="90%">
</p>
*One item per line* 토글을 사용하여 여러 도메인을 한 번에 추가하세요: 디펜그된 링크가 복원되고, *Preview*가 저장 전에 결과를 보여주며, 요약에는 생성됨, 건너뜀 또는 오류로 표시된 모든 도메인이 나열됩니다.
### 데이터 유출 탐지
<p align="center">
<img alt="Data Leak Detection" src="https://assets.kitploit.com/production/public/readmes/6816/0efc4cb08ee39066c82dcff002bebbb9dbb123e62b1462e112dd51f255391030.gif" width="90%">
</p>
### 의심스러운 도메인 이름 모니터링
<p align="center">
<img alt="Suspicious domain names monitoring" src="https://assets.kitploit.com/production/public/readmes/6816/22089bdbcf891c978ff028cef7bf6b7a8e4b039affe84bfaa6456174aae317b3.gif" width="90%">
</p>
여러 도메인을 선택하고 정당성, 테이크다운, 법적 및 차단 플래그를 함께 변경하세요.
### 일괄 작업 및 내보내기
<p align="center">
<img alt="Bulk actions" src="https://assets.kitploit.com/production/public/readmes/6816/6ffaf564e82a83d943cd3fabe66d79808ca72af7b06c6a322b70224a190a01a0/250bfeac45daa277f4972dee424ca4063524f2af37f2ec48286c8052dc8f1332-display-v1.webp" width="90%">
</p>
오탐은 일괄적으로 정상 도메인으로 내보낼 수 있습니다: 내보낸 사이트는 페이지 새로고침 없이 웹사이트 모니터링에서 사라지고 정상 목록에 나타납니다.
### Cyber Watch
<p align="center">
<img alt="Cyber Watch" src="https://assets.kitploit.com/production/public/readmes/6816/db6600625f050dddebb7f0534f4cef8d5c193f1afa87bbb67f0cd1d4f85c1e5e/8e74510b574b4d6c0384f8547eb2da15c04bcc1d04abbe4da38d42b61ecb7bf2-display-v1.webp" width="90%">
</p>
규칙, 모니터링 키워드 및 RSS 소스를 감시하고, 이들이 생성하는 CVE 및 랜섬웨어 매치를 확인하세요.
### 모든 변경 내역
<p align="center">
<img alt="Timeline history" src="https://assets.kitploit.com/production/public/readmes/6816/521ead163a778ba959570582b4eaff79a70c0e177f61d6a38c9847ba3167fcee/2284f87e67030806393ed8fd836b23db69c16cb6bc13091f249d1d337325335a-display-v1.webp" width="90%">
</p>
모든 생성, 업데이트 및 삭제가 작성자와 함께 기록되므로 누가 무엇을 언제 변경했는지 확인할 수 있습니다.
### 사용자 지정 가능한 대시보드
<p align="center">
<img alt="대시보드 레이아웃" src="https://assets.kitploit.com/production/public/readmes/6816/1725ea872465a60e59fef9c825988e060cf53cf305491f414f53461d7354d70a/b2d3fd7e3f949c84a89a2c46695acdcdc30e926cf4b0946bab2c69b04c38fbd5-display-v1.webp" width="90%">
</p>
패널을 표시, 숨기기, 이동 및 크기 조정할 수 있습니다. 레이아웃은 프로필에 저장됩니다.
### 테마 미리보기
<p align="center">
<img alt="테마 환경설정 1" src="https://assets.kitploit.com/production/public/readmes/6816/fbf617489fff9bc0c0ffe42a8b11e3a9fe55e9cd3983e36ef672b28ba931866b.gif" width="45%">
<img alt="테마 환경설정 2" src="https://assets.kitploit.com/production/public/readmes/6816/4b4cd39dea20c42dabbd06568fd8bd775f4f99ed9829f9e7e037a03ceb61df77.gif" width="45%">
</p>
<p align="center">
<img alt="테마 환경설정 3" src="https://assets.kitploit.com/production/public/readmes/6816/684a9ea44b83d902bd472186b01940dfa3103cc3f7d84f7a63221f277201ee57.gif" width="45%">
<img alt="테마 환경설정 4" src="https://assets.kitploit.com/production/public/readmes/6816/219137924c2313f86e8284b0a98ec394ec4fd685a2d4054743f1bb59cc7e60cb.gif" width="45%">
</p>
Watcher는 사용자의 선호도와 작업 환경에 맞는 다양한 시각적 테마를 제공합니다.
### 관리자 인터페이스
<p align="center">
<img alt="관리자 인터페이스" src="https://assets.kitploit.com/production/public/readmes/6816/7414067a08daf38145261589e72b4e0ddee70f23a9d18d2f01383af434b96c99.gif" width="90%">
</p>
Django는 관리 활동을 위한 즉시 사용 가능한 사용자 인터페이스를 제공합니다. 관리자 인터페이스가 웹 프로젝트에서 얼마나 중요한지 모두 알고 있습니다: 사용자 관리, 사용자 그룹 관리, Watcher 구성, 사용 로그...
## 설치
```bash
# 1. Clone the repo
git clone https://github.com/thalesgroup-cert/watcher.git
cd watcher/deployment
# 2. Initialize environment, configs & directory structure
make init
# 3. Start the stack
make up
# 4. On first run: run database migrations + create superuser
make migrate
make superuser
make populate-db
# 5. Open the web UI
# http://localhost:9002 (or your configured domain/port)
```
Docker를 사용하여 단 **10분** 만에 Watcher를 설치하고 실행하세요. **자세한 지침은 [설치 가이드](https://thalesgroup-cert.github.io/Watcher/README.html)에서 확인할 수 있습니다.**
## 플랫폼 아키텍처
```mermaid
flowchart LR
subgraph SRC["External sources"]
RSS["RSS / CERT advisories"]
CVE["CVE & ransomware feeds"]
CT["Certificate Transparency"]
WEB["Paste sites & code registries"]
RSS ~~~ CVE ~~~ CT ~~~ WEB
end
subgraph HOST["Host server (Docker)"]
TRAEFIK["Traefik<br/>TLS reverse proxy"]
subgraph WATCHER["Watcher (Django)"]
UI["React UI / Django admin"]
API["Django REST API"]
JOBS["Scheduled jobs (APScheduler)<br/>Threats · CyberWatch · DNS Threats<br/>Data Leak · Website Monitoring"]
CONN["Connectors"]
end
CERTSTREAM["CertStream"]
SEARX["SearXNG"]
DB[("MySQL")]
end
subgraph OUT["Outputs"]
HIVE["TheHive"]
MISP["MISP"]
CHAT["Slack / Citadel"]
MAIL["Email (SMTP)"]
end
ANALYST(["Analyst"]) --> TRAEFIK --> UI
UI <--> API
API <--> DB
JOBS <--> DB
RSS & CVE --> JOBS
CT --> CERTSTREAM --> JOBS
WEB --> SEARX --> JOBS
JOBS --> CONN
API --> CONN
CONN --> HIVE & MISP & CHAT & MAIL
```
Watcher의 모듈식 아키텍처는 확장성, 안정성, 그리고 기존 보안 스택과의 손쉬운 통합을 보장합니다.
## 기여
보안 커뮤니티의 기여를 환영합니다!
버그 신고, 기능 요청 또는 코드 제출을 위해서는 전체 [기여 가이드](https://github.com/thalesgroup-cert/watcher/blob/master/CONTRIBUTING.md)를 읽어 주시기 바랍니다.
## Pastebin 규정 준수
Watcher의 pastebin API 기능을 사용하려면 pastebin pro 계정을 구독하고 Watcher의 공인 IP를 화이트리스트에 등록해야 합니다(https://pastebin.com/doc_scraping_api 참조).