Using PrefersEphemeralWebBrowserSession in Auth0 MAUI SDK

Last Updated: Sep 10, 2025

Overview

This article explains why it is no longer possible to create ASWebAuthenticationSessionBrowser in MAUI SDK and a potential alternative. This can be used for suppressing the iOS consent prompt by setting Setting PrefersEphemeralWebBrowserSession = true.

Applies To

Auth0 MAUI SDK

Cause

The ASWebAuthenticationSessionBrowser class is not exposed by the current version of the MAUI SDK (1.0.0 at the time of writing).

Solution

In the current version of the MAUI SDK (1.0.0 at the time of writing), the ASWebAuthenticationSessionBrowser class is not exposed.

Instead, create a custom Browser implementation that is a copy of:

https://github.com/auth0/auth0-oidc-client-net/blob/master/src/Auth0.OidcClient.MAUI/WebAuthenticatorBrowser.cs

Then replace:

var result = await WebAuthenticator.Default.AuthenticateAsync(new Uri(options.StartUrl), new Uri(options.EndUrl));

With:

var result = await WebAuthenticator.Default.AuthenticateAsync(new WebAuthenticatorOptions { Url = new Uri(options.StartUrl), CallbackUrl = new Uri(options.EndUrl), PrefersEphemeralWebBrowserSession = true });

Then, when instantiating the client, pass the custom browser class that was created:

new Auth0Client() { Browser = new CustomBrowser() }