BHEU Demos

Questo repository contiene tre demo per la conferenza Black Hat Europe 2025 The Forensic Trail On GitHub: Hunting For Supply Chain Activity

1. potential_attacks_demo: Un'applicazione web Flask che mostra una demo di identificazione e investigazione di un attacco basato sul flusso pubblico di GH.
2. ghdig: Uno strumento da riga di comando per investigare l'attività su GitHub.
3. gitthrunter: Un piccolo strumento che identifica attività sospette su GitHub, le arricchisce e le presenta per ulteriori indagini.

potential_attacks_demo

Esecuzione della demo

1. Naviga nella directory potential_attacks_demo:
   root@kitploit:~

   cd potential_attacks
   

2. Installa le dipendenze richieste:
   root@kitploit:~

   pip install -r requirements.txt
   

3. Esegui l'applicazione Flask:
   root@kitploit:~

   flask run
   

4. Apri il tuo browser web e vai su http://127.0.0.1:5000 per vedere la demo.

ghdig

Installazione

1. Naviga nella directory ghdig:
   root@kitploit:~

   cd ghdig
   

2. Installa le dipendenze richieste:
   root@kitploit:~

   pip install -r requirements.txt
   

Configurazione

ghdig richiede un token di accesso personale di GitHub per interagire con l'API di GitHub.

1. Crea un file chiamato .env nella directory ghdig.

2. Aggiungi il tuo token GitHub al file in questo modo:

   root@kitploit:~

   GITHUB_TOKEN=your_github_token_here
   

Utilizzo

Lo strumento viene eseguito come modulo Python dalla radice del progetto.

python -m ghdig <comando> [opzioni]

Comandi

Ecco i comandi disponibili e esempi di come utilizzarli:

• gist: Gestisce i Gist di GitHub.

  • Utilizzo: python -m ghdig gist <gist_id_or_url>
  • Esempio: python -m ghdig gist https://gist.github.com/mmvojwip/e9975a3a16acc492e3e7f677b6276cb2

• pr: Gestisce le Pull Request di GitHub.

  • Utilizzo: python -m ghdig pr <repo_url>
  • Esempio: python -m ghdig pr https://github.com/7finney/ethcode

• commit: Gestisce i Commit di GitHub.

  • Utilizzo: python -m ghdig commit <commit_url>
  • Esempio: python -m ghdig commit https://github.com/mmvojwip/agentkit/commit/023f11f08cc7b82036a78580202143381d703b9a

• user: Analizza un utente GitHub.

gitthrunter

Installazione

1. Naviga nella directory gitthrunter:
   root@kitploit:~

   cd gitthrunter
   

2. Installa le dipendenze richieste:
   root@kitploit:~

   pip install -r requirements.txt
   

Utilizzo

Per eseguire una query, esegui lo script main.py e fornisci il percorso del file di query SQL situato nella directory queries/.

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

Nota: --start_date potrebbe essere necessario per ridurre la dimensione della query

Poi, arricchisci i dati dell'attore:

python main.py potential_attacks.sql --enrich

Nota: l'arricchimento potrebbe avere problemi con i limiti di velocità se non è configurato un token GitHub

Infine, avvia l'app:

python app.py