Advanced Configuration

Custom Windows WebView

The default Unity Web Browser (UWB) doesn’t support IL2CPP. For IL2CPP builds or more control, integrate a third-party WebView.

Vuplex Integration

Vuplex is a commercial WebView that supports IL2CPP.

1. Install Vuplex

Purchase Vuplex Windows WebView
Import the .unitypackage from your Vuplex dashboard
Include Core/ and Standalone/ directories (skip Mac/)

2. Implement the Interface

Create a class implementing IWindowsWebBrowserClient:

#if UNITY_STANDALONE_WIN

using Cysharp.Threading.Tasks;
using Immutable.Browser.Core;
using Vuplex.WebView;

public class VuplexWebView : IWindowsWebBrowserClient
{
    public event OnUnityPostMessageDelegate OnUnityPostMessage;
    private IWebView webView;

    public VuplexWebView()
    {
        webView = Web.CreateWebView();
    }

    public async UniTask Init()
    {
        await webView.Init(1, 1);

        webView.MessageEmitted += (sender, eventArgs) =>
        {
            OnUnityPostMessage?.Invoke(eventArgs.Value);
        };
    }

    public void LoadUrl(string url)
    {
        webView.LoadUrl(url);
    }

    public async void ExecuteJavaScript(string js)
    {
        await webView.ExecuteJavaScript(js);
    }

    public string GetPostMessageApiCall()
    {
        return "window.vuplex.postMessage";
    }

    public void Dispose()
    {
        webView.Dispose();
    }
}

#endif

3. Initialize with Custom WebView

passport = await Passport.Init(clientId, environment
#if UNITY_STANDALONE_WIN || (UNITY_EDITOR_WIN && UNITY_STANDALONE_WIN)
    , windowsWebBrowserClient: new VuplexWebView()
#endif
);

4. Configure Scripting Defines

Go to File → Build Settings → Player Settings
Navigate to Player → Other Settings
Add IMMUTABLE_CUSTOM_BROWSER to Scripting Define Symbols
Click Apply

This excludes the default WebView from your build.

5. Exclude Vuplex from Non-Windows Builds

Follow Vuplex’s platform exclusion guide to prevent Vuplex from being included in non-Windows builds.

Custom Timeout Configuration

Override default timeouts for SDK operations:

// Set custom timeout (default is 60 seconds)
passport.SetCallTimeout(TimeSpan.FromMinutes(2));

Session Persistence

The SDK automatically persists sessions. To manually control:

// Check for existing session
bool hasSession = await passport.HasCredentialsSaved();

if (hasSession)
{
    // Silent login (no UI)
    await passport.Login(useCachedSession: true);
}
else
{
    // Full login flow
    await passport.Login();
}

Logging

The Passport SDK provides logging so you can monitor and troubleshoot its behaviour. You can set the log level and optionally redact sensitive data from logs.

Log level

Use the LogLevel property to control the severity of logged messages. The default is LogLevel.Info.

Level	Description
`LogLevel.Debug`	Detailed information for debugging
`LogLevel.Info`	General SDK operation information (default)
`LogLevel.Warn`	Warnings about potential issues
`LogLevel.Error`	Errors indicating SDK failures

// Set log level to Debug for verbose output
Passport.LogLevel = LogLevel.Debug;

Redacting sensitive tokens in logs

By default, access and ID tokens are logged in full. Set RedactTokensInLogs to true to replace them with [REDACTED] in log output.

Passport.RedactTokensInLogs = true;

Use this when debugging or sharing logs to avoid exposing sensitive data.

Next Steps

Platform Setup

iOS, Android configuration

FAQ

Common questions

TypeScript

Unity

Unreal

Custom Windows WebView

Vuplex Integration

1. Install Vuplex

2. Implement the Interface

3. Initialize with Custom WebView

4. Configure Scripting Defines

5. Exclude Vuplex from Non-Windows Builds

Custom Timeout Configuration

Session Persistence

Logging

Log level

Redacting sensitive tokens in logs

Next Steps

Platform Setup

FAQ

​Custom Windows WebView

​Vuplex Integration

​1. Install Vuplex

​2. Implement the Interface

​3. Initialize with Custom WebView

​4. Configure Scripting Defines

​5. Exclude Vuplex from Non-Windows Builds

​Custom Timeout Configuration

​Session Persistence

​Logging

​Log level

​Redacting sensitive tokens in logs

​Next Steps

Platform Setup

FAQ

Custom Windows WebView

Vuplex Integration

1. Install Vuplex

2. Implement the Interface

3. Initialize with Custom WebView

4. Configure Scripting Defines

5. Exclude Vuplex from Non-Windows Builds

Custom Timeout Configuration

Session Persistence

Logging

Log level

Redacting sensitive tokens in logs

Next Steps