# 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](https://ubuntu.com/download/server).
    
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 :
    
    ```bash
    sudo apt install -y git
    ```
    
3. Clonez le dépôt Pandora-BOX :
    
    ```bash
    git clone https://github.com/dbarzin/pandora-box
    ```
    
4. Accédez au répertoire cloné :
    
    ```bash
    cd pandora-box
    ```
    
5. Lancez le script d'installation :
    
    ```bash
    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 :
    
    ```bash
    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 :
    
    ```ini
    [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 :
    
    ```bash
    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 :
    
    ```plaintext
    $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 :
    
    ```bash
    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.