Builds reproductibles pour les assemblys .NET obfusqués
La compilation déterministe vous donne une DLL identique octet pour octet à partir d'un même code source... jusqu'à ce que l'obfuscateur estampille dans la sortie un nouveau MVID, l'heure courante et une graine de renommage aléatoire. Voici où se loge cette non-déterminisme dans le PE et les métadonnées, et comment le mode déterministe de Nebula.NET dérive le MVID, l'horodatage et la graine de renommage d'un hachage du contenu afin que l'assembly protégé ait le même hachage à chaque exécution.
La compilation déterministe est l”une des victoires les plus discrètes du .NET moderne. Activez <Deterministic>true</Deterministic> — c”est la valeur par défaut pour les projets de style SDK — et Roslyn émettra un assembly identique octet pour octet à partir d”un code source identique, de références identiques et d”un compilateur identique. Pas d”horodatage d”horloge, pas de GUID de module aléatoire. Deux ingénieurs sur deux machines obtiennent la même DLL, et la CI peut prouver que le binaire livré correspond au code source.
Puis vous le faites passer par un obfuscateur, et la garantie s”évapore. Calculez le hachage de l”assembly protégé issu de deux exécutions consécutives avec exactement les mêmes entrées et vous obtenez deux hachages différents. Rien dans votre code n”a changé. Où est passé le déterminisme ?
La vraie question
Un obfuscateur lit un assembly, réécrit ses métadonnées et son IL, puis écrit un nouvel assembly. Deux champs de cette sortie sont, par longue tradition, remplis à partir de l”environnement plutôt que de l”entrée — et une troisième source de variance se cache dans la manière dont le renommeur parcourt vos membres. Trouvez ces trois-là et vous pourrez rétablir la garantie.
Où se loge la non-déterminisme
La première est l”identité du module. Chaque module .NET porte un Module Version ID, un GUID stocké dans le tas de métadonnées #GUID et référencé depuis l”unique ligne de la table Module. ildasm l”imprime en tête du module :
// Metadata: Module (table 0x00)
// Gen Name Mvid (-> #GUID) EncId EncBaseId
// 0 MyApp.dll 1 0 0
// #GUID[1] = {3f2504e0-4f89-41d3-9a0c-0305e82c3301}
Roslyn, en mode déterministe, fixe ce GUID à un hachage des entrées de la compilation. Un obfuscateur typique réémet le module et le fixe à Guid.NewGuid() — une nouvelle valeur aléatoire à chaque exécution. Un seul champ, et la reproductibilité est déjà perdue.
La seconde est l”horodatage de l”en-tête PE. L”en-tête COFF possède un TimeDateStamp de 32 bits. Roslyn déterministe n”y écrit pas l”heure réelle ; il y écrit un hachage du contenu avec le bit de poids fort activé, pour que les outils sachent que ce n”est pas un horodatage :
// PE / COFF header
// Machine: 0x014C (I386)
// TimeDateStamp: 0x8E0F3A21 // high bit set: content hash, not a real time
Un obfuscateur qui appelle DateTimeOffset.UtcNow pour remplir ce champ fait différer la sortie à chaque seconde.
La troisième est plus subtile et se loge dans le renommeur. Donner à un membre son nom obfusqué est déterministe isolément, mais l”ordre dans lequel les membres sont visités ne l”est généralement pas. Parcourez les méthodes d”un type à travers un HashSet ou une collection ordonnée par réflexion et l”ordre d”itération peut varier entre les exécutions ou les versions du framework ; semez le générateur de noms depuis Environment.TickCount et le tout premier nom change à chaque exécution. Voici la forme d”une implémentation naïve — chaque ligne est une fuite de reproductibilité :
module.Mvid = Guid.NewGuid(); // random identity
peHeader.TimeDateStamp = (uint)DateTimeOffset.UtcNow
.ToUnixTimeSeconds(); // wall clock
var rng = new NameGenerator(seed: Environment.TickCount); // random seed
foreach (var m in type.Methods) // unstable order
m.Name = rng.Next(); // -> different map
Même le chiffrement des chaînes y contribue : si la clé par build provient de RandomNumberGenerator, les blobs chiffrés dans les données adjacentes à #US diffèrent à chaque exécution même s”ils déchiffrent vers les mêmes chaînes.
Dériver l”identité du contenu
La solution est de remplacer chaque valeur issue de l”environnement par une fonction de l”entrée. Le mode déterministe de Nebula.NET calcule un digest sur le module transformé sous une forme canonique — les tables de métadonnées et l”IL après réécriture, lus dans l”ordre des tables, avec les champs dépendant des noms masqués pour que le digest ne dépende pas de noms qu”il n”a pas encore attribués — et utilise ce digest comme unique source d”entropie :
byte[] digest = SHA256.HashData(canonicalModuleBytes); // stable over inputs + config
module.Mvid = new Guid(digest.AsSpan(0, 16)); // identity from content
peHeader.TimeDateStamp =
BinaryPrimitives.ReadUInt32LittleEndian(digest.AsSpan(16)) | 0x8000_0000u; // hash, flagged
var rng = new NameGenerator(seed: digest); // reproducible map
foreach (var m in type.Methods.OrderBy(StableKey)) // (declaring token, signature)
m.Name = rng.Next();
var stringKey = HKDF.DeriveKey(HashAlgorithmName.SHA256, digest, 32, info: "nebula/strings"u8);
StableKey est la partie qui rend le renommeur honnête : les membres sont triés par un tuple du token de métadonnées de leur type déclarant et de leur signature complète, de sorte que l”ordre du parcours ne dépend pas des rouages internes de la collection. La clé de chiffrement des chaînes est dérivée du même digest avec HKDF, de sorte que les blobs chiffrés sont stables eux aussi — et puisque cette clé doit déjà vivre à l”intérieur de l”assembly pour que le runtime déchiffre, la dériver du contenu ne donne rien de nouveau à un attaquant.
Vous l”activez avec une seule clé de configuration :
{
"assemblies": ["MyApp.dll"],
"rename": { "enabled": true },
"controlFlow": { "enabled": true },
"stringEncryption": { "enabled": true },
"deterministic": true
}
Le pipeline est désormais une fonction pure. Exécutez-le deux fois et comparez :
nebula --config nebula.config.json --out run1/
nebula --config nebula.config.json --out run2/
sha256sum run1/MyApp.dll run2/MyApp.dll
# 4e02a9… run1/MyApp.dll
# 4e02a9… run2/MyApp.dll <- identical
Ce que cela vous apporte
Attestation. Un assembly protégé reproductible peut être reconstruit par quiconque possède l”assembly d”entrée et la configuration, et le hachage qu”il obtient est le hachage que vous avez livré. Cela transforme le « faites confiance à notre serveur de build » en « reconstruisez-le vous-même et comparez », ce qui est tout l”intérêt d”une posture de builds reproductibles pour une chaîne d”approvisionnement.
Mise en cache. Comme la sortie est une fonction de (assembly d''entrée, configuration, version de Nebula.NET), vous pouvez indexer un cache de CI sur le hachage de précisément ces trois éléments. Sur une branche qui n”a pas touché à l”assembly, le cache réussit et vous sautez entièrement l”obfuscation — sûr, car un succès garantit une sortie identique octet pour octet à celle que vous auriez produite.
Comparabilité. Avec un MVID et un horodatage fixés, une comparaison binaire entre deux releases ne montre que les métadonnées et l”IL qui ont réellement changé, au lieu d”être noyée sous un nouveau GUID et un nouvel horodatage à chaque build. Associez cela à une carte de renommage stable et la comparaison reflète le changement réel.
Quand cela casse
La reproductibilité n”est déterministe qu”à hauteur de sa plus faible entrée, et trois méritent d”être signalées honnêtement.
La version de l”outil fait partie de la clé. Une nouvelle version de Nebula.NET peut ajouter ou affiner une transformation, ce qui change légitimement la sortie. La sortie déterministe est reproductible pour une version fixée ; épinglez la version dans la CI et enregistrez-la à côté du hachage.
L”horodatage Authenticode n”est pas reproductible. La signature par nom fort est déterministe — c”est une fonction de la clé et du contenu — mais une signature Authenticode avec un contreseing RFC 3161 incorpore l”heure de signature et le nonce de l”autorité d”horodatage, qu”aucune paire de signatures ne partage. Gardez la signature comme étape finale et attestez le hachage de l”assembly protégé non signé, ou comparez le contenu à signer.
Les métadonnées de build incorporées se glissent au travers. Si votre propre code intègre DateTime.Now, un compteur de build ou un GUID neuf dans une constante, cette non-déterminisme est dans l”assembly d”entrée avant même que Nebula.NET ne le voie. La compilation déterministe en amont est un prérequis, pas une réflexion après coup — corrigez d”abord le code source.
À retenir
L”obfuscation n”a pas à vous coûter un build reproductible. La non-déterminisme n”est pas inhérente à la réécriture d”un assembly ; elle se loge dans trois décisions remplaçables — le GUID du module, l”horodatage du PE et la graine de renommage — plus le matériel de clé de toute transformation chiffrant du contenu. Dérivez chacune d”elles d”un hachage de l”entrée au lieu de l”horloge ou d”un générateur aléatoire, parcourez vos membres dans un ordre stable, et la DLL protégée aura le même hachage à chaque exécution. Activez deterministic: true, épinglez la version, et votre artefact durci devient quelque chose que vous pouvez attester et mettre en cache plutôt que quelque chose qui change chaque fois que vous le regardez.
Essayez Nebula.NET
Renforcez votre code .NET en quelques minutes — commencez avec l'édition gratuite.