[Annoucement] WebListener 1.0.0-rc2 is now available on nuget.org

[Tratcher]

The following packages have been released today on nuget.org:

Microsoft.AspNetCore.Server.WebListener.1.0.0-rc2-final Microsoft.Net.Http.Server.1.0.0-rc2-final

WebListener is a Windows HTTP server built on the Http.Sys kernel mode driver. It exposes a number of Http.Sys features previously only availabe in IIS.

Kernel mode:

• Windows Authentication
• Port sharing
• HTTPS with SNI
• HTTP/2 over TLS (Windows 10)
• Direct file transmission
• Response caching

WebSockets (Windows 8)

WebListener is supported for edge deployments because it's built on the existing Http.Sys HTTP stack. Note AspNetCoreModule is not compatible with WebListener for use behind IIS/Express, Kestrel must continue to be used in that scenario.

These packages are supported on Windows 7 and Windows Server 2008 R2 and later.

Usage with ASP.NET Core (Microsoft.AspNetCore.Server.WebListener):

        public static void Main(string[] args)
        {
            var host = new WebHostBuilder()
                .UseWebListener(options =>
                {
                    options.ListenerSettings.Authentication.Schemes = AuthenticationSchemes.NTLM;
                    options.ListenerSettings.Authentication.AllowAnonymous = false;
                })
                .UseStartup<Startup>()
                .Build();

            host.Run();
        }

Direct usage (Microsoft.Net.Http.Server):

            var settings = new WebListenerSettings();
            settings.UrlPrefixes.Add("http://localhost:8080");

            using (WebListener listener = new WebListener(settings))
            {
                listener.Start();

                while (true)
                {
                    var context = await listener.AcceptAsync();
                    byte[] bytes = Encoding.ASCII.GetBytes("Hello World: " + DateTime.Now);
                    context.Response.ContentLength = bytes.Length;
                    context.Response.ContentType = "text/plain";

                    await context.Response.Body.WriteAsync(bytes, 0, bytes.Length);
                    context.Dispose();
                }
            }

[campersau]

Are there any public changelogs available for these packages?

[304NotModified]

Could you tell us in which cases we should use this?

[Tratcher]

If you're on Windows and want to expose your server directly to the internet (Kestrel is not certified for direct exposure), or you need any of the features listed above.

[Tratcher]

@campersau not at the moment, though there is a prior announcement for API breaking changes. https://github.com/aspnet/ServerTests/issues/39

[aminebizid]

NTLM Authent not working:

 public static void Main(string[] args)
        {            

            var host = new WebHostBuilder()                
                 .UseWebListener(options =>
                 {
                     options.ListenerSettings.Authentication.Schemes = AuthenticationSchemes.NTLM;
                     options.ListenerSettings.Authentication.AllowAnonymous = false;                     

                 })
                 .UseKestrel()
                .UseContentRoot(Directory.GetCurrentDirectory())
                .UseIISIntegration()
                .UseStartup<Startup>()
                .Build();

            host.Run();
        }

PS: If I remove Kestrel, MVC stops routing

[Tratcher]

You need to remove UseKestrel and UseIISIntegration and not run in IIS/Express, only self-host. See the comments above about AspNetCoreModule not being compatible with WebListener.

 public static void Main(string[] args)
{            
            var host = new WebHostBuilder()                
                 .UseWebListener(options =>
                 {
                     options.ListenerSettings.Authentication.Schemes = AuthenticationSchemes.NTLM;
                     options.ListenerSettings.Authentication.AllowAnonymous = false;                     

                 })
                .UseContentRoot(Directory.GetCurrentDirectory())
                .UseStartup<Startup>()
                .Build();

            host.Run();
}

[justdmitry]

If you're on Windows and want to expose your server directly to the internet (Kestrel is not certified for direct exposure)

Where can I read more details about Kestrel, WebListener and other "expose to internet" certification?

[Tratcher]

@blowdart, do we have docs around edge certification?

[blowdart]

Considering there's no "expose to internet" certification, no, we don't.

[Tratcher]

@justdmitry @blowdart this is the official doc: https://docs.asp.net/en/latest/fundamentals/servers.html#kestrel

[Tratcher]

@justdmitry also https://github.com/aspnet/Docs/issues/1903

[NeelBhatt]

I have tried to convert it into blog post so that more people can know about this.

https://neelbhatt40.wordpress.com/2016/10/08/weblistener-is-now-on-nuget-a-net-core-server/

[tdykstra]

That blog post is well done - I've created a proposed outline for a new doc about WebListener that follows a similar organization and expands on it, see https://github.com/aspnet/Docs/issues/1827

[NeelBhatt]

Thanks a lot @tdykstra.

I will update my post by taking points from above comment.

[tdykstra]

Moving the doc outline to the Docs repo issue for this doc -- https://github.com/aspnet/Docs/issues/1827

[Tratcher]

WebListener 1.0.0 has now released to nuget.org. There are no significant changes from rc2.