MSAL .NET中VSTO插件的AcquireTokenInteractive不显示登录窗口

环境与场景 #

• 项目类型：Word VSTO插件，认证代码位于.NET 4.7.2类库
• 触发时机：Application_WindowActivate事件中调用认证逻辑
• 历史情况：此前使用ADAL的AuthenticationContext实现时，登录弹窗可正常显示
• 当前问题：MSAL的AcquireTokenInteractive无法弹出登录窗口，但首次认证成功后，AcquireTokenSilent可正常执行

现有代码 #

VSTO事件触发代码 #

void Application_WindowActivate(Interop.Document Doc, Interop.Window Wn)
{ 
    onDocOpen(Doc, Wn);
}

认证类调用代码 #

AuthenticateOffice authResult = new AuthenticateOffice();

MSAL核心认证代码 #

string[] scopes = new string[] { "https://graph.microsoft.com/user.read" };

var app = PublicClientApplicationBuilder
              .Create(ADFS_clientID)
              .WithAuthority(ADFS_authority)
              .WithRedirectUri("http://localhost")
              .Build();

var accounts = await app.GetAccountsAsync();

AuthenticationResult result = null;

try
{
    result = await app.AcquireTokenSilent(scopes, accounts.FirstOrDefault())
                      .ExecuteAsync();
}
catch (MsalUiRequiredException ex)
{
    Debug.WriteLine($"MsalUiRequiredException: {ex.Message}");

    try
    {
        result = await app.AcquireTokenInteractive(scopes)
                                   .WithParentOfficeAddin(GetActiveWindow())
                                   .ExecuteAsync();
    }
    catch (MsalException)
    {
        // 异常处理逻辑
    }
}

return result;

排查与解决方案 #

1. 修正父窗口传递的语法错误 #

代码中WithParentOfficeAddin.GetActiveWindow()存在语法问题，正确调用方式应为：

.WithParentWindow(GetActiveWindow())

或针对Office插件的专用API：

.WithParentOfficeAddInWindow(GetActiveWindow())

必须传递Word窗口的有效句柄，MSAL依赖该句柄将登录弹窗以模态形式绑定到Word窗口。

2. 确保异步操作在UI线程执行 #

VSTO事件默认在Office UI线程触发，但异步操作可能导致上下文切换，需强制切回UI线程：

• 使用ConfigureAwait(true)确保回到原上下文：

result = await app.AcquireTokenInteractive(scopes)
                  .WithParentWindow(GetActiveWindow())
                  .ExecuteAsync()
                  .ConfigureAwait(true);

• 若存在线程切换问题，可通过Dispatcher.Invoke（WPF）或Control.Invoke（WinForms）将认证逻辑强制拉回UI线程执行。

3. 验证重定向URI配置 #

• 确认Azure AD应用注册中已添加http://localhost作为公共客户端的重定向URI
• 可尝试替换为MSAL公共客户端推荐的默认值urn:ietf:wg:oauth:2.0:oob

4. 检查MSAL版本兼容性 #

确保使用的MSAL.NET版本与.NET 4.7.2兼容，推荐使用最新稳定版的MSAL.NET（如4.x系列），旧版本可能存在Office插件场景的适配缺陷。

5. 延迟触发认证逻辑 #

Application_WindowActivate事件可能在Word窗口完全初始化前触发，导致窗口句柄无效，可添加延迟等待窗口就绪：

async void Application_WindowActivate(Interop.Document Doc, Interop.Window Wn)
{ 
    await Task.Delay(500); // 等待窗口初始化完成
    await onDocOpen(Doc, Wn);
}

同时需将onDocOpen改为异步方法，避免阻塞UI线程。

内容的提问来源于stack exchange，提问作者Dharun