REST API权限集成设计

REST API权限集成设计

应用分为两大部分，前端html+后端Rest服务，前端html和后端Rest服务部署完全分离。
目标：可访问资源都处于权限控制之下(意味着通过浏览器地址栏的任意url都会被拦截)，并提供跨域访问支持。
***

项目模块

前端模块：应用界面，通过rest接口与后台交互。
后端模块：UPM(用户权限管理)模块+数据服务(包含多种数据来源，比如本地DB、第三方服务等)统一作为Rest封装层。

应用模块权限访问交互流程

Token

• Client和Server交互的令牌，相当于客户端和Server交互的唯一id，绝大部分(登录时不需要)Client请求都会带上此id，和SessionId类似，只是它不必受限于单个Web容器并能够自定义Token的过期时间、生成策略。
• 对于一个独立用户，Server和UPM共用相同的Token。
• Token包含tokenid+userid+其它辅助信息.

UPM

UPM提供对整个应用系统中关于资源和用户角色关系的权限配置，并且对外提供认证和授权的接口。

Token Manager

维护Token生命周期，可配置Token的过期时间，Token Mananger维护一张hash表，k为用户id，v为Token，每次用户请求匹配token时自动检查Token是否过期，如果过期，则返回过期的状态码。
Token指标：Token使用次数、Token过期时间
Token使用次数：如果客户端请求次数大于了Token默认设定请求次数，则需要重新生成Token，但无需重新登录。
Token过期时间：超过Token过期时间的请求将会触发重新登录。

登录权限交互流程

业务流：用户登录(login.html)访问，输入用户名和密码后访问主页(index.html)

登录权限交互流程：

• 用户访问Client静态资源login.html，填写用户名和密码并执行登录
• 用户名和密码被传递到UPM
• UPM执行认证(authentication)，校验用户名和密码
• 认证通过后执行授权(authorization)，获取和当前用户关联的所有可访问的资源
• 如果上一步执行成功，UPM将请求TokenManager创建Token，若不通过则返回错误码(授权、认证错误码不同)
• UPM将token+授权数据返回给客户端
• 客户端收到token+授权数据展现index.html给用户(index.html可能存在多个模块,需要控制页面展示)

备注：Client端需要处理从UPM端返回的数据，包含Token和状态码，如果状态码不是成功标识，依据具体的状态码转向特定页面，否则登录成功，存储Token(比如存储到Cookie)，并跳转到首页。

登录后资源访问

业务流：假定用户进入index.html存在一个rest资源链接，对应rest服务"/audience/report"，用于请求最新的人群报告，人群报告展示页面为audience.html

备注：此时用户已登录，Client的Cookie中已存在Token

人群报告权限交互流程：

• 用户点击"人群报告"链接(rest url=/audience/report)
• 客户端发送请求(包含user+rest url+ token)给UPM
• 客户端发送请求(rest url=/audience/report + token)发给Server
• Server匹配token，UPM授权rest url，如果token未过期并且匹配成功并且upm授权成功将调用实际业务处理流获取数据，否则返回错误码
• 将数据和Token信息返回给客户端
• Client依据Server的数据渲染人群报告页面展现给用户

前后端交互备注

• 前端的所有请求，除登入请求之外，其它所有请求都在header中附带用户id(userId)和令牌(tokenId)传递给服务端。
• 任何请求都必须带令牌，若无令牌，直接rest url访问目标资源，则返回登录页。