接入说明

关于来鼓快速登录功能的说明

当网站应用发起来鼓授权登录请求时，用户需要输入来鼓账号密码进行登录，校验通过之后点击授权即可。

准备工作

网站应用来鼓登录是基于 OAuth2.0 协议标准构建的来鼓OAuth2.0授权登录系统。在进行来鼓 OAuth2.0 授权登录接入之前，需要先线下申请一个来鼓应用，并获得相应的appId和appSecret，可开始接入流程。

授权流程说明

来鼓 OAuth2.0 授权登录让来鼓用户使用来鼓身份安全登录第三方应用或网站，在来鼓用户授权登录已接入来鼓 OAuth2.0 的第三方应用后，第三方可以获取到用户的接口调用凭证（accessToken），通过accessToken可以实现来鼓内嵌页面数据访问。来鼓 OAuth2.0 授权登录目前支持authorization_code模式，适用于拥有server端的应用授权。该模式整体流程为：

第三方发起来鼓授权登录请求，来鼓用户允许授权第三方应用后，来鼓会重定向到第三方网站，并且带上授权临时票据code参数；

通过code参数加上appId和appSecret等，通过API换取accessToken；

通过accessToken进行内嵌页面的访问，完成页面操作

获取accessToken时序图：

第一步：请求CODE

第三方使用网站应用授权登录前请注意已获取相应网页授权作用域（scope=oauth2_login），则可以通过在 PC 端打开以下链接： https://ai.laigu.com/oauth2/login?appId=APPID&redirectUri=redirectUri&responseType=code&scope=SCOPE&state=STATE 若提示“该链接无法访问”，请检查参数是否填写错误。
参数说明

授权请求参数说明

参数名	是否必须	说明
`appId`	是	应用唯一标识
`redirectUri`	是	请使用 `urlEncode` 对链接进行处理
`responseType`	是	填写 `code`
`scope`	是	应用授权作用域，拥有多个作用域用逗号（`,`）分隔，网页应用目前仅填写 `oauth2_login`
`state`	否	用于保持请求和回调的状态，授权请求后原样带回给第三方。该参数可用于防止 CSRF 攻击，建议第三方带上该参数，可设置为简单的随机数加 session 进行校验

返回说明

用户允许授权后，会返回code值，目前有效期10min，然后重定向到redirectUri的网址上，并且带上code和state参数
redirectUri?code=CODE&state=STATE
若用户禁止授权，则不会发生重定向。

请求示例

登录canvas网站应用 https://test.canvas.com/laigu/login.do 打开后，canvas会生成state参数，跳转到 https://open.laigu.com/oauth2/login?appid=testappid123&redirectUri=https%3A%2F%2Fpassport.canvas.com%2Flaigu%2Fcallback.do&responseType=code&scope=oauth_login&state=3d6be0a4035d839573b04816624a415e 来鼓用户输入用户名密码并且确认登录后，PC端会跳转到 https://test.canvas.com/laigu/callback.do?code=CODE&state=3d6be0a4035d839573b04816624a415e

第二步：通过code获取accessToken

通过code获取accessToken
详细请求信息参考接口：get access token

第三步：刷新accessToken有效期

详细请求信息参考接口：refresh access token

注意：
1、appSecret是应用接口使用密钥，泄漏后将可能导致应用数据泄漏、应用的用户数据泄漏等高风险后果；存储在客户端，极有可能被恶意窃取（如反编译获取appSecret）；
2、accessToken为用户授权第三方应用发起接口调用的凭证（相当于用户登录态），存储在客户端，可能出现恶意获取accessToken后导致的用户数据泄漏、用户来鼓相关接口功能被恶意发起等行为；
3、refreshToken为用户授权第三方应用的长效凭证，仅用于刷新accessToken，但泄漏后相当于accessToken泄漏，风险同上；
4、如无特别业务需求，建议开发者自行管理业务登录态并合理设置过期时间，减少用户重新授权登录次数，优化用户体验。
建议将secret、用户数据（如accessToken）放在 App 云端服务器，由云端中转接口调用请求。

登陆流程

调用 get login code 接口，获取到登陆使用的 OPEN_CODE ，然后使用 OPEN_CODE 访问来鼓登陆界面即可
示例：https://ai.laigu.com/login?openCode=OPEN_CODE

关于来鼓快速登录功能的说明#

准备工作#

授权流程说明#

第一步：请求CODE#

授权请求参数说明#

返回说明#

请求示例#

第二步：通过code获取accessToken#

第三步：刷新accessToken有效期#

登陆流程#