ASP.NET Core 2.0 Web API修改认证票据名称后认证状态异常排查

以下是针对性的排查和修复步骤：

1. 确认中间件顺序是否正确 #

ASP.NET Core 2.0的中间件执行顺序直接影响认证逻辑，你需要保证：

• CustomCookieMiddleware 必须放在 UseAuthentication 之前，这样当请求到达认证中间件时，Cookie名称已经被正确修改/识别。
• 示例Startup.Configure顺序：

  app.UseCustomCookieMiddleware(); // 你的自定义中间件
  app.UseAuthentication(); // 认证中间件
  app.UseMvc();
  

2. 检查CustomCookieManager的实现逻辑 #

认证中间件依赖CookieManager读取请求中的Cookie，你的CustomCookieManager必须正确返回对应来源的Cookie值：

• 确保GetRequestCookie(HttpContext context, string key)方法中，根据请求来源（比如context.Request.Host或自定义标识）返回正确名称的Cookie内容，而不是固定使用默认key。
• 示例实现片段：

  public string GetRequestCookie(HttpContext context, string key)
  {
      // 根据请求来源动态获取实际的Cookie名称
      var actualCookieName = GetCookieNameBySource(context);
      return context.Request.Cookies[actualCookieName];
  }
  

• 同时要保证AppendResponseCookie方法正确写入动态生成的Cookie名称，确保登录时Cookie被正确设置。

3. 确保SignInAsync使用正确的认证方案 #

调用SignInAsync时，必须指定与CookieAuthenticationOptions匹配的认证方案，否则票据不会被正确关联：

• 如果你的Cookie认证使用默认方案，直接传递CookieAuthenticationDefaults.AuthenticationScheme：

  await HttpContext.SignInAsync(
      CookieAuthenticationDefaults.AuthenticationScheme,
      new ClaimsPrincipal(identity)
  );
  

• 如果自定义了认证方案名称，要确保AddCookie时的名称和SignInAsync一致：

  // Startup.ConfigureServices中
  services.AddAuthentication("CustomCookieScheme")
      .AddCookie("CustomCookieScheme", options =>
      {
          options.CookieManager = new CustomCookieManager();
          // 其他配置
      });
  
  // 登录时
  await HttpContext.SignInAsync("CustomCookieScheme", principal);
  

4. 验证ClaimsIdentity的IsAuthenticated属性 #

创建ClaimsIdentity时，必须指定有效的认证类型，否则Identity.IsAuthenticated会返回false：

• 错误示例（未指定认证类型）：

  var identity = new ClaimsIdentity(claims); // IsAuthenticated会是false
  

• 正确示例：

  var identity = new ClaimsIdentity(claims, CookieAuthenticationDefaults.AuthenticationScheme);
  

5. 检查CookieAuthenticationOptions的配置 #

• 确保没有禁用自动认证：options.AutomaticAuthenticate = true（ASP.NET Core 2.0中默认是true，但如果手动设置为false会导致认证不自动执行）。
• 确认options.Cookie.Name不需要硬编码，因为你的CustomCookieManager会动态处理，但如果有冲突可能覆盖，建议留空或与动态逻辑兼容。

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