Tutoriel d'installation et de configuration de Pandora-BOX

Présentation

Pandora-BOX est un projet permettant de scanner des clés USB à la recherche de fichiers infectés et de les mettre en quarantaine. Ce tutoriel vous guide dans l'installation et la configuration de Pandora-BOX sur un système Ubuntu Server 22.04 LTS.

---

Prérequis matériels

• Processeur : Intel Core i5

• Mémoire vive : 4 Go

• Stockage : 30 Go

Installation d'Ubuntu Server

1. Téléchargez l'image d'installation depuis Ubuntu 22.04 Server LTS.

2. Pendant l'installation :

   • Sélectionnez l'option Ubuntu Server (minimized).

   • Activez l'installation du serveur OpenSSH.

   • Créez un utilisateur initial nommé pandora.

3. Une fois l'installation terminée, redémarrez le serveur.

Installation de Pandora-BOX

1. Connectez-vous au serveur avec l'utilisateur pandora.

2. Installez Git :

    sudo apt install -y git
   

3. Clonez le dépôt Pandora-BOX :

    git clone https://github.com/dbarzin/pandora-box
   

4. Accédez au répertoire cloné :

    cd pandora-box
   

5. Lancez le script d'installation :

    sudo ./install.sh
   

Configuration du pare-feu

Pour garantir le bon fonctionnement de Pandora-BOX, assurez-vous que le serveur peut accéder aux sites suivants :

• Ubuntu repositories

• github.com

• pypi.org

• install.python-poetry.org

• clamav.net

• database.clamav.net

• download.comodo.com

• hashlookup.circl.lu

Configurez votre pare-feu en conséquence.

Configuration de Pandora-BOX

1. Copiez le fichier de configuration exemple :

    cp pandora-box.ini.ubuntu pandora-box.ini
   

2. Modifiez le fichier pandora-box.ini pour adapter les paramètres à vos besoins. Voici un exemple de configuration :

    [DEFAULT]
    ; Mode curse (texte uniquement)
    CURSES = False
   
    ; Montage automatique des clés USB
    USB_AUTO_MOUNT = False
   
    ; URL racine du serveur Pandora
    PANDORA_ROOT_URL = http://127.0.0.1:6100
   
    ; Simuler le processus de scan (pour le développement uniquement)
    FAKE_SCAN = False
   
    ; Copier les fichiers infectés dans le dossier de quarantaine
    QUARANTINE = True
   
    ; Dossier de quarantaine
    QUARANTINE_FOLDER = /var/quarantine
   
    ; Nombre de threads
    THREADS = 24
   

Configuration des journaux (logging)

1. Copiez le fichier de configuration rsyslog :

    sudo cp rsyslog.conf/pandora-box.conf /etc/rsyslog.d/
   

2. Si vous utilisez UDP pour les logs distants, ajoutez les lignes suivantes dans le fichier :

    $ModLoad imfile
    $InputFileName /var/log/pandora-box.log
    $InputFileTag pandora-box:
    $InputFileStateFile stat-pandora-box-info
    $InputFileFacility local7
    $InputFileSeverity info
    $InputRunFileMonitor
    local7.info @@192.168.12.123:514
   

   Remplacez 192.168.12.123 par l'adresse IP de votre serveur distant.

3. Redémarrez rsyslog pour appliquer les modifications :

    sudo systemctl restart rsyslog
   

Conclusion

Pandora-BOX est maintenant installé et configuré sur votre serveur. Assurez-vous que les paramètres sont adaptés à vos besoins et que le pare-feu permet l'accès aux ressources nécessaires. En cas de problème, consultez les journaux pour diagnostiquer les éventuels dysfonctionnements.