【翻译】配置基于策略的Blazor WebAssembly(Blazor客户端)应用程序的授权

原文:https://chrissainty.com/securing-your-blazor-apps-configuring-policy-based-authorization-with-blazor/

在中，我展示了如何向blazor webassembly(blazor客户端)应用程序添加基于角色的授权。在这篇文章中，我将向您展示如何使用blazor配置基于策略的授权。

基于策略的授权

asp.net core基于策略的授权允许一种更加灵活的方式来创建授权规则。策略授权由三个概念组成：

• policy - 策略有一个或者多个要求。
• requirement - 策略用于评估当前用户主体的数据参数集合。
• handler - 处理程序用于确定当前用户主体是否有权访问所请求的资源。

策略通常在应用程序启动时在startup类的configureservice方法中注册。

            services.addauthorization(config => {
                config.addpolicy("isdeveloper", policy => policy.requireclaim("isdeveloper", "true"));
            });

在上面的示例中，策略isdeveloper要求用户需要有isdeveloper声明，并且值为true。

与角色授权一样，您一样可以使用authorize属性应用于策略授权。

[route("api/[controller]")]
[apicontroller]
public class systemcontroller 
{
    [authorize(policy = “isdeveloper”)]
    public iactionresult loaddebuginfo()
    {
        // ...
    }
}

blazors指令和组件也一样可以使用策略。

@page "/debug"
@attribute [authorize(policy = "isdeveloper")]

<authorizeview policy="isdeveloper">
    <p>you can only see this if you satisfy the isdeveloper policy.</p>
</authorizeview>

更容易管理

基于策略的授权的最大优点就是改进应用程序中的授权管理。使用基于角色的授权，如果我们有两个角色被允许访问受保护资源 - 比如admin和moderator。我们需要在每个被允许的访问的资源添加一个authorize属性。

[authorize(roles = "admin,moderator")]

这在一开始看起来不是很糟糕，但是如果出现一个新的需求，第三个角色superuser，需要相同的访问权限，该怎么办呢？现在我们需要在每个被访问资源更新所有角色。通过基于策略的验证，我们可以避免这种情况。

我们可以在一个定义一个策略，然后将其应用于需要它的所有资源。当需要添加额外角色时，我们只需更新这个策略，而不需要更新各个资源。

public void configureservices(iservicecollection services)
{
    services.addauthorization(config =>
    {
    config.addpolicy("isadmin", policy => policy.requirerole("admin", "moderator", "superuser"));
    });
}

[authorize(policy = "isadmin")]

创建自定义需求

策略授权非常灵活，您可以基于角色、声明创建需求，甚至可以创建自定义需求。让我们来看看如何创建自定义需求。

通常，当您有复杂的逻辑时，会使用自定义需求。如上所述，我们需要顶一个需求和一个处理程序来使用策略授权。

我们来创建一个检查用户的电子邮件地址是否使用公司域的需求。我们需要创建授权需求类，这个类需要实现iauthorizationrequirement接口，这只是一个空的标记接口。

public class companydomainrequirement : iauthorizationrequirement
{
    public string companydomain { get; }

    public companydomainrequirement(string companydomain)
    {
        companydomain = companydomain;
    }
}

接下来，我们需要为我们的需求创建一个继承自authorizationhandler的处理程序，t就是要处理的需求。

public class companydomainhandler : authorizationhandler<companydomainrequirement>
{
    protected override task handlerequirementasync(authorizationhandlercontext context, companydomainrequirement requirement)
    {
        if (!context.user.hasclaim(c => c.type == claimtypes.email))
        {
            return task.completedtask;
        }
        
        var emailaddress = context.user.findfirst(c => c.type == claimtypes.email).value;
        
        if (emailaddress.endswith(requirement.companydomain))
        {
            return context.succeed(requirement);
        }
        
        return task.completedtask;
    }
}

在上面代码中，我们检查是否存在电子邮件声明。如果存在，那么我们检查它是否按要求中指定的域结束，如果是，则返回成功，否则就是失败。

我们只需要将我们的要求与一个策略关联起来，并将companydomainhandler注册到依赖注入容器中。

public void configureservices(iservicecollection services)
{
    services.addauthorization(config =>
    {
        config.addpolicy("iscompanyuser", policy =>
            policy.requirements.add(new companydomainrequirement("newco.com")));
    });

    services.addsingleton<iauthorizationhandler, companydomainhandler>();
}

要了解更多关于自定义要求的详细信息，建议查看。

blazor中使用策略

现在我们已经了解了什么是策略，让我们看看如何在应用程序中使用它们。

我们将把上一篇文章的中blazor应用程序切换到基于策略的授权。作为这项工作的一部分，我们将看到基于策略的授权的另一个优点，即能够在共享项目中定义策略并在服务端和客户端引用它们。

创建共享策略

在share项目中创建策略之前，我们需要先从nuget安装microsoft.aspnetcore.authorization这个包。

安装之后，使用以下代码创建一个名为policies 的类。

    public static class policies
    {
        public const string isadmin = "isadmin";
        public const string isuser = "isuser";

        public static authorizationpolicy isadminpolicy() {
            return new authorizationpolicybuilder().requireauthenticateduser()
                .requirerole("admin")
                .build();
        }

        public static authorizationpolicy isuserpolicy() {
            return new authorizationpolicybuilder().requireauthenticateduser()
                .requirerole("user")
                .build();
        }
    }

我们首先定义了两个常量isadmin和isuser。我们将在注册策略时候使用它们。接下来是策略本身，isadminpolicy和isuserpolicy。这里我使用authorizationpolicybuilder来定义每个策略，这两个策略都需要用户进行身份验证，然后根据策略的不同，用户可以是admin角色和user角色。

配置服务端

现在我们已经定义了策略，我们需要让服务端使用它们。首先，在startup类中的configureservices方法注册策略，在addauthentication之后添加以下代码。

            services.addauthorization(config => {
                config.addpolicy(policies.isadmin, policies.isadminpolicy());
                config.addpolicy(policies.isuser, policies.isuserpolicy());
            });

代码非常容易理解，我们使用policies类中定义的常量来声明它们的名称，并注册每个策略，避免使用魔法字符串。

在weatherforecastcontroller则可以使用isadmin策略代旧的角色。

    [apicontroller]
    [route("[controller]")]
    [authorize(policy = policies.isadmin)]
    public class weatherforecastcontroller : controllerbase

同样，我们可以使用名称常量来避免魔法字符串。

配置客户端

现在服务端可以使用我们定义的新策略，接下来就是在blazor客户端使用他们。

和服务端一样，我们也在在startup类中的configureservices方法注册策略。之前我们已经调用了addauthorizationcore，所以只需要更新它。

            services.addauthorizationcore(config => {
                config.addpolicy(policies.isadmin, policies.isadminpolicy());
                config.addpolicy(policies.isuser, policies.isuserpolicy());
            });

在index.razor，使用策略更新authorizeview组件 - 一样要避免使用魔法字符串。

<authorizeview policy="@policies.isuser">
    <p>you can only see this if you satisfy the isuser policy.</p>
</authorizeview>

<authorizeview policy="@policies.isadmin">
    <p>you can only see this if you satisfy the isadmin policy.</p>
</authorizeview>

最后，更新fetchdata.razor的authorize属性。

@attribute [authorize(policy = policies.isadmin)]

就是这样!我们的应用程序现在转移到基于策略的授权。我们现在有一个更灵活的授权系统，可以使用角色、声明、自定义策略或者上述任何组合。

关于服务端blazor

我并没有专门讨论服务端blazor，原因很简单，我们上面所做的应该可以毫无问题的转移到服务端blazor。

总结

在这篇文章中，我们讨论了asp.net core和blazor基于策略的授权。我们也了解了使用基于策略的授权相对于基于角色的授权的一些优点并且我们将应用程序从基于角色的验证迁移到了基于策略的验证。

最后还是代码(github)