ILSpy

ILSpy を使うと、.NET で作られたプログラム（DLL や EXE）を C# のコードに戻して、画面で読めます。この記事では、自分で作った小さなアプリを開き、埋め込んだ秘密が丸見えになることを確かめて、秘密をプログラムに入れてはいけない理由を体験する使い方を説明します。

この記事は、.NET でアプリやライブラリを作っていて、配る前に「ビルドした成果物から何が読み取れるか」を自分の目で確かめたい人に向けています。読み終えると、次のことができるようになります。

• ILSpy のデスクトップ版、コマンドライン版（ilspycmd）、VS Code 拡張の違いが分かる
• 自分でビルドした .NET アプリを開き、コードと文字列を読む
• 埋め込んだダミーの秘密が読めることを確かめ、秘密の持ち方を見直す

##ILSpy でできること

ILSpy は、.NET のアセンブリ（実行用にまとめられたファイル）を読むためのブラウザー兼デコンパイラです。公式 README によると、次のことができます。

• アセンブリを C# のコードに戻す（IL という中間言語で表示することもできる）
• プロジェクト全体をまとめて書き出す
• 型・メソッド・プロパティなどを検索し、リンクをたどって移動する
• アセンブリのメタデータ（型や参照の一覧表）を調べる
• ディスクのほか、NuGet フィードと実行中のプロセスからもアセンブリを開く（v11.0 のリリースノートは、実行中のプロセスから開く機能を全 OS で使えると書いています。GAC から開く機能は Windows 専用です）
• プラグインで機能を足す

##入手と動作環境

ILSpy は MIT ライセンスです。同じ ILSpy の名前で、使う場面の違う入口がいくつかあります。2026-10-28 時点の最新版は v11.2 です。

デスクトップ版について、公式が書いていることは次のとおりです。

• v11.0 のリリースノートによると、ILSpy は WPF から Avalonia に移りました。これで Linux と macOS でも動くようになりました。WPF 版は完全に取り除かれたので、v11.0 以降は Avalonia 版だけです。WPF 版は Windows 専用でした。
• Windows 向けの zip は、.NET ランタイムが別に要る版（x64・arm64）と、ランタイムを同梱した版（x64）があります。Linux と macOS の配布ファイルは、ランタイムを同梱しています。
• Windows 向けのインストーラー（MSI）は、ユーザー単位（%LocalAppData%\Programs\ILSpy）に入る設定です。zip を展開して使うなら、どの OS でも管理者権限は要りません。Linux 向けには .deb と .rpm もありますが、こちらは /opt/ilspy に入るので root 権限が要ります。
• README によると、Microsoft Store にも版があります（正式版のみ）。
• v11.2 の配布ファイルに、macOS の Intel 向けと、Linux の arm64 向けはありません。その環境では、README のビルド手順で自分で作ります。

ilspycmd のインストールには、.NET SDK 10.0.100 以上が要ります。Windows x64 と Linux x64 では、.NET ランタイムが要らない Native AOT 版が入ります。それ以外の環境では、.NET 10 のランタイムで動く版が入ります。

##外と行う通信

ソースコードを読んで確かめた範囲は、次のとおりです。

• デスクトップ版の更新確認。既定で有効です。起動したときにバックグラウンドで、https://icsharpcode.github.io/ILSpy/updates.xml を取得して、新しい版があるか調べます。前回の成功から 7 日以内なら調べません。失敗しても、画面にエラーは出ません。「Help → Check for Updates」で手動でも調べられます。止めるには、About 画面の「Automatically check for updates every week」のチェックを外します。
• NuGet フィードから開く機能。「Open from NuGet feed」を使ったときだけ、NuGet のフィードに接続します。既定のフィードは https://api.nuget.org/v3/index.json です。
• ilspycmd の更新確認。既定で有効です。実行のたびに https://api.nuget.org/v3-flatcontainer/ilspycmd/index.json を取得して、最新版と比べます。古いときは、標準エラーに「更新してください」と出します。止めるには --disable-updatecheck を付けます。
• VS Code 拡張。初回の起動時に、.NET ランタイムを自動でダウンロードします。ランタイムは VS Code のフォルダーに入り、システムには手を加えません。Linux だけは、ランタイムに必要なパッケージを入れることがあります。

README のプライバシーの項は、個人を特定できる情報を集めないこと、ユーザーのファイルを第三者のサービスに送らないこと、利用状況の計測サービスを使わないことを書いています。更新確認のコードにも、開いたファイルを送る処理はありませんでした。ただし、ILSpy の全部のコードは読んでいません。

##安全な試し方：自作アプリに埋めたダミーの秘密を読む

自分でビルドした小さなアプリを使います。他人のソフトは使いません。ここで埋め込む文字列は、本物ではないダミーです。

1. .NET SDK を入れて、作業用のフォルダーでコンソールアプリを作ります。

   dotnet new console -n demo

2. demo/Program.cs を、次の内容に書き換えます。ダミーの API キーを、コードの中に直接書いています。

   var apiKey = "DUMMY-API-KEY-0000-NOT-REAL";
   Console.WriteLine($"key length: {apiKey.Length}");

3. demo フォルダーでリリースビルドをします。

   dotnet build -c Release

   できあがる bin/Release/<フレームワーク名>/demo.dll が、配る形のファイルです。手元の環境（.NET SDK 10.0.402）では bin/Release/net10.0/demo.dll でした。この DLL の中に、ダミーの文字列が UTF-16 のまま入っていることを、バイト列の検索で確かめました。つまり、読み出すのに特別な技術は要りません。

4. リリースページから、自分の環境に合う zip を入手して展開し、ILSpy を起動します。.NET ランタイムが別に要る Windows 版の zip を選ぶなら、先に .NET 10 のランタイムを入れます。ランタイムを入れたくないときは、selfcontained の付いた zip を選びます。

5. demo.dll を開きます（File メニューから開きます）。

6. 左のツリーで Program を選びます。右に戻した C# のコードが出て、apiKey に入れたダミーの文字列が、そのまま読めるはずです。

7. 検索ボックスで、c:DUMMY のように種類を絞って探すこともできます。検索の種類には Constant があります。ただし、Constant で探せる値の範囲は、公式の説明では確かめられませんでした。見つからないときは、Program を開いて直接読みます。

8. 確かめたら、秘密の持ち方を見直します。キー、トークン、パスワードを、コードやアプリの設定ファイルに書いて配ってはいけません。環境変数、秘密管理サービス、サーバー側の処理で持ちます。すでに配ったビルドに本物の秘密が入っていた場合は、漏れたものとして扱い、キーを再発行します。

コマンドラインで一括して調べることもできます。

1. ilspycmd を入れます。

   dotnet tool install --global ilspycmd

2. DLL を指定して実行します。出力先を省くと、戻した C# が標準出力に出ます。

   ilspycmd --disable-updatecheck demo.dll

3. 出力を検索ツールにかけると、ビルドのたびに秘密が残っていないかを点検できます。同じ目的で、ソースやリポジトリの履歴を調べる gitleaks と組み合わせるのも手です。

##主な使い方

ilspycmd の主なオプションです。全部は ilspycmd --help で確かめられます。

デスクトップ版では、リンクをたどって型や参照先へ移動し、基底型と派生型の間も行き来できます。

##Ghidra・x64dbg・jadx との違い

.NET のプログラムは、中間言語（IL）にメタデータが付いた形で配られます。このため、ILSpy で戻したコードは、元の C# にかなり近くなります。ネイティブの実行ファイルでは、同じようにはなりません。

目的で選ぶなら、次のようになります。.NET の成果物の中身を読むなら ILSpy、ネイティブの実行ファイルなら Ghidra、動いている最中の挙動を見るなら x64dbg、Android アプリなら jadx です。

##注意点

##次に読む

• jadxAndroid アプリを Java のコードに戻して読むツールcd ../jadx
• Ghidraネイティブのプログラムを読むためのリバースエンジニアリングツールcd ../ghidra
• x64dbgWindows のプログラムを動かしながら調べるデバッガーcd ../x64dbg
• gitleaksソースや履歴に残った秘密を探すツールcd ../gitleaks
• 安全な検証環境の作り方cat ~/guides/lab-setup.md