认证系统是为了让集成的应用服务或第三方应用系统,在面向集成需求接入时,可以一键授权给应用服务,通过认证系统来完成业务,开放给所有通过集成认证的应用服务开发者使用的服务。
本文档中认证系统访问地址为:http://authapi.yeework.cn,管理系统访问地址为:http://manage.yeework.cn,集成应用地址为:http://www.yeework.cn,进行接口开发时应以产品的实际部署地址为主。
由具有管理员权限的用户进行集成应用的添加,集成应用包括:应用服务(Web Service)、网站(Site)。
应用服务(Web Service)添加时需填写访问地址、跳转地址、校验用户接口地址、获取用户接口地址;
访问地址:一般为应用服务的访问域名/IP地址;
跳转地址:从UMS服务门户中,点击集成应用之后跳转的地址;
校验用户接口地址:集成应用需提供用户信息校验接口,该接口应符合以下要求:
①接口参数
集成应用该接口应最少含有以下两个参数:
参数 | 类型 | 参数说明 |
login_name | string | 用户登录名,已使用对应RSA公钥加密 |
password | string | 用户密码,已使用对应RSA公钥加密 |
②返回参数
集成应用返回参数格式应为:
{ "Status": "0", "Msg": "用户名或密码不正确" }
返回参数说明:
返回值 | 字段类型 | 说明 |
Status | string | 验证结果,0:表示成功,1:表示失败 |
Msg | string | 验证结果描述 |
获取用户接口地址:
提供集成系统的用户信息,用户信息格式为:
[{ "UserLoginName": "nBQycm058Q8fHggSEKP2W3tBzKwLCTU4oWe1Y8dTVYb49RdjYrLSo0BhEaZOQOE0cXKgmguPC1F7vpTIHONUkiD62mzvyKw+amNXL2tLwseaPkemhtbl2RHl11u8IbFaCgYPY+PQK+Xk3zVzIKkITTGASY16QFZMk1PGatNOFhTKM/gnHcqzufNRHxw/lkwLS9+pDc05oocXB4U1df+d2V8DixpFFIUcITGASpXwGtkqXZkrDlNN/3z8aRrAd3/zYo+JNcaevaredqP0og1k9Ao6PNIMMqv/B719d/c9eqsG+JA5JUoEXf6cpkCN7DxUEdoBbCJWt9sirVf7i02wfA==" }, { "UserLoginName": "L6hKkPC0er6M4tmWjrNcdvHcpgLUPPhqt8ESfhJ3Bkf4rcKix7t0oWsSaHVHwaZ+aEscpKVndobMoH8OTKzDEukZKKkVM4nfS4qS3RH/vntRI9DyNVmdh4FTorBSJNfBJ1linuI84M2XgH59aJV+/J/7k7YDALWE6ksv9YOLn9sa62H/5tXB8wohZUxpm9M7YuH0ReFPVinQoAoQdJbWTyp5V5dA2x3KFlOYJdKGC5ClHEwoUw/axY7vxMwnMli/lwTORiuW66MyyvrFfN5mf0rWQpAGLkfDzl/bBapsibQ5vexUfeex8BG8WbhIyGOXkWPHKxoIdwJ6FqYnYTXLZg==" }]
返回参数说明:
返回值 | 字段类型 | 说明 |
UserLoginName | string | 用户登录名 |
返回参数UserLoginName值需使用自身存储的RSA密钥加密,即请求该接口时返回的数据应已加密。
集成应用最多支持OAuth2.0、可信域验证、账号绑定、百度账号、微信账号、新浪账号、QQ账号七种认证方式。
IP地址标识、手机号标识、用户名口令三种登录方式。
OAuth2.0:QS-UMS通过认证系统将自身用户信息开放共享,集成应用可通过OAuth2.0得到QS-UMS的用户信息,从而实现用户登录。
可信域验证:集成应用可自行构造登录页面,通过JS发送JSONP请求,从而实现QS-UMS用户的登录、获取在线用户等操作。
账号绑定:集成应用可在自身用户登录成功之后,通过发送JSONP请求,使该用户在认证系统中登录成功,从而实现全平台的免登访问。
百度账号:集成应用可通过认证系统直接接入到百度开放平台,使用百度账号进行用户登录。
微信账号:集成应用可通过认证系统直接接入到微信开放平台,使用微信账号进行用户登录。
新浪账号:集成应用可通过认证系统直接接入到新浪开放平台,使用新浪账号进行用户登录。
QQ账号:集成应用可通过认证系统直接接入到QQ开放平台,使用QQ账号进行用户登录。
IP地址标识登录:传递IP地址,使用角色默认权限登录。
手机号标识登录:使用手机号、验证码进行登录。
用户名口令登录:使用QS-UMS用户名、口令进行账号登录。