企业微信登录流程
实现方式
使用js-sdk
使用 @wecom/jssdk 初始化企业微信登录组件。
为了满足网站定制化的需求，我们支持将企业微信登录组件内嵌到开发者的网站中。用户使用企业微信登录授权后，登录组件将 auth code 返回给网站。
企业微信登录组件主要用途：网站希望用户在网站内就能完成登录，无需跳转到企业微信域下登录后再返回，提升登录的流畅性与成功率。
使用：
使用企业微信 JS-SDK可查看官方文档，@wecom/jssdk >=1.3.1；
不再详述本篇主要介绍另一种实现方式。
效果如下：
扫码后就可获取到auth_code。
构造登录链接
同时支持通过构造链接的方式，在新窗口中打开企业微信登录页面，用户使用企业微信登录授权后通过将携带 auth code 跳转至指定的 redirect_uri。
开发流程
这里是我使用构造登录链接的开发流程。
登录授权
服务商登录授权
位置：服务商后台【开发配置】->【登录授权】。
登录授权与之前配置的应用指令回调和数据回调配置相同；但是不要使用同一个路由和方法。
登录授权回调解析
这里需要处理的是指令回调url的get和post处理响应。
Get回调处理把回调内容进行解密后返回给微信服务器，表示正确接收到回调。
Post回调处理接收登录授权各种事件回调的解析和处理：目前主要处理登录授权的ticket解密和保存。
控制器端
可以设置为同一入口，通过请求方法的不同，进行分别处理。
代码如下：
public function companyWxNotify(){ $all = request()->all(); writeRecordLog('companyWechat.log', '数据回调' . request()->method()); writeRecordLog('companyWechat.log', var_export($all, true)); if (request()->isMethod('POST')) { $msg_signature = request()->input('msg_signature'); $timeStamp = request()->input('timestamp'); $nonce = request()->input('nonce'); // post请求的密文数据 $sReqData = file_get_contents('php://input'); echo $this->wxService->notifyPOST($msg_signature, $timeStamp, $nonce, $sReqData); } else { // 获取参数 $msg_signature = request()->input('msg_signature'); $timeStamp = request()->input('timestamp'); $nonce = request()->input('nonce'); $echoStr = request()->input('echostr'); echo $this->wxService->callbackGET($msg_signature, $timeStamp, $nonce, $echoStr); } die();}
业务层
Get回调处理把回调内容进行解密后返回给微信服务器，表示正确接收到回调。
Post回调处理接收登录授权各种事件回调的解析和处理：
目前主要处理登录授权的ticket解密和保存。
代码如下：
/** * 企业微信GET回调处理（URL地址校验） * @param $sVerifyMsgSig * @param $sVerifyTimeStamp * @param $sVerifyNonce * @param $sVerifyEchoStr * @return string */public function callbackGET($sVerifyMsgSig, $sVerifyTimeStamp, $sVerifyNonce, $sVerifyEchoStr){ $sVerifyEchoStr = str_replace(" ", "+", $sVerifyEchoStr); $wxcpt = new \WXBizMsgCrypt(‘Token’, ‘EncodingAESKey’, ‘通用开发参数-CorpID’); // 调用验证函数 $sEchoStr = ""; $errCode = $wxcpt->VerifyURL($sVerifyMsgSig, $sVerifyTimeStamp, $sVerifyNonce, $sVerifyEchoStr, $sEchoStr); writeRecordLog('companyWechat.log', $sEchoStr); if ($errCode == 0) { return $sEchoStr; } else { return "ERR: " . $errCode; }}/** * 企业微信-登录授权post回调解析 * @param $sReqMsgSig * @param $sReqTimeStamp * @param $sReqNonce * @param $sReqData * @return string */public function notifyPOST($sReqMsgSig, $sReqTimeStamp, $sReqNonce, $sReqData){ try { $sMsg = ""; // 解析之后的明文 $wxcpt = new \WXBizMsgCrypt(‘登录授权token’, ‘登录授权EncodingAESKey’, ‘登录授权SuiteID’); $errCode = $wxcpt->DecryptMsg($sReqMsgSig, $sReqTimeStamp, $sReqNonce, $sReqData, $sMsg); if ($errCode == 0) { // 解密成功，sMsg即为xml格式的明文 writeRecordLog('companyWechat.log', "解密成功：\r\n" . var_export($sMsg, true)); // TODO: 对明文的处理 // 解析该xml字符串，利用simpleXML libxml_disable_entity_loader(true); //禁止xml实体解析，防止xml注入 $xml = simplexml_load_string($sMsg, 'SimpleXMLElement', LIBXML_NOCDATA); switch ($xml->InfoType) { case 'suite_ticket': // 存储suite_ticket $log_desc = '登录授权-存储suite_ticket：' . $xml->SuiteTicket; self::$redisWechat->setLoginTicket($xml->SuiteTicket); break; default: $log_desc = '未知的类型:' . $xml->InfoType; break; } writeRecordLog('companyWechat.log', '解析日志：' . $log_desc); return 'success'; } else { writeRecordLog('companyWechat.log', "ERR: " . $errCode . "\r\n"); return "ERR: " . $errCode . "\r\n"; } } catch (\Exception $e) { logUnit($e, 'wx_callback.log'); return 'success'; }}
构造企业微信登录链接
同时支持通过构造链接的方式，在新窗口中打开企业微信登录页面，用户使用企业微信登录授权后通过将携带 auth code 跳转至指定的 redirect_uri 。
请求地址
企业微信
参数说明
| 参数名 | 类型 | 必填 | 说明 |
| login_type | string | 是 | 登录类型。 ServiceApp：服务商登录；CorpApp：企业自建/代开发应用登录。 |
| appid | string | 是 | 第三方登录时填登录授权 SuiteID |
| agentid | string | 否 | 企业自建应用/服务商代开发应用 AgentID，当login_type=CorpApp时填写 |
| redirect_uri | string | 是 | 登录成功重定向 url 需进行 URLEncode |
| state | string | 否 | 登录 state 用于保持请求和回调的状态，授权请求后原样带回给企业。该参数可用于防止CSRF 攻击（跨站请求伪造攻击），建议带上该参数，可设置为简单的随机数加 session 进行校验 需进行 URLEncode |
| lang | string | 否 | 语言类型。zh：中文；en：英文。 |
返回说明
用户允许授权后，将会重定向到 redirect_uri 的网址上，并且在地址栏带上 code 和 state 参数可通过返回链接获取code。
示例
首先构造web登录链接，之后扫码同意登录；回调到设置的路由地址，并携带授权code。
代码如下：
/** * 测试登录授权-构造企业微信登录链接 */public function createLoginUrl(){ $backUrl = getSolveUrl('/api/getLoginCode'); $url = "https://login.work.weixin.qq.com/wwlogin/sso/login?login_type=ServiceApp&appid=登录授权SuiteID&redirect_uri={$backUrl}&state=STATE"; echo '<a href="' . $url . '">点击获取code</a>';}/** * 获取企业微信回调信息 */public function getLoginCode(){ print_r(request()->input());}
登录流程模拟
1.首先访问登录链接
2.点击后出现授权二维码
3.同意登录获取授权code
企业微信扫码同意登录后，跳转至设置好路径，获取授权code。
4.获取用户身份信息实现登录
通过授权code获取登录用户身份信息然后再跟自定义网站的账号信息绑定，实现登录。
获取登录用户身份
通过授权code获取登录用户身份。
请求方式
GET（HTTPS）
请求地址
https://qyapi.weixin.qq.com/cgi-bin/service/auth/getuserinfo3rd?suite_access_token=SUITE_ACCESS_TOKEN&code=CODE
参数说明
| 参数 | 必须 | 说明 |
| suite_access_token | 是 | 服务商登录授权SuiteId对应的suite_access_token，参见“获取第三方应用凭证” 。不允许代开发自建应用调用。代开发自建应用获取用户身份参考“获取访问用户身份” |
| code | 是 | 通过成员授权获取到的code，最大为512字节。每次成员授权带上的code将不一样，code只能使用一次，5分钟未被使用自动过期。 |
业务代码
获取access_token加上前端传递的code去获取登录用户信息。
代码如下：
public function loginAccessToken(){ $url = "https://qyapi.weixin.qq.com/cgi-bin/service/get_suite_token"; $params = json([ 'suite_id' => ‘登录授权suiteId’, 'suite_secret' => ‘登录授权secret’, 'suite_ticket' => self::$redisWechat->getLoginTicket() ]); $info = $this->linkCurl($url, 'POST', $params); $res = djson($info); if (isset($res['errcode'])) { return toFail('error', $res); } $access_token = $res['suite_access_token']; return toSuccess('success', [ 'access_token' => $access_token ]);}/** * 请求接口返回内容 * @param $url : 请求的URL地址 * @param $method : 请求方式POST|GET * @param bool $params : 请求的参数 * @param bool $header : 请求头 * @return bool|string */protected function linkCurl($url, $method, $params = false, $header = false){ $ch = curl_init(); curl_setopt($ch, CURLOPT_CUSTOMREQUEST, $method); curl_setopt($ch, CURLOPT_URL, $url); //curl_setopt($ch, CURLOPT_HTTPHEADER, $header); curl_setopt($ch, CURLOPT_FAILONERROR, false); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); if (strpos("$" . $url, "https://") == 1) { curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false); } curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 60); curl_setopt($ch, CURLOPT_TIMEOUT, 60); if ($method == "POST") { curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_POSTFIELDS, $params); } else if ($params) { curl_setopt($ch, CURLOPT_URL, $url . '?' . http_build_query($params)); } $response = curl_exec($ch); if ($response === FALSE) return false; curl_close($ch); return $response;}/** * 获取企业微信用户信息 * @param $code * @return array|mixed */public function getWxUserInfo($code,){ if (empty($code)) { return toFail('请输入code参数！'); } $get_access_token = $this->loginAccessToken(); if ($get_access_token['status'] != 1) { return $get_access_token; } $access_token = $get_access_token['data']['access_token']; $url = "https://qyapi.weixin.qq.com/cgi-bin/service/auth/getuserinfo3rd?suite_access_token={$access_token}&code={$code}"; $info = $this->linkCurl($url, 'GET'); $res = djson($info); if ($res['errcode'] != 0) { return toFail($res['errmsg'], $res); } return toSuccess('success', $res);}
返回参数说明
| 参数 | 说明 |
| errcode | 返回码 |
| errmsg | 对返回码的文本描述内容 |
| corpid | 用户所属企业的corpid |
| userid | 用户在企业内的UserID，如果该企业与第三方应用没有授权关系时，返回密文UserId，有授权关系时，按照升级后的ID策略返回明文或密文 |
| open_userid | 全局唯一。对于同一个服务商，不同应用获取到企业内同一个成员的open_userid是相同的，最多64个字节。仅第三方应用可获取 |
注意：返回与网页授权登录内容相同，只是获取方式为登录授权的参数。
总结
企业微信web登录使用构建授权登录链接实现的全过程。