1.0.1 • Published 9 months ago
kaihong-auth v1.0.1
接入开鸿账号
开鸿统一身份认证接入。
用户登录并授权
(/Users/lenghao/Library/Application Support/typora-user-images/image-20230801165815325.png)
调起开鸿账号登录
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>xxx 应用系统</title>
<script src="https://cdn.jsdelivr.net/npm/@kaihong/auth@1.0.0"></script>
<script type="text/javascript">
window.onload = function() {
let oAuth = new Auth();
// let oAuth = new Auth(url, options);
document.querySelector('#logout').onclick = function() {
oAuth.logout();
}
document.querySelector('#login').onclick = function() {
oAuth.login();
}
}
</script>
</head>
<body>
<button id="login">登录</button>
<button id="logout">登出</button>
</body>
</html>请求参数
| 参数名称 | 是否必选 | 参数说明 |
|---|---|---|
| url | 否 | 登录地址 |
| options | 否 | 入参 |
| options.redirect_url | 否 | 请求服务后返回地址 |
服务响应
服务响应将响应值通过回调地址redirect_url 回调给应用。
如果用户同意授权，则回调请求中带有token。
https://xx.xxx.xxxx/xxxxx?token=<返回token>如果用户不同意授权，则回调请求中包含错误消息。
https://xx.xxx.xxxx/xxxxx?error=<返回错误码>&error_description=<返回错误描述>
响应参数
| 参数名称 | 是否必选 | 参数说明 |
|---|---|---|
| token | 是 | 用户的鉴权凭证 |
| expires_in | 是 | Access Token 的剩余有效期，单位：秒 |
| error | 否 | 错误状态码 |
| error_description | 否 | 错误描述 |
错误码
| 错误码（error） | 描述（error_description） | 解决方法 |
|---|---|---|
| xxx | 取消登录 | |
| xxx | 请求开鸿服务器失败 | |
| xxx | 应用未授权，需要授权 |