基于单个ASP.NET Core服务器的多应用API认证及邮箱唯一性问题求解

核心改造逻辑 #

基于现有ASP.NET Core Identity Server扩展多租户能力，通过邮箱+租户标识的绑定关系实现全局邮箱唯一性校验，同时兼容原有认证流程。

具体实现步骤 #

1. 扩展Identity用户实体，增加租户标识 #

修改ApplicationUser实体，新增TenantId字段（直接用companyA、companyB这类业务标识即可），并配置邮箱与租户的联合唯一索引，从数据库层面杜绝重复。

public class ApplicationUser : IdentityUser
{
    // 租户业务标识，如"companyA"
    public string TenantId { get; set; } = string.Empty;
}

在DbContext的OnModelCreating中添加联合约束：

protected override void OnModelCreating(ModelBuilder builder)
{
    base.OnModelCreating(builder);
    // 配置全局唯一约束：同一邮箱不能在不同租户下存在
    builder.Entity<ApplicationUser>()
           .HasIndex(u => new { u.Email, u.TenantId })
           .IsUnique();
}

2. 改造注册接口/api/customer/signup #

• 请求体新增TenantId参数，要求外部应用调用时传入自身租户标识
• 注册前先全局校验邮箱是否已在任意租户下存在，若存在直接返回错误；否则执行租户内用户创建逻辑

[HttpPost("signup")]
public async Task<IActionResult> SignUp([FromBody] SignUpRequest request)
{
    // 全局校验邮箱是否已被其他租户注册
    var existingUser = await _userManager.FindByEmailAsync(request.Email);
    if (existingUser != null)
    {
        return BadRequest("该邮箱已被其他企业注册");
    }

    // 创建当前租户下的用户
    var user = new ApplicationUser
    {
        UserName = request.Email,
        Email = request.Email,
        TenantId = request.TenantId
    };

    var createResult = await _userManager.CreateAsync(user, request.Password);
    if (createResult.Succeeded)
    {
        // 生成JWT令牌等后续逻辑
        return Ok("注册成功");
    }
    return BadRequest(createResult.Errors);
}

3. 租户标识的传递与合法性校验 #

• 要求外部应用在所有请求（包括注册）中通过请求头（如X-Tenant-Id）传递租户标识
• 新增全局过滤器或在API网关层校验租户标识的合法性，仅允许已授权的租户（如companyA、companyB）调用接口

4. Identity Server适配多租户 #

• 为每个租户配置独立的客户端（Client），在Identity Server的Client表中新增TenantId字段关联租户
• 颁发JWT令牌时，将TenantId作为Claim写入令牌，后续业务接口可通过Claim识别请求所属租户

额外优化点 #

• 单独维护Tenant表，存储租户名称、状态、授权范围等信息，便于统一管理
• 注册接口增加租户授权校验，确保只有已备案的租户才能发起用户注册
• 若需支持邮箱跨租户迁移，可新增管理员专属接口，先删除原租户下的用户再在目标租户创建

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