Blazor WASM调试时如何模拟OIDC认证，跳过企业账号登录

要在调试阶段跳过企业OIDC登录，直接模拟超级管理员身份，可以通过自定义AuthenticationStateProvider替换默认的OIDC认证逻辑，同时配合后端的调试配置实现。

一、前端实现：模拟认证状态 #

Blazor WASM的身份认证基于AuthenticationStateProvider，我们可以在调试模式下自定义一个提供器，直接返回预设的超级管理员身份。

1. 创建调试用的AuthenticationStateProvider #

using Microsoft.AspNetCore.Components.Authorization;
using System.Security.Claims;

public class DebugAuthStateProvider : AuthenticationStateProvider
{
    public override Task<AuthenticationState> GetAuthenticationStateAsync()
    {
        // 构造超级管理员的权限Claims，尽量和生产环境OIDC返回的结构一致
        var claims = new List<Claim>
        {
            new Claim(ClaimTypes.Name, "超级管理员"),
            new Claim(ClaimTypes.Email, "admin@example.com"),
            new Claim(ClaimTypes.Role, "Admin"),
            // 添加需要的自定义权限Claim，比如全权限标识
            new Claim("system_permission", "full_access")
        };

        var identity = new ClaimsIdentity(claims, "DebugAuthentication");
        var userPrincipal = new ClaimsPrincipal(identity);

        return Task.FromResult(new AuthenticationState(userPrincipal));
    }
}

2. 按环境切换认证配置 #

修改Program.cs，根据开发环境判断是否启用调试认证：

var builder = WebAssemblyHostBuilder.CreateDefault(args);
builder.RootComponents.Add<App>("#app");
builder.RootComponents.Add<HeadOutlet>("head::after");

// 区分调试/生产环境配置认证
if (builder.HostEnvironment.IsDevelopment())
{
    // 调试模式：注册调试用的认证服务
    builder.Services.AddAuthorizationCore();
    builder.Services.AddScoped<AuthenticationStateProvider, DebugAuthStateProvider>();
}
else
{
    // 生产模式：保留原OIDC配置
    builder.Services.AddOidcAuthentication(opt =>
    {
        opt.ProviderOptions.Authority = "https://xx.zz.pl/auth/cp";
        opt.ProviderOptions.ClientId = "xxx";
        opt.ProviderOptions.DefaultScopes.Add("email");
        opt.ProviderOptions.ResponseType = "code";
    });
}

// 注册其他服务...
await builder.Build().RunAsync();

二、后端配合：兼容调试身份 #

如果前端需要调用后端API，需要确保后端在调试模式下能识别模拟的身份，避免权限拦截。提供两种方案：

方案1：调试模式启用匿名访问 #

在需要授权的Controller/Action上，仅在调试模式下添加[AllowAnonymous]：

#if DEBUG
[AllowAnonymous]
#endif
[Authorize]
[ApiController]
[Route("api/[controller]")]
public class AdminController : ControllerBase
{
    // API逻辑...
}

方案2：后端模拟认证（更贴近生产权限逻辑） #

自定义调试认证Handler，直接返回超级管理员身份，避免修改业务代码的授权属性：

1. 创建调试认证Handler

using Microsoft.AspNetCore.Authentication;
using Microsoft.Extensions.Logging;
using Microsoft.Extensions.Options;
using System.Security.Claims;
using System.Text.Encodings.Web;

public class DebugAuthenticationHandler : AuthenticationHandler<AuthenticationSchemeOptions>
{
    public DebugAuthenticationHandler(IOptionsMonitor<AuthenticationSchemeOptions> options, ILoggerFactory logger, UrlEncoder encoder, ISystemClock clock)
        : base(options, logger, encoder, clock)
    {
    }

    protected override Task<AuthenticateResult> HandleAuthenticateAsync()
    {
        // 构造和前端一致的超级管理员Claims
        var claims = new List<Claim>
        {
            new Claim(ClaimTypes.Name, "超级管理员"),
            new Claim(ClaimTypes.Email, "admin@example.com"),
            new Claim(ClaimTypes.Role, "Admin"),
            new Claim("system_permission", "full_access")
        };

        var identity = new ClaimsIdentity(claims, Scheme.Name);
        var principal = new ClaimsPrincipal(identity);
        var authTicket = new AuthenticationTicket(principal, Scheme.Name);

        return Task.FromResult(AuthenticateResult.Success(authTicket));
    }
}

2. 修改后端Program.cs配置

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddControllers();

// 按环境配置认证服务
if (builder.Environment.IsDevelopment())
{
    // 调试模式：使用自定义调试认证
    builder.Services.AddAuthentication("DebugAuth")
        .AddScheme<AuthenticationSchemeOptions, DebugAuthenticationHandler>("DebugAuth", null);
}
else
{
    // 生产模式：保留原JWT配置
    builder.Services
        .AddAuthentication("Bearer")
        .AddJwtBearer("Bearer", options =>
        {
            options.Authority = "https://xx.zz.pl/auth/cp";
        });
}

builder.Services.AddAuthorization(options =>
{
    options.DefaultPolicy = new AuthorizationPolicyBuilder()
        .RequireAuthenticatedUser()
        .Build();
});

var app = builder.Build();

if (app.Environment.IsDevelopment())
{
    app.UseDeveloperExceptionPage();
}

app.UseHttpsRedirection();
app.UseAuthentication();
app.UseAuthorization();

app.MapControllers();

app.Run();

三、注意事项 #

• 所有调试相关的代码必须通过环境判断或#if DEBUG隔离，绝对不能编译到生产环境，避免安全漏洞。
• 调试用的Claims要和生产环境OIDC返回的结构保持一致，这样前端的权限判断逻辑无需修改。
• 如果前端需要发送请求头，调试模式下可以在HttpClient中添加模拟的Authorization头，但使用方案2的后端调试认证时，无需额外处理请求头。

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