.NET Core Cookie Authentication中如何为Role Claim添加自定义属性

嘿，我懂你的需求了——不用Identity Core，靠Cookie认证，从自定义表拉取用户角色，现在已经把RoleCd作为Role Claim添加进去，但账户页面需要同时展示RoleCd和对应的RoleNm（角色的文本描述）对吧？下面给你两种实用的解决方案：

核心是在保留RoleCd作为标准Role Claim（满足授权逻辑）的同时，把RoleNm也存入用户的Claims集合里，这样在账户页面就能轻松取出展示。

方式1：添加独立的自定义Claim存储RoleNm #

这是最直接的方式，在你遍历角色添加Role Claim的代码里，为每个角色额外加一个自定义Claim来存RoleNm。

示例代码（ASP.NET Core场景） #

// 假设你从自定义仓储拿到了用户的角色列表，每个角色包含RoleCd和RoleNm
var userRoles = _customRoleRepo.GetAssignedRolesForUser(currentUserId);

var claims = new List<Claim>();
foreach (var role in userRoles)
{
    // 保留原有的标准Role Claim，用RoleCd作为值（不影响现有授权逻辑）
    claims.Add(new Claim(ClaimTypes.Role, role.RoleCd));
    // 添加自定义Claim存储角色名称，类型可以自己定义，比如"RoleName"
    claims.Add(new Claim("RoleName", role.RoleNm));
}

// 生成Cookie身份并登录
var identity = new ClaimsIdentity(claims, CookieAuthenticationDefaults.AuthenticationScheme);
await HttpContext.SignInAsync(CookieAuthenticationDefaults.AuthenticationScheme, new ClaimsPrincipal(identity));

账户页面展示逻辑 #

在页面后台（比如Razor页面模型、MVC控制器）关联两个Claim集合，然后前端展示：

// 从当前用户Claims中取出角色编码和名称
var roleCdClaims = User.Claims.Where(c => c.Type == ClaimTypes.Role).ToList();
var roleNmClaims = User.Claims.Where(c => c.Type == "RoleName").ToList();

// 把编码和名称配对成字典，方便页面遍历
var roleMap = roleCdClaims.Zip(roleNmClaims, (cd, nm) => new { Cd = cd.Value, Nm = nm.Value })
                          .ToDictionary(k => k.Cd, v => v.Nm);

前端（以Razor页面为例）：

<div class="user-roles">
    <h3>已分配角色</h3>
    @foreach (var role in roleMap)
    {
        <p>角色编码：<strong>@role.Key</strong>，角色名称：@role.Value</p>
    }
</div>

方式2：自定义Claim存储完整角色信息 #

如果不想维护两个独立的Claim，也可以把RoleCd和RoleNm序列化后存入一个自定义Claim，同时保留标准Role Claim用于授权：

示例代码 #

foreach (var role in userRoles)
{
    // 保留标准Role Claim
    claims.Add(new Claim(ClaimTypes.Role, role.RoleCd));
    // 序列化角色信息为JSON，存入自定义Claim
    var roleInfo = JsonSerializer.Serialize(new { RoleCd = role.RoleCd, RoleNm = role.RoleNm });
    claims.Add(new Claim("UserRoleInfo", roleInfo));
}

页面解析展示 #

// 解析自定义Claim中的JSON数据
var userRoles = User.Claims.Where(c => c.Type == "UserRoleInfo")
                           .Select(c => JsonSerializer.Deserialize<RoleInfo>(c.Value))
                           .ToList();

// 定义一个简单的模型类用于反序列化
public class RoleInfo
{
    public string RoleCd { get; set; }
    public string RoleNm { get; set; }
}

前端展示：

@foreach (var role in userRoles)
{
    <p>角色编码：<strong>@role.RoleCd</strong>，角色名称：@role.RoleNm</p>
}

注意事项 #

• 自定义Claim的类型名称（比如"RoleName"、"UserRoleInfo"）可以自行定义，只要前后保持一致即可；
• 默认情况下Cookie认证会序列化所有Claims到Cookie中，如果你配置了ClaimFilter，要确保自定义Claim被包含进去；
• 方式1更适合简单场景，方式2适合需要存储更多角色属性的情况。

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