Obfuscation
Un projet d’obfuscation réunit les assemblies à protéger, leurs dépendances et les paramètres de chacun. Babel Desktop le présente sous forme de graphe sur un canevas ou de tableau dans une grille et l’exécute avec le moteur de Babel Obfuscator.
Babel Desktop enregistre les projets sous forme de fichiers .babel, le format de projet MSBuild qu’utilise la tâche MSBuild. Vous pouvez générer avec MSBuild un projet enregistré dans l’application, et ouvrir dans l’application un projet .babel existant.
À partir de la version 12.1.1, un projet enregistré sur une machine où la tâche MSBuild est installée charge la tâche depuis le fichier de cette installation, et un projet qui désigne encore la tâche par le nom de l’assembly et sa version est converti lorsque vous l’enregistrez. Voir Tâche MSBuild.
Babel Desktop préserve les parties d’un fichier .babel qu’il ne modifie pas, comme les commentaires, les propriétés personnalisées et les tâches MSBuild personnalisées. Il n’évalue ni les imports, ni les conditions, ni les tâches personnalisées de MSBuild : un projet qui en dépend doit être généré avec MSBuild. Seule exception : l’élément UsingTask de la tâche Babel, converti comme décrit plus haut.
Cibles, dépendances et flux
Un projet se compose de quelques types d’éléments. Les autres pages de cette section emploient ces termes dans le sens indiqué ci-dessous.
| Terme | Signification |
|---|---|
| Cible | Un assembly que le moteur obfusque et écrit dans son propre fichier de sortie. Chaque cible a ses propres paramètres. Elle est aussi appelée cible principale. |
| Dépendance | Un assembly fusionné dans une cible, incorporé à celle-ci ou utilisé uniquement pour résoudre ses références. Une dépendance appartient à une seule cible et n’a pas de paramètres propres. Voir Dépendances. |
| Lien de mappage | Une connexion entre deux cibles : la première écrit son fichier de mappage XML des renommages et la seconde le lit, si bien que les deux utilisent les mêmes nouveaux noms pour les symboles publics. Voir Ordre d’exécution. |
| Flux | Un groupe de cibles reliées entre elles par des dépendances, des liens de mappage ou l’ordre d’exécution. Les cibles d’un flux s’exécutent l’une après l’autre, dans l’ordre de leurs étapes. |
Créer un projet
Un projet se prépare en quatre étapes, de l’ajout des assemblies à la première exécution.
Ajouter les assemblies
Cliquez sur Ajouter des assemblies dans l’écran d’accueil ou sur + Ajouter un assembly dans la barre d’outils (Ctrl+Shift+A, Cmd+Shift+A sous macOS), ou faites glisser des assemblies .NET du gestionnaire de fichiers vers le canevas. Chaque assembly devient une cible : un nœud du canevas et une ligne de la grille.
Relier les dépendances
Ajoutez les assemblies qui sont fusionnés dans une cible, incorporés à celle-ci ou référencés par elle, comme décrit dans Dépendances. Pour un ensemble d’assemblies distribués ensemble, reliez par des liens de mappage les cibles qui utilisent l’API publique les unes des autres.
Configurer chaque cible
Sélectionnez une cible et ouvrez le panneau des propriétés pour modifier ses paramètres et ses règles XML, ou modifiez plusieurs cibles à la fois dans la grille. Voir Paramètres de la cible et La grille du projet.
Enregistrer et exécuter
Enregistrez le projet avec Fichier > Enregistrer (Ctrl+S, Cmd+S sous macOS), puis cliquez sur Exécuter le projet (Ctrl+Enter, Cmd+Enter sous macOS). Voir Exécuter le projet.
Les commandes de configuration se chargent de la deuxième et de la troisième étape dans les cas les plus courants : une application dans laquelle ses bibliothèques sont fusionnées, ou un ensemble de bibliothèques dont les symboles publics sont renommés. Flux de travail courants décrit ces deux cas pas à pas.
Ouvrir et enregistrer des projets
Un projet est enregistré dans un fichier .babel. La plupart des commandes de projet se trouvent dans le menu Fichier et ont aussi un raccourci clavier.
| Action | Méthode |
|---|---|
| Nouveau projet | Fichier > Nouveau projet, Ctrl+N (Cmd+N sous macOS), Projet : nouveau dans la palette de commandes ou le bouton Nouveau projet à gauche de la barre d’outils |
| Ouvrir un projet | Fichier > Ouvrir un projet…, Ctrl+O (Cmd+O sous macOS), le bouton Ouvrir un projet… de l’écran d’accueil, ou un fichier .babel déposé sur la grille |
| Ouvrir un projet récent | Projet : Ouvrir un récent… dans la palette de commandes |
| Enregistrer | Fichier > Enregistrer, Ctrl+S (Cmd+S sous macOS) |
| Enregistrer sous un autre nom | Fichier > Enregistrer sous…, Ctrl+Shift+S (Cmd+Shift+S sous macOS) |
Enregistrer écrit le fichier .babel ouvert et ne demande un nom de fichier que pour un nouveau projet. La boîte de dialogue Ouvrir un projet s’ouvre sur le dossier du dernier projet ouvert. Si le projet en cours contient des modifications non enregistrées, Babel Desktop vous demande s’il faut les abandonner avant d’en créer ou d’en ouvrir un autre, et vous le demande de nouveau avant la fermeture de la fenêtre. Attendez la fin de la tâche en cours avant d’ouvrir un autre projet.
Babel Desktop mémorise aussi, sur cet ordinateur, si vous avez consulté un projet en dernier sur le canevas ou dans la grille. Changer de vue ne modifie pas le fichier de projet.
Remplacer une entrée
Pour faire pointer une cible vers un nouveau build de son assembly sans perdre ses paramètres, sélectionnez la cible et exécutez Assembly : remplacer l’entrée et conserver les paramètres… depuis la palette de commandes. Assembly : retirer la cible sélectionnée, ou Retirer l’assembly dans le menu d’un nœud ou d’une ligne, retire une cible avec ses dépendances et ses connexions.
Pages de cette section
Les pages suivantes présentent les deux vues d’un projet, la façon dont ses cibles sont reliées et ordonnées, leurs paramètres, l’exécution et ses résultats, et se terminent par des exemples complets.
- Le canevas du projet : la vue en graphe, ses nœuds, le menu des nœuds et la façon de s’y déplacer.
- Dépendances : les dépendances de fusion, d’incorporation et de référence, et la fusion d’une cible dans une autre.
- Ordre d’exécution : les flux, les étapes, les arêtes de flux et les liens de mappage.
- La grille du projet : la vue en tableau, la modification de nombreuses cibles à la fois, l’ordre d’exécution et les détails de chaque cible.
- Paramètres de la cible : le panneau des propriétés, les fichiers de mappage, les règles XML, les plugins du moteur, les commandes de configuration et les niveaux de protection.
- Exécuter le projet : les fichiers de sortie, le panneau Activité, les avertissements et l’exécution en parallèle des flux.
- Résultats d’exécution : le score d’obfuscation et les statistiques de protection de chaque exécution.
- Flux de travail courants : une application seule, une application avec des bibliothèques fusionnées, et un ensemble de bibliothèques avec obfuscation publique.
Pour retrouver, à l’aide de ses fichiers de mappage XML, les noms d’origine dans les traces de pile obfusquées d’une application protégée, utilisez le Décodeur de pile.