Asclepius

Asclepius convalida l'integrità dei backup ripristinando i file e testando attivamente la loro recuperabilità. Invece di fidarsi dei metadati, tenta di analizzare formati di file reali (documenti, immagini, video, archivi, email) per confermare che i backup possano effettivamente essere letti e siano sicuri da usare.

Installazione

git clone https://github.com/matank001/asclepius
cd asclepius
uv sync

Dipendenze aggiuntive

FFmpeg (per la validazione video)

# macOS
brew install ffmpeg

# Ubuntu/Debian
sudo apt install ffmpeg

# Arch Linux
sudo pacman -S ffmpeg

Utilizzo

Validazione di un singolo file

uv run asclepius -f /path/to/file.pdf

Validazione di una directory

# Valida tutti i file nella directory
uv run asclepius -d /path/to/backups

# Campiona casualmente N file dalla directory
uv run asclepius -d /path/to/backups --rand-sample 100

Integrazione con Restic

A differenza di restic check, che verifica la struttura del repository e l'integrità dei dati, Asclepius esegue una validazione funzionale ripristinando gli snapshot e testando se i file sono effettivamente leggibili e analizzabili.

Solo verifica del repository

Esegue controlli sui metadati per verificare l'integrità del repository:

uv run asclepius --restic-repo /path/to/repo --restic-passwd your-password

Ripristino e validazione di tutti gli snapshot

Ripristina ogni snapshot in una directory temporanea e valida tutti i file:

# Valida tutti i file in tutti gli snapshot
uv run asclepius --restic-repo /path/to/repo --restic-passwd your-password --recover

# Valida 100 file casuali da ogni snapshot (più veloce per backup grandi)
uv run asclepius --restic-repo /path/to/repo --restic-passwd your-password --recover --rand-sample 100

Ripristino e validazione di uno snapshot specifico

Ripristina e valida un singolo snapshot tramite ID:

# Valida tutti i file in uno snapshot specifico
uv run asclepius --restic-repo /path/to/repo --restic-passwd your-password --recover --snapshot ab4eb95a

# Valida 50 file casuali da uno snapshot specifico
uv run asclepius --restic-repo /path/to/repo --restic-passwd your-password --recover --snapshot ab4eb95a --rand-sample 50

Validatori

• Documenti (PDF, DOCX, PPTX, ecc.) - Analisi MarkItDown + analisi di entropia
• Immagini (JPEG, PNG, GIF, ecc.) - Verifica strutturale PIL
• Video (MP4, AVI, MKV, ecc.) - Rilevamento corruzione FFprobe
• Archivi (ZIP, TAR) - Controllo integrità + validazione contenuto ricorsivo
• Email (EML) - Validazione parsing + verifica intestazione
• Malware (Tutti i formati) - Scansione con regole YARA

Configurazione

I validatori sono configurati in validators.yaml. Ogni validatore specifica i tipi MIME supportati, le estensioni dei file e le impostazioni di validazione.

Impostazione delle regole YARA

Il validatore YARA scansiona tutti i file alla ricerca di firme di malware. Per abilitarlo:

1. Clona un repository di regole YARA o aggiungi le tue regole:

git clone [email protected]:embee-research/Yara-detection-rules.git

2. Configura il percorso in validators.yaml:

settings:
  yara_rules_path: "Yara-detection-rules"

Se le regole YARA non vengono trovate o falliscono la compilazione, il validatore salterà la scansione con un singolo avviso all'avvio.

Licenza

Licenza MIT - vedi LICENSE per i dettagli.