睿码主数据
当前版本:2.7.3

密钥管理

1.了解密钥管理

密钥管理支持对用户生成的密钥进行全生命周期的管理,包括生成、修改、删除等。通过密钥管理可保证数据传输的安全性。
点击用户权限-密钥管理,访问密钥管理页面。
密钥创建密钥时输入密钥的第三方名称、选择绑定用户、配置令牌时长、配置令牌次数限制,创建后自动生成APPID和APPSECRET。
第三方名称:密钥名称,根据密钥的业务管理需求进行填写即可。
绑定用户:选择机构用户下的某一用户,密钥的权限范围和用户的权限范围保持一致。
令牌的有效时长:密钥生效的时长,单位是分钟,为空时默认为3分钟,输入负数则定义为不限时。可通过时间控制密钥的有效性。
令牌的最大次数:密钥生效的次数,单位是次数,为空默认为10次,输入负数则定义为不限次数。可通过接口调用次数控制密钥的有效性。

2.普通用户获取密钥

访问个人设置-API密钥页面,点击【获取密钥】按钮可获取当前登录用户密钥。
页面处会展示APPID和APPSECRET,时长默认为120分钟,令牌最大次数默认为无限次数。
获取后需要调整密钥配置内容,可再前往密钥管理页面进行调整。

3.密钥使用

2.1token免密登录方式

通过第三方账号密钥一次调用获取Token带前面进行免密登录(获取Token及签名合并一起调用)
接口地址:/eacl/api/token/getTokenAndSign.do
参数说明:

参数key

描述

备注

是否必传参数

appid

秘钥管理页面注册的账号

 

appsecret

秘钥管理页面注册的密码

 

url

预访问的链接地址,支持到参数:/xxx/yyy.do?cmd=aaa

字符串;例如:/web/eacl (页面url前缀) 或 /eacl (接口url前缀) 或 /(所有地址均可访问)。代表使用token的时候免密的url地址前缀

注意:

1.如果是页面url地址,则使用esentoken和esensign登录之后会有登录会话,即新开浏览器tab不带token可以访问该用户所有有权限的页面。

2.如果是接口url地址,则使用esentoken和esensign访问接口之后无登录会话,即新开浏览器tab不带token不能访问其它有权限的接口。

uid

使用的用户id

例如:user (如果密钥管理绑定了用户,则不需要传用户id)

referurls

该参数是针对页面url增强控制。

1.url是页面:增强控制仅能使用到页面内的url,新开tab页无法访问到该用户别的有权限页面地址。

字符串;多个地址以逗号分隔

页面url控制:例如:/web/eacl/orgmgr.do

否,非高安全场景,不需要加该参数

请求示例:/eacl/api/token/getTokenAndSign.do?appid=30ba62d1e6c541269c442a2a40b1fd0c&appsecret=0ba256f05ef34e02961dcb20a71a2950&url=/welcome.do

返回示例:{"status":200,"message":"获取token及签名成功。","data":{"esensign":"3NPLTtozCbwzSkcc3zihQ46JIfU-kbCiiayi_iHf4LdKQ2-EQjAaNAqWr-Fx1Xd8","esentoken":"885237f549a847dbb09e9909c752c56e","refreshToken":"cd94c039c1a945e49e63391c13e1f11c"},"error":null}


在另外一个浏览器使用该登录用户的esentoken(令牌)及esensign(签名)去免密访问接口url(/web/eacl)获取数据或访问页面(esentoken、esensign参数请求支持header中存储获取)

请求示例:/welcome.do?esentoken=885237f549a847dbb09e9909c752c56e&esensign=3NPLTtozCbwzSkcc3zihQ46JIfU-kbCiiayi_iHf4LdKQ2-EQjAaNAqWr-Fx1Xd8#navigator:web/index.do?rshid=welcome


2.2失效token

接口地址:/eacl/api/token/invalidToken.do
参数说明:

参数key

描述

备注

是否必传参数

token

token值

例如:ba86b396379944a8a813f8d017bf6669

请求示例:/eacl/api/token/invalidToken.do?token=ba86b396379944a8a813f8d017bf6669

返回示例:{"status":200,"message":"失效令牌token成功。","data":null,"error":null}


2.3检查token有效性

接口地址:/eacl/api/token/checkToken.do
参数说明:

参数key

描述

备注

是否必传参数

token

token值

例如:ba86b396379944a8a813f8d017bf6669

请求示例:/eacl/api/token/checkToken.do?token=ba86b396379944a8a813f8d017bf6669
返回示例:{"status":200,"message":"检查令牌token成功","data":{"state":4,"msg":"token访问时长已经用完,无法继续访问"},"error":null}
返回参数:

参数key

描述

备注

status

状态码

默认是200

data

state: 枚举值:1,2,3,4

msg:state对应的描述如下:1(token有效),2(token不存在,无法正常使用该token)

,3(token访问次数为0,无法继续访问),4(token访问时长已经用完,无法继续访问)

 

message

检查结果信息

 


2.4延续token时长

接口地址:/eacl/api/token/refreshToken.do
参数说明:

参数key

描述

备注

是否必传参数

refreshToken

刷新token值

例如:ba86b396379944a8a813f8d017bf6669

请求示例:/eacl/api/token/refreshToken.do?refreshToken=6514bf84177c48cbb1164954aca83b29
返回示例:{"status":200,"message":"刷新令牌token成功。","data":{"esentoken":"1dd0da31b1c84387b89b8e33aae28fe3","refreshToken":"6514bf84177c48cbb1164954aca83b29"},"error":null}
返回参数:

参数key

描述

备注

status

状态码

默认是200

data

esentoken:刷新成功的token值

refreshToken:使用到的刷新token

 

message

刷新结果信息

 

附件列表

0

文档内容仅供参考
如果您需要解决具体问题,还可以登录亿信社区
在提问求助板块提问,30分钟内帮您解决问题

如果您认为本词条还有待完善,请编辑

上一篇免登陆设置

下一篇常用权限场景

请先登录