Update README.md

Author: Bulletdev

README.md

@@ -1,2 +1,84 @@
-# GitPentest
- Pentest github
+# <div align="center">
+  <h1>🔒 Bullet Security Pentest Script</h1>
+  <p>Ferramenta em Python para análise de segurança em repositórios do GitHub</p>
+  <img src="https://img.shields.io/badge/GitHub-API-blue?logo=github&style=flat-square" alt="GitHub API">
+  <img src="https://img.shields.io/badge/Python-3.x-blue?logo=python&style=flat-square" alt="Python 3.x">
+</div>
+
+---
+
+## 🚀 Funcionalidades
+
+<div style="display: flex; flex-direction: column; gap: 10px;">
+  
+- **🔐 Acesso a repositório privado**  
+  <span>Verifica se um repositório privado pode ser acessado sem a devida permissão.</span>
+
+- **📝 Modificação de repositório**  
+  <span>Testa a possibilidade de alterar descrições de repositórios sem autorização.</span>
+
+- **💥 Injeção de código em workflows**  
+  <span>Tenta injetar um payload malicioso em workflows do GitHub Actions.</span>
+
+- **🔑 Exposição de secrets**  
+  <span>Checa se há acesso não autorizado aos secrets configurados no repositório.</span>
+
+- **🔍 Escopo de token**  
+  <span>Verifica se o token utilizado permite a criação de issues indevidas.</span>
+
+- **👥 Manipulação de colaboradores**  
+  <span>Testa se colaboradores podem ser adicionados sem permissão.</span>
+
+- **🚨 Proteção de branches**  
+  <span>Verifica se configurações de proteção de branch podem ser alteradas.</span>
+
+- **📜 Análise de logs de CI**  
+  <span>Avalia se há exposição de dados sensíveis nos logs de execução.</span>
+
+- **📊 Acesso GraphQL**  
+  <span>Testa o endpoint GraphQL para verificar dados avançados do repositório.</span>
+
+- **🌐 Injeção de webhook**  
+  <span>Tenta adicionar um webhook malicioso ao repositório.</span>
+
+</div>
+
+---
+
+## 📋 Pré-requisitos
+
+<div style="display: flex; flex-direction: column; gap: 10px;">
+  
+- **Python 3.x**
+- **Biblioteca requests** – para instalar, use:
+  
+  ```bash
+  pip install requests
+</div>
+⚙️ Configuração
+<div style="display: flex; flex-direction: column; gap: 10px;">
+Clone este repositório:
+
+bash
+Copiar código
+git clone https://github.com/bulletdev/bullet-security-pentest
+cd bullet-security-pentest
+Insira seu token do GitHub no lugar de ZZZZZZZZ no código:
+
+python
+Copiar código
+GITHUB_TOKEN = "ZZZZZZZZ"  # Insira seu token do GitHub aqui
+Atualize os parâmetros, como o nome do repositório e o ID do workflow, conforme necessário.
+
+</div>
+💻 Uso
+Para executar o script, use:
+
+bash
+Copiar código
+python script_pentest.py
+O script exibirá os resultados no console, indicando se foram detectadas vulnerabilidades ou permissões incorretas.
+
+⚠️ Aviso
+<div style="background-color: #fff3cd; padding: 10px; border-left: 5px solid #ffecb5;"> <strong>Este script destina-se exclusivamente a fins educacionais e de pesquisa em segurança cibernética em seus próprios repositórios ou com permissão explícita.</strong> O uso não autorizado em repositórios de terceiros pode violar as políticas de GitHub e a legislação aplicável. </div>
+<div align="center"> <h3>👤 Autor</h3> <p>Desenvolvido por <a href="https://github.com/bulletdev">bulletdev</a></p> </div> ```