CoolFace
Apppublic

beppause/smtp-ethical-hack

sourceHugging Faceupdated 1y agoView on Hugging Face
0likes
App README

SMTP Ethical Hack - Email Sender Testing

Gradio Python License

Un'applicazione Gradio per testare server SMTP e verificare se consentono l'invio di email con mittente personalizzato (spoofing).

🎯 Scopo del programma

Questo 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.

⚠️ Utilizzo etico

Questo tool è destinato esclusivamente a:

  • —Testing di sicurezza e configurazione dei server SMTP
  • —Verifica delle policy anti-spoofing
  • —Scopi educativi e di analisi tecnica

🚀 Funzionalità

  • —Interfaccia intuitiva con Gradio
  • —Supporto per mittenti spoofati con formato esteso (Nome <email@dominio.com>)
  • —Visualizzazione del dialogo SMTP in tempo reale
  • —Validazione avanzata degli indirizzi email
  • —Gestione SSL configurabile (verifica disabilitabile)
  • —Supporto allegati multipli
  • —Log completo della comunicazione client-server

📦 Installazione locale

bash
# Clona il repository
git clone <repository-url>
cd smtp_ethical_hack

# Installa le dipendenze
pip install -r requirements.txt

# Avvia l'applicazione
python main.py

🌐 Deployment su Hugging Face Spaces

L'applicazione è ottimizzata per il deployment su Hugging Face Spaces:

Opzione 1: Interfaccia Web

  1. 1.Crea un nuovo Space su Hugging Face
  2. 2.Imposta il tipo a Gradio
  3. 3.Carica tutti i file del progetto
  4. 4.L'applicazione si avvierà automaticamente

Opzione 2: Hugging Face CLI (Consigliato)

bash
# Installa l'Hugging Face CLI (se non già installato)
pip install huggingface_hub
# Oppure con uv:
uv pip install huggingface_hub

# Autenticazione (se huggingface-cli non funziona, usa questo comando Python)
python -c "from huggingface_hub import login; login()"

# Crea il repository (sostituisci <username> con il tuo)
huggingface-cli repo create <username>/smtp-ethical-hack --type space --space-sdk gradio

# Clona il repository
git clone https://huggingface.co/spaces/<username>/smtp-ethical-hack
cd smtp-ethical-hack

# Copia tutti i file del progetto
cp -r ../smtp_ethical_hack/* .
cp -r ../smtp_ethical_hack/src/ .
cp ../smtp_ethical_hack/requirements.txt .
cp ../smtp_ethical_hack/README.md .

# Commit e push
git add .
git commit -m "Deploy SMTP Ethical Hack application"
git push

File necessari per Hugging Face:

  • —app.py - File principale per il deployment
  • —requirements.txt - Dipendenze Python
  • —Tutti i file nella cartella src/
  • —README.md - Questa documentazione

🛠️ Utilizzo

  1. 1.Configurazione SMTP: Inserisci server, porta, username e password
  2. 2.Contenuto email: Specifica mittente, destinatario, oggetto e corpo
  3. 3.Opzioni sicurezza: Configura TLS e verifica SSL
  4. 4.Invio: Premi "Send Email" e monitora il log SMTP

Esempi di testing:

  • —Verifica se un server accetta bill.gates@microsoft.com come mittente
  • —Testa policy anti-spoofing con mittenti arbitrari
  • —Analizza il comportamento dei server con diversi formati

📁 Struttura del progetto

smtp_ethical_hack/
├── app.py                 # File per Hugging Face deployment
├── main.py               # File principale per esecuzione locale
├── requirements.txt      # Dipendenze Python
├── src/
│   ├── __init__.py      # Package initialization
│   ├── email_sender.py  # Classe per gestione SMTP e invio email
│   └── gradio_app.py    # Classe per interfaccia utente Gradio
└── README.md            # Documentazione

🔧 Tecnologie utilizzate

  • —Python 3.12+
  • —Gradio - Interfaccia utente web
  • —smtplib - Client SMTP nativo Python
  • —email - Gestione email e allegati

📄 Licenza

Questo progetto è rilasciato sotto licenza MIT. Vedere il file LICENSE per maggiori dettagli.

⚠️ Disclaimer

Questo 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.

🤝 Contributi

I contributi sono benvenuti! Sentiti libero di:

  • —Segnalare bug o problemi
  • —Proporre nuove funzionalità
  • —Inviare pull request

Nota: Utilizzare sempre questo tool in ambienti controllati e con autorizzazione esplicita per il testing.