Référence de la tâche Babel
Tous les attributs de la tâche MSBuild Babel, regroupés par fonctionnalité, avec l’option de ligne de commande à laquelle chaque attribut correspond.
La tâche Babel expose un attribut pour chaque option de l’outil en ligne de commande et lui transmet les valeurs des attributs telles quelles. Un attribut booléen accepte true ou false. Lorsque l’option de ligne de commande prend un argument, le même argument peut être passé comme valeur de l’attribut : un attribut marqué Booléen / Chaîne accepte donc l’une ou l’autre forme. Les attributs de type liste prennent plusieurs valeurs séparées par ;. Les attributs non définis conservent les valeurs par défaut indiquées dans les tableaux.
Avec le package NuGet Babel Obfuscator, chaque attribut se définit au moyen d’une propriété ou d’un élément MSBuild ; voir le tableau Correspondance des propriétés de la référence du package.
La version 12.0 ajoute les attributs SingleFile, TrustedSigner, TrustedBundle et TrustedTeam, qui pilotent les contrôles d’intégrité du paquet sur mobile de la détection de falsification, ainsi que la valeur stream de StringEncryption. Ils sont signalés par 12.0 dans les tableaux ci-dessous.
Divers
| Attribut | Type | Valeur par défaut | Ligne de commande | Description |
|---|---|---|---|---|
BabelDirectory | Chaîne | Ancien moyen de remplacer le dossier qui contient babel.exe. La tâche échoue si l’exécutable ne s’y trouve pas. Préférez ToolPath. | ||
DbgHelpDllDir | Chaîne | --dbghelpdlldir | Chemin du dossier qui contient dbghelp.dll. | |
DetectIfObfuscated | Booléen / Chaîne | false | --isobfuscated | Indique s’il faut détecter si l’assembly cible est déjà obfusqué. La valeur warn émet un avertissement et poursuit, exit s’arrête sans traiter l’assembly. |
EnableObfuscationAgent | Booléen | true | --agent | Indique s’il faut exécuter l’agent d’obfuscation, qui analyse l’assembly et exclut de l’obfuscation les symboles dont l’obfuscation l’empêcherait de fonctionner. |
License | Chaîne | --license | Chemin complet du fichier de licence, ou liste de répertoires où rechercher les fichiers de licence. | |
NoConfiguration | Booléen | false | --noconfig | Indique s’il faut ignorer les valeurs par défaut enregistrées dans le fichier de configuration de Babel. |
NoWarnings | Chaîne | --nowarn | Liste des codes d’avertissement à ignorer. | |
ProvideCommandLineArgs | Booléen | false | Indique s’il faut écrire dans le journal la ligne de commande passée à Babel et la renvoyer dans l’élément de sortie CommandLineArgs. | |
QuickRules | Chaîne | --quickrule | Définitions de règles rapides. | |
RandomSeed | Chaîne | --randomseed | Graine du générateur de nombres aléatoires utilisé pendant l’obfuscation. | |
RemoveKey | Booléen | false | --removekey | Indique s’il faut supprimer le nom fort de l’assembly obfusqué. |
SatelliteAssemblies | Chaîne | --satellite | Liste des fichiers d’assemblies satellites à traiter. | |
SearchDirectories | Chaîne | --addsearch | Liste des répertoires où sont recherchés les assemblies référencés. References est accepté comme alias. | |
SearchSatelliteAssemblies | Booléen | true | --satellite | Indique s’il faut rechercher et traiter les assemblies satellites de la cible. |
ShowLogo | Booléen | true | --logo | Indique s’il faut afficher la version de Babel et les informations de copyright. |
ShowStatistics | Booléen | true | --statistics | Indique s’il faut afficher les statistiques d’obfuscation à la fin du processus. Booléen uniquement : utilisez StatisticsFile pour enregistrer les statistiques dans un fichier. |
StatisticsFile | Chaîne | --statistics | Chemin du fichier où sont enregistrées les statistiques d’obfuscation. Ignoré lorsque ShowStatistics vaut false. | |
TargetAssemblyName | Chaîne | nochange | --assemblyname | Origine du nom de l’assembly cible : nochange, inputfilename, outputfilename ou name=<assembly name>. |
ToolExe | Chaîne | Nom de l’exécutable Babel, babel.exe ou babel.dll. | ||
ToolPath | Chaîne | Répertoire de l’exécutable Babel. | ||
Trace | Chaîne | --trace | Liste d’expressions régulières qui sélectionnent les symboles à tracer. La trace indique pourquoi un symbole est obfusqué ou non et aide à déboguer les règles d’obfuscation. | |
Use | Clé=Valeur | --use | Options d’utilisation sous forme de paires clé-valeur. | |
VerboseLevel | Entier | 1 | --verbose | Niveau de détail de la sortie de la console. 0 désactive les messages, les valeurs supérieures à 10 affichent des informations de débogage. |
WarningsAsErrors | Chaîne | --warnaserror | Liste des codes d’avertissement signalés comme des erreurs. Une erreur arrête le processus d’obfuscation. | |
WarningsAsInfos | Chaîne | --warnasinfo | Liste des codes d’avertissement signalés comme des messages d’information. | |
XmlRules | Chaîne | Éléments de règles XML intégrées, voir Règles XML. |
Fichiers d’entrée
| Attribut | Type | Valeur par défaut | Ligne de commande | Description |
|---|---|---|---|---|
InputFile | Chaîne | Chemin de l’assembly à obfusquer. | ||
KeyContainer | Chaîne | --keyname | Nom du conteneur de clés de nom fort (Windows uniquement). | |
KeyFile | Chaîne | --keyfile | Chemin du fichier de clé de nom fort utilisé pour signer l’assembly obfusqué. | |
KeyPwd | Chaîne | --keypwd | Mot de passe du fichier de clé de nom fort ou du certificat. | |
MapInFiles | Chaîne | --mapin | Liste des fichiers de mappage XML d’assemblies déjà obfusqués, utilisés pour renommer les références à leurs symboles. | |
Project | Chaîne | --project | Chemin d’un fichier de projet d’obfuscation Babel. | |
RulesFiles | Chaîne | --rules | Liste des fichiers de règles XML à traiter. |
Fichiers de sortie
| Attribut | Type | Valeur par défaut | Ligne de commande | Description |
|---|---|---|---|---|
GenerateLogFile | Booléen | false | --logfile | Indique s’il faut générer un journal d’obfuscation. Le nom par défaut du fichier journal est <target assembly>.log. |
GenerateMapOutFile | Booléen | false | --mapout | Indique s’il faut générer un fichier de mappage de l’obfuscation. Le nom par défaut du fichier de mappage est <target assembly>.xml.map. |
LogFile | Chaîne | --logfile | Chemin du fichier journal de l’obfuscation. | |
MakeProject | Chaîne | --makeproject | Chemin du fichier de projet MSBuild créé à partir des paramètres de la tâche. | |
MapOutFile | Chaîne | --mapout | Chemin du fichier de mappage de l’obfuscation. | |
OutputFile | Chaîne | --output | Chemin de l’assembly obfusqué. | |
PdbFile | Chaîne | --pdb | Chemin du fichier de symboles de débogage. | |
PdbPwd | Chaîne | --pdbpwd | Mot de passe du fichier de symboles de débogage. |
Plugins
| Attribut | Type | Valeur par défaut | Ligne de commande | Description |
|---|---|---|---|---|
Plugins | Chaîne | --plugin | Liste des fichiers d’assemblies de plugins. | |
PluginsArguments | Clé=Valeur | --argument | Arguments des plugins sous forme de paires clé-valeur. |
Fusion et incorporation
| Attribut | Type | Valeur par défaut | Ligne de commande | Description |
|---|---|---|---|---|
CopyAttributes | Booléen / Chaîne | false | --copyattrs | Indique si les attributs de niveau assembly des assemblies fusionnés sont copiés dans l’assembly cible. Une expression régulière sélectionne les attributs en double qui peuvent être fusionnés. |
DependenciesManifest | Booléen | true | --jsonmanifest | Indique s’il faut mettre à jour le manifeste de dépendances .deps.json de l’assembly cible lorsque des assemblies sont fusionnés ou incorporés. |
EmbedAssemblies | Chaîne | --embed | Liste des fichiers d’assemblies à incorporer dans l’assembly cible. | |
Internalize | Booléen | false | --internalize | Indique si la visibilité des types fusionnés est restreinte à l’assembly cible. |
MergeAssemblies | Chaîne | Liste des fichiers d’assemblies à fusionner dans l’assembly cible. |
Renommage
| Attribut | Type | Valeur par défaut | Ligne de commande | Description |
|---|---|---|---|---|
FlattenNamespaces | Booléen / Chaîne | true | --flatns | Indique s’il faut déplacer les types renommés dans l’espace de noms global. Une chaîne définit à la place un nom d’espace de noms commun aux types renommés. |
NameLength | Entier / Clé=Valeur | --namelength | Longueur minimale des noms obfusqués. Des paires clé-valeur attribuent la longueur à une catégorie de symboles donnée. | |
NamePrefix | Chaîne / Clé=Valeur | --nameprefix | Préfixe des noms obfusqués, $name ou une chaîne quelconque. Des paires clé-valeur attribuent le préfixe à une catégorie de symboles donnée. | |
ObfuscateEvents | Booléen | true | --events | Indique s’il faut renommer les événements. |
ObfuscateFields | Booléen | true | --fields | Indique s’il faut renommer les champs. |
ObfuscateMethods | Booléen | true | --methods | Indique s’il faut renommer les méthodes. |
ObfuscateParameters | Booléen | true | --parameters | Indique s’il faut renommer les paramètres de méthode. |
ObfuscateProperties | Booléen | true | --properties | Indique s’il faut renommer les propriétés. |
ObfuscateTypes | Booléen | true | --types | Indique s’il faut renommer les types. |
ObfuscateXaml | Booléen / Clé=Valeur | false | --xaml | Indique s’il faut renommer les symboles référencés par les ressources XAML et BAML. Des paires clé-valeur configurent le renommage. |
OverloadedRenaming | Booléen / Clé=Valeur | false | --overloaded | Indique s’il faut réutiliser le même nom pour des membres de signatures différentes. Des paires clé-valeur sélectionnent les membres auxquels la surcharge s’applique. |
UnicodeNormalization | Booléen / Chaîne | false | --unicode | Indique s’il faut générer les noms avec des caractères Unicode. Lorsque l’option est désactivée, des caractères ASCII sont utilisés. Une liste de caractères ou de plages séparés par des virgules restreint le jeu de caractères. |
VirtualFunctions | Booléen / Clé=Valeur | true | --virtual | Indique s’il faut renommer les membres virtuels. Des paires clé-valeur configurent le renommage des substitutions externes. |
XmlDocFiles | Chaîne | --xmldoc | Liste des fichiers de documentation XML à traiter en même temps que l’assembly. XmlDoc est accepté comme ancien alias. |
Obfuscation du flux de contrôle
| Attribut | Type | Valeur par défaut | Ligne de commande | Description |
|---|---|---|---|---|
ControlFlowObfuscation | Booléen / Clé=Valeur | false | --controlflow | Indique s’il faut obfusquer le flux de contrôle des méthodes. Des paires clé-valeur sélectionnent les algorithmes, dont chain=on pour l’état chaîné Ultimate. |
ControlFlowIterations | Entier | 3 | --iterations | Nombre d’itérations des algorithmes d’obfuscation du flux de contrôle. 0 désactive l’obfuscation du flux de contrôle. ILIterations et Iterations sont acceptés comme alias. |
EmitInvalidOpcodes | Booléen / Chaîne | false | --invalidopcodes | Indique s’il faut émettre des codes d’opération MSIL non valides, ce qui rend l’assembly non vérifiable. La valeur enhanced insère des codes d’opération non valides supplémentaires. |
Chiffrement et protection
| Attribut | Type | Valeur par défaut | Ligne de commande | Description |
|---|---|---|---|---|
DebuggingProtection | Booléen | false | --antidebugging | Indique s’il faut activer la protection contre le débogage. |
DynamicProxy | Booléen / Chaîne | false | --proxy | Indique s’il faut envelopper les appels de méthode dans des proxys générés dynamiquement. La valeur sélectionne les appels à faire passer par un proxy : internal, external ou all. |
DynamicProxyCallFilters | Chaîne | --proxy | Liste d’expressions régulières qui sélectionnent les appels de méthode à faire passer par un proxy. | |
MsilEncryption | Booléen / Chaîne | false | --msilencryption | Indique s’il faut chiffrer le code MSIL des méthodes. Des expressions régulières sélectionnent les méthodes à chiffrer d’après leur signature. |
ResourceEncryption | Booléen / Clé=Valeur | false | --resourceencryption | Indique s’il faut chiffrer les ressources managées. Des paires clé-valeur activent séparément le chiffrement et la compression. |
SingleFile 12.0 | Booléen | false | --singlefile | Signale que la cible est publiée sous forme d’application en fichier unique, découpée (trimming) ou NativeAOT. Sur les cibles de bureau, le contrôle de détection de falsification est inopérant pour une telle publication, et Babel émet un avertissement lorsqu’il est demandé. |
StringEncryption | Booléen / Chaîne | false | --stringencryption | Indique s’il faut chiffrer les chaînes utilisateur. La valeur sélectionne l’algorithme : xor, hash ou stream 12.0 Ultimate. |
SuppressIldasm | Booléen | false | --ildasm | Indique s’il faut empêcher ILDASM de désassembler l’assembly obfusqué. |
SuppressReflection | Booléen / Entier | false | --reflection | Indique s’il faut émettre des métadonnées non valides qui bloquent les outils de réflexion. Un entier définit le niveau : plus le niveau est élevé, plus les métadonnées non valides générées sont nombreuses. |
TamperingDetection | Booléen | false | --tamperingdetection | Indique s’il faut activer la détection de falsification. |
TrustedBundle 12.0 Ultimate | Chaîne | --trustedbundle | Identifiant de bundle iOS approuvé (CFBundleIdentifier), épinglé par le contrôle d’intégrité du paquet iOS. | |
TrustedSigner 12.0 Ultimate | Chaîne | --trustedsigner | Liste des empreintes SHA-256, de 64 caractères hexadécimaux chacune, des certificats de signature d’APK Android approuvés, épinglés par le contrôle d’intégrité du paquet Android. | |
TrustedTeam 12.0 Ultimate | Chaîne | --trustedteam | Identifiant d’équipe Apple Developer (Team ID) approuvé, épinglé par le contrôle d’intégrité du paquet iOS. | |
ValueEncryption | Booléen / Clé=Valeur | false | --valueencryption | Indique s’il faut chiffrer les valeurs constantes et les tableaux. Des paires clé-valeur sélectionnent les catégories de valeurs à chiffrer. |
Optimisations
| Attribut | Type | Valeur par défaut | Ligne de commande | Description |
|---|---|---|---|---|
CleanAttributes | Booléen / Chaîne | false | --cleanattrs | Indique s’il faut supprimer les attributs indésirables. Des expressions régulières sélectionnent les noms complets des types d’attributs à supprimer. |
ConstRemoval | Booléen | false | --constremoval | Indique s’il faut supprimer les champs constants. |
DeadCodeElimination | Booléen / Chaîne | false | --deadcode | Indique s’il faut supprimer les méthodes, les propriétés et les événements que l’application n’utilise pas. Des expressions régulières définissent les points d’entrée d’où part la recherche. |
DisgregateRemoval | Booléen | false | --disgregateremoval | Indique s’il faut supprimer les métadonnées des propriétés et des événements. |
EnumRemoval | Booléen | false | --enumremoval | Indique s’il faut supprimer les types System.Enum. |
InlineExpansion | Booléen | false | --inlineexpansion | Indique s’il faut remplacer les appels aux méthodes marquées pour l’expansion en ligne par le corps de la méthode. |
SealClasses | Booléen | false | --seal | Indique s’il faut sceller les classes qui n’interviennent dans aucune chaîne d’héritage. |
Génération de code
| Attribut | Type | Valeur par défaut | Ligne de commande | Description |
|---|---|---|---|---|
AddReferences | Chaîne | --addreference | Liste des assemblies à ajouter comme références de l’assembly cible. | |
Framework | Chaîne | Nom du framework cible imposé à l’assembly traité. | ||
GenerateDebug | Booléen / Chaîne | false | --debug | Indique s’il faut générer les symboles de débogage de l’assembly obfusqué. Un chemin de magasin de symboles peut être indiqué comme valeur. |
Instrument | Booléen / Chaîne | false | --instrument | Indique s’il faut instrumenter le code. Des expressions régulières sélectionnent les noms complets des méthodes à instrumenter. |
InstrumentEmptyMethods | Booléen | false | --emptymethods | Indique s’il faut instrumenter les méthodes dont le corps est vide. |
ModuleInitializer | Booléen / Chaîne | false | --moduleinitializer | Indique s’il faut ajouter du code d’initialiseur de module à l’assembly cible. |
ModuleInitializerTarget | Chaîne | --moduleinitializer | Signature de la méthode statique, sans paramètres, appelée après le chargement du module. | |
ModuleVersionId | Booléen / Chaîne | false | --moduleversionid | Indique s’il faut définir l’identificateur de version du module (MVID) de l’assembly obfusqué. Une chaîne GUID définit la valeur ; sinon, une valeur aléatoire est générée. |
Paquets
| Attribut | Type | Valeur par défaut | Ligne de commande | Description |
|---|---|---|---|---|
AndroidSigningKeyAlias | Chaîne | --keyalias | Alias de la clé dans le magasin de clés Android (paquets APK). | |
AndroidSigningKeyPass | Chaîne | --keypass | Mot de passe de la clé dans le magasin de clés Android (paquets APK). | |
AndroidSigningKeyStore | Chaîne | --keystore | Fichier du magasin de clés Android (paquets APK). | |
AndroidSigningStorePass | Chaîne | --storepass | Mot de passe du magasin de clés Android (paquets APK). | |
RemoveFiles | Chaîne | --remove | Liste des assemblies déployés à retirer du paquet. | |
SkipFiles | Chaîne | --skip | Liste des assemblies déployés qui ne sont pas obfusqués. | |
TakeFiles | Chaîne | --take | Liste des assemblies déployés à obfusquer. | |
XapCompressionLevel | Entier | 6 | --compress | Niveau de compression du paquet, de 0 (aucune compression) à 9 (paquets XAP). |
Sorties de la tâche
| Sortie | Description |
|---|---|
CommandLineArgs | La ligne de commande passée à Babel, disponible lorsque ProvideCommandLineArgs vaut true. |
ExitCode | Le code de sortie renvoyé par Babel. |
Exemple
La tâche ci-dessous obfusque l’assembly intermédiaire d’un projet .NET MAUI Android avec le chiffrement des chaînes STREAM et la détection de falsification épinglée sur le certificat de signature de l’APK, et récupère la ligne de commande passée à Babel :
<Target Name="Obfuscate" AfterTargets="Compile" Condition="'$(DesignTimeBuild)' != 'true'">
<Babel InputFile="$(ProjectDir)$(IntermediateOutputPath)$(TargetFileName)"
OutputFile="$(ProjectDir)$(IntermediateOutputPath)$(TargetFileName)"
StringEncryption="stream"
ControlFlowObfuscation="true"
ControlFlowIterations="3"
TamperingDetection="true"
TrustedSigner="2924C53EE9C511E9F26E0720FD8151064F7621681667D7AB1899E551CDB25104"
ProvideCommandLineArgs="true">
<Output TaskParameter="CommandLineArgs" ItemName="BabelCommandLineArgs" />
</Babel>
<Message Importance="high" Text="@(BabelCommandLineArgs, ' ')" />
</Target>Last updated on