PC 客户端授权登录

使用知音楼授权登录功能并确认登录您的系统，在您的系统内获得正在访问用户的知音楼身份，而用户无需输入账户密码。

获取 appId 及 appSecret

联系知音楼的产品刘欣老师（邮箱:liuxin22@tal.com;工号:135373），创建用于免登过程中验证身份的 appId 及 appSecret

需提交字段	是否必填	说明
名称	必填	授权应用的名称
描述	必填	应用使用的场景
授权页面 LOGO 地址	必填	以 http 或 https 开头
回调域名	必填	应用回调的 scheme 地址，e.g. yach://

获取用户授权码

1. 客户端内通过 iframe 嵌入授权页面

   host: https://yach-work.zhiyinlou.com 正式环境

   host: https://yach-work-test.zhiyinlou.com 测试环境 (具备调试条件)

   <iframe width="100%" height="100%" frameborder="0" src="https://yach-work.zhiyinlou.com/login/qrcode/deskauth?appid=xxx&redirect_uri=yachtest%3A%2F%2Ftest.com%2FwinAuth%3Fextraparam%3Dtest"></iframe>
   

   参数

   参数	参数类型	必须	说明
   appid	String	是	扫码登录应用appid
   redirect_uri	String	是	scheme 地址，需要在自己的 pc 客户端中注册 scheme，授权页面会通过 scheme 与 pc 客户端通信**（要通过 encodeURIComponent 编码）**

2. 通过知音楼 App 扫码或者通过快速登录模式获取用户授权码

   

用户通过使用知音楼 App 扫码二维码或者通过快速登录模式（知音楼 pc 客户端唤醒并且登录状态下可以通过快速登录模式登录），此操作成功后，会跳转到 redirect_uri scheme地址，并向 redirect_uri 参数中追加用户授权码 loginTmpCode。

通过用户授权码获取临时授权码

host: https://yach-oapi.zhiyinlou.com 正式环境

host: https://yach-oapi-dev.zhiyinlou.com 开发环境 (具备调试条件)

host: https://yach-oapi-test.zhiyinlou.com 测试环境 (具备调试条件)

host: https://yach-oapi-pre.zhiyinlou.com 预发布环境

概述

名称	值
地址	/connect/oauth2/sns_authorize?appid=APPID&response_type=code&scope=snsapi_login&state=STATE&redirect_uri=REDIRECT_URI&loginTmpCode=loginTmpCode
请求方式	GET
参数	见【参数】
返回值	见【返回值】

参数

参数	参数类型	必须	说明
appid	String	是	扫码登录应用appid
redirect_uri	String	是	重定向地址，该地址使用域名需配置为appid对应的回调域名，回调域名是在获取appId及appSecret时填写。必填
state	String	是	用于防止重放攻击，开发者可以根据此信息来判断redirect_uri只能执行一次来避免重放攻击， 选填
response_type	String	是	固定为code，必填
scope	String	是	固定为snsapi_login，必填
loginTmpCode	String	是	通过js获取到的loginTmpCode，必填

此链接处理成功后，会302跳转到你goto参数指定的redirect_uri，并向url参数中追加临时授权码code及state两个参数。

e.g.

https://yach-oapi.zhiyinlou.com/connect/oauth2/sns_authorize?appid=APPID&response_type=code&scope=snsapi_login&state=STATE&redirect_uri=REDIRECT_URI&loginTmpCode=loginTmpCode

通过临时授权码获取授权用户的个人信息

host: https://yach-oapi.zhiyinlou.com 正式环境

host: https://yach-oapi-dev.zhiyinlou.com 开发环境 (具备调试条件)

host: https://yach-oapi-test.zhiyinlou.com 测试环境 (具备调试条件)

host: https://yach-oapi-pre.zhiyinlou.com 预发布环境

概述

名称	值
地址	/sns/getuserinfo_bycode
请求方式	POST
参数	见【参数】
返回值	见【返回值】

参数

参数	参数类型	必须	说明
tmp_auth_code	String	是	用户授权的临时授权码code，只能使用一次；在扫码后回调到设置的redirect_uri时会追加code参数

URL签名参数说明

参数	参数类型	必须	说明
accessKey	String	是	扫码应用appid
timestamp	String	是	当前时间戳，单位是毫秒
signature	String	是	通过扫码应用appSecret计算出来的签名值，签名计算方法

Signature 参数

签名算法为HmacSHA256，签名数据是当前时间戳timestamp，密钥是appId对应的appSecret计算出来的签名值。

发送HTTP请求时需要把signature进行urlEncode，如果您使用的是HTTP封装方法，请确保不要重复urlEncode。

签名计算代码示例（PHP）

    // 根据timestamp, appSecret计算签名值
    $s = hash_hmac('sha256', 'timestamp', 'appSecret', true);
    $signature = base64_encode($s);
    var_dump($signature);
    $urlencode_signature = urlencode($signature);
    var_dump($urlencode_signature);

签名例子参考:

• timestamp=1546084445901
• appSecret=testappSecret
• signature=HCbG3xNE3vzhO+u7qCUL1jS5hsu2n5r2cFhnTrtyDAE=
• urlEncode后的signature=HCbG3xNE3vzhO%2Bu7qCUL1jS5hsu2n5r2cFhnTrtyDAE%3D

【注意】正常情况下access_token有效期为7200秒，有效期内重复获取返回相同结果。

返回值

{
    "code": 200,
    "msg": "",
    "obj": {
        "user_info": {
            "nick": "晋刚",
            "userid": "Yach076429"
        }
    }
}

返回值说明：

参数	说明
code	返回码
msg	对返回码的文本描述内容
obj	返回数据
userid	员工在当前企业内的唯一标识