SSO单点登录API

配置参数

 

重定向地址（Redirect_URL）获取

 

业务流程

HTTP 请求过程
参考上方的”业务流程图“进行

第2步、用户浏览器从 helplook 站点跳转到企业 SSO 登录界面

跳转链接：https://sso.company.com/oauth/authorize?client_id=9d8a121ce581499d&redirect_uri=https%3A%2F%2Fcompany.helplook.com%2Faccess&response_type=code&scope=public

 

第4步、用户浏览器从企业 SSO 登录界面跳转到 helplook 授权回调界面

跳转链接：https://company.helplook.com/access?code=9e7d0a6dea2e12e99df0

 

第5.1步、helplook后台向 SSO 获取用户 Token

请求方式	请求地址
POST	https://sso.company.com/login/oauth/access_token

Body 类型 : application/json

参数	必填	说明	示例
client_id	是	应用ID	9d8a121ce581499d
client_secret	是	应用密钥	698d59D8A1217b701668
code	是	预授权码	9e7d0a6dea2e12e99df0
grant_type	是	授权类型	code

响应

{
    "access_token": "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",
    "token_type": "bearer",
    "scope": "",
    "expire_time": "7200" // 过期时间(秒), 不返回此参数, token默认为30天过期
}

 

第6步、helplook 通过 Token 从后台向企业 SSO 获取用户信息

请求方式	请求地址
GET	https://sso.company.com/api/user

Body 类型 : application/json

请求头： Authorization: Bearer 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

响应

{
	"nickname": "helplook",
	"open_id": 166786062,
	"avatar": "",
	"phone": "",
	"email": "",
    "auth_group_id": "",
}

参数	必填	说明	示例
nickname	是	昵称	helplook
open_id	是	企业自有系统用户唯一ID	166786062
avatar	否	头像
phone	否	手机号
email	否	邮箱
auth_group_id	否	分组ID(多个用，分割)	2,3

 

备注、业务异常响应格式

{
	"error": "无效的授权码",
	"error_description": "传递的授权码不正确或已过期",
	"error_uri ": ""
}

将帮助中心嵌入系统中，并且对接企业自有SSO登录系统，跳过登录流程，自动验证身份

方式一：

方式二：

 

FAQ

1. 站点开启授权访问，用户使用SSO授权登陆，导致AI问答小部件SDK，提示需要登陆怎么办？

答：使用SDK提供的js方法实现SSO登陆授权 

<script type="text/javascript" id="helplook-sdk" src="https://sdk.helplook.net/pro/hlSdk.js?id={站点id}"></script>
<script>
        // code是通过后端请求获取的
        window.HelpLookSdk.ssoLogin('code')
</script>

配置实例