Skip to content
← Alle Beiträge
· Delta1 Labs ObfuscationNebula

SuppressIldasmAttribute ist kein Schutz: Was Anti-ILDASM wirklich bringt

Warum das Attribut [SuppressIldasm] genau ein Werkzeug stoppt — und auf modernem .NET schlicht ignoriert wird — plus was echtes Metadaten- und String-Hardening leistet, mit C#, IL und Nebula-Konfiguration.

Suchen Sie nach „.NET-Assembly schützen”, und jemand wird Ihnen sagen, Sie sollten eine Zeile hinzufügen:

[assembly: System.Runtime.CompilerServices.SuppressIldasm]

Das Versprechen: Ihre DLL lässt sich nicht mehr disassemblieren. Die Wirklichkeit ist weit enger, als fast jeder annimmt, der diese Zeile einfügt, und auf modernem .NET tut sie gar nichts. Dies ist eine ausführliche Erklärung, was SuppressIldasmAttribute tatsächlich bewirkt, warum es genau ein Programm stoppt und was nötig ist, damit ein Assembly wirklich teuer zu lesen wird.

Was das Attribut wirklich ist

SuppressIldasmAttribute ist keine Verschlüsselung, keine Berechtigung, kein Schloss. Es ist ein Markierer — ein feldloses benutzerdefiniertes Attribut, das der Compiler in die Metadaten Ihres Assemblys schreibt. Auf IL-Ebene ist es nur ein weiterer .custom-Eintrag in der Tabelle CustomAttribute:

.custom instance void [System.Runtime]
    System.Runtime.CompilerServices.SuppressIldasmAttribute::.ctor() = ( 01 00 00 00 )

Dieses ( 01 00 00 00 ) ist der Attribut-Blob: ein Zwei-Byte-Prolog und ein Zwei-Byte-Zähler, ohne Argumente. An Ihrem Code ändert sich nichts. Jeder Typ, jeder Methodenrumpf, jedes String-Literal wird exakt wie zuvor in die Datei geschrieben. Das Einzige, was im Assembly neu ist, ist ein Kennzeichen, das im Grunde sagt: „bitte disassembliere mich nicht.”

Ob jemand diese Bitte beachtet, hängt vollständig von dem Werkzeug ab, das die Datei liest.

Genau ein Werkzeug hörte zu — und hörte auf

Historisch prüfte Microsofts eigene ildasm.exe — der mit dem .NET-Framework-SDK ausgelieferte IL-Disassembler — dieses Attribut. Fand sie es, gab sie // This assembly is protected... aus und weigerte sich, den IL auszugeben. Das ist der gesamte Mechanismus. Es war ein Gentlemen’s Agreement zwischen Microsofts Erstellungswerkzeug und Microsofts Disassemblierungswerkzeug.

Zwei Tatsachen bringen den Schutz zum Einsturz:

  1. Kein anderer Leser hat es je geprüft. ILSpy, dnSpy, dotPeek, JustDecompile, das monodis-Werkzeug von Mono und moderne Decompiler einschließlich Glass.NET lesen die Metadatentabellen direkt. Keiner von ihnen zieht das SuppressIldasm-Kennzeichen zurate, weil nichts im ECMA-335-Format sie dazu verpflichtet. Sie öffnen die Datei, durchlaufen die Tabellen TypeDef und MethodDef, lösen den IL jeder Methode aus ihrem RVA auf und rekonstruieren das C#. Das Attribut ist für sie unsichtbar.

  2. Auf .NET 6 und neuer ignoriert selbst ildasm es. Die Beachtung wurde entfernt. Das Attribut kompiliert weiterhin — es ist als veraltet markiert — aber der moderne Disassembler gibt das Assembly trotzdem aus. Auf jedem aktuellen .NET-Ziel ist [assembly: SuppressIldasm] also buchstäblich ein No-Op: Es ändert vier Byte Metadaten und schützt nichts, nicht einmal gegen das eine Werkzeug, für das es geschrieben wurde.

Das Nettoergebnis heute: Sie haben ein Attribut hinzugefügt, das nichts tut, und sich möglicherweise eingeredet, geschützt zu sein, obwohl Sie es nicht sind. Dieser zweite Teil ist die eigentliche Gefahr.

Warum es schon immer schwach war: Die Datei bleibt lesbar

Treten Sie vom Attribut zurück und sehen Sie sich an, was ein .NET-Assembly tatsächlich preisgibt. Die verwalteten Metadaten sind kein undurchsichtiger Blob — sie sind ein Satz wohldefinierter Streams innerhalb der PE-Datei, und Decompiler nähren sich direkt daran.

What a decompiler reads from the metadata streams — the SuppressIldasm flag guards none of it Assembly metadata a decompiler walks directly #~ (tables) TypeDef, MethodDef, Field, Param rows #Strings every type, method and field name #US every string literal in your code method bodies (IL) resolved from each RVA #Blob signatures, constants SuppressIldasm flag — one row in CustomAttribute The flag sits beside the data; it does not encrypt, remove or guard any of it. A reader that skips the flag still reads every box above.

Der #Strings-Heap enthält den Klartextnamen jedes Typs, jeder Methode, jedes Felds und jedes Parameters. Der #US-Heap (Benutzerstrings) enthält jedes String-Literal, das Ihr Code enthält. Der #~-Stream enthält die Tabellen, die sie zusammenfügen, und der IL jeder Methode wird aus ihrer relativen virtuellen Adresse aufgelöst. Ein Decompiler öffnet die Datei und liest diese Strukturen. Das ist die gesamte Aufgabe.

Das SuppressIldasm-Kennzeichen sitzt neben all dem, in einer Zeile der Tabelle CustomAttribute. Es entfernt keinen einzigen Namen, verschlüsselt kein einziges Literal, verschleiert keinen einzigen Opcode. Es bittet einen Leser wegzusehen — und die Daten, von denen er wegsehen würde, liegen für alle anderen weiterhin vollständig da. Deshalb war der Schutz nie bedeutsam, unabhängig von der .NET-6-Änderung: Das, was zu schützen sich gelohnt hätte, wurde nie angetastet.

Was die Kosten wirklich hebt

Echter Schutz bittet keinen Leser, höflich zu sein. Er entfernt oder verwürfelt die Information, von der der Leser abhängt, sodass ein Decompiler, der alle Kennzeichen ignoriert, seinem Bediener dennoch sehr wenig liefert.

Benennen Sie die Metadaten um. Der #Strings-Heap ist die Stelle, an der die Bedeutung durchsickert. CalculateMonthlyAccrual und _remainingTrialDays sagen einem Angreifer genau, wo er suchen muss. Benennen Sie sie in nicht druckbare oder kollidierende Bezeichner um, und die dekompilierte Ausgabe wird zu einem Labyrinth aus a.b(c) ohne semantische Anker — die Namen sind schlicht aus dem Heap verschwunden.

Verschlüsseln Sie die Literale. Der #US-Heap ist der andere Verräter: die Form von Verbindungszeichenfolgen, API-Routen, Fehlermeldungen und Lizenzprüfungstexten liegt im Klartext vor. Ersetzen Sie jedes Literal durch einen verschlüsselten Blob und einen faulen Entschlüsseler, und der Heap trägt Chiffretext statt Ihrer Geschäftslogik in Prosa.

Formen Sie den Fluss um. Kontrollfluss-Abflachung und opake Prädikate greifen die Form der Logik an, die in den Methodenrümpfen überlebt, sodass selbst rekonstruierter Code dem Lesen widersteht.

In Nebula ist dies Konfiguration, nicht Attribute. Eine minimale nebula.config.json, die die Arbeit leistet, die SuppressIldasm nur vorgibt zu leisten:

{
  "renaming": { "mode": "dictionary" },
  "encryptStrings": true,
  "controlFlow": { "enabled": true, "opaquePredicates": true },
  "antiIldasm": true
}

Dann schützen Sie das kompilierte Assembly:

nebula protect ./bin/Release/net8.0/Billing.dll \
  --config nebula.config.json \
  --out ./protected/

Beachten Sie, dass antiIldasm in dieser Liste steht — Nebula gibt das Kennzeichen aus, wenn Sie darum bitten, denn es kostet nichts und schließt auf den Frameworks, wo es noch eine Wirkung hat, eine triviale Tür. Aber es ist absichtlich die letzte und geringste Zeile der Datei. Die drei Zeilen darüber verändern das Ergebnis. Nur antiIldasm zu aktivieren und auszuliefern ist der Fehler, zu dessen Vermeidung dieser ganze Artikel existiert.

Beweisen Sie es sich selbst

Sie müssen es nicht auf Treu und Glauben hinnehmen. Bauen Sie ein Assembly mit nichts als dem Attribut und öffnen Sie es dann in einem beliebigen modernen Decompiler — einschließlich eines kostenlosen wie Glass.NET:

# Build with only [assembly: SuppressIldasm] — no other protection
dotnet build -c Release

# Open the output and read the source straight back
glass decompile ./bin/Release/net8.0/Billing.dll --out ./recovered/

Jeder Methodenname, jeder String, jede Zeile Logik kommt zurück. Lassen Sie nun dasselbe Assembly durch nebula protect mit der obigen Konfiguration laufen und dekompilieren Sie das. Die Namen sind weg, die Strings sind Chiffretext, und der Kontrollfluss wehrt sich. Dieser Kontrast ist das ganze Argument: Der eine Ansatz bittet ein Werkzeug, nicht hinzusehen; der andere entfernt das, wonach das Werkzeug gesucht hat.

Das Fazit

SuppressIldasmAttribute ist eine historische Höflichkeit zwischen zwei Microsoft-Werkzeugen, und diese Höflichkeit endete mit .NET 6. Es hat Ihren Code nie geschützt — es bat einen einzigen Alt-Disassembler, darauf zu verzichten, ihn zu zeigen, während es für jeden anderen Leser jeden Namen, jedes Literal und jeden Opcode vollständig intakt ließ. Liefern Sie es aus, wenn Sie wollen; es ist kostenlos und harmlos. Verwechseln Sie es nur nie mit einer Verteidigung. Das Assembly ist geschützt, wenn die Information, die ein Angreifer braucht, nicht in der Datei zum Lesen vorhanden ist — und das ist ein Problem der Umbenennung, der String-Verschlüsselung und des Kontrollflusses, kein einzeiliges Attribut.

Umbenennung und String-Verschlüsselung sind Pro-Funktionen in Nebula; aggressiver Kontrollfluss-Schutz ist Enterprise. Das Attribut ist in jedem Tier enthalten, denn ein Häkchen, das nichts kostet, ist genau so viel wert, wie es kostet.

Nebula.NET testen

Härten Sie Ihren .NET-Code in wenigen Minuten — starten Sie mit der kostenlosen Edition.