RBAC权限控制

hsweb提供了常规的RBAC权限控制，默认基于AOP实现。hsweb-authorization-api 模块中定义了权限相关接口，核心类:

Authentication : 用户的所有权限相关信息。

AuthenticationManager：用于管理用户的权限信息已经授权。

AuthenticationSupplier： 用于获取当前登录用户和指定用户的权限，可通过实现此接口来自定义权限获取方式。

注解权限控制声明

在需要进行权限控制的Controller 中注解@Authorize 以声明此接口需要控制权限。

属性列表:

属性名	说明
permission	权限标识,如: user-manager
action	操作,如: add
role	角色ID,如: admin
user	用户名,如: admin
logical	存在多个声明时使用的策略: AND: 并且 OR: 或者
phased	验证时机: before: 在请求之前 after: 在请求之后
ignore	忽略权限控制
description	权限说明
dataAccess	数据权限声明

注意：

1. 在类上注解时,表示此类的所有接口都需要进行权限控制。

2. 方法和类上的注解默认将合并处理，如:类注解@Authorize(permission="user-manager")，方法注解 @Authorize(action="add")，在权限控制时会合并为@Authorize(permission="user-manager",action="add")

自定义权限控制声明

在注解方式进行声明时,可能不能完全满足需求，比如要修改已经打了包的模块的权限控制声明。

实现接口: AopMethodAuthorizeDefinitionCustomizerParser ,实现parse 方法，返回 AuthorizeDefinition .即可。AuthorizeDefinition 的属性和Authorize注解基本一致，具体查看源代码即可。

如果返回EmptyAuthorizeDefinition 则表示不进行权限控制,如果返回null 则表示使用默认的权限定义。

事件

在进行权限控制时，会触发事件:AuthorizingHandleBeforeEvent ,可通过监听此事件,来实现自定义的权限控制。例如:

@EventListener
public void handEvent(AuthorizingHandleBeforeEvent event) {
        if(event.getContext()
        .getAuthentication()
        .getUser()
        .getUsername()
        .equals("admin")){
         //admin用户拥有所有权限
           event.setAllow(true);
        }
}

通过配置文件设置不进行权限控制的接口

application.yml

hsweb:
    authorize:
        allows:
            users:
                admin: * # admin用户可以访问全部接口
                guest: **.query* # guest 可以返回query开头的方法
            roles:
                admin: *