Specifica Completa delle API RESTful e WebSocket del Sistema TORNET
Versione 1.0.0 — Base URL:http://localhost:8000/api/v1
- Autenticazione
- Statistiche di Sistema
- Gestione Scansioni (Scans)
- Vulnerabilità & Risultati
- Report & Comparazione
- Scan Scheduling
- AI Security Assistant
- Progetti Multi-Target
- Notifiche & Alerting
- Tool Plugins
- WebSocket Real-Time API
Tutte le richieste autenticate richiedono l'header:
Authorization: Bearer <access_token>
Autentica un utente e restituisce il token JWT.
Request Body:
{
"username": "admin",
"password": "tornet2026"
}Response (200 OK):
{
"access_token": "eyJhbGciOiJIUzI1NiIsIn...",
"token_type": "bearer",
"user": {
"id": 1,
"username": "admin",
"email": "admin@tornet.local",
"is_admin": true
}
}Restituisce il riepilogo complessivo del Command Center.
Response (200 OK):
{
"critical_vulns": 3,
"active_scans": 1,
"assets_tested": 12,
"success_rate": 95.8,
"total_scans": 24,
"severity_distribution": {
"critical": 3,
"high": 7,
"medium": 14,
"low": 5,
"info": 18
},
"recent_activity": []
}Crea ed avvia una nuova scansione di penetration testing.
Request Body:
{
"target": "http://testphp.vulnweb.com",
"target_type": "web",
"scan_type": "full_auto",
"intensity": "medium",
"selected_tools": ["nmap", "nuclei", "sqlmap"]
}Restituisce la lista di scansioni ordinate per data decrescente.
- Parametro opzionale query:
?status=running(oppurecompleted,failed,stopped).
Restituisce il dettaglio della scansione con l'elenco dei risultati dei tool, vulnerabilità e log.
Invia la sequenza di terminazione forzata per i processi della pipeline in esecuzione.
Elimina il record della scansione e i risultati associati.
Restituisce tutte le vulnerabilità scoperte nel database con filtri opzionali.
- Parametro query:
?severity=critical
Restituisce i risultati raw e parsed di ogni tool per la scansione specificata.
Scarica il report della scansione nel formato specificato:
format:html,csv,json.
Calcola la matrice di differenza tra due scansioni:
- Vulnerabilità risolte / estinte.
- Nuove vulnerabilità emerse.
- Delta punteggio CVSS globale.
Restituisce tutte le pianificazioni di scansione registrate.
Crea una nuova pianificazione ricorrente.
Request Body:
{
"name": "Weekly Perimeter Security Audit",
"target": "http://testphp.vulnweb.com",
"target_type": "web",
"scan_type": "full_auto",
"intensity": "medium",
"interval_hours": 168
}Attiva o disattiva la pianificazione.
Forza l'avvio immediato di una scansione pianificata.
Elimina la pianificazione.
Elabora l'analisi euristica avanzata della scansione.
Response (200 OK):
{
"target": "http://testphp.vulnweb.com",
"scan_id": 1,
"posture_score": 68,
"posture_grade": "C",
"threat_vectors": [
{
"category": "Data Layer Compromise (SQL Injection)",
"risk": "Critical",
"impact": "Possibile estrazione non autorizzata di database."
}
],
"immediate_actions": [
"Implementare Prepared Statements / query parametrizzate su tutti gli endpoint database."
],
"strategic_recommendations": [
"Configurare Web Application Firewall (WAF) per la mitigazione automatica."
],
"summary_it": "Analisi di sicurezza completata per http://testphp.vulnweb.com...",
"summary_en": "Security assessment completed for http://testphp.vulnweb.com..."
}Consulenza interattiva e risposte alle domande tecniche dell'operatore.
Request Body:
{
"scan_id": 1,
"prompt": "Come posso correggere l'SQL injection rilevata?"
}Elenco di tutti i progetti registrati con i relativi target configurati.
Crea un nuovo progetto multi-target.
Request Body:
{
"name": "Audit Infrastruttura Cloud",
"description": "Perimetro esterno corporate",
"client_name": "Acme Corp",
"initial_targets": [
{ "target": "https://api.acme.com", "target_type": "web" },
{ "target": "192.168.1.10", "target_type": "network" }
]
}Aggiunge un asset bersaglio al progetto.
Avvia in batch le scansioni su tutti i target associati al progetto.
Restituisce le configurazioni attuali di Telegram, Email e Webhook.
Salva le configurazioni di notifica.
Invia un alert di prova per validare i canali configurati.
Restituisce tutti i manifest dei plugin personalizzati installati in backend/plugins/.
Registra un nuovo plugin tool personalizzato.
Request Body:
{
"name": "dnsrecon",
"display_name": "DNSRecon Enumerator",
"category": "Reconnaissance",
"description": "DNS enumeration and zone transfer script",
"version": "1.1.0",
"command_template": "dnsrecon -d {target} {intensity_flags}",
"intensity_flags": {
"light": "-s",
"medium": "-a",
"aggressive": "-a -z"
},
"vulnerability_keywords": ["Zone Transfer Successful", "Vulnerable"],
"enabled": true
}Endpoint di connessione:
ws://localhost:8000/ws/{channel}
Canali standard:
global: Notifiche di sistema, cambi di stato scansioni e statistiche.scan_{scan_id}: Streaming dedicato di avanzamento e log del terminale per un audit specifico.
Messaggio di Avanzamento (scan_progress):
{
"type": "scan_progress",
"scan_id": 1,
"progress": 65,
"status": "running",
"current_tool": "Nuclei Scanner"
}Messaggio di Output Terminale (terminal_output):
{
"type": "terminal_output",
"scan_id": 1,
"stream": "stdout",
"chunk": "[NUCLEI] [CVE-2023-XXXX] [critical] http://target/login"
}