sureness - 一个面向restful api保护的权限认证

`sureness` - 面向`restful api`的权限认证

`Background`

目前java主流的权限框架有shiro，spring security
下面对于它们的探讨都是个人浅薄之见，接受纠正
shiro对于restful api原生支持不是太友好,需要改写一些代码,2年前一个项目就是改造shiro,使其在过滤链就能匹配不同的rest请求进行权限校验,项目传送门booshiro,之后给shiro commit几次pr,fix其在过滤链匹配时的危险漏洞,PR传送门SHIRO-682,总的来说shiro很强大但其起源并非面向web,对restful不是很友好
spring security很强大,与spring深度集成,离开spring,比如google的精简guice,之前用过的osgi框架karaf就用不了了
它们都会在链式匹配这块，用请求的url和配置的链一个一个ant匹配(匹配过程中会有缓存等提高性能)，但匹配的链过多时还是比较耗性能
所以想写一个权限包吸取上面的优秀设计,加一些自己的想法

`Introduction`

sureness 是作者在使用java权限框架shiro之后,吸取其良好的设计加上一些自己想法实现的全新认证鉴权项目
面对restful api的认证鉴权,基于RABC主要关注于对restful api的保护
原生支持 restful api, websocket protection
原生支持动态权限(权限配置的动态加载)
原生支持 jwt, Basic Auth ... 可扩展自定义支持的认证方式
基于改进的字典匹配树大大提高性能
sureness的低配置，易扩展，不耦合其他框架，能使开发者对自己的项目多场景快速安全的进行保护

仓库的组成部分:

一些约定

基于RABC,但只有(角色-资源)的映射,没有(权限)动作
我们将restful api请求视作一个资源,资源格式为: requestUri===httpMethod
即请求的路径加上其请求方式(post,get,put,delete...)作为一个整体被视作一个资源
eg: /api/v2/book===get get方式请求/api/v2/book接口数据
用户所属角色--角色拥有资源--用户拥有资源(用户就能访问此api)

使用

maven坐标

<!-- https://mvnrepository.com/artifact/com.usthe.sureness/sureness-core -->
<dependency>
    <groupId>com.usthe.sureness</groupId>
    <artifactId>sureness-core</artifactId>
    <version>0.0.2.3</version>
</dependency>

gradle坐标

compile group: 'com.usthe.sureness', name: 'sureness-core', version: '0.0.2.3'

入口,一般放在拦截所有请求的filter:

SurenessSecurityManager.getInstance().checkIn(servletRequest)

认证鉴权成功直接通过,失败抛出特定异常,捕获异常:

        try {
            SubjectSum subject = SurenessSecurityManager.getInstance().checkIn(servletRequest);
        } catch (ProcessorNotFoundException | UnknownAccountException | UnsupportedSubjectException e4) {
            // 账户创建相关异常 
        } catch (DisabledAccountException | ExcessiveAttemptsException e2 ) {
            // 账户禁用相关异常
        } catch (IncorrectCredentialsException | ExpiredCredentialsException e3) {
            // 认证失败相关异常
        } catch (UnauthorizedException e5) {
            // 鉴权失败相关异常
        } catch (RuntimeException e) {
            // 其他自定义异常
        }

sureness异常	异常描述
SurenessAuthenticationException	基础认证异常,认证相关的子异常应该继承此异常
SurenessAuthorizationException	基础鉴权异常,鉴权相关的子异常应该继承此异常
ProcessorNotFoundException	认证异常,未找到支持此subject的processor
UnknownAccountException	认证异常,不存在此账户
UnSupportedSubjectException	认证异常,不支持的请求,未创建出subject
DisabledAccountException	认证异常,账户禁用
ExcessiveAttemptsException	认证异常,账户尝试认证次数过多
IncorrectCredentialsException	认证异常,密钥错误
ExpiredCredentialsException	认证异常,密钥认证过期
UnauthorizedException	鉴权异常,没有权限访问此资源

自定义异常需要继承SurenessAuthenticationException或SurenessAuthorizationException才能被最外层捕获

若权限配置数据来自文本,请参考使用sureness10分钟搭建权限项目--sample-bootstrap

若权限配置数据来自数据库,请参考使用sureness30分钟搭建权限项目--sample-tom

HAVE FUN

进阶扩展

如果了解处理流程,就大概知道sureness提供的扩展点
sureness支持自定义subject，自定义subjectCreator注册，自定义processor处理器等

扩展之前需要了解以下接口:

Subject: 认证鉴权对象接口,提供访问对象的账户密钥,请求资源,角色等信息
SubjectCreate: 创建Subject接口,根据请求内容创建不同类型的Subject对象
Processor: Subject处理接口,根据Subject信息,进行认证鉴权
PathTreeProvider: 资源的数据源接口,实现从数据库,文本等加载数据
SurenessAccountProvider: 用户的账户密钥信息接口,实现从数据库,文本等加载数据

sureness大致流程:

graph TD
A(用户请求体进来) --> B(s)
B(subjectCreate根据请求头内容创建不同的钥匙subject,每把钥匙都可以尝试) --> C(s)
C(不同的钥匙认证方式即不同的锁processor来处理进来的钥匙subject) --> D(s)
D(以上一次成功即成功并结束,失败即下一个钥匙锁尝试直到所有尝试结束)