BHEU Demonstrações

Este repositório contém três demonstrações para a Black Hat Europe 2025: A Trilha Forense no GitHub: Caçando Atividades na Cadeia de Suprimentos

1. potential_attacks_demo: Uma aplicação web Flask que demonstra a identificação e investigação de um ataque baseado no fluxo público do GH.
2. ghdig: Uma ferramenta de linha de comando para investigar atividades no GitHub.
3. gitthrunter: Uma ferramenta de brinquedo que identifica atividades suspeitas no GitHub, enriquece-as e as renderiza para investigação adicional.

---

potential_attacks_demo

Executando a demonstração

1. Navegue até o diretório potential_attacks_demo:

   cd potential_attacks
   

2. Instale as dependências necessárias:

   pip install -r requirements.txt
   

3. Execute a aplicação Flask:

   flask run
   

4. Abra seu navegador web e vá para http://127.0.0.1:5000 para ver a demonstração.

---

ghdig

Instalação

1. Navegue até o diretório ghdig:

   cd ghdig
   

2. Instale as dependências necessárias:

   pip install -r requirements.txt
   

Configuração

ghdig requer um Token de Acesso Pessoal do GitHub para interagir com a API do GitHub.

1. Crie um arquivo chamado .env no diretório ghdig.

2. Adicione seu token do GitHub ao arquivo assim:

   GITHUB_TOKEN=your_github_token_here
   

Uso

A ferramenta é executada como um módulo Python a partir da raiz do projeto.

python -m ghdig <comando> [opções]

Comandos

Aqui estão os comandos disponíveis e exemplos de como usá-los:

• gist: Lida com Gists do GitHub.

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

• pr: Lida com Pull Requests do GitHub.

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

• commit: Lida com Commits do GitHub.

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

• user: Analisa um usuário do GitHub.

  • Uso: python -m ghdig user <username_or_url>
  • Exemplo: python -m ghdig user mmvojwip

• render: Renderiza um relatório HTML de análise de usuário.

  • Uso: python -m ghdig render <username>
  • Exemplo: python -m ghdig render mmvojwip

• absence: Verifica usuários e repositórios ausentes a partir de uma consulta ClickHouse.

  • Uso: python -m ghdig absence "<query>"
  • Exemplo: python -m ghdig absence "$(< ghdig/tjactions_demo_query.sql)"

gitthrunter

Instalação

1. Navegue até o diretório gitthrunter:

   cd gitthrunter
   

2. Instale as dependências necessárias:

   pip install -r requirements.txt
   

Uso

Para executar uma consulta, execute o script main.py e forneça o caminho para seu arquivo de consulta SQL localizado no diretório queries/.

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

Nota: --start_date pode ser necessário para reduzir o tamanho da consulta

Em seguida, enriqueça os dados do ator:

python main.py potential_attacks.sql --enrich

Nota: o enriquecimento provavelmente terá problemas com limites de taxa se um token do GitHub não estiver configurado

Finalmente, inicie a aplicação:

python app.py