Introduction

PandoraBox est une borne libre de décontamination de clés USB, une « station blanche » : l'utilisateur insère une clé USB, la borne analyse chaque fichier avec plusieurs moteurs de détection, affiche les fichiers dangereux trouvés, et les supprime quand l'utilisateur touche l'écran. C'est une réécriture complète de la première version de PandoraBox, sans dépendance à Pandora (CIRCL).

Objectif

Les clés USB restent une porte d'entrée courante dans des systèmes d'information par ailleurs bien protégés : partagées entre organisations, utilisées sur des ordinateurs non gérés, branchées sur des réseaux isolés. Une borne de décontamination les vérifie avant qu'elles ne servent sur un poste de travail.

PandoraBox veut être une alternative libre, auditable et durcie aux bornes commerciales, pour les environnements sensibles : santé, industrie, administrations. Elle tourne sur un petit ordinateur reconditionné avec un écran tactile, et fonctionne sans réseau.

Fonctionnement

• Plusieurs moteurs : empreintes de logiciels malveillants connus (MalwareBazaar), fichiers connus (CIRCL Hashlookup), ClamAV, règles YARA-X (YARA Forge) et heuristiques de structure (programmes déguisés en documents, PDF avec JavaScript). Voir Moteurs de détection.
• Échec sûr (« fail closed ») : un fichier qui n'a pas pu être entièrement analysé (archive chiffrée, limite dépassée, erreur d'un moteur) n'est jamais déclaré sain. Chaque partition d'une clé est analysée ; une partition qui ne peut pas l'être (chiffrée, système de fichiers inconnu) rend la clé non vérifiée.
• Rien n'est supprimé sans l'utilisateur : les fichiers dangereux sont listés à l'écran, copiés dans la quarantaine de la borne, puis supprimés de la clé seulement après un appui sur l'écran.
• Traçabilité : chaque analyse produit un rapport JSON structuré.

Principes

• Image minimale et durcie : le système ne contient que ce qui sert à analyser. Système de fichiers racine en lecture seule avec dm-verity, Secure Boot, USBGuard, aucun compte et aucune session. Voir Fonctionnement de l'image.
• Défense en profondeur : la clé USB est hostile, et les moteurs d'analyse sont supposés compromettables. Chaque moteur tourne dans son propre bac à sable, sans réseau.
• Hors ligne par défaut : aucun réseau n'est nécessaire pour analyser ; les signatures et les mises à jour du système arrivent sur des clés USB signées, ou par un canal en ligne dédié. Voir Signatures.
• Personnalisable : l'organisation choisit son logo, ses couleurs et les textes de l'interface. Voir Interface.

Documentation

Installer une borne

Étape	Page
1. Choisir le matériel	Matériel : ordinateur et écran validés, boîtier
2. Construire l'image	Construction de l'image : configuration, clés, profil online
3. La tester dans une machine virtuelle	Test avec QEMU : test automatisé, machine interactive, vraies clés USB
4. Installer la borne	Installation initiale : BIOS, écriture du disque, Secure Boot, premier jeu de signatures

Maintenir une borne

Tâche	Page
Mettre à jour les signatures	Signatures : clés de mise à jour des signatures, publication, mises à jour en ligne
Mettre à jour le système	Mises à jour du système : mises à jour A/B de l'image, par clé USB ou en ligne
Lire les journaux	Journaux : clé de maintenance ; Export vers un SIEM

Référence

Page	Contenu
Interface	Écrans de la borne, thème de l'organisation
Configuration	Tous les réglages de pandora-box.toml
Moteurs de détection	Moteurs, politique de verdict, rapport d'analyse
Fonctionnement de l'image	Partitions, chaîne de démarrage, périphériques USB, durcissement, bac à sable
Développement	Lancer la borne depuis les sources, tests

L'avancement du projet est suivi dans la feuille de route. PandoraBox est un logiciel libre, sous licence publique générale GNU v3.0.