如何在Auth0登录成功后调用自定义方法将用户ID存入数据库

原有的Login方法仅负责发起Auth0的认证挑战，用户的身份信息要等Auth0回调回应用后才能获取。要实现将Auth0用户ID存入数据库，需要在认证完成后的回调流程中处理，以下是两种常用方案：

方案一：利用Auth0认证事件处理 #

在配置Auth0认证时，通过OnAuthenticated事件捕获用户信息，调用自定义服务存储ID：

1. 配置认证事件（Program.cs/Startup.cs） #

builder.Services.AddAuthentication(options =>
{
    options.DefaultAuthenticateScheme = CookieAuthenticationDefaults.AuthenticationScheme;
    options.DefaultSignInScheme = CookieAuthenticationDefaults.AuthenticationScheme;
    options.DefaultChallengeScheme = Auth0Constants.AuthenticationScheme;
})
.AddCookie()
.AddAuth0WebAppAuthentication(options =>
{
    options.Domain = builder.Configuration["Auth0:Domain"];
    options.ClientId = builder.Configuration["Auth0:ClientId"];
    options.ClientSecret = builder.Configuration["Auth0:ClientSecret"];

    // 注册认证成功后的处理事件
    options.Events = new Auth0WebAppAuthenticationEvents
    {
        OnAuthenticated = async context =>
        {
            // 从Claims中提取Auth0用户ID（对应JWT的sub声明）
            string auth0UserId = context.User.FindFirst("sub")?.Value;
            if (string.IsNullOrEmpty(auth0UserId)) return;

            // 从请求服务容器中获取自定义用户服务
            var userService = context.HttpContext.RequestServices.GetRequiredService<IUserService>();
            
            // 检查用户是否已存在，避免重复创建
            if (!await userService.UserExistsAsync(auth0UserId))
            {
                await userService.CreateUserAsync(auth0UserId);
            }
        }
    };
});

方案二：自定义回调Action处理 #

指定自定义回调路径，在回调方法中获取用户信息并存储：

1. 修改Login方法的跳转路径 #

public async Task Login(string returnUrl = "/")
{
    var authenticationProperties = new LoginAuthenticationPropertiesBuilder()
        // 指定自定义回调地址，携带原返回路径
        .WithRedirectUri($"/Account/Auth0Callback?returnUrl={Uri.EscapeDataString(returnUrl)}")
        .Build();

    await HttpContext.ChallengeAsync(Auth0Constants.AuthenticationScheme, authenticationProperties);
}

2. 实现自定义回调Action #

private readonly IUserService _userService;

// 通过构造函数注入用户服务
public AccountController(IUserService userService)
{
    _userService = userService;
}

public async Task<IActionResult> Auth0Callback(string returnUrl = "/")
{
    // 获取认证后的用户身份
    var authResult = await HttpContext.AuthenticateAsync(CookieAuthenticationDefaults.AuthenticationScheme);
    if (!authResult.Succeeded)
    {
        return RedirectToAction("Login");
    }

    // 提取Auth0用户ID
    string auth0UserId = authResult.Principal.FindFirst("sub")?.Value;
    if (string.IsNullOrEmpty(auth0UserId))
    {
        return RedirectToAction("Login");
    }

    // 调用服务存储用户ID（先检查是否存在）
    if (!await _userService.UserExistsAsync(auth0UserId))
    {
        await _userService.CreateUserAsync(auth0UserId);
    }

    // 跳转到最初的目标页面
    return Redirect(Uri.UnescapeDataString(returnUrl));
}

关键注意事项 #

• 确保IUserService已通过依赖注入注册（如builder.Services.AddScoped<IUserService, UserService>();）
• 必须加入用户存在性检查，避免每次登录都重复创建数据库记录
• Auth0用户ID通常存储在sub声明中，也可以用ClaimTypes.NameIdentifier提取，二者值一致

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