Module d anonymisation

Transcription

1 Module d anonymisation Préambule Ce module permet d «anonymiser» un fichier, c est à dire de masquer les informations qu il contient en fonction de règles préalablement spécifiées. Le fichier généré par la fonction anonymisation sera crée dans le même répertoire que le fichier à traiter. Celui-ci pourra être compressé (au format ZIP) en fonction de l état de l option «Compression» de l interface. Le Module d anonymisation existe en deux versions une sous forme d interface graphique pour les clients Windows, l autre pour être exploitée directement dans des scripts exécutés sur des serveurs. Table des matières 1. Module d Anonymisation pour Serveur Pré-requis : Installation Utilisation Intégration du module d anonymisation dans un script Lancement d un script encapsulant le module d anonymisation Module d Anonymisation pour client Windows Pré-requis : Installation Utilisation Lancement Fonctions de l interface Mode Opératoire pour l anonymisation d un fichier Annexes Codes retour de l application

2 1. Module d Anonymisation pour Serveur 1.1 Pré-requis : L application livrée est un exécutable de type JAVA qui nécessite la présence d une machine virtuelle JAVA (JVM) dans la version 1.5 au minimum. Variable d environnement PATH et CLASSPATH correctement renseignés pour utiliser la commande java. 1.2 Installation L application est disponible en téléchargement sur la plateforme PRISME Emploi. Elle est fournie sous la forme d une archive : PrismeAnonym_Server.zip Pour l installer, il faut décompresser sur votre serveur l archive dans le répertoire de votre choix. L archive comporte un shell script nommé anonymisation.sh et un répertoire lib contenant le module d anonymisation PrismeAnonym.jar. Le script anonymisation.sh propose un exemple d utilisation du module d anonymisation PrismeAnonym.jar, il s agit d un script de type shell Unix/Linux mais il peut être adapté pour fonctionner sur n importe quel type de serveur disposant d une Machine Virtuelle Java compatible (JVM). 1.3 Utilisation Intégration du module d anonymisation dans un script L archive comporte un shell script nommé anonymisation.sh et un répertoire lib contenant le module d anonymisation PrismeAnonym.jar. Le script propose un exemple d utilisation du module d anonymisation PrismeAnonym.jar. Dans le script, le lancement du module d anonymisation s effectue par la commande suivante : java -jar./lib/prismeanonym.jar $FILE_IN $OPTION_ZIP où $FILE_IN contient le chemin du fichier à anonymiser $OPTION_ZIP contient les chaînes de caractère true ou false pour activer ou non la compression du fichier anonymisé. Exemple : java -jar./lib/prismeanonym.jar /u/tmp/prisme/monfichier.dmm true Note : En cas de non conformité des paramètres du module le message suivant apparaît : «Nombre de paramètres incorrects : Le script nécessite les paramètres suivants pour fonctionner : NOM_FICHIER : Chemin absolu du fichier à anonymiser ZIP : 'true' pour compresser le fichier de sortie, 'false' sinon» 2

3 Le module renvoie un code retour (voir signification en Annexe : 3.1 Codes retour de l application ) qui doit être testé, par exemple en shell Unix via la variable d environnement $? (Exemple détaillé dans le script anonymisation.sh) Lancement d un script encapsulant le module d anonymisation Exemple de traitement suite au lancement du script anonymisation.sh Pour chaque anonymisation, un fichier de log est généré à l emplacement du fichier anonymisé [nom du fichier + extension.log] il peut être consulté ou exploité au besoin par le script encapsulant le module d anonymisation. 3

4 2. Module d Anonymisation pour client Windows 2.1 Pré-requis : L application livrée est un exécutable de type JAVA qui nécessite la présence d une machine virtuelle JAVA (JVM) dans la version 1.5 au minimum. Attention : L extension de fichier.jar doit être associée à la plateforme JAVA, si tel n est pas le cas voici la marche à suivre : Positionnez-vous dans n importe quel répertoire de votre machine, sélectionner Outils / Options des dossiers puis sélectionnez l onglet type de fichiers, enfin associez l extension JAR avec l application Java Platform. 2.2 Installation L application est disponible en téléchargement sur la plateforme PRISME Emploi. Elle est fournie sous la forme d une archive : PrismeAnonym_ClientWindows.zip Pour l installer, il faut décompresser sur votre machine l archive dans le répertoire de votre choix. Par exemple : C:\Program Files\Prisme 4

5 2.3 Utilisation Lancement Le lancement du programme s effectue en exécutant le fichier PrismeGraphicalAnonym.jar du répertoire d installation (double-clic sur le fichier ou Sélection du fichier + Enter). L interface suivante apparaît : A B Fonctions de l interface (1) Parcourir : Permet de parcourir l arborescence des répertoires de votre machine pour trouver un fichier à anonymiser. (Attention : Pour la fonction «Parcourir», par défaut, le filtre sur les fichiers ayant une extension.dmm est positionné). (2) Case à cocher : Si cochée (fonctionnement par défaut), le fichier anonymisé sera compressé automatiquement au format zip. (3) Anonymiser le fichier : Commande l anonymisation du fichier indiqué dans la zone de saisie (A) (4) Quitter : Ferme l application L application dispose d une zone de texte (B) qui permet d informer l utilisateur sur l état du traitement en cours. Par ailleurs, elle restitue au fil de l eau, les informations de traitement d anonymisation pour chaque fichier traité. 5

6 2.3.3 Mode Opératoire pour l anonymisation d un fichier 1) Sélection du fichier à anonymiser : Deux méthodes sont possibles : Soit en saisissant l emplacement du fichier dans la zone de saisie (A) Soit au moyen du bouton «Parcourir» (1) : Remarque : le filtre de recherche des fichiers est par défaut.dmm, il faut le modifier pour pouvoir visualiser les autres types de fichier. Sélectionnez le fichier de votre choix et pressez le bouton Ouvrir pour valider votre sélection Une fois la sélection effectuée le message suivant apparaît dans l interface : 6

7 2) Lancement du processus d anonymisation Une fois le fichier sélectionné, si vous souhaitez que le fichier anonymisé soit compressé ou non, actionnez la case à cocher en conséquence. Utilisez ensuite la fonction «Anonymiser le fichier» pour lancer le processus. A la fin du traitement, le journal d information relatif à l anonymisation s affiche dans la zone de texte (B). 3) Consulter les informations relatives au processus d anonymisation Pour chaque anonymisation, un fichier de log est généré à l emplacement du fichier anonymisé [nom du fichier + extension.log ], il peut être consulter à l aide d un éditeur de texte. Toutefois, le contenu de ce fichier est remonté dans l interface à l issue du processus. En cas d anomalie, des codes d erreurs sont remontés (voir signification en Annexe : 3.1 Codes retour de l application ) 4) Quitter l application ou renouveler le processus pour un autre fichier On sort de l application au moyen du bouton Quitter (4) ou bien de la croix à droite de la barre de titre de l application. 7

8 3. Annexes 3.1 Codes retour de l application Ci-dessous la liste des codes retour du processus d anonymisation : Code Description 0 Le traitement s est bien déroulé. Aucune erreur. 1 Format du fichier incorrect 2 Fichier de sortie déjà existant 3 Espace disque insuffisant pour générer le fichier anonymisé 4 Pas de caractères aux endroits prévus (lignes tronquées) 5 Absence des droits d écriture dans le répertoire de sortie 6 Fichier à anonymiser introuvable 99 Autre erreur 8