提交 aa78cae0 编写于 作者: sinat_25235033's avatar sinat_25235033

docs update: modify extend-point

上级 b8935f74
......@@ -162,10 +162,15 @@ try {
## 进阶扩展
如果了解 [处理流程](docs/cn/design.md),就大概知道`sureness`提供的扩展点
`sureness`支持自定义`subject`,自定义`subjectCreator`注册,自定义`processor`处理器等
`sureness`支持自定义`subject`,自定义`subjectCreator`注册,自定义`processor`处理器等
扩展之前需要了解以下接口:
进阶自定义扩展之前我们先来了解下sureness的大致流程:
![flow](docs/_images/flow-cn.png)
如上面流程,Subject被SubjectCreate根据request请求体所创造,不同的认证鉴权处理器Processor来处理所支持的Subject。
sureness提供了下面这些常用接口作为扩展点:
- `Subject`: 认证鉴权对象接口,提供访问对象的账户密钥,请求资源,角色等信息
- `SubjectCreate`: 创建`Subject`接口,根据请求内容创建不同类型的`Subject`对象
......@@ -173,25 +178,30 @@ try {
- `PathTreeProvider`: 资源的数据源接口,实现从数据库,文本等加载数据
- `SurenessAccountProvider`: 用户的账户密钥信息接口,实现从数据库,文本等加载数据
`sureness`大致流程:
![flow](docs/_images/flow-cn.png)
扩展文档详见 [扩展点](docs/cn/extend-point.md)
1. **自定义数据源**
1. **自定义subject**
实现 `PathTreeProvider`的接口, 加载到`DefaultPathRoleMatcher`
实现 `SurenessAccountProvider`的接口,加载到需要的`processor`
实现`Subject`接口,添加自定义的`subject`内容
实现`SubjectCreate`接口方法,自定义subjectCreator创建出自定义的`subject`
实现`BaseProcessor`接口,自定义processor支持处理自定义的`subject`
详见 [自定义Subject](docs/cn/custom-subject.md)
2. **自定义subject**
2. **自定义subjectCreator**
实现`Subject`接口,添加自定义的`subject`内容
实现`SubjectCreate`接口方法,创建出自定义的`subject`
实现`Processor`接口,支持处理自定义的`subject`
实现`SubjectCreate`接口方法,根据request请求的内容创建出对应需要的的`subject`
详见 [自定义SubjectCreate](docs/cn/custom-subject-creator.md)
3. **自定义processor**
一个`subject`当然也可以被不同的`processor`处理,所以可以单独自定义`processor`
实现`Processor`接口,设置支持的`subject`,实现处理该`subject`的逻辑
实现`BaseProcessor`接口,设置支持的`subject`,实现处理该`subject`的认证鉴权逻辑
详见 [自定义Processor](docs/cn/custom-processor.md)
4. **自定义数据源**
实现 `PathTreeProvider`的接口, 加载到对应的资源权限匹配器`DefaultPathRoleMatcher`
实现 `SurenessAccountProvider`的接口,加载到需要账户数据的`processor`
详见 [自定义数据源](docs/cn/custom-datasource.md)
具体扩展实践请参考 [sureness集成springboot样例(数据库方案)--sample-tom](sample-tom)
......
## 进阶扩展
进阶自定义扩展之前我们先来了解下sureness的大致流程
`sureness`支持自定义`subject`,自定义注册`subjectCreator`,自定义`processor`处理器,自定义数据源加载器等
如果了解处理流程,就大概知道`sureness`提供的扩展点
`sureness`支持自定义`subject`,自定义`subjectCreator`注册,自定义`processor`处理器等
`sureness`的大致流程:
进阶自定义扩展之前我们先来了解下sureness的大致流程:
![flow](../_images/flow-cn.png)
......@@ -18,6 +15,4 @@ sureness提供了下面这些常用接口作为扩展点:
- `SubjectCreate`: 创建`Subject`接口,根据请求内容创建不同类型的`Subject`对象
- `Processor`: `Subject`处理接口,根据Subject信息,进行认证鉴权
- `PathTreeProvider`: 资源的数据源接口,实现从数据库,文本等加载数据
- `SurenessAccountProvider`: 用户的账户密钥信息接口,实现从数据库,文本等加载数据
`sureness`支持自定义`subject`,自定义注册`subjectCreator`,自定义`processor`处理器,自定义数据源加载器等。
- `SurenessAccountProvider`: 用户的账户密钥信息接口,实现从数据库,文本等加载数据
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册