ASP.NET Core 8.0 MVC（IIS10）Cookie认证下如何让IIS日志记录用户名？

在ASP.NET Core的Cookie认证体系中，默认不会将认证用户信息传递给IIS的服务器上下文——这和传统ASP.NET Forms认证的深度集成逻辑不同，直接导致IIS日志的cs-username字段无法捕获到用户名。以下是具体的解决步骤：

1. 确认IIS日志配置 #

先确保你的IIS站点日志已启用**用户名（cs-username）**字段：

• 打开IIS管理器，找到目标站点 → 日志 → 选择字段 → 确认“用户名”已被勾选。

2. 添加自定义中间件传递用户信息 #

在ASP.NET Core的请求管道中，添加一个中间件，在用户认证通过后，将用户名写入IIS的服务器变量，让IIS日志能捕获到该值。修改Program.cs：

var builder = WebApplication.CreateBuilder(args);

// 常规配置（MVC、认证等）
builder.Services.AddControllersWithViews();
builder.Services.AddAuthentication(CookieAuthenticationDefaults.AuthenticationScheme)
    .AddCookie(options =>
    {
        // 你的Cookie认证配置示例
        options.LoginPath = "/Account/Login";
        options.ExpireTimeSpan = TimeSpan.FromDays(7);
    });

var app = builder.Build();

// 其他中间件配置（静态文件、错误页等）
app.UseStaticFiles();
app.UseRouting();

// 认证中间件必须在自定义中间件之前
app.UseAuthentication();

// 添加自定义中间件，将认证用户传递给IIS
app.Use(async (context, next) =>
{
    if (context.User.Identity?.IsAuthenticated == true)
    {
        // 获取当前认证用户的用户名，可根据你的认证逻辑调整（比如取Claim中的特定值）
        var username = context.User.Identity.Name;
        
        // 获取IIS上下文特性，设置服务器变量
        var iisFeature = context.Features.Get<IISHttpContextFeature>();
        if (iisFeature != null)
        {
            // 设置LOGON_USER和REMOTE_USER，确保IIS能捕获到用户名
            iisFeature.ServerVariables["LOGON_USER"] = username;
            iisFeature.ServerVariables["REMOTE_USER"] = username;
        }
    }
    
    await next();
});

app.UseAuthorization();

app.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");

app.Run();

3. 验证效果 #

部署修改后的应用，用户登录后发起请求，查看IIS日志文件，cs-username字段应该会显示当前认证的用户名，和传统Forms认证的日志格式一致。

关键原因说明 #

传统ASP.NET Forms认证与IIS深度集成，会自动将认证用户信息同步到IIS的服务器变量中；而ASP.NET Core的Cookie认证是独立的认证体系，默认不会向IIS暴露用户身份信息，因此需要通过自定义中间件手动传递用户名到IIS的LOGON_USER/REMOTE_USER变量，让IIS日志能够捕获并记录。

如果上述方案无法满足需求，再考虑使用W3CLogger或Http Logging组件，但这样会带来日志重复的问题，建议优先使用上述中间件方案。

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