Asclepius

Asclepius valida la integridad de las copias de seguridad restaurando archivos y probando activamente su recuperabilidad. En lugar de confiar en los metadatos, intenta analizar formatos de archivo reales (documentos, imágenes, vídeos, archivos comprimidos, correos electrónicos) para confirmar que las copias de seguridad son realmente legibles y seguras de usar.

Instalación

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

Dependencias adicionales

FFmpeg (para validación de vídeos)

# macOS
brew install ffmpeg

# Ubuntu/Debian
sudo apt install ffmpeg

# Arch Linux
sudo pacman -S ffmpeg

Uso

Validación de un solo archivo

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

Validación de directorios

# Validate all files in directory
uv run asclepius -d /path/to/backups

# Randomly sample N files from directory
uv run asclepius -d /path/to/backups --rand-sample 100

Integración con Restic

A diferencia de restic check, que verifica la estructura del repositorio y la integridad de los datos, Asclepius realiza una validación funcional restaurando instantáneas y comprobando si los archivos son realmente legibles y analizables.

Solo comprobación del repositorio

Ejecuta comprobaciones de metadatos para verificar la integridad del repositorio:

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

Restaurar y validar todas las instantáneas

Restaura cada instantánea a un directorio temporal y valida todos los archivos:

# Validate all files in all snapshots
uv run asclepius --restic-repo /path/to/repo --restic-passwd your-password --recover

# Validate random 100 files from each snapshot (faster for large backups)
uv run asclepius --restic-repo /path/to/repo --restic-passwd your-password --recover --rand-sample 100

Restaurar y validar una instantánea específica

Restaura y valida una única instantánea por ID:

# Validate all files in specific snapshot
uv run asclepius --restic-repo /path/to/repo --restic-passwd your-password --recover --snapshot ab4eb95a

# Validate random 50 files from specific snapshot
uv run asclepius --restic-repo /path/to/repo --restic-passwd your-password --recover --snapshot ab4eb95a --rand-sample 50

Validadores

• Documentos (PDF, DOCX, PPTX, etc.) - Análisis con MarkItDown + análisis de entropía
• Imágenes (JPEG, PNG, GIF, etc.) - Verificación estructural con PIL
• Vídeos (MP4, AVI, MKV, etc.) - Detección de corrupción con FFprobe
• Archivos comprimidos (ZIP, TAR) - Comprobación de integridad + validación recursiva del contenido
• Correos electrónicos (EML) - Validación de parseo + verificación de cabeceras
• Malware (todos los formatos) - Escaneo con reglas YARA

Configuración

Los validadores se configuran en validators.yaml. Cada validador especifica los tipos MIME admitidos, las extensiones de archivo y los ajustes de validación.

Configuración de reglas YARA

El validador YARA escanea todos los archivos en busca de firmas de malware. Para habilitarlo:

1. Clona un repositorio de reglas YARA o añade tus propias reglas:

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

2. Configura la ruta en validators.yaml:

settings:
  yara_rules_path: "Yara-detection-rules"

Si no se encuentran las reglas YARA o no se pueden compilar, el validador omitirá el escaneo con una única advertencia al inicio.

Licencia

Licencia MIT: consulta LICENSE para más detalles.