BHEU デモ

このリポジトリには、Black Hat Europe 2025 の The Forensic Trail On GitHub: Hunting For Supply Chain Activity のための3つのデモが含まれています。

1. potential_attacks_demo: 公開された GH ファイアホースをもとに、攻撃の特定と調査を行うデモを表示する Flask Web アプリケーション。
2. ghdig: GitHub アクティビティを調査するためのコマンドラインツール。
3. gitthrunter: 不審な GitHub アクティビティを特定し、エンリッチし、さらに調査するためにレンダリングするトイツール。

potential_attacks_demo

デモの実行

1. potential_attacks_demo ディレクトリに移動します:
   root@kitploit:~

   cd potential_attacks
   

2. 必要な依存関係をインストールします:
   root@kitploit:~

   pip install -r requirements.txt
   

3. Flask アプリケーションを実行します:
   root@kitploit:~

   flask run
   

4. ウェブブラウザを開き、http://127.0.0.1:5000 にアクセスしてデモを確認します。

ghdig

インストール

1. ghdig ディレクトリに移動します:
   root@kitploit:~

   cd ghdig
   

2. 必要な依存関係をインストールします:
   root@kitploit:~

   pip install -r requirements.txt
   

設定

ghdig は GitHub API とやり取りするために GitHub Personal Access Token を必要とします。

1. ghdig ディレクトリ内に .env という名前のファイルを作成します。

2. 以下のように GitHub トークンをファイルに追加します:

   root@kitploit:~

   GITHUB_TOKEN=your_github_token_here
   

使用方法

このツールはプロジェクトのルートから Python モジュールとして実行します。

python -m ghdig <command> [options]

コマンド

以下が利用可能なコマンドとその使用例です:

• gist: GitHub Gist を処理します。

  • 使用法: python -m ghdig gist <gist_id_or_url>
  • 例: python -m ghdig gist https://gist.github.com/mmvojwip/e9975a3a16acc492e3e7f677b6276cb2

• pr: GitHub プルリクエストを処理します。

  • 使用法: python -m ghdig pr <repo_url>
  • 例: python -m ghdig pr https://github.com/7finney/ethcode

• commit: GitHub コミットを処理します。

  • 使用法: python -m ghdig commit <commit_url>
  • 例: python -m ghdig commit https://github.com/mmvojwip/agentkit/commit/023f11f08cc7b82036a78580202143381d703b9a

• user: GitHub ユーザーを分析します。

gitthrunter

インストール

1. gitthrunter ディレクトリに移動します:
   root@kitploit:~

   cd gitthrunter
   

2. 必要な依存関係をインストールします:
   root@kitploit:~

   pip install -r requirements.txt
   

使用方法

クエリを実行するには、main.py スクリプトを実行し、queries/ ディレクトリ内の SQL クエリファイルへのパスを指定します。

python main.py potential_attacks.sql --start_date "2025-09-01 00:00:00"

注: クエリサイズを削減するために --start_date が必要な場合があります

次に、アクターデータをエンリッチします:

python main.py potential_attacks.sql --enrich

注: GitHub トークンが設定されていない場合、エンリッチメントはレート制限に問題が発生する可能性があります

最後に、アプリを起動します:

python app.py