codewave-openclaw-installer 1.0.0

package/skills/smart-customer-service/docs/codewave/40./346/211/251/345/261/225/344/270/216/351/233/206/346/210/220/20./351/233/206/346/210/220/345/274/200/345/217/221/346/226/271/345/274/217/50./347/231/273/345/275/225/350/256/244/350/257/201/344/270/216/346/235/203/351/231/220/351/233/206/346/210/220/40./350/256/244/350/257/201/345/222/214/346/235/203/351/231/220/345/270/270/350/247/201/351/227/256/351/242/230/350/247/243/347/255/224.md

@@ -0,0 +1,106 @@
+# 认证和权限常见问题解答
+
+## 认证：
+
+### 1. CodeWave应用怎么使用统一认证中心登录页面
+
+答：应用前端存在全局事件逻辑（页面切换前会执行），会默认跳转到CodeWave应用的login页面，这里只需要清除login页面的所有逻辑。然后在login页面添加进入时事件，事件内容即是跳转到认证中心的页面。
+
+![0](../assets/dlyqxFAQ1.png)
+
+### 2. 新用户登录成功后跳转401页面提示无权限，如何设置
+
+答：目前应用开启认证后，会默认开启权限并绑定DEV-AdminRole角色，这里可以在登录流程中通过逻辑对用户进行添加角色，或者在权限管理页面进行授权当前角色。
+
+![0](../assets/dlyqxFAQ2.png)
+
+### 3. 系统上线时有没有什么方法批量同步用户用户中心数据
+
+答：目前应用还没支持主动去拉取用户信息，可以通过暴露接口的方式，由用户主动调用，然后入库。
+
+### 4. 应用集成OAuth2后挂载到门户的免登地址是什么？
+
+答：集成OAuth2的回调页面。
+
+### 5. 应用集成统一认证中心后退出登录怎么同时去注销统一认证中心的登录
+
+答：在需要注销的地方先调用lcap-auth依赖库下的removeToken，再调用认证中心的注销接口。
+
+![0](../assets/dlyqxFAQ3.png)
+
+### 6. 登录成功后使用前端组件跳转页面，发现获取不到用户信息，需要刷新下页面后才能获取
+
+答：使用js代码块进行跳转，示例为跳转至dashboard总览页。
+
+![0](../assets/dlyqxFAQ4.png)
+
+### 7. 退出登录调用removeToken还是退出失败
+
+答：
+
+* 检查是否复写了removeToken，复写逻辑可能存在问题；
+* 检查是否复写了createToken，并且将其放到同父域（domain）下了，如果是这种情况，还需要复写removeToken方法，并指定相同的域。需要注意的是，若复写removeToken后，退出登录需要手动调用removeToken。
+
+![0](../assets/dlyqxFAQ5.png)
+
+### 8. 使用默认的登录组件，输入正确的账号密码，但还是无法登录
+
+答：检查为authorization的cookie的domain是否设置的是当前域名，如果为父域名默认退出组件无法清除cookie，需要确认该cookie的来源是哪里。建议复写createToken时不要将cookie的名称设置为authorization。
+
+### 9. 未登录访问A页面，跳转到登录页面，想要登录成功后，回调到A页面
+
+答：当前登录成功后默认跳转到首页，如果想要跳转到登录前的页面，这里只需要三步。
+
+1. 在login页面定义入参url
+2. 修改拦截js，在跳转login的页面上添加url参数
+3. login页面登录成功跳转指定url
+
+![0](../assets/dlyqxFAQ6.png)
+
+![0](../assets/dlyqxFAQ7.png)
+
+### 10. 登录成功后，怎么拿到登录的用户信息？
+
+答: 登录成功后，可以从服务端的全局变量currentUser中拿到用户信息
+
+![0](../assets/rzqxFAQ_20240402_1505_8.png)
+
+## 权限：
+
+### 1. 复写LCAPGetUserResources后，成功获取到了权限中心用户有权限的资源列表，为什么前端页面还是跳转到了401页面（3.6版本已修复）
+
+答：由于历史原因需要将resourceType设置成ui，前端才能正常解析。
+
+![0](../assets/rzqxFAQ_20240402_1505_9.png)
+
+### 2. 为什么设置了角色，并且角色有这个页面的权限，访问页面还是跳转到401
+
+答：需要检查权限相关的表是否是用的是系统自带的LCAP实体，如果是自建的权限表，需要复写权限扩展逻辑。
+
+### 3. 复写了lcap_permission的getUserResources后，发布应用失败，显示空指针异常（3.7版本后已修复）
+
+问题描述：
+
+![0](../assets/rzqxFAQ_20240402_1505_10.png)
+
+解决方案：
+
+getUserResources的出参clientType必须要设置，这里任意赋值字符串即可。
+
+![0](../assets/rzqxFAQ_20240402_1505_11.png)
+<style>
+  h4 {
+    font-size: 18px;
+  }
+  h5 {
+    font-size: 16px;
+  }
+</style>
+<div style="text-align: right;font-size: 14px;">
+    <span style="color: rgb(78, 110, 142);">创建人：</span>
+    <span style="color: rgb(118, 118, 118);">亚琦</span>
+    <span style="color: rgb(78, 110, 142);margin: 0 0 0 40px;">更新时间：</span>
+    <span style="color: rgb(118, 118, 118);">2024年04月02日</span>
+</div>
+
+

package/skills/smart-customer-service/docs/codewave/40./346/211/251/345/261/225/344/270/216/351/233/206/346/210/220/20./351/233/206/346/210/220/345/274/200/345/217/221/346/226/271/345/274/217/50./347/231/273/345/275/225/350/256/244/350/257/201/344/270/216/346/235/203/351/231/220/351/233/206/346/210/220/50./345/270/270/350/247/201/347/231/273/345/275/225/350/256/244/350/257/201/346/241/210/344/276/213/10.CodeWave/345/272/224/347/224/250/346/216/245/345/205/245/351/222/211/351/222/211/347/231/273/345/275/225.md

@@ -0,0 +1,220 @@
+# CodeWave应用接入钉钉登录
+
+本文是通过手动创建页面和逻辑来集成钉钉登录，平台3.10及以上版本已推出一键导入的登录认证模板，提供开箱即用的登录认证功能，包含微信公众号关注登录、企业微信登录、钉钉登录、飞书登录、OAuth2.0协议登录、CAS协议等多种登录认证方式，无需手动实现钉钉登录，推荐使用认证模板来实现第三方登录：[权限认证模块配置](../60.IAM局部模版/010.权限认证模块配置.md)。
+
+## 1. 场景介绍
+
+实现为CodeWave应用接入钉钉登录，效果如下图所示。更多登录集成方式请参考[集成场景介绍](../020.集成场景介绍.md)。
+
+<img src="../assets/dingdinglogin_0320_1.png" alt="0" style="width:350px;border: 1px solid #ccc;" />
+<br>
+<img src="../assets/dingdinglogin_0320_2.png" alt="0" style="width:350px;border: 1px solid #ccc;" />
+
+## 2. 操作步骤
+
+### 2.1 时序图
+
+本案例的钉钉授权登录采用OAuth2.0流程，时序图如下。钉钉官方文档可参考：[获取登录用户的访问凭证 - 钉钉开放平台](https://open.dingtalk.com/document/isvapp/obtain-identity-credentials)
+
+<img src="../assets/dingdinglogin_0417_1.png" alt="0" style="width:700px;" />
+
+### 2.2 前置准备
+
+#### 2.2.1 创建钉钉应用
+
+进入[钉钉开放平台>应用开发](https://open-dev.dingtalk.com/fe/app#/corp/app)，创建钉钉应用。
+
+<img src="../assets/dingdinglogin_0320_4.png" alt="0" style="width:800px;border: 1px solid #ccc;" />
+
+#### 2.2.2 获取应用的Client ID、Client Secret
+
+进入钉钉应用，在凭证与基础信息下可查看该应用的Client ID、Client Secret
+
+<img src="../assets/dingdinglogin_0320_6.png" alt="0" style="width:800px;border: 1px solid #ccc;" />
+
+#### 2.2.3 添加重定向地址
+
+添加钉钉登录成功后要跳转的地址，本案例跳转的地址为CodeWave应用中创建的的callback页面，为该页面添加输入参数code。
+
+回调域名可分别添加开发环境和生产环境的域名。
+
+<img src="../assets/dingdinglogin_0320_8.png" alt="0" style="width:350px;border: 1px solid #ccc;" />
+
+<br>
+
+<img src="../assets/dingdinglogin_0320_7.png" alt="0" style="width:800px;border: 1px solid #ccc;" />
+
+#### 2.2.4 开启获取用户信息的权限
+
+> 调用钉钉登录相关的接口需要为钉钉应用申请部分权限，钉钉文档请参考：[添加接口调用权限 - 钉钉开放平台](https://open.dingtalk.com/document/orgapp/add-api-permission)
+
+进入钉钉应用的权限管理页面，根据以下配置添加接口调用权限。
+
+* 权限范围选择全部员工。
+* 表格分类中选择个人权限，申请个人手机号信息和通讯录个人信息读权限。
+
+其中个人手机号信息为可选项，开启后调用接口查询个人信息时可获取到手机号。
+
+<img src="../assets/dingdinglogin_0320_9.png" alt="0" style="width:800px;border: 1px solid #ccc;" />
+
+#### 2.2.5 添加自定义参数配置
+
+将Client ID、Client Secret、重定向地址添加到自定义参数配置，方便后续使用。
+
+注意，此处的**重定向地址必须进行URL编码**，否则调用钉钉接口可能失败，URL编码工具：<https://www.kjson.com/url/>
+
+Client Secret为隐私信息，请勿在前端调用。
+
+<img src="../assets/dingdinglogin_0320_10.png" alt="0" style="max-width: 80%;border: 1px solid #ccc;" />
+
+#### 2.2.6 添加获取token的API
+
+该接口根据code获取token，详细文档请参考：[获取用户token - 钉钉开放平台](https://open.dingtalk.com/document/isvapp/obtain-user-token)，将该API添加至平台。
+
+接口地址：<https://api.dingtalk.com/v1.0/oauth2/userAccessToken>
+
+请求类型：post
+
+请求头
+
+| 参数名          | 参数值              |
+| :----------- | :--------------- |
+| Content-Type | application/json |
+
+Body参数
+
+| 名称           | 类型     | 是否必填 | 描述                                                                                                                                      |
+| :----------- | :----- | :--- | :-------------------------------------------------------------------------------------------------------------------------------------- |
+| clientId     | String | 是    | 应用id。可使用扫码登录应用或者第三方个人小程序的appId。                                                                                                         |
+| clientSecret | String | 否    | 应用密钥。                                                                                                                                   |
+| code         | String | 否    | OAuth 2.0 临时授权码，根据[获取登录用户的访问凭证](https://open.dingtalk.com/document/orgapp/obtain-identity-credentials#p-90l-x49-kqq)内容，获取临时授权码authCode。 |
+| refreshToken | String | 否    | OAuth2.0刷新令牌，从返回结果里面获取。                                                                                                                 |
+| grantType    | String | 否    | 如果使用授权码换token，传authorization\_code。如果使用刷新token换用户token，传refresh\_token。                                                                 |
+
+返回参数
+
+| 名称           | 类型     | 描述                                                 |
+| :----------- | :----- | :------------------------------------------------- |
+| accessToken  | String | 生成的accessToken。                                    |
+| refreshToken | String | 生成的refresh\_token。可以使用此刷新token，定期的获取用户的accessToken |
+| expireIn     | Long   | 超时时间，单位秒。                                          |
+| corpId       | String | 所选企业corpId。                                        |
+
+#### 2.2.7 添加获取钉钉用户信息的API
+
+根据token获取钉钉登录用户信息，详细文档请参考：[获取用户通讯录个人信息 - 钉钉开放平台](https://open.dingtalk.com/document/isvapp/dingtalk-retrieve-user-information)，将该API添加至平台中。
+
+接口地址：<https://api.dingtalk.com/v1.0/contact/users/me>
+
+请求类型：get
+
+请求头：
+
+| 参数名                         | 参数值                     |
+| :-------------------------- | :---------------------- |
+| Content-Type                | application/json        |
+| x-acs-dingtalk-access-token | 获取token接口得到的accessToken |
+
+返回参数：
+
+| 名称        | 类型     | 描述          |
+| :-------- | :----- | :---------- |
+| nick      | String | 用户的钉钉昵称。    |
+| avatarUrl | String | 头像URL。      |
+| mobile    | String | 用户的手机号。     |
+| openId    | String | 用户的openId。  |
+| unionId   | String | 用户的unionId。 |
+| email     | String | 用户的个人邮箱。    |
+| stateCode | String | 手机号对应的国家号。  |
+
+### 2.3 制作登录页面
+
+制作钉钉登录的入口，本案例在login（登录页）的基础上添加钉钉登录按钮。
+
+<img src="../assets/dingdinglogin_0320_11.png" alt="0" style="border: 1px solid #ccc;" />
+
+为钉钉登录按钮添加点击事件，跳转到钉钉登录页面，该跳转链接的详细接口文档请参考：[获取登录用户的访问凭证 - 钉钉开放平台](https://open.dingtalk.com/document/isvapp/obtain-identity-credentials)
+
+本案例的网址路径如下，路径中的参数使用上文添加的自定义参数配置：
+```
+https://login.dingtalk.com/oauth2/auth?redirect_uri=【重定向地址】&response_type=code&client_id=【钉钉应用ID】&scope=openid&prompt=consent
+```
+
+<img src="../assets/dingdinglogin_0320_12.png" alt="0" style="border: 1px solid #ccc;" />
+
+### 2.4 添加钉钉登录的服务端逻辑
+
+添加服务端逻辑用于获取钉钉用户信息，逻辑添加输入参数code、输出参数result。
+
+1.调用获取token的接口。
+
+<img src="../assets/dingdinglogin_0320_13.png" alt="0" style="border: 1px solid #ccc;" />
+
+2.根据获取到的token调用获取钉钉用户信息的接口，判断接口调用的结果，不存在有效id则返回错误信息。
+
+<img src="../assets/dingdinglogin_0320_14.png" alt="0" style="border: 1px solid #ccc;" />
+
+3.在数据库中查询钉钉用户是否已入库，没有入库则创建该用户，已入库可选择更新用户信息。
+
+User的source字段用于标志该用户数据来自哪个用户源，可自行为枚举UserSourceEnum添加相应的枚举值，并在创建User时进行赋值。
+
+  <details>
+      <summary title="点击查看如何source字段如何配置" style="font-weight: bold; color: #679CF8; cursor: pointer;">
+          点击查看如何source字段如何配置
+          </summary>
+
+User实体的source字段数据类型为应用自带的枚举UserSourceEnum，该枚举默认有一个枚举值“普通登录”，可自行添加其他枚举值，例如钉钉登录、微信登录等，在创建User时对该字段进行赋值。
+
+<img src="../assets/dingdinglogin_0320_15.png" alt="0" style="border: 1px solid #ccc;" />
+
+ </details>
+
+<br>
+
+<img src="../assets/dingdinglogin_0320_16.png" alt="0" style="border: 1px solid #ccc;" />
+
+4.调用lcap\_auth依赖库的createToken逻辑创建token，输入参数的类型为lcap\_auth依赖库中的LCAPUser。
+
+> lcap_auth依赖库的相关内容可参考文档[lcap\_auth依赖库使用说明](../050.lcap_auth依赖库使用说明.md)。
+
+<img src="../assets/dingdinglogin_0320_17.png" alt="0" style="border: 1px solid #ccc;" />
+
+### 2.5 配置回调页面
+
+为回调页面添加进入时事件，进入时判断code是否有效，有效则调用服务端逻辑进行钉钉登录，根据逻辑输出参数判断登录是否成功，成功登录则跳转到自定义的页面。
+
+<img src="../assets/dingdinglogin_0320_18.png" alt="0" style="border: 1px solid #ccc;" />
+
+### 2.6 发布预览
+
+发布预览，测试效果。
+
+<img src="../assets/dingdinglogin_0320_19.gif" alt="0" style="max-width: 70%;border: 1px solid #ccc;" />
+
+## 3. demo下载
+
+点击下载本案例应用模板：[应用模板\_CodeWave应用接入钉钉登录\_1.0.0.zip](https://static-vusion.nos-eastchina1.126.net/tutorial/%E6%96%87%E6%A1%A3%E4%B8%AD%E5%BF%83%E9%99%84%E4%BB%B6/%E7%99%BB%E5%BD%95%E8%AE%A4%E8%AF%81%E4%B8%8E%E6%9D%83%E9%99%90%E9%9B%86%E6%88%90/%E9%92%89%E9%92%89%E7%99%BB%E5%BD%95/%E5%BA%94%E7%94%A8%E6%A8%A1%E6%9D%BF_%E4%BD%8E%E4%BB%A3%E7%A0%81%E5%BA%94%E7%94%A8%E6%8E%A5%E5%85%A5%E9%92%89%E9%92%89%E7%99%BB%E5%BD%95_1.0.0.zip)
+
+使用模板的注意事项：
+
+* 应自行在CodeWave平台创建钉钉相关API并在模板中重新调用。
+* 自定义参数配置替换成自己的实际参数。
+
+## 4. 常见问题
+
+### 4.1 登录时提示重定向URL错误
+
+进行钉钉登录时提示“重定向URL错误”，可能是没有在钉钉应用中添加当前的回调域名，请参照[添加重定向地址](#_2-2-3-添加重定向地址)章节为钉钉应用添加回调域名，也可能是因为在平台中输入的重定向URL没有经过URLencoding编码。
+
+<img src="../assets/dingdinglogin_0320_20.png" alt="0" style="width:550px;border: 1px solid #ccc;" />
+
+### 4.2 钉钉登录后一直停在回调页面
+
+钉钉登录后跳转到回调页面，一直停在回调页面没有成功登录CodeWave应用，可能是回调页面调用的服务端逻辑出现异常，例如钉钉接口调用失败，建议查看应用日志，或使用调试功能定位故障原因。
+
+<div style="text-align: right;font-size: 14px;">
+    <span style="color: rgb(78, 110, 142);">创建人：</span>
+    <span style="color: rgb(118, 118, 118);">老王</span>
+    <span style="color: rgb(78, 110, 142);margin: 0 0 0 40px;">更新时间：</span>
+    <span style="color: rgb(118, 118, 118);">2024年10月09日</span>
+</div>

package/skills/smart-customer-service/docs/codewave/40./346/211/251/345/261/225/344/270/216/351/233/206/346/210/220/20./351/233/206/346/210/220/345/274/200/345/217/221/346/226/271/345/274/217/50./347/231/273/345/275/225/350/256/244/350/257/201/344/270/216/346/235/203/351/231/220/351/233/206/346/210/220/50./345/270/270/350/247/201/347/231/273/345/275/225/350/256/244/350/257/201/346/241/210/344/276/213/20.CodeWave/345/272/224/347/224/250/346/216/245/345/205/245/344/274/201/344/270/232/345/276/256/344/277/241/347/231/273/345/275/225.md

@@ -0,0 +1,249 @@
+# CodeWave应用接入企业微信登录
+
+本文是通过手动创建页面和逻辑来集成企业微信登录，平台3.10及以上版本已推出一键导入的登录认证模板，提供开箱即用的登录认证功能，包含微信公众号关注登录、企业微信登录、钉钉登录、飞书登录、OAuth2.0协议登录、CAS协议等多种登录认证方式，无需手动实现企业微信登录，推荐使用认证模板来实现第三方登录：[权限认证模块配置](../60.IAM局部模版/010.权限认证模块配置.md)。
+
+## 1. 场景介绍
+
+实现为CodeWave应用接入微信登录,采用<strong>单体应用接入SSO（OAuth2.0）</strong>方式，更多登录集成方式请参考[集成场景介绍](../020.集成场景介绍.md)。
+
+<img src="../assets/didaimayingyongjieruqiyeweixindenglu_0416_1.png" style="width:400px;border: 1px solid rgb(204, 204, 204);" />
+
+<img src="../assets/didaimayingyongjieruqiyeweixindenglu_0416_2.png" style="width:400px;border: 1px solid #ccc;" />
+
+## 2. 操作步骤
+
+### 2.1 时序图
+
+本案例的微信授权登录采用OAuth2.0流程，时序图如下。微信官方文档可参考：[企业微信Web登录](https://developer.work.weixin.qq.com/document/path/98170)
+
+<img src="../assets/didaimayingyongjieruqiyeweixindenglu_0418_1.png" style="width:900px;border: 1px solid rgb(204, 204, 204);" />
+
+### 2.2 前置准备
+
+#### 2.2.1 创建企业微信应用
+
+在应用管理界面创建自建应用：[企业微信-应用管理](https://work.weixin.qq.com/wework_admin/frame#apps)
+
+<img src="../assets/didaimayingyongjieruqiyeweixindenglu_0416_4.png" style="max-width: 80%;border: 1px solid #ccc;" />
+
+#### 2.2.2 获取应用的AgentId和Secret
+
+创建应用后进入该应用，获取应用的AgentId和Secret，用于后续CodeWave开发中使用。
+
+<img src="../assets/didaimayingyongjieruqiyeweixindenglu_0416_5.png" style="max-width: 80%;border: 1px solid #ccc;" />
+
+#### 2.2.3 获取企业ID
+
+如图所示获取企业ID，用于后续CodeWave应用中使用。
+
+<img src="../assets/didaimayingyongjieruqiyeweixindenglu_0416_6.png" style="max-width: 80%;border: 1px solid #ccc;" />
+
+#### 2.2.4 添加授权回调域
+
+进入应用详情界面，添加企业微信授权登录的回调域名，即CodeWave应用的地址，使用企业微信登录时只能回调至该域名下的页面。
+
+填写域名时无需输入http://或https://，也无需输入页面路径，直接输入域名即可。
+
+<img src="../assets/didaimayingyongjieruqiyeweixindenglu_0416_7.png" style="max-width: 80%;border: 1px solid #ccc;" />
+
+<img src="../assets/didaimayingyongjieruqiyeweixindenglu_0416_8.png" style="max-width: 80%;border: 1px solid #ccc;" />
+
+#### 2.2.5 设置可信域名
+
+在应用详情界面选择“网页授权及JS-SDK”。
+
+<img src="../assets/didaimayingyongjieruqiyeweixindenglu_0416_9.png" style="max-width: 80%;border: 1px solid #ccc;" />
+
+可信域名输入回调域名。
+
+点击下方“申请校验域名”按钮后，下载txt文件。
+
+此时点击确定会提示“域名所有权检验不通过”，需要完成下文的上传txt步骤后再点击确定。
+
+<img src="../assets/didaimayingyongjieruqiyeweixindenglu_0416_10.png" style="width:800px;border: 1px solid #ccc;" />
+
+在CodeWave应用中选择H5端的“发布设置”，没有H5端时可以添加一个H5端再进行该操作。
+
+<img src="../assets/didaimayingyongjieruqiyeweixindenglu_0416_11.png" style="width:400px;border: 1px solid #ccc;" />
+
+在移动端发布设置中上传下载好的txt文件，点击保存，需要发布应用后才生效。
+
+<img src="../assets/didaimayingyongjieruqiyeweixindenglu_0416_12.png" style="width:400px;border: 1px solid #ccc;" />
+
+此时设置可信域名可以点击确定按钮完成保存。
+
+<img src="../assets/didaimayingyongjieruqiyeweixindenglu_0416_13.png" style="width:600px;border: 1px solid #ccc;" />
+
+#### 2.2.6 配置可信IP
+
+只有在企业管理后台中配置好的IP才可调用后需要用到的微信相关接口，在应用详情界面选择“企业可信IP”，输入CodeWave应用的服务器IP地址。需要进行接口的调试时也要配置本机IP地址。
+
+<img src="../assets/didaimayingyongjieruqiyeweixindenglu_0416_14.png" style="width:800px;border: 1px solid #ccc;" />
+
+#### 2.2.7 添加获取access_token的API
+
+该接口根据企业ID和应用secret获取access_token，详细的接口文档请参考：[获取access_token - 企业微信开发者中心](https://developer.work.weixin.qq.com/document/path/91039)，将该API添加至平台中。
+
+> 获取access_token是调用企业微信API接口的第一步，相当于创建了一个登录凭证，其它的业务API接口，都需要依赖于access_token来鉴权调用者身份。
+> 
+> 在调用该接口时，开发者需要缓存access_token，用于后续接口的调用。不能频繁调用获取token接口，否则会受到频率拦截。
+
+接口地址：`https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=ID&corpsecret=SECRET`
+
+请求类型：get（https）
+
+query参数：
+
+| 参数         | 必须 | 说明           |
+| :--------- | :- | :----------- |
+| corpid     | 是  | 企业ID，获取方式参考：[术语说明-corpid](https://developer.work.weixin.qq.com/document/path/90665#corpid) |
+| corpsecret | 是  | 应用的凭证密钥，**注意应用需要是启用状态**，获取方式参考：[术语说明-secret](https://developer.work.weixin.qq.com/document/path/90665#secret)     |
+
+返回参数（json）
+
+| 参数            | 说明                    |
+| :------------ | :-------------------- |
+| errcode       | 出错返回码，为0表示成功，非0表示调用失败 |
+| errmsg        | 返回码提示语                |
+| access_token | 获取到的凭证，最长为512字节       |
+| expires_in   | 凭证的有效时间（秒）            |
+
+#### 2.2.8 添加获取微信用户信息的API
+
+根据access_token和code获取微信登录用户信息，详细的接口文档请参考：[获取访问用户身份 - 企业微信开发者中心](https://developer.work.weixin.qq.com/document/path/91023)，将该API添加至平台中。
+
+接口地址：`https://qyapi.weixin.qq.com/cgi-bin/auth/getuserinfo?access_token=ACCESS_TOKEN&code=CODE`
+
+请求类型：get（https）
+
+query参数：
+
+| 参数            | 必须 | 说明                                                                       |
+| :------------ | :- | :----------------------------------------------------------------------- |
+| access_token | 是  | [调用接口凭证](https://developer.work.weixin.qq.com/document/path/91023#15074) |
+| code          | 是  | 通过成员授权获取到的code，最大为512字节。每次成员授权带上的code将不一样，code只能使用一次，5分钟未被使用自动过期。        |
+
+返回参数（json）：
+
+| 参数           | 说明                             |
+| :----------- | :----------------------------- |
+| errcode      | 返回码                            |
+| errmsg       | 对返回码的文本描述内容                    |
+| userid       | 成员UserID。若需要获得用户详情信息，可调用通讯录接口： |
+| user_ticket | 成员票据，最大为512字节，有效期为1800s。       |
+
+### 2.3 添加回调页面
+
+添加一个页面并添加string类型的输入参数code，用于微信登录完成后进行回调的重定向地址，即微信登录成功后会携带code参数跳转到这个页面。
+
+<img src="../assets/didaimayingyongjieruqiyeweixindenglu_0416_15.png" style="border: 1px solid #ccc;" />
+
+### 2.4 添加自定义参数配置
+
+将AgentId、Secret、重定向地址、企业ID添加到自定义参数配置，方便后续使用。
+
+重定向地址为上文创建的回调页面的链接地址，注意，此处的重定向地址必须进行URL编码，URL编码工具：[https://www.kjson.com/url/](https://www.kjson.com/url/)
+
+Secret为隐私信息，请勿在前端调用，防止泄漏。
+
+<img src="../assets/didaimayingyongjieruqiyeweixindenglu_0416_16.png" style="max-width: 80%;border: 1px solid #ccc;" />
+
+### 2.5 制作登录页面
+
+制作微信登录的入口，本案例在login（登录页）的基础上添加微信登录按钮。
+
+<img src="../assets/didaimayingyongjieruqiyeweixindenglu_0416_17.png" style="border: 1px solid #ccc;" />
+
+为微信登录按钮添加点击事件，跳转到微信登录页面，该跳转链接的详细接口文档请参考：[构造企业微信登录链接](https://developer.work.weixin.qq.com/document/path/98171#2-%E6%9E%84%E9%80%A0%E4%BC%81%E4%B8%9A%E5%BE%AE%E4%BF%A1%E7%99%BB%E5%BD%95%E9%93%BE%E6%8E%A5)
+
+本案例的网址路径如下，路径中的参数使用上文添加的自定义参数配置：
+
+```https://login.work.weixin.qq.com/wwlogin/sso/login?login_type=CorpApp&agentid=【应用的AgentId】&appid=&【企业id】redirect_uri=【重定向地址】```
+
+<img src="../assets/didaimayingyongjieruqiyeweixindenglu_0416_18.png" style="border: 1px solid #ccc;" />
+
+### 2.6 添加微信登录的服务端逻辑
+
+添加服务端逻辑用于获取微信用户信息，逻辑添加输入参数code、输出参数result。
+
+1. 调用获取access_token的接口。（平台支持使用企微应用连接器获取access_token，该连接器的使用可参考：[企微应用连接器](../../20.连接器集成/40.连接器汇总/40.企微应用连接器.md)）
+
+    > 在实际项目中调用该接口时，需要缓存access_token用于后续接口的调用。不能频繁调用获取token接口，否则会受到频率拦截，详细说明请参考该接口的文档。
+
+    <img src="../assets/didaimayingyongjieruqiyeweixindenglu_0416_19.png" style="width:800px;border: 1px solid #ccc;" />
+
+2. 根据获取到的token调用获取微信用户信息的接口。
+
+    <img src="../assets/didaimayingyongjieruqiyeweixindenglu_0416_20.png" style="width:800px;border: 1px solid #ccc;" />
+
+3. 判断接口调用的结果，没有成功获取到微信用户信息则返回错误信息。
+
+    <img src="../assets/didaimayingyongjieruqiyeweixindenglu_0416_21.png" style="width:900px;border: 1px solid #ccc;" />
+
+4. 成功获取到微信用户信息时，在数据库中查询微信用户是否已入库，没有入库则创建该用户。
+
+    <img src="../assets/didaimayingyongjieruqiyeweixindenglu_0416_22.png" style="border: 1px solid #ccc;" />
+
+    User的source字段用于标志该用户数据来自哪个用户源，可自行为枚举UserSourceEnum添加相应的枚举值，并在创建User时进行赋值。
+
+    <details>
+      <summary title="点击查看如何source字段如何配置" style="font-weight: bold; color: #679CF8; cursor: pointer;">
+          点击查看如何source字段如何配置
+          </summary>
+
+    User实体的source字段数据类型为应用自带的枚举UserSourceEnum，该枚举默认有一个枚举值“普通登录”，可自行添加其他枚举值，例如钉钉登录、微信登录等，在创建User时对该字段进行赋值。
+
+    <img src="../assets/didaimayingyongjieruqiyeweixindenglu_0416_23.png" style="border: 1px solid #ccc;" />
+
+    </details>
+
+5. （成功获取微信用户信息时）调用lcap_auth依赖库的createToken逻辑创建token，并为输出参数赋值表示微信登录成功。
+
+    > createToken逻辑的输入参数的类型为lcap_auth依赖库中的LCAPUser数据结构，lcap_auth依赖库的相关内容可参考文档[lcap_auth依赖库使用说明](../050.lcap_auth依赖库使用说明.md)。
+
+    <img src="../assets/didaimayingyongjieruqiyeweixindenglu_0416_24.png" style="border: 1px solid #ccc;" />
+
+### 2.7 配置回调页面
+
+为回调页面添加进入时事件，进入时判断code是否有值，有值则调用服务端逻辑进行微信登录，根据逻辑输出参数判断登录是否成功，成功登录则跳转到自定义的页面。
+
+<img src="../assets/didaimayingyongjieruqiyeweixindenglu_0416_25.png" style="border: 1px solid #ccc;" />
+
+### 2.8 发布预览
+
+发布预览，测试效果。
+
+<img src="../assets/didaimayingyongjieruqiyeweixindenglu_0416_26.gif" style="width:800px;border: 1px solid #ccc;" />
+
+## 3. demo下载
+
+下载本案例应用模板：[应用模板_CodeWave应用接入企业微信登录_1.0.0.zip](https://static-vusion.nos-eastchina1.126.net/tutorial/%E6%96%87%E6%A1%A3%E4%B8%AD%E5%BF%83%E9%99%84%E4%BB%B6/%E7%99%BB%E5%BD%95%E8%AE%A4%E8%AF%81%E4%B8%8E%E6%9D%83%E9%99%90%E9%9B%86%E6%88%90/%E4%BC%81%E4%B8%9A%E5%BE%AE%E4%BF%A1%E7%99%BB%E5%BD%95/%E5%BA%94%E7%94%A8%E6%A8%A1%E6%9D%BF_%E4%BD%8E%E4%BB%A3%E7%A0%81%E5%BA%94%E7%94%A8%E6%8E%A5%E5%85%A5%E4%BC%81%E4%B8%9A%E5%BE%AE%E4%BF%A1%E7%99%BB%E5%BD%95_1.0.0.zip)
+
+使用模板的注意事项：
+
+* 应自行在CodeWave平台创建企微相关API并在模板中重新调用。
+* 自定义参数配置替换成自己的实际参数。
+
+## 4. 常见问题
+
+### 4.1 微信登录后一直停在回调页面
+
+微信登录后跳转到回调页面，一直停在回调页面没有成功登录CodeWave应用，可能是回调页面调用的服务端逻辑出现异常，例如微信接口调用失败，建议查看应用日志，并使用[逻辑调试](../../../../20.应用开发/15.逻辑功能实现/45.逻辑编辑/80.逻辑调试.md)功能定位故障原因。
+
+### 4.2 redirect_uri与配置的授权完成回调域名不一致
+
+微信扫码登录时显示以下错误，这是由于当前应用的域名和企微应用中设置的域名不一致。
+
+<img src="../assets/jieruqiyeweixinshehuihuadenglu_202501021423_1.png" style="width:400px;" />
+
+进入企业微信应用管理，需要确保**网页授权及JS-SDK**和**企业微信授权登录**中的域名和当前应用的域名是一致的。
+
+<img src="../assets/jieruqiyeweixinshehuihuadenglu_202501021423_2.png" style="width:400px;" />
+
+
+<div style="text-align: right;font-size: 14px;">
+    <span style="color: rgb(78, 110, 142);">创建人：</span>
+    <span style="color: rgb(118, 118, 118);">老王</span>
+    <span style="color: rgb(78, 110, 142);margin: 0 0 0 40px;">更新时间：</span>
+    <span style="color: rgb(118, 118, 118);">2025年01月02日</span>
+</div>