Asclepius

Asclepius valide l'intégrité des sauvegardes en restaurant les fichiers et en testant activement leur récupérabilité. Au lieu de se fier aux métadonnées, il tente d'analyser les formats de fichiers réels (documents, images, vidéos, archives, courriels) pour confirmer que les sauvegardes peuvent réellement être lues et sont sûres à utiliser.

Installation

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

Dépendances supplémentaires

FFmpeg (pour la validation vidéo)

# macOS
brew install ffmpeg

# Ubuntu/Debian
sudo apt install ffmpeg

# Arch Linux
sudo pacman -S ffmpeg

Utilisation

Validation d'un seul fichier

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

Validation d'un répertoire

# Valider tous les fichiers du répertoire
uv run asclepius -d /path/to/backups

# Échantillonner aléatoirement N fichiers du répertoire
uv run asclepius -d /path/to/backups --rand-sample 100

Intégration avec Restic

Contrairement à restic check qui vérifie la structure du dépôt et l'intégrité des données, Asclepius effectue une validation fonctionnelle en restaurant les instantanés et en testant si les fichiers sont réellement lisibles et analysables.

Vérification du dépôt uniquement

Exécute des vérifications de métadonnées pour valider l'intégrité du dépôt :

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

Restaurer et valider tous les instantanés

Restaure chaque instantané dans un répertoire temporaire et valide tous les fichiers :

# Valider tous les fichiers de tous les instantanés
uv run asclepius --restic-repo /path/to/repo --restic-passwd your-password --recover

# Valider aléatoirement 100 fichiers de chaque instantané (plus rapide pour les grosses sauvegardes)
uv run asclepius --restic-repo /path/to/repo --restic-passwd your-password --recover --rand-sample 100

Restaurer et valider un instantané spécifique

Restaure et valide un seul instantané par son ID :

# Valider tous les fichiers d'un instantané spécifique
uv run asclepius --restic-repo /path/to/repo --restic-passwd your-password --recover --snapshot ab4eb95a

# Valider aléatoirement 50 fichiers d'un instantané spécifique
uv run asclepius --restic-repo /path/to/repo --restic-passwd your-password --recover --snapshot ab4eb95a --rand-sample 50

Validateurs

• Documents (PDF, DOCX, PPTX, etc.) – Analyse MarkItDown + analyse d'entropie
• Images (JPEG, PNG, GIF, etc.) – Vérification structurelle PIL
• Vidéos (MP4, AVI, MKV, etc.) – Détection de corruption FFprobe
• Archives (ZIP, TAR) – Vérification d'intégrité + validation récursive du contenu
• Courriels (EML) – Validation d'analyse + vérification d'en-tête
• Logiciels malveillants (Tous formats) – Analyse des règles YARA

Configuration

Les validateurs sont configurés dans validators.yaml. Chaque validateur spécifie les types MIME pris en charge, les extensions de fichiers et les paramètres de validation.

Configuration des règles YARA

Le validateur YARA scanne tous les fichiers à la recherche de signatures de logiciels malveillants. Pour l'activer :

1. Clonez un dépôt de règles YARA ou ajoutez vos propres règles :

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

2. Configurez le chemin dans validators.yaml :

settings:
  yara_rules_path: "Yara-detection-rules"

Si les règles YARA ne sont pas trouvées ou échouent à compiler, le validateur ignorera l'analyse avec un seul avertissement au démarrage.

Licence

Licence MIT – voir LICENSE pour les détails.