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. .envを作成 このディレクトリ（docker-compose.ymlと同じフォルダ）に：

   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の場合、データは backend_data ボリュームの /app/data/threat_intel.db にあります。
  • ローカル開発（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/ドメインレピュテーションおよびマルウェアフィード。
• より深いインジケーターインテリジェンス: 各インジケーターと国クラスターの詳細情報を拡充。