beppause/smtp-ethical-hack

1---2title: smtp-ethical-hack3app_file: main.py4sdk: gradio5sdk_version: 5.46.06---7# SMTP Ethical Hack - Email Sender Testing8 9![Gradio](https://img.shields.io/badge/🤗-Gradio%20App-blue)10![Python](https://img.shields.io/badge/Python-3.12%2B-green)11![License](https://img.shields.io/badge/License-MIT-yellow)12 13Un'applicazione Gradio per testare server SMTP e verificare se consentono l'invio di email con mittente personalizzato (spoofing).14 15## 🎯 Scopo del programma16 17Questo strumento permette di testare server SMTP per verificare se consentono l'invio di email con **mittente personalizzato** (spoofing) per scopi di testing di sicurezza e analisi tecnica.18 19### ⚠️ Utilizzo etico20 21Questo tool è destinato esclusivamente a:22- Testing di sicurezza e configurazione dei server SMTP23- Verifica delle policy anti-spoofing24- Scopi educativi e di analisi tecnica25 26## 🚀 Funzionalità27 28- **Interfaccia intuitiva** con Gradio29- **Supporto per mittenti spoofati** con formato esteso (Nome <email@dominio.com>)30- **Visualizzazione del dialogo SMTP** in tempo reale31- **Validazione avanzata** degli indirizzi email32- **Gestione SSL configurabile** (verifica disabilitabile)33- **Supporto allegati** multipli34- **Log completo** della comunicazione client-server35 36## 📦 Installazione locale37 38```bash39# Clona il repository40git clone <repository-url>41cd smtp_ethical_hack42 43# Installa le dipendenze44pip install -r requirements.txt45 46# Avvia l'applicazione47python main.py48```49 50## 🌐 Deployment su Hugging Face Spaces51 52L'applicazione è ottimizzata per il deployment su Hugging Face Spaces:53 54### Opzione 1: Interfaccia Web551. Crea un nuovo Space su [Hugging Face](https://huggingface.co/spaces)562. Imposta il tipo a **Gradio**573. Carica tutti i file del progetto584. L'applicazione si avvierà automaticamente59 60### Opzione 2: Hugging Face CLI (Consigliato)61```bash62# Installa l'Hugging Face CLI (se non già installato)63pip install huggingface_hub64# Oppure con uv:65uv pip install huggingface_hub66 67# Autenticazione (se huggingface-cli non funziona, usa questo comando Python)68python -c "from huggingface_hub import login; login()"69 70# Crea il repository (sostituisci <username> con il tuo)71huggingface-cli repo create <username>/smtp-ethical-hack --type space --space-sdk gradio72 73# Clona il repository74git clone https://huggingface.co/spaces/<username>/smtp-ethical-hack75cd smtp-ethical-hack76 77# Copia tutti i file del progetto78cp -r ../smtp_ethical_hack/* .79cp -r ../smtp_ethical_hack/src/ .80cp ../smtp_ethical_hack/requirements.txt .81cp ../smtp_ethical_hack/README.md .82 83# Commit e push84git add .85git commit -m "Deploy SMTP Ethical Hack application"86git push87```88 89### File necessari per Hugging Face:90- `app.py` - File principale per il deployment91- `requirements.txt` - Dipendenze Python92- Tutti i file nella cartella `src/`93- `README.md` - Questa documentazione94 95## 🛠️ Utilizzo96 971. **Configurazione SMTP**: Inserisci server, porta, username e password982. **Contenuto email**: Specifica mittente, destinatario, oggetto e corpo993. **Opzioni sicurezza**: Configura TLS e verifica SSL1004. **Invio**: Premi "Send Email" e monitora il log SMTP101 102### Esempi di testing:103- Verifica se un server accetta `bill.gates@microsoft.com` come mittente104- Testa policy anti-spoofing con mittenti arbitrari105- Analizza il comportamento dei server con diversi formati106 107## 📁 Struttura del progetto108 109```110smtp_ethical_hack/111├── app.py                 # File per Hugging Face deployment112├── main.py               # File principale per esecuzione locale113├── requirements.txt      # Dipendenze Python114├── src/115│   ├── __init__.py      # Package initialization116│   ├── email_sender.py  # Classe per gestione SMTP e invio email117│   └── gradio_app.py    # Classe per interfaccia utente Gradio118└── README.md            # Documentazione119```120 121## 🔧 Tecnologie utilizzate122 123- **Python 3.12+**124- **Gradio** - Interfaccia utente web125- **smtplib** - Client SMTP nativo Python126- **email** - Gestione email e allegati127 128## 📄 Licenza129 130Questo progetto è rilasciato sotto licenza MIT. Vedere il file LICENSE per maggiori dettagli.131 132## ⚠️ Disclaimer133 134Questo tool è destinato esclusivamente a scopi educativi e di testing autorizzato. L'utilizzo per attività illegali o non autorizzate è severamente proibito. Gli sviluppatori non si assumono alcuna responsabilità per l'uso improprio di questo software.135 136## 🤝 Contributi137 138I contributi sono benvenuti! Sentiti libero di:139- Segnalare bug o problemi140- Proporre nuove funzionalità141- Inviare pull request142 143---144 145**Nota**: Utilizzare sempre questo tool in ambienti controllati e con autorizzazione esplicita per il testing.146