WebView2

What is WebView2

A modern embedded browser based on Microsoft Edge, capable of performing Windows Hello, log-in with FIDO keys, etc. This browser replaces the old embedded WebView, based on an outdated version of Internet Explorer.

Where is it available?

• All Windows versions
• MSAL version 4.28.0 and higher
• WebView2 runtime must be installed on the machine

Evergreen runtime

WebView2 runtime is not available on Windows by default. Applications should install it or guide the end users to install it. Installing it requires admin access.

Fixed runtime

As an alternative to the evergreen runtime, apps can bundle a fixed runtime.

var builder = pca.AcquireTokenInteractive(scopes)
  .WithUseEmbeddedWebView(true);

// checks for the evergreen WebView2 runtime 
if (!pca.IsEmbeddedWebViewAvailable())
{
    builder = builder.WithEmbeddedWebViewOptions(
        new EmbeddedWebViewOptions()
        {
            WebView2BrowserExecutableFolder = @"c:\my_app\webview2\fixed_version"
        });
}

Changes to call pattern

• On .NET5-windows, there is no change
• On .NET Classic and .NET Core 3.1, add a reference to Microsoft.Identity.Client.Desktop and call .WithDesktopFeatures()

var pca = PublicClienntApplicationBuilder
    .Create("client_id")
    .WithDesktopFeatures()
    .Build()

Behaviour

	Embedded WebView	Default WebView
.NET Fx	WebView2, fallback to Legacy	Embedded
.NET Core	WebView2, fallback to Legacy*	Embedded
.NET 5	WebView2, fallback to Legacy*	Embedded

*In .NET Core and .NET 5, fallback to legacy WebView is available starting in MSAL 4.30.0.