openSquat Core

📑 Indice

• Cos'è openSquat?
• Menzionato in
• Modello Open-Core
• Caratteristiche principali
• Avvio rapido
• Requisiti
• Utilizzo
• Modalità Premium e API
• Configurazione
• Automazione
• Riferimento CLI
• Contribuire
• Autore
• Licenza

🎯 Cos'è openSquat?

openSquat è uno strumento di sicurezza OSINT (Open Source Intelligence) che identifica minacce di cybersquatting mirate al tuo marchio o ai tuoi domini:

🌟 Menzionato in

"Un potente coltellino svizzero per la protezione del marchio" — Blog WhoisXML API, agosto 2022

"Uno strumento con un potere pazzesco per combattere il typosquatting e tutti i tipi correlati di malefatte informatiche." — Blog WhoisXML API, agosto 2022

"Uno strumento utile per raccogliere informazioni su domini di nuova registrazione." — Classificato tra i primi 5 strumenti di rilevamento phishing — Blog SOCRadar, luglio 2022

"openSquat fornisce una protezione essenziale contro gli attacchi di domain squatting e phishing attraverso il monitoraggio e il rilevamento automatizzati." — Prince Yadav, TutorialsPoint, marzo 2026

Citazione accademica

"OpenSquat ha identificato 103 domini squatting, 960 siti web di phishing attivi e 53 domini con certificati sospetti." — Sharma et al., Journal of Information Security and Cybercrimes Research (JISCR), Vol. 7, Numero 1, giugno 2024

🔓 Modello Open-Core

openSquat segue un modello open-core:

• Motore di rilevamento principale — Open source e guidato dalla comunità
• Capacità avanzate — Fornite attraverso servizi di intelligence commerciali

Questo modello consente trasparenza e collaborazione della comunità, supportando al contempo i requisiti di scala, affidabilità e operativi per l'uso aziendale.

✨ Caratteristiche principali

• 📅 Feed NRD giornalieri — Aggiornamenti automatici dei domini di nuova registrazione
• 🔍 Rilevamento di similarità — Algoritmo della distanza di Levenshtein
• 🔓 Tre modalità operative — Community (feed gratuito), Premium Feed (feed a pagamento, stesso pipeline locale) o Premium API (servizio di domini simili ospitato). Le due modalità Premium condividono una singola chiave API openSquat — vedere Modalità Premium e API.
• 🛡️ Integrazione VirusTotal — Verifica la reputazione del dominio
• 🌐 Validazione DNS Quad9 — Identifica domini dannosi
• 📜 Trasparenza dei certificati — Monitora i certificati SSL/TLS
• 📊 Formati di output multipli — TXT, JSON, CSV

🚀 Avvio rapido

Installazione tramite pip (consigliata)

pip install opensquat
opensquat -k keywords.txt

Oppure clona il repository

git clone https://github.com/atenreiro/opensquat
cd opensquat
pip install -r requirements.txt
python3 opensquat.py -k keywords.txt

Utenti del repository: in tutti gli esempi seguenti, sostituisci opensquat con python3 opensquat.py per eseguire da una copia clonata.

📦 Requisiti

• Python 3.10+
• Dipendenze: confusable_homoglyphs, homoglyphs, colorama, requests, dnspython, beautifulsoup4

📖 Utilizzo

Comandi di base

# Esecuzione predefinita
opensquat

# Mostra tutte le opzioni
opensquat -h

# Usa un file di parole chiave personalizzato
opensquat -k my_keywords.txt

Opzioni di validazione

# Validazione DNS tramite Quad9
opensquat --dns

# Controlla i log di Certificate Transparency
opensquat --ct

# Scansiona porte aperte (80/443)
opensquat --portcheck

# Incrocia database di phishing
opensquat --phishing results.txt

Formati di output

# Salva come JSON
opensquat -o results.json -t json

# Salva come CSV
opensquat -o results.csv -t csv

Livelli di confidenza

Nota: Lato API (--api), i cinque livelli di confidenza corrispondono a quattro valori di fuzzyness (exact, low, auto, high) — -c 3 e -c 4 corrispondono entrambi a high. Vedi Modalità Premium e API per la mappatura completa e come sovrascrivere con --api-fuzziness.

💎 Modalità Premium e API

openSquat supporta tre modalità. La modalità predefinita (Community) è invariata — gli utenti esistenti non necessitano di opzioni. Le due modalità Premium condividono una singola chiave API openSquat; scegli Premium Feed se vuoi lo stesso pipeline di rilevamento locale con un feed più grande, o Premium API se vuoi rilevamento lato server senza download locale del feed.

Ottieni una chiave API

Registrati su opensquat.com per ottenere una chiave. La stessa chiave funziona sia per Premium Feed (--premium) che per Premium API (--api).

Fornisci la chiave API (ordine di priorità)

1. --api-key YOUR_KEY sulla riga di comando
2. Variabile d'ambiente OPENSQUAT_API_KEY
3. File api_key.txt nella directory corrente (una chiave per file, commenti # consentiti)

L'opzione CLI è visibile in ps. Preferisci la variabile d'ambiente o il file chiave in ambienti condivisi.

Esempi

# Modalità Premium Feed — stesso pipeline locale, feed più grande
export OPENSQUAT_API_KEY=os_xxxxxxxxxxxx
opensquat -k keywords.txt --premium

# Modalità Premium API — rilevamento lato server per parola chiave
opensquat -k keywords.txt --api

# Premium API + controllo reputazione DNS su ogni dominio restituito
opensquat -k keywords.txt --api --dns

# Premium API con output JSON raggruppato per parola chiave
opensquat -k keywords.txt --api -t json -o results.json

# Ottimizza la ricerca Premium API
opensquat -k keywords.txt --api --api-fuzziness high --api-history-days 7 --api-max-results 200

Quando --premium o --api caricano correttamente una chiave, la CLI stampa una riga di conferma mascherata in modo che tu possa verificare quale chiave è stata rilevata senza esporla:

[*] Chiave API caricata: os_gL...L5Mb

In modalità Premium API, il riepilogo dell'esecuzione riporta la modalità attiva, il numero di chiamate API effettuate e il saldo residuo con delta di utilizzo (ad esempio, 4972 (usati 4 di 4976 in questa esecuzione)). Le righe di avanzamento per parola chiave appaiono nello stesso ordine del file delle parole chiave anche se le chiamate vengono eseguite in parallelo. L'esaurimento della quota (HTTP 429) restituisce risultati parziali in modo elegante; errori di autenticazione (401) e errori di piano (403) interrompono con un messaggio chiaro.

Se il backend limita la velocità della tua richiesta (HTTP 429 con intestazione Retry-After), lo strumento lo distingue dall'esaurimento della quota: vedrai un avviso giallo [!] Limite di velocità raggiunto (riprova tra Ns) invece del messaggio rosso quota esaurita, i risultati parziali vengono comunque restituiti e il riepilogo conserva il saldo API reale in modo da vedere esattamente quanti crediti hai effettivamente utilizzato. Per evitare di attivare limiti di velocità su scansioni grandi, usa --api-rate-limit N per limitare le richieste in uscita al secondo su tutti i worker. Un valore di 8 è un punto di partenza sicuro per la maggior parte dei backend.

# Limita a 8 richieste/secondo su tutti i worker
opensquat -k keywords.txt --api --api-rate-limit 8

Raccomandazione sul formato di output

JSON è il formato di output consigliato per la modalità Premium API perché l'API restituisce metadati per dominio che gli altri formati non possono trasportare altrettanto pulitamente: il TLD registrato, la data di prima apparizione NRD, un flag IDN homograph e la resa Unicode dell'homograph quando il dominio lo è.

opensquat -k keywords.txt --api -t json -o results.json

Esempio dell'output più ricco in modalità Premium API (ridotto):

[
  {
    "keyword": "microsoft",
    "domains": [
      {"domain": "securite-microsoft.fr", "tld": "fr", "date": "09-04-2026", "idn": false},
      {"domain": "xn--mirosoft-hw7c.com", "tld": "com", "date": "09-04-2026", "idn": true, "unicode": "miᴄrosoft.com"}
    ]
  }
]

Il flag idn più la resa unicode ti permettono di vedere a colpo d'occhio che xn--mirosoft-hw7c.com è in realtà ᴄ (Lettera latina piccola capitale C) che impersona la c in "microsoft" — informazioni che una semplice stringa punycode nasconde completamente.

È supportato anche l'output CSV e produce una riga per dominio con le stesse colonne di metadati, adatto ad analisti che lavorano in Excel o pandas:

opensquat -k keywords.txt --api -t csv -o results.csv

Il CSV viene scritto con un BOM UTF-8 in modo che Excel su Windows visualizzi correttamente la colonna unicode dell'homograph.

Le modalità Community e Premium Feed emettono la stessa struttura JSON di alto livello per coerenza tra le modalità, ma con solo il campo domain popolato per voce — il feed NRD non trasporta i metadati per dominio che solo l'API ospitata ha:

[
  {
    "keyword": "microsoft",
    "domains": [
      {"domain": "mirosoft.com"},
      {"domain": "mcrosoft.net"}
    ]
  }
]

Se passi --api-key senza selezionare anche --premium o --api, la CLI stampa un suggerimento di una riga che la chiave verrà ignorata in modalità Community (nessun cambio di modalità silenzioso).

In modalità Premium API, -c/--confidence viene mappato automaticamente alla fuzzyness API (0→exact, 1→low, 2→auto, 3→high, 4→high). Usa --api-fuzziness per sovrascrivere.

Premium API (--api) è incompatibile con --doppelganger e -d/--domains.

⚙️ Configurazione

File delle parole chiave (keywords.txt)

# Le righe che iniziano con # sono commenti
mycompany
mybrand
myproduct

Chiave API VirusTotal (vt_key.txt)

Per usare --vt o --subdomains, aggiungi la tua chiave API:

# Ottieni la tua chiave API gratuita su https://www.virustotal.com
your_api_key_here

Chiave API openSquat (api_key.txt)

Richiesta per --premium e --api. Crea un file api_key.txt nella directory di lavoro:

# Ottieni la tua chiave su https://opensquat.com
# Le righe che iniziano con # vengono ignorate; viene utilizzata la prima riga non di commento.
os_your_key_here

La CLI risolve la chiave in questo ordine: flag --api-key → variabile d'ambiente $OPENSQUAT_API_KEY → file api_key.txt. I metodi variabile d'ambiente e file sono preferibili al flag CLI in ambienti condivisi, poiché gli argomenti CLI sono visibili tramite ps.

🤖 Automazione

Esegui quotidianamente tramite crontab:

# installato via pip (consigliato) — ogni giorno alle 8:00, i feed si aggiornano ~7:30 UTC
0 8 * * * cd /path/to/workdir && opensquat -k keywords.txt -o results.json -t json

# Repository checkout — invoca opensquat.py direttamente con python3
0 8 * * * cd /path/to/opensquat && python3 opensquat.py -k keywords.txt -o results.json -t json

Il cd in una directory di lavoro è importante se ti affidi a api_key.txt (risolto dalla directory corrente) o vuoi che results.json venga scritto in una posizione specifica.

📋 Riferimento CLI

🤝 Contribuire

Accogliamo con favore i contributi! Consulta la nostra Guida ai contributi per i dettagli.

• 🐛 Segnala bug tramite GitHub Issues
• 💡 Richiedi funzionalità aprendo un'issue
• 🔧 Invia PR per correzioni di bug o miglioramenti
• 📝 Note di rilascio — consulta il CHANGELOG per le novità di ogni versione

👤 Autore

Andre Tenreiro — LinkedIn · Chiave PGP

📜 Licenza

Questo progetto è concesso in licenza sotto GNU GPL v3.