如何在SignInManager<TUser>中添加自定义SignInResults实现登录暂停至条款同意完成

核心思路：复用Identity流程扩展机制，避免重写SignInManager #

Identity本身提供了类似TFA的流程拦截/暂停能力，无需完全重写SignInManager，仅需利用其扩展点做增量开发，既保留基类的后续更新收益，又实现强制条款同意的逻辑。

具体实现步骤 #

1. 自定义登录结果标记 #

定义一个SignInResult派生类，用于标记用户需完成条款同意操作：

public class RequiresTermsAcceptanceResult : SignInResult
{
    public override Task ExecuteAsync(HttpContext context)
    {
        // 跳转至条款同意页面，携带登录上下文参数
        context.Response.Redirect("/Account/TermsAcceptance");
        return Task.CompletedTask;
    }
}

2. 扩展原生登录逻辑（而非重写） #

调用基类PasswordSignInAsync完成身份验证后，追加条款检查逻辑，不破坏原生登录流程：

public async Task<SignInResult> ExtendedPasswordSignInAsync(string userName, string password, bool isPersistent, bool lockoutOnFailure)
{
    // 先执行基类原生登录逻辑，确保密码验证、账户锁控等规则生效
    var result = await base.PasswordSignInAsync(userName, password, isPersistent, lockoutOnFailure);

    if (result.Succeeded)
    {
        var user = await UserManager.FindByNameAsync(userName);
        // 检查用户是否已同意最新版本条款
        if (!await UserManager.HasAcceptedLatestTermsAsync(user))
        {
            // 生成临时登录凭证，用于在同意页恢复登录上下文
            var tempToken = await UserManager.GenerateUserTokenAsync(user, "TermsAcceptance", "TempLogin");
            // 将临时凭证和用户ID存入会话（或加密Cookie）
            HttpContext.Session.SetString("TempLoginToken", tempToken);
            HttpContext.Session.SetString("TempUserId", user.Id.ToString());
            
            // 返回自定义结果，触发条款同意页跳转
            return new RequiresTermsAcceptanceResult();
        }
    }

    return result;
}

3. 实现条款同意页的流程恢复逻辑 #

用户同意条款后，验证临时凭证并完成最终登录：

public async Task<IActionResult> TermsAcceptance(bool accept, string returnUrl)
{
    if (!accept)
    {
        // 用户拒绝条款，清除临时会话并返回登录页
        HttpContext.Session.Remove("TempLoginToken");
        HttpContext.Session.Remove("TempUserId");
        return RedirectToAction("Login", new { returnUrl });
    }

    var tempUserId = HttpContext.Session.GetString("TempUserId");
    var tempToken = HttpContext.Session.GetString("TempLoginToken");
    var user = await UserManager.FindByIdAsync(tempUserId);

    // 验证临时凭证有效性
    if (user != null && await UserManager.VerifyUserTokenAsync(user, "TermsAcceptance", "TempLogin", tempToken))
    {
        // 标记用户已同意最新条款
        user.TermsAcceptedDate = DateTime.UtcNow;
        user.TermsVersion = "202406"; // 存储当前条款版本号
        await UserManager.UpdateAsync(user);

        // 清除临时会话，完成最终登录
        HttpContext.Session.Remove("TempLoginToken");
        HttpContext.Session.Remove("TempUserId");
        await SignInManager.SignInAsync(user, isPersistent: true);
        
        // 跳转至用户原本访问的页面
        return Redirect(returnUrl ?? "/");
    }

    // 凭证无效，返回登录页
    return RedirectToAction("Login", new { returnUrl });
}

4. 注册自定义令牌提供器 #

在启动配置中，添加用于生成临时登录凭证的令牌提供器：

services.AddIdentity<ApplicationUser, IdentityRole>()
    .AddEntityFrameworkStores<ApplicationDbContext>()
    .AddDefaultTokenProviders()
    .AddTokenProvider<DataProtectorTokenProvider<ApplicationUser>>("TermsAcceptance");

方案优势 #

• 完全保留SignInManager基类的原生逻辑，包括密码验证、双因子触发、账户锁定等，后续Identity版本更新可直接受益
• 实现类似TFA的强制拦截：用户未同意条款前无法完成登录，临时凭证仅用于流程恢复，无直接登录权限，避免跳过风险
• 增量开发模式，仅扩展必要逻辑，代码侵入性低，维护成本小

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