ASP.NET Core 中基于角色的授权

创建标识时，它可能属于一个或多个角色。 例如，Tracy 可能属于 Administrator 和 User 角色，而 Scott 只属于 User 角色。 如何创建和管理这些角色取决于授权过程的后备存储。 角色通过 IsInRole 类的 ClaimsPrincipal 方法向开发人员公开。 AddRoles 必须添加到角色服务。

虽然角色是声明，但并非所有声明都是角色。 根据身份颁发者的不同，角色可能指的是一组用户，这些用户可以代表组成员提出声明，同时也可以指对身份的实际声明。 但是，声明是关于个人用户的信息。 使用角色向用户添加声明可能会混淆用户与其个人声明之间的界限。 这种混淆就是为什么 SPA 模板不是围绕角色设计的原因。 此外，对于从本地旧系统迁移的组织而言，多年来角色的激增可能意味着角色声明可能太大而无法包含在 SPA 可用的令牌中。 若要保护 SPA，请参阅使用 Identity 保护 SPA 的 Web API 后端。

本文概述了 ASP.NET Core MVC 和 Razor 应用的基于角色的授权。 有关 Blazor 应用，请参阅 ASP.NET Core Blazor 身份验证和授权以及具有 Microsoft Entra ID 组和角色的 ASP.NET CoreBlazor WebAssembly。

将角色服务添加到 Identity

通过使用应用 Program.cs 配置中的角色类型调用 AddRoles ，在 Identity 中注册基于角色的授权服务。 以下示例中的角色类型为 IdentityRole：

builder.Services.AddDefaultIdentity<IdentityUser>( ... )
    .AddRoles<IdentityRole>()
    ...

上述代码需要 Microsoft.AspNetCore.Identity.UI 包和 using 的 Microsoft.AspNetCore.Identity 指令。

添加角色检查

基于角色的授权检查：

• 是声明性的，指定当前用户必须是其成员才能访问请求的资源的角色。
• 适用于控制器中的 Razor 页面、控制器或操作。
• 不能在 页面处理程序级别应用，它们必须应用于页面。

例如，以下代码将访问权限限制为属于 AdministrationController 角色成员的用户对 Administrator 的任何操作：

[Authorize(Roles = "Administrator")]
public class AdministrationController : Controller
{
    public IActionResult Index() =>
        Content("Administrator");
}

多个角色可以指定为逗号分隔的列表：

[Authorize(Roles = "HRManager,Finance")]
public class SalaryController : Controller
{
    public IActionResult Payslip() =>
                    Content("HRManager || Finance");
}

仅当用户为 SalaryController 或 HRManager 角色成员时才可访问 。

应用多个属性时，访问用户必须是所有指定角色的成员。 以下示例要求用户必须同时是 和 角色的成员PowerUser：

[Authorize(Roles = "PowerUser")]
[Authorize(Roles = "ControlPanelUser")]
public class ControlPanelController : Controller
{
    public IActionResult Index() =>
        Content("PowerUser && ControlPanelUser");
}

可以通过在操作级别应用其他角色授权属性来限制对操作的访问：

[Authorize(Roles = "Administrator, PowerUser")]
public class ControlAllPanelController : Controller
{
    public IActionResult SetTime() =>
        Content("Administrator || PowerUser");

    [Authorize(Roles = "Administrator")]
    public IActionResult ShutDown() =>
        Content("Administrator only");
}

前面的 ControlAllPanelController 控制器中：

• Administrator 角色或 PowerUser 角色的成员可以访问控制器和 SetTime 操作。
• 只有 Administrator 角色的成员才能访问 ShutDown 操作。

可以保护控制器，但允许对单个操作的匿名、未经身份验证的访问：

[Authorize]
public class Control3PanelController : Controller
{
    public IActionResult SetTime() =>
        Content("[Authorize]");

    [AllowAnonymous]
    public IActionResult Login() =>
        Content("[AllowAnonymous]");
}

对于 Razor 页面，可以通过以下任一方法应用 [Authorize]：

• 使用 约定，或
• 将 [Authorize] 应用到 PageModel 实例：

[Authorize(Policy = "RequireAdministratorRole")]
public class UpdateModel : PageModel
{
    public IActionResult OnPost() =>
         Content("OnPost RequireAdministratorRole");
}

重要

筛选器属性（包括 AuthorizeAttribute），只能应用于 PageModel，不能应用于特定页面处理程序方法。

基于 Policy 的角色检查

角色要求也可以使用 Policy 语法来表达，其中开发人员在应用程序启动时注册策略作为授权服务配置的一部分。 这通常出现在 Program.cs 文件中：

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();
builder.Services.AddControllersWithViews();

builder.Services.AddAuthorization(options =>
{
    options.AddPolicy("RequireAdministratorRole",
         policy => policy.RequireRole("Administrator"));
});

var app = builder.Build();

if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseAuthentication();
app.UseAuthorization();

app.MapDefaultControllerRoute();
app.MapRazorPages();

app.Run();

使用 Policy 属性上的 [Authorize] 属性应用策略：

[Authorize(Policy = "RequireAdministratorRole")]
public IActionResult Shutdown()
{
    return View();
}

若要在某个要求中指定多个允许的角色，请将它们指定为 RequireRole 方法的参数：

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();
builder.Services.AddControllersWithViews();

builder.Services.AddAuthorization(options =>
{
    options.AddPolicy("ElevatedRights", policy =>
          policy.RequireRole("Administrator", "PowerUser", "BackupAdministrator"));
});

var app = builder.Build();

前面的代码授权属于 Administrator、PowerUser 或 BackupAdministrator 角色的用户。