ASP.NET CoreにおけるUseIISIntegrationとは？Kestrelとの関係を解説

WebHostとWebHostBuilderの基本

すべてのASP.NET Coreアプリケーションには、アプリケーションとWebサーバーの中核となる「WebHost」オブジェクトが必要です。このWebHostは、WebHostBuilderを使って構成・生成されます。通常、セットアップコードにはUseKestrel()とUseIISIntegration()という2つのメソッドが登場します。

それぞれのメソッドの役割

UseKestrel()

UseKestrel()は、Kestrelをアプリケーションをホストするサーバーとして登録するためのメソッドです。内部的には、IServerインターフェースに対してKestrelの実装を指定しています。

将来的には、Windows専用のWebListenerをはじめ、他のサーバーオプションも選択できるようになる可能性があります。

UseIISIntegration()

UseIISIntegration()は、IISがKestrelの前段でリバースプロキシとして動作することをASP.NET Coreに伝えるためのメソッドです。

これにより、Kestrelがリスンすべきポート番号、転送ヘッダー（Forwarded Headers）の扱いなど、IISとの連携に必要な各種設定が自動的に行われます。

コード例

public class Program
{
    public static void Main(string[] args)
    {
        var host = new WebHostBuilder()
            .UseKestrel()
            .UseContentRoot(Directory.GetCurrentDirectory())
            .UseIISIntegration()
            .UseStartup<Startup>()
            .Build();
        host.Run();
    }
}

IISでのアウトオブプロセスホスティング（ASP.NET Core 2.2まで）

ASP.NET Core 2.2までの時代、ASP.NET CoreアプリケーションはIIS上で「アウトオブプロセス（プロセス外）」方式でホストされていました。つまり、1つのアプリケーションに対して次の2つのプロセスが存在していました。

• w3wp.exe： IIS側のワーカープロセス
• dotnet.exe： ASP.NET Core側のプロセス。ここでKestrel Webサーバーが起動されます。

この構成では、IISとKestrelが別々のプロセス間で通信を行うことになります。このようにIISをリバースプロキシとして利用するシナリオにおいて、UseIISIntegration()が重要な役割を果たします。