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

Wie ein Decompiler C#-Interceptors liest

C#-Interceptors leiten einen Aufruf zur Kompilierzeit um und hinterlassen an der Aufrufstelle keine Markierung; die einzige Spur ist ein InterceptsLocation-Attribut, dessen Base64-Blob Glass zu einem Content-Hash, einer Quellposition und dem Namen der abgefangenen Methode dekodiert.

Sie dekompilieren einen Release-Build, öffnen Program.cs und stoßen auf einen Aufruf, der nicht mehr dorthin führt, wohin der Quellcode sagte. Der Code liest client.GetForecast("NYC"), aber die IL ruft eine statische Methode einer generierten file-Klasse auf, von der Sie noch nie gehört haben. Niemand hat den Quellcode geändert. Der Compiler hat den Aufruf umverdrahtet – und kaum etwas hinterlassen, das es erklärt.

Das ist ein C#-Interceptor. Es ist eines der wenigen Sprachfeatures, das ändert, an welche Methode ein Aufruf gebunden wird, nachdem Sie den Aufruf geschrieben haben, und es ist an der Aufrufstelle absichtlich unsichtbar. Für einen Decompiler ist das ein Problem: kein Opcode, kein Modifizierer, keine Markierung, die sagt „dieser Aufruf wurde umgeleitet”. Den eigenen Build zu verstehen bedeutet zu wissen, wo der einzige überlebende Beweis wohnt und wie man ihn liest.

Die eigentliche Frage

Ein Interceptor ist eine Methode, bereitgestellt von einem Quellcode-Generator, die der Compiler für einen bestimmten Aufruf an einer bestimmten Quellcode-Stelle einsetzt. Die Minimal-APIs von ASP.NET Core nutzen das, um die reflexionsbasierte MapGet-Verrohrung durch generierte, stark typisierte Request-Handler zu ersetzen; Konfigurationsbinder und Mapping-Bibliotheken tun dasselbe. Das Feature ist optional, hinter <InterceptorsNamespaces> in der Projektdatei.

Hier sind der Benutzercode und der generierte Interceptor:

// Program.cs  (what you wrote)
var client = new WeatherClient();
var forecast = client.GetForecast("NYC");   // ← compiler redirects this call
// WeatherClient.g.cs  (emitted by a source generator)
namespace Generated;

file static class WeatherInterceptors
{
    [global::System.Runtime.CompilerServices.InterceptsLocation(
        1, "khAcU2t0b2tlbgAAAABQAAAAUHJvZ3JhbS5jcw==")]
    public static Forecast GetForecast_Fast(this WeatherClient client, string city)
    {
        // generated fast path, no reflection
    }
}

Der Compiler sieht, dass GetForecast_Fast die Stelle des GetForecast-Aufrufs beansprucht, und emittiert stattdessen einen Aufruf des Interceptors. Die Frage, die ein Decompiler beantworten muss, lautet: Wie stellt man allein aus der Assembly wieder her, dass eine Interception stattgefunden hat und was das ursprüngliche Ziel war?

Die Aufrufstelle sagt Ihnen nichts

Beginnen Sie dort, wo Ihr Instinkt Sie hinschauen heißt: beim Aufruf selbst. Die emittierte IL für diese Zeile ist ein gewöhnlicher Aufruf:

ldloc.0                                              // client
ldstr      "NYC"
call       class Generated.Forecast
             Generated.WeatherInterceptors::GetForecast_Fast(
               class WeatherClient, string)

Nirgends in diesem Methodenrumpf gibt es ein WeatherClient::GetForecast. Das ursprüngliche Ziel wird nicht referenziert, nicht kommentiert, nicht markiert. Was die IL betrifft, haben Sie einfach einen Aufruf von GetForecast_Fast geschrieben. Ein Decompiler, der das getreu rendert, zeigt Ihnen genau das – was korrekt ist, denn das wird ausgeführt –, aber es verbirgt die Umschreibung. Die Interception ist eine Bindungsentscheidung, die in das Aufruf-Token eingebacken ist; nichts überlebt an der Aufrufstelle, um sie rückgängig zu machen.

Der einzige Ort, an dem die Umleitung festgehalten wird, ist also die Interceptor-Methode, als benutzerdefiniertes Attribut.

Den InterceptsLocation-Blob dekodieren

InterceptsLocationAttribute wird wie jedes andere benutzerdefinierte Attribut in die Metadaten emittiert. Die aktuelle Form (Version 1) nimmt zwei Argumente: ein int für die Version und einen string-Daten-Blob:

.method public hidebysig static class Forecast
        GetForecast_Fast(class WeatherClient client, string city) cil managed
{
  .custom instance void
    System.Runtime.CompilerServices.InterceptsLocationAttribute::.ctor(int32, string)
    = ( 01 00  01 00 00 00  24 6B 68 41 63 55 32 74 30 62 32 74 6C 62 ... 00 00 )

Lesen Sie diesen CA-Blob nach den Regeln von ECMA-335. 01 00 ist der Prolog. 01 00 00 00 ist das erste feste Argument, das int32 der Version 1. Dann folgt das string-Argument als SerString: eine Länge als komprimierte Ganzzahl (0x24 = 36 Bytes), gefolgt von den UTF-8-Bytes des Base64-Texts. Das abschließende 00 00 ist die Anzahl der benannten Argumente, null.

Dieser Base64-String ist selbst ein gepackter Binärdatensatz. Dekodieren Sie ihn, und Sie erhalten drei hintereinander angeordnete Felder:

byte[] blob = Convert.FromBase64String(data);

// 1) 16-byte content hash of the intercepted source file (XxHash128 in current Roslyn)
ReadOnlySpan<byte> contentHash = blob.AsSpan(0, 16);

// 2) position of the intercepted name token, as an ECMA-335 compressed unsigned integer
int offset = 16;
int position = ReadCompressedUInt(blob, ref offset);

// 3) a display name for the file, UTF-8, to the end of the blob
string displayName = Encoding.UTF8.GetString(blob, offset, blob.Length - offset);

Jetzt bedeutet das Attribut etwas Konkretes. Es sagt: Diese Methode fängt den Aufruf ab, dessen Namens-Token am Zeichen position in einer Datei beginnt, deren Inhalt den Hash contentHash hat und Menschen als displayName angezeigt wird. Glass führt genau diese Dekodierung aus, wenn es auf ein InterceptsLocation-Attribut trifft, sodass die Interceptor-Methode im Typbaum mit der Position und der Datei markiert ist, die sie beansprucht, statt Ihnen einen undurchsichtigen Base64-String zu zeigen.

client.GetForecast(..)AufrufstelleCompiler-Umschreibungcall GetForecast_FastIL: keine Spur des Originals[InterceptsLocation(1,"..")]an der Interceptor-MethodeGlassdekodiertdekodierter BlobcontentHash(16) · position · displayNameder einzige Beweis, dass der Aufruf umgeleitet wurde
Ein C#-Interceptor schreibt den Aufruf während der Kompilierung um. Die IL behält an der Aufrufstelle keine Markierung; die einzige überlebende Spur ist das InterceptsLocation-Attribut an der Interceptor-Methode, das Glass in einen Content-Hash, eine Quellposition und einen Anzeigenamen dekodiert.

Vom Beweis zum Verständnis

Fügen Sie die beiden Hälften zusammen, und die Umschreibung wird lesbar. Durchlaufen Sie den Typbaum nach Methoden, die InterceptsLocation tragen; jede ist ein Interceptor. Ihre Signatur verrät die Form des Aufrufs, den sie ersetzt hat: ein erster Parameter im Erweiterungsstil this WeatherClient bedeutet, dass sie für einen Instanzaufruf auf WeatherClient einsteht, und der vom Generator gewählte Methodenname (GetForecast_Fast) hallt oft den Originalnamen wider. Dann der Querverweis: Suchen Sie in der Assembly nach direkten Aufrufen dieses Interceptors, und diese Aufrufstellen sind die Orte, die der Compiler umgeleitet hat. Die dekodierte position und der displayName sagen Ihnen, welche Quelldatei und ungefähr wo – sofern Sie den Quellcode haben, um ihn gegen den Hash abzugleichen.

In Glass erscheinen die Interceptor-Methoden mit ihrer dekodierten Position in der IL-Ansicht, und der Attribut-Blob wird erweitert statt roh angezeigt, sodass Sie auf einen Blick sehen, dass eine generierte Methode eine Aufrufstelle beansprucht – der Hinweis, dass ein unscheinbar wirkender Aufruf anderswo nicht das ist, was er zu sein scheint.

Wann das zusammenbricht

Seien Sie ehrlich über die Grenzen, denn sie sind real.

  • Kein Quellcode, keine Zeilennummer. Der Blob der Version 1 ist absichtlich quellrelativ. Der Content-Hash und die Zeichenposition sind nur auflösbar, wenn Sie die Originaldatei haben, um sie zu hashen und darin zu indexieren. Ohne sie erfahren Sie, dass ein Aufruf abgefangen wurde, und seinen Anzeigenamen, aber nie die genaue sichtbare Zeile. Das ist Absicht: Die Kodierung tauscht Lesbarkeit gegen Widerstandsfähigkeit gegenüber Leerzeichenänderungen.
  • Die Aufrufstelle ist wirklich sauber. Suchen Sie nicht nach einem Modifizierer oder einer Markierung am umgeleiteten Aufruf. Es gibt keine. Die Umleitung wohnt nur im Interceptor, sodass ein Decompiler, der die benutzerdefinierten Attribute nicht inspiziert, das Feature vollständig verpasst und einen Aufruf zeigt, der von Hand geschrieben aussieht.
  • Die alte Form liest sich anders. Die ursprüngliche Vorschaukodierung war [InterceptsLocation(string filePath, int line, int character)]: menschenlesbar, aber fragil und inzwischen abgelöst. Sie können ihr noch in älteren Assemblys begegnen; dekodieren Sie sie als drei einfache Argumente, nicht als Blob.
  • Es ist noch ein optionales, in Bewegung befindliches Feature. Interceptors wohnen hinter <InterceptorsNamespaces>, und die Form des Attributs hat sich bereits einmal geändert. Behandeln Sie das genaue Byte-Layout als versionsabhängig und lesen Sie zuerst das Versionsargument.

Fazit

Interceptors sind der Fall, in dem die ehrliche und die nützliche Dekompilierung auseinandergehen. Die IL, die ausgeführt wird, ist ein direkter Aufruf einer generierten Methode, und sie getreu zu rendern ist korrekt – aber es verbirgt eine Umschreibung zur Kompilierzeit. Die ganze Geschichte ist in ein benutzerdefiniertes Attribut am Interceptor gefaltet, und es zu lesen bedeutet, einen Base64-Datensatz aus einem Content-Hash, einer Quellposition und einem Namen zu dekodieren. Glass erledigt diese Dekodierung für Sie, und das ist der Unterschied zwischen dem Sehen eines Aufrufs von GetForecast_Fast und dem Verständnis, dass Ihr eigener GetForecast-Aufruf still ersetzt wurde.

Glass.NET ist ein kostenloser .NET-Decompiler. Siehe die Produktseite und die Dokumentation.

Nebula.NET testen

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