DarkGrid – 글로벌 위협 인텔리전스 대시보드

OSINT 위협 인텔리전스 대시보드: AbuseIPDB 및 OpenPhish 같은 공개 소스의 악성 인프라를 보여주는 3D 지구본과 실시간 피드

https://github.com/user-attachments/assets/e4f6a4fa-6ff4-4ad1-8e5c-5b50ce6ad722

개요

DarkGrid는 전 세계적으로 의심스러운 인터넷 인프라를 시각화합니다:

• 지표량에 따라 국가별로 반짝이는 '핑'이 있는 3D 위협 지구본
• OSINT 수집기에서 가져온 최신 IP/URL의 위협 피드
• 지표나 지리적 위치로 이동할 수 있는 찾기/위치 표시줄
• 컨텍스트 카드(위협 클러스터, 지역 개요, 뉴스 등)를 위한 인텔 패널

초점은 개인이 아닌 인프라의 상황 인식에 있습니다.

프로젝트 구조

• backend/ – FastAPI + SQLite OSINT API
  • 수집기: AbuseIPDB (IP), OpenPhish (URL)
  • 스케줄러는 시작 시와 15분마다 수집기를 실행
  • /api/indicators/latest – 피드용 최신 지표
  • /api/map – 지구본용 국가별 버킷
• frontend/ – Next.js 16 앱 (DarkGrid UI)
  • src/app/page.tsx – 메인 대시보드 레이아웃
  • src/components/ThreatGlobeViewer.tsx – 3D 지구본
  • src/hooks/useThreatDataPolling.ts – 위협 API 폴링
• docker-compose.yml – 로컬 스택 (백엔드 + 프론트엔드)

빠른 시작 (Docker)

1. 이 디렉토리(docker-compose.yml과 같은 폴더)에 .env 파일을 생성합니다:

   root@kitploit:~

   copy .env.example .env
   

   .env를 편집하여 다음을 설정:

   • ABUSEIPDB_API_KEY – https://www.abuseipdb.com/에서 무료 키를 얻으세요.

2. 스택을 시작합니다:

   root@kitploit:~

   docker-compose up -d
   

   또는 로그를 보려면 포그라운드에서 실행:

   root@kitploit:~

   docker-compose up
   

3. UI와 API를 엽니다:

   • 대시보드: http://localhost:3000
   • 백엔드 API: http://localhost:8000
   • 상태 확인: http://localhost:8000/health

4. 코드 변경 후 재빌드:

   root@kitploit:~

데이터 및 수집

• 데이터베이스: SQLite, 백엔드 첫 시작 시 자동 생성됩니다.

  • Docker에서는 데이터가 /app/data/threat_intel.db의 backend_data 볼륨에 있습니다.
  • 로컬 개발(Docker 없음) 시 데이터는 backend/data/threat_intel.db에 있습니다.

• 수집기 (시작 시와 15분마다 실행):

  • AbuseIPDB (ABUSEIPDB_API_KEY 필요):

    • geo.country와 함께 type=ip, source=abuseipdb 지표를 생성합니다.
    • 위협 피드와 지구본 핑(국가 버킷) 모두에 공급합니다.

  • OpenPhish (키 불필요):

    • type=url, source=openphish 지표를 생성합니다 (지리 정보 없음).
    • 위협 피드에만 나타납니다 (지구본 핑 없음).

• 지구본/피드가 비어 있을 때 문제 해결:

  • 지구본에 핑이 없고 피드가 비어 있다면:
    • .env를 확인하여 가 설정되고 유효한지 확인하세요.

로컬 개발 (Docker 없이)

요구 사항:

• Python 3.11+
• Node.js 20+

백엔드

cd backend
python -m venv .venv
.venv\Scripts\activate  # on Windows
pip install -r requirements.txt
python main.py  # serves on http://localhost:8000

수집을 위해 루트 .env에 ABUSEIPDB_API_KEY가 있는지 확인하세요.

프론트엔드

cd frontend
npm install

frontend/.env.local 파일 생성 (로컬 개발 전용):

NEXT_PUBLIC_THREAT_API_URL=http://localhost:8000

그런 다음 실행:

npm run dev

http://localhost:3000을 엽니다.

상태

이 프로젝트는 진행 중인 작업이며 DarkGrid 위협 인텔리전스 대시보드의 대략적인 MVP입니다. 백엔드, 수집기, UI가 개선됨에 따라 파괴적인 변경이 있을 수 있습니다.

계획된 향후 단계는 다음과 같습니다:

• 더 풍부한 지구본 핑: 더 세분화된 버킷, 정제된 크기/애니메이션, 개선된 클릭 동작.
• 추가 OSINT 소스: AbuseIPDB와 OpenPhish 외에 더 많은 IP/URL/도메인 평판 및 악성코드 피드.
• 더 깊은 지표 인텔리전스: 각 지표 및 국가 클러스터에 대한 확장된 세부 정보.