Appearance
用户票据
当用户在第三平台引用运行平台时,为进行权限认证必需手动传入票据(用户凭证 token)。
验证方式
token 验证
如果使用是平台默认的验证方式,存在两种情况:
在 url 中通过传入 query
access_token
,如/#/render-form?access_token=c61d6fe3af7e4bc49bb7be2bf29ce806-1
/#/render-form?access_token=c61d6fe3af7e4bc49bb7be2bf29ce806-1
若是引入 CoRender,则需在
localStorage
中设置Browser-User-Token
,如tslocalStorage.setItem( 'Browser-User-Token', 'c61d6fe3af7e4bc49bb7be2bf29ce806-1' )
localStorage.setItem( 'Browser-User-Token', 'c61d6fe3af7e4bc49bb7be2bf29ce806-1' )
这两种方式分别对应通过网页引入和使用 CoRender JDK,都是合法的。
SSO 第三方验证
config.js 参数 | 描述 | 是否必须 |
---|---|---|
THIRD_API_URL | 第三方单点登录 ssoTicket 转换和退出地址 | 是 |
ENV | 前端登录环境配置 | 是 |
PROJECT | 项目名称 | 是 |
THIRD_SSO_TICKET_NAME | 自定义票据名称 | 否 |
示例:
js
const config = {
API: {
/**
* 第三方单点登录ssoTicket转换和退出地址,此处配置平台单点登录服务地址, 具体地址见服务相关配置
*/
THIRD_API_URL: 'http://117.160.244.96:7001',
},
/**
* 前端登录环境配置, 必须填写为`thirdsso`
*/
ENV: 'thirdsso',
/**
* 项目名称,当需要使用第三方单点登录时请填写此项,非空即可
*/
PROJECT: 'thirdsso',
SETTINGS: {
/**
* 自定义第三方登录的sso票据名称,第三方登录界面跳转至平台时通过在URL后面拼接参数进行token传递,不填默认`ssoTicket`,
* 例如:http://192.168.1.13/#/home?ssoTicket=69f09eaf-e273-46a8-bf88-615a00d636e2
*/
THIRD_SSO_TICKET_NAME: '',
},
}
const config = {
API: {
/**
* 第三方单点登录ssoTicket转换和退出地址,此处配置平台单点登录服务地址, 具体地址见服务相关配置
*/
THIRD_API_URL: 'http://117.160.244.96:7001',
},
/**
* 前端登录环境配置, 必须填写为`thirdsso`
*/
ENV: 'thirdsso',
/**
* 项目名称,当需要使用第三方单点登录时请填写此项,非空即可
*/
PROJECT: 'thirdsso',
SETTINGS: {
/**
* 自定义第三方登录的sso票据名称,第三方登录界面跳转至平台时通过在URL后面拼接参数进行token传递,不填默认`ssoTicket`,
* 例如:http://192.168.1.13/#/home?ssoTicket=69f09eaf-e273-46a8-bf88-615a00d636e2
*/
THIRD_SSO_TICKET_NAME: '',
},
}
在第三方登录完成之后,前端将上面获取的信息作为参数拼接在 URL 中传递至平台,以ssoTicket
或者自定义的THIRD_SSO_TICKET_NAME
为票据名称进行 token 传递。
例:http://192.168.1.13/#/home?ssoTicket=69f09eaf-e273-46a8-bf88-615a00d636e2
服务配置
前端完成 config.js
配置后,服务需要做对应的配置,具体请参照 服务配置。