如何让ASP.NET 4.8混合应用中的Owin自定义认证后中间件仅触发一次

我之前处理过ASP.NET WebForms/MVC混合应用从表单认证转Owin OpenIdConnect的场景，给你几个比用Cookie标记更优雅的方案，解决自定义逻辑仅执行一次的问题：

方案一：直接绑定OpenIdConnect认证完成事件（最推荐） #

其实你不需要额外加中间件，OpenIdConnect本身提供了认证完成时触发的生命周期事件，这些事件只会在用户完成认证流程（比如首次登录、令牌验证成功）时触发，完全符合你“仅执行一次”的需求。

修改你的UseOpenIdConnectAuthentication配置，添加SecurityTokenValidated或AuthorizationCodeReceived通知事件：

app.UseOpenIdConnectAuthentication(new OpenIdConnectAuthenticationOptions
{
    // 你的身份提供商配置（ClientId、Authority等）
    ClientId = "your-client-id",
    Authority = "your-identity-provider-url",
    RedirectUri = "your-callback-url",
    
    Notifications = new OpenIdConnectAuthenticationNotifications
    {
        SecurityTokenValidated = async notification =>
        {
            // 这里就是认证完成后仅需执行一次的代码
            // 示例：获取用户信息、初始化用户业务数据、写入日志等
            var userIdentity = notification.AuthenticationTicket.Identity;
            await InitializeUserProfile(userIdentity.NameIdentifier);
            
            // 可以在这里添加自定义声明，后续请求直接使用
            userIdentity.AddClaim(new Claim("IsInitialized", "true"));
            
            // 确保继续执行后续认证流程
            await Task.CompletedTask;
        }
    }
});

注意：如果你的逻辑需要在用户首次登录时执行（而非每次令牌刷新），可以在事件里加额外判断，比如检查数据库中是否已有用户记录，避免重复执行。

方案二：优化自定义中间件，用Claims标记替代独立Cookie #

如果你的逻辑必须在Owin管道中执行（比如需要访问管道上下文的特定资源），可以优化现有中间件，利用用户身份的Claims作为执行标记，比单独的Cookie更安全且与用户身份绑定：

public static void UseAfterAuthentication(this IAppBuilder app)
{
    app.Use(async (context, next) =>
    {
        var authenticatedUser = context.Authentication.User;
        // 检查用户已认证，且未执行过初始化逻辑
        if (authenticatedUser.Identity.IsAuthenticated && 
            !authenticatedUser.HasClaim(c => c.Type == "PostAuthCompleted"))
        {
            // 执行你的一次性业务逻辑
            await RunPostAuthenticationTasks(authenticatedUser);
            
            // 给用户身份添加标记声明，持久化到认证Cookie中
            var claimsIdentity = authenticatedUser.Identity as ClaimsIdentity;
            claimsIdentity.AddClaim(new Claim("PostAuthCompleted", DateTime.UtcNow.ToString()));
            
            // 更新认证票证，让声明生效
            await context.Authentication.SignInAsync(
                CookieAuthenticationDefaults.AuthenticationType,
                new ClaimsPrincipal(claimsIdentity),
                new AuthenticationProperties { IsPersistent = true });
        }

        // 继续执行管道后续中间件
        await next();
    });
}

为什么原来的中间件会每次请求都触发？ #

Owin中间件是管道式执行的，每个HTTP请求都会从头到尾遍历整个中间件管道，所以你的UseAfterAuthentication会在每个请求都被调用。通过添加Claims或Cookie的条件判断，本质是在用户首次执行后添加“已完成”标记，后续请求直接跳过逻辑。

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