Obfusquer une application .NET localisée sans casser les ressources
Une application localisée résout ses traductions par nom à l'exécution, et c'est précisément le type de recherche que l'obfuscation peut casser en silence. La surprise, c'est que les deux styles de localisation courants se comportent à l'opposé au renommage : un accesseur .resx classique généré par le concepteur est sûr parce que le nom de base de son ResourceManager est un littéral de chaîne déjà incorporé, tandis que IStringLocalizer<T> est fragile parce que la fabrique dérive le nom de base du nom complet du type marqueur : renommez ce type et la recherche échoue, l'assembly satellite n'est jamais consulté et le localiseur renvoie en silence la clé de ressource au lieu de la traduction. Cet article lit ce qu'émet chaque style, montre pourquoi l'un survit et l'autre non, et donne les règles de conservation précises de Nebula.NET pour que vos traductions continuent de se charger dans toutes les cultures.
La localisation est un sous-système fondé sur les noms, et « par nom » est justement l”expression qui devrait pousser chacun à manier un obfuscateur avec prudence. Chaque chaîne traduite que votre application affiche a été résolue à l”exécution en faisant correspondre une clé à un jeu de ressources, et les jeux de ressources se trouvent par nom : un nom de base que le runtime transforme en un flux .resources incorporé et, pour les cultures non par défaut, en un assembly satellite qu”il sonde sur le disque. L”obfuscation renomme des choses. La question est de savoir si l”un des noms qu”elle renomme est un nom que le pipeline de localisation recherche.
La réponse est réellement partagée. Le vieil accesseur .resx ennuyeux du concepteur est sûr pour une raison qui mérite d”être comprise. Le moderne IStringLocalizer<T> est fragile pour une raison qui mérite d”être comprise encore mieux, car il échoue en silence : pas d”exception, pas de journal, juste vos clés en anglais qui transparaissent dans une build en français. Voici ce qu”émet chacun, pourquoi ils divergent et les règles de conservation exactes qui rendent les deux sûrs avec Nebula.NET.
D”où vient réellement le nom de la ressource
Commencez par le chemin classique : un Strings.resx avec son Strings.Designer.cs généré. Ce qui compte, c”est la façon dont l”accesseur construit son ResourceManager :
internal static global::System.Resources.ResourceManager ResourceManager {
get {
if (object.ReferenceEquals(resourceMan, null)) {
var temp = new global::System.Resources.ResourceManager(
"MyApp.Resources.Strings", // base name — a string literal
typeof(Strings).Assembly); // assembly — a token reference
resourceMan = temp;
}
return resourceMan;
}
}
Le nom de base est un littéral. Le concepteur incorpore "MyApp.Resources.Strings" dans l”IL sous forme de ldstr, et c”est ce littéral auquel ResourceManager ajoute la culture : MyApp.Resources.Strings.fr.resources pour le français, trouvé dans le manifeste incorporé pour la culture neutre et dans fr/MyApp.resources.dll pour le satellite. Renommez le type Strings en a et le littéral ne bouge pas ; il dit toujours "MyApp.Resources.Strings". Le typeof(Strings) est réécrit par jeton comme toute référence de type, il pointe donc toujours vers le type renommé et renvoie toujours le bon assembly. Les deux moitiés survivent. Même le chiffrement des chaînes le laisse fonctionner, car le littéral est déchiffré avant d”atteindre le constructeur : ResourceManager reçoit le nom de base en clair exactement tel qu”il a été écrit.
Passons au chemin moderne. IStringLocalizer<HomeController> se résout via ResourceManagerStringLocalizerFactory, et la fabrique ne reçoit pas de littéral. Elle calcule le nom de base à partir du type marqueur :
// Program.cs
builder.Services.AddLocalization(o => o.ResourcesPath = "Resources");
// HomeController.cs
public HomeController(IStringLocalizer<HomeController> loc) => _loc = loc;
// ...
ViewData["Title"] = _loc["PageTitle"];
En coulisses, la fabrique lit typeof(HomeController).FullName, retire l”espace de noms racine de l”assembly et insère ResourcesPath pour produire un nom de base comme MyApp.Resources.Controllers.HomeController. Ce nom de base est la clé de recherche : ce selon quoi un flux .resources doit être nommé. Il est dérivé de l”identifiant du type à l”exécution, qui est précisément l”identifiant que l”obfuscation réécrit.
L”échec est silencieux, et c”est le vrai danger
Si IStringLocalizer levait une exception lorsqu”il ne trouve pas de jeu de ressources, ce serait un bogue bruyant que vous corrigeriez au premier test de fumée. Il ne lève pas d”exception. Le contrat d”IStringLocalizer est qu”une ressource manquante est une condition récupérable : il renvoie un LocalizedString dont l”indicateur ResourceNotFound vaut true et dont le Value est la clé que vous avez passée :
var s = _loc["PageTitle"];
// After a renamed marker type:
// s.ResourceNotFound == true
// s.Value == "PageTitle" // the key, shown verbatim in the UI
Ainsi, un utilisateur francophone voit PageTitle là où devrait figurer le titre, chaque satellite que vous avez livré est toujours sur le disque et parfaitement valide, et rien dans les journaux n”y renvoie. La build en culture neutre semble elle aussi souvent correcte, car beaucoup d”équipes mettent le texte anglais dans la clé ou dans un repli neutre — la régression n”apparaît donc que dans les cultures exactes sur lesquelles un relecteur est le moins susceptible de cliquer. C”est l”argument le plus fort pour traiter la localisation comme une cible de protection avec ses propres règles de conservation, plutôt que d”espérer que l”autodétection la couvre.
Les règles de conservation
Nebula détecte automatiquement l”usage courant de ResourceManager, donc l”accesseur .resx classique est généralement pris en charge pour vous — et même un type accesseur renommé convient parce que, comme montré ci-dessus, son nom de base est un littéral. Le chemin qui exige une décision explicite est IStringLocalizer<T> : les types marqueurs doivent conserver leurs noms complets, car la fabrique transforme FullName en clé de recherche.
Épinglez exactement ces types marqueurs et rien de plus. Dans nebula.config.json, placez les règles keep étroites au-dessus du rename général qui attrape tout — la première correspondance l”emporte :
{
"schemaVersion": 1,
"inputs": [ "bin/Release/net8.0/MyApp.dll" ],
"outputDirectory": "protected",
"preservePublicApi": true,
"encryptStrings": true,
"controlFlowObfuscation": true,
"renaming": {
"rules": [
{ "pattern": "MyApp.Controllers.*", "action": "keep" },
{ "pattern": "MyApp.Resources.*", "action": "keep" },
{ "pattern": "MyApp.*", "action": "rename" }
]
}
}
Deux choses à remarquer. D”abord, keep épingle le nom, pas le corps : un contrôleur conservé a toujours ses champs privés renommés, ses corps de méthode aplatis par le flux de contrôle et ses chaînes chiffrées — vous avez renoncé à renommer un identifiant de type, pas à la protection de son code. Ensuite, conservez la feuille, pas la branche. Si seule une poignée de types sont utilisés comme marqueurs d”IStringLocalizer<T>, épinglez ces types plutôt qu”un espace de noms entier. Pour une alternative chirurgicale et locale au code, marquez le type marqueur exact avec un attribut qui vit juste à côté :
[Obfuscation(Feature = "renaming", Exclude = true)] // used as IStringLocalizer<T> marker
public class HomeController : Controller { /* ... */ }
Une conservation plus subtile s”applique si vous localisez les annotations de données via des types de ressources : [Display(Name = "Field_Email", ResourceType = typeof(Strings))]. Le typeof(Strings) est une référence de jeton sûre, mais Name = "Field_Email" se résout en réfléchissant pour trouver une propriété statique de ce nom sur le type de ressource. Cela rend les membres de l”accesseur généré porteurs : conservez les membres publics de tout type accesseur de ressources que vous référencez depuis un ResourceType, pas seulement le nom du type. IViewLocalizer n”a besoin de rien : il dérive son nom de base du chemin de la vue, qu”aucun renommage ne touche.
Les assemblys satellites ne demandent aucun travail. Un satellite est un assembly de ressources uniquement — des flux .resources par culture et aucun IL à vous —, il n”y a donc rien à renommer ni à aplatir dedans. Laissez fr/MyApp.resources.dll et consorts hors de vos entrées Nebula et livrez-les tels qu”ils ont été compilés. Ils continuent de se résoudre parce que Nebula conserve le nom de l”assembly principal (de sorte que le runtime sonde le bon sous-dossier de culture) et parce que, sur le chemin classique, le nom de base que l”assembly principal demande ne change pas.
Vérifiez dans la culture, pas seulement en anglais
La casse de localisation se cache d”une exécution en culture par défaut, donc le test d”acceptation doit changer de culture et affirmer sur une valeur traduite, pas simplement qu”une chaîne est revenue :
[Theory]
[InlineData("fr")]
[InlineData("de")]
public void Localizer_returns_translation_not_key(string culture)
{
CultureInfo.CurrentUICulture = new CultureInfo(culture);
var s = _loc["PageTitle"];
Assert.False(s.ResourceNotFound); // the real assertion
Assert.NotEqual("PageTitle", s.Value); // guards against the silent key fallback
}
Exécutez cette suite contre la build protégée, pas celle de débogage : tout l”intérêt est d”exercer l”assembly renommé. Associez-la à une vérification statique dans Glass.NET, le compagnon gratuit purement statique : ouvrez le MyApp.dll protégé, confirmez que votre moteur interne se lit a, b, c, et confirmez que vos types marqueurs d”IStringLocalizer<T> ont conservé leurs noms complets et espaces de noms pour que la fabrique dérive le nom de base contre lequel les satellites ont été construits. Pour la discipline générale derrière les listes de conservation minimales, voyez listes de conservation et exclusions de renommage ; pour le catalogue plus large des casses par nom, ce que l”obfuscation casse.
À retenir
La localisation se résout par nom, donc la seule question que soulève l”obfuscation est de savoir lesquels des noms sont les clés de recherche. Sur le chemin .resx classique, ce ne sont pas du tout des identifiants — le nom de base est un littéral incorporé —, donc le type accesseur se renomme librement et même le chiffrement des chaînes le laisse fonctionner. Sur le chemin IStringLocalizer<T>, le nom de base est dérivé du nom complet du type marqueur à l”exécution, donc renommer ce type déplace la recherche hors de chaque flux .resources que vous avez livré et le localiseur sert la clé en silence. Conservez la poignée de types marqueurs (et les membres publics de tout type de ressource que vous atteignez via un ResourceType d”annotation de données), laissez les assemblys satellites hors des entrées et intacts, protégez tout le reste intégralement, et prouvez-le avec un test qui change de culture et affirme sur la traduction — pas sur le fait qu”une chaîne est revenue.
Essayez Nebula.NET
Renforcez votre code .NET en quelques minutes — commencez avec l'édition gratuite.