如何让ASP.NET已认证用户名显示在IIS日志的cs-username字段中？

IIS默认的cs-username字段仅记录通过IIS原生认证机制（如Windows认证、基本认证）的用户。如果你的ASP.NET应用使用Forms认证、JWT这类应用层认证，IIS本身无法感知用户身份，因此该字段会显示“-”。以下是几种可行的解决办法：

方法一：传统ASP.NET（Framework）自定义HttpModule #

创建一个HttpModule，在用户认证完成后手动将用户名写入IIS依赖的服务器变量，让日志能捕获到该值：

public class LogUsernameModule : IHttpModule
{
    public void Init(HttpApplication context)
    {
        context.AuthenticateRequest += OnAuthenticateRequest;
    }

    private void OnAuthenticateRequest(object sender, EventArgs e)
    {
        var app = (HttpApplication)sender;
        if (app.User?.Identity.IsAuthenticated == true)
        {
            // 给REMOTE_USER赋值，IIS会将该值写入cs-username字段
            app.Context.Request.ServerVariables["REMOTE_USER"] = app.User.Identity.Name;
        }
    }

    public void Dispose() { }
}

随后在web.config中注册这个Module：

<system.webServer>
  <modules>
    <add name="LogUsernameModule" type="你的命名空间.LogUsernameModule" />
  </modules>
</system.webServer>

方法二：ASP.NET Core 自定义中间件 #

在ASP.NET Core中，通过中间件在认证完成后设置对应的服务器变量：

public class LogUsernameMiddleware
{
    private readonly RequestDelegate _next;

    public LogUsernameMiddleware(RequestDelegate next)
    {
        _next = next;
    }

    public async Task Invoke(HttpContext context)
    {
        if (context.User.Identity.IsAuthenticated)
        {
            // 获取服务器变量特性并设置REMOTE_USER
            var serverVars = context.Features.Get<IHttpServerVariablesFeature>();
            serverVars?["REMOTE_USER"] = context.User.Identity.Name;
        }
        await _next(context);
    }
}

在Program.cs中注册中间件时，必须放在认证中间件之后：

var builder = WebApplication.CreateBuilder(args);
// 配置认证服务
builder.Services.AddAuthentication(...);

var app = builder.Build();

app.UseAuthentication();
// 注册自定义中间件
app.UseMiddleware<LogUsernameMiddleware>();

// 其他中间件配置
app.Run();

方法三：确认IIS日志字段配置 #

先检查IIS的日志记录设置，确保cs-username（对应界面中的“用户名称”）已被勾选：

1. 打开IIS管理器，找到目标站点
2. 双击“日志”功能
3. 点击“选择字段”，确认“用户名称”选项已勾选

注意事项 #

• 自定义Module/中间件必须在认证流程之后执行，否则无法获取到已认证的用户身份
• 确保用户确实完成了ASP.NET的认证流程（如Forms认证调用FormsAuthentication.SetAuthCookie，ASP.NET Core调用SignInManager.PasswordSignInAsync等），只有User.Identity.IsAuthenticated为true时，用户名才能被正确写入日志

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