zscan

Uno strumento di rilevamento dei servizi veloce e personalizzabile, alimentato da un sistema di impronte digitali flessibile. Aiuta a identificare servizi, API e configurazioni di rete nella propria infrastruttura.

Documentazione | Funzionalità | Installazione | Utilizzo

✨Funzionalità

• Motore di scansione attivo: scansione delle porte e rilevamento dei servizi ad alte prestazioni e concorrenti
• Rilevamento intelligente:
  • Identificazione del vendor MAC (oltre 200 associazioni OUI)
  • Rilevamento di macchine virtuali (VMware, VirtualBox, Hyper-V, KVM, ecc.)
  • Impronta digitale del sistema operativo
• Targeting POC preciso:
  • Targeting POC ad alta precisione tramite impronte digitali
  • Più veloce e preciso rispetto agli scanner tradizionali
• Sistema di impronte digitali flessibile:
  • Supporto per definizioni di impronte personalizzate
  • Supporto per più protocolli (HTTP, HTTPS, TCP, UDP)
  • Pattern matching e analisi delle risposte
• Rilevamento dei servizi:
  • Identificazione dei servizi web
  • Rilevamento di framework applicativi comuni
  • Analisi della configurazione TLS/SSL
• Formati di output:
  • Output JSON per l'integrazione
  • Output console leggibile dall'uomo
  • Report remoto tramite API HTTP

📦 Installazione

Da binario

Scarica l'ultima versione da Releases

🚀 Utilizzo

Scansione attiva

# Scansione di un singolo IP
zscan -target 192.168.1.1

# Scansione di un range CIDR
zscan -target 192.168.1.0/24

# Scansione di più target (separati da ; o ,)
zscan -target "192.168.1.0/24;10.0.0.0/24"
zscan -target "192.168.1.1,192.168.1.2,192.168.1.3"

# Scansione di porte specifiche
zscan -target 192.168.1.1 -port 80,443,8080

# Salvataggio dei risultati in un file JSON
zscan -target 192.168.1.1 -output results.json

# Invio dei risultati a un server remoto
zscan -target 192.168.1.0/24 -report http://server/api/assets

Opzioni disponibili

Utilizzo come libreria Go

package main

import (
	"flag"
	"log"
	"os"
	"time"

	"github.com/zcyberseclab/zscan/pkg/stage"
)

func main() {
	target := flag.String("target", "", "IP address or CIDR range to scan")
	configPath := flag.String("config", "config/config.yaml", "Path to config file")
	templatesDir := flag.String("templates-dir", "templates", "Path to templates directory")
	enableGeo := flag.Bool("geo", false, "Enable geolocation and IP info lookup")
	enableCensys := flag.Bool("censys", false, "Enable Censys data enrichment")
	censysAPIKey := flag.String("censys-api-key", "", "Censys API Key")
	censysSecret := flag.String("censys-secret", "", "Censys API Secret")
	flag.Parse()

	if *target == "" {
		log.Fatal("Target IP or CIDR range is required")
	}

	// Handle Censys credentials from environment if not provided
	if *enableCensys {
		if *censysAPIKey == "" || *censysSecret == "" {
			*censysAPIKey = os.Getenv("CENSYS_API_KEY")
			*censysSecret = os.Getenv("CENSYS_SECRET")
		}
		if *censysAPIKey == "" || *censysSecret == "" {
			log.Printf("Warning: Censys integration enabled but credentials not provided. Skipping Censys data enrichment.")
			*enableCensys = false
		}
	}

	// Create scanner
	scanner, err := stage.NewScanner(*configPath, *templatesDir, *enableGeo, *enableCensys, *censysAPIKey, *censysSecret)
	if err != nil {
		log.Fatalf("Failed to create scanner: %v", err)
	}
	defer scanner.Close()

	// Perform scan
	startTime := time.Now()
	results, err := scanner.Scan(*target)
	if err != nil {
		log.Fatalf("Scan failed: %v", err)
	}

	// Print results
	if err := stage.PrintResults(results); err != nil {
		log.Printf("Error printing results: %v", err)
	}

	duration := time.Since(startTime)
	log.Printf("\nScan completed in: %v\n", duration)
}

Creare un Docker con Dockerfile

Esegui docker build -t zscan . per creare l'immagine.

Esegui docker run zscan --target 127.0.0.1 --config /app/config/config.yaml per avviare un container.

🔍 Scrivere POC

ZScan supporta lo sviluppo di POC personalizzati in formato YAML. Per informazioni dettagliate sulla scrittura dei POC, consulta la nostra Guida alla scrittura di POC.

Esempio di POC:

type: Path Traversal
cve-id: CVE-2021-41773
severity: critical
rules:
  - method: GET
    path: /icons/.%2e/%2e%2e/etc/passwd
    expression: "response.status==200 && response.body.bcontains(b'root:')"

Per ulteriori esempi e sintassi dettagliata, consulta la nostra Guida alla scrittura di POC.

La nostra missione

Gli scanner tradizionali di asset o vulnerabilità sono stati creati decenni fa. Sono chiusi, incredibilmente lenti e guidati dai vendor. Oggi gli attaccanti sfruttano massivamente le nuove CVE pubblicate su Internet nel giro di giorni, a differenza degli anni che servivano un tempo. Questo cambiamento richiede un approccio completamente diverso per contrastare gli exploit più diffusi su Internet.

Abbiamo creato ZScan per risolvere questa sfida. Abbiamo reso l'intero motore di scansione aperto e personalizzabile, consentendo alla community globale di sicurezza di collaborare per affrontare i vettori di attacco e le vulnerabilità di tendenza su Internet. ZScan è ora utilizzato e supportato da molte aziende, enti governativi e università.

Puoi partecipare contribuendo al nostro codice, alla libreria di template o unendoti al nostro team.

Contributori

Grazie a tutti gli incredibili contributori della community per aver inviato PR e per aver mantenuto aggiornato questo progetto. ❤️

Licenza

ZScan è distribuito sotto licenza MIT.