SSL Global Guard 🛡️

SSL Global Guard è un monitor leggero in Python che verifica se un sito web è raggiungibile e se il suo certificato SSL è valido e prossimo alla scadenza.

Risolve un problema semplice ma critico: i certificati scaduti e i siti web non funzionanti vengono spesso scoperti troppo tardi. Con una modalità CLI e un endpoint API Flask, SSL Global Guard può essere utilizzato localmente, integrato in strumenti di automazione come n8n o collegato a flussi di lavoro di monitoraggio personalizzati.

✨ Caratteristiche Principali

• 🔐 Validazione del certificato SSL con giorni rimanenti esatti e data di scadenza.
• 🌐 Verifica della disponibilità del sito web prima di validare il certificato.
• 🚨 Risposte chiare per i fallimenti per siti web offline, URL non validi, errori HTTP e certificati scaduti.
• ⚡ Doppia modalità d'uso: eseguilo da riga di comando o esponilo come API Flask locale.
• 🔁 Output JSON adatto all'automazione progettato per strumenti di workflow come n8n.

📸 Screenshot / Demo

🚀 Installazione

1. Clona il repository

git clone https://github.com/arcangelorosato-dev/ssl-global-guard.git
cd ssl-global-guard

2. Crea e attiva un ambiente virtuale

python3 -m venv .venv
source .venv/bin/activate

Su Windows:

python -m venv .venv
.venv\Scripts\activate

3. Installa le dipendenze

pip install -r requirements.txt

⚙️ Utilizzo

Esegui un controllo SSL rapido da CLI

python main.py example.com

Output di esempio:

avvio controllo cli per: example.com
---
status: success
url: example.com
ssl_valido: True
giorni_rimanenti: 120
data_scadenza: 13/09/2026
messaggio: certificato ssl valido e verificato

Avvia l'API Flask locale

python main.py

Il server si avvierà su:

http://localhost:5000

Controlla un sito web tramite API

curl -X POST http://localhost:5000/check-ssl \
  -H "Content-Type: application/json" \
  -d '{"url": "example.com"}'

Risposta JSON di esempio:

{
  "status": "success",
  "url": "example.com",
  "ssl_valido": true,
  "giorni_rimanenti": 120,
  "data_scadenza": "13/09/2026",
  "messaggio": "certificato ssl valido e verificato"
}

Esempio di risposta in caso di fallimento

{
  "status": "failed",
  "url": "invalid-domain.test",
  "ssl_valido": false,
  "giorni_rimanenti": -1,
  "data_scadenza": "N/D",
  "messaggio": "❌ il sito è offline o l'url è inesistente"
}

🧰 Tecnologie Utilizzate

🗺️ Roadmap

• Aggiungere soglie di avviso configurabili per i certificati in scadenza imminente.
• Aggiungere esempi di avvisi tramite email, Slack, Telegram o Discord.
• Fornire un Dockerfile per distribuzioni containerizzate.
• Aggiungere test automatizzati per il comportamento di CLI e API.
• Aggiungere GitHub Actions per linting e controlli di test.
• Migliorare la localizzazione delle risposte e offrire template di messaggi in inglese/italiano.

🤝 Contribuire

I contributi sono benvenuti e apprezzati.

Per contribuire:

1. Effettua il fork del repository.
2. Crea un nuovo branch:

git checkout -b feature/nome-della-tua-feature

3. Apporta le tue modifiche e committale:

git commit -m "Aggiungi la tua feature"

4. Esegui il push del tuo branch:

git push origin feature/nome-della-tua-feature

5. Apri una Pull Request con una chiara descrizione delle tue modifiche.

Prima di inviare, assicurati che il tuo codice sia mirato, leggibile e facile da revisionare.

📄 Licenza

Questo progetto è rilasciato sotto la Licenza MIT.

Sei libero di usarlo, modificarlo e distribuirlo secondo i termini della licenza.