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/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/30.CodeWave/345/272/224/347/224/250/346/216/245/345/205/245/351/243/236/344/271/246/347/231/273/345/275/225.md

@@ -0,0 +1,251 @@
+# CodeWave应用接入飞书登录
+
+本文是通过手动创建页面和逻辑来集成飞书登录，平台3.10及以上版本已推出一键导入的登录认证模板，提供开箱即用的登录认证功能，包含微信公众号关注登录、企业微信登录、钉钉登录、飞书登录、OAuth2.0协议登录、CAS协议等多种登录认证方式，无需手动实现飞书登录，推荐使用认证模板来实现第三方登录：[权限认证模块配置](../60.IAM局部模版/010.权限认证模块配置.md)。
+
+## 1.场景介绍
+
+实现为CodeWave应用接入飞书登录，效果如下图所示。更多登录集成方式请参考[集成场景介绍](../020.集成场景介绍.md)。
+
+<img src="../assets/didaimayingyongjierufeishudenglu_0417_1.png" style="width:400px;border: 1px solid #ccc;" />
+
+<img src="../assets/didaimayingyongjierufeishudenglu_0417_2.png" style="width:400px;border: 1px solid #ccc;" />
+
+## 2.操作步骤
+
+### 2.1时序图
+
+本案例的飞书授权登录的时序图如下。飞书官方文档可参考：[登录流程概述 - 飞书开放平台](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/authen-v1/login-overview)
+
+<img src="../assets/didaimayingyongjierufeishudenglu_0417_3.png" style="width:900px;border: 1px solid #ccc;" />
+
+### 2.2前置准备
+
+#### 2.2.1 创建企业自建应用
+
+在飞书开放平台中创建企业自建应用：[飞书开放平台 - 开发者后台 - 企业自建应用](https://open.feishu.cn/app)。
+
+<img src="../assets/didaimayingyongjierufeishudenglu_0417_4.png" style="border: 1px solid #ccc;" />
+
+#### 2.2.2 获取AppID和AppSecret
+
+在飞书自建应用的应用详情界面获取AppID和AppSecret，用于后续在CodeWave应用中使用。
+
+<img src="../assets/didaimayingyongjierufeishudenglu_0417_5.png" style="border: 1px solid #ccc;" />
+
+#### 2.2.3 配置重定向地址
+
+1\. 在CodeWave应用中创建一个页面并添加string类型的输入参数code，用于飞书登录回调，即飞书登录成功后会跳转到该页面并携带code参数。
+
+<img src="../assets/didaimayingyongjierufeishudenglu_0417_6.png" style="width:400px;border: 1px solid #ccc;" />
+
+2.在飞书应用详情界面选择“安全设置”，添加重定向URL，链接内容为上文创建的回调页面地址。
+
+<img src="../assets/didaimayingyongjierufeishudenglu_0417_7.png" style="border: 1px solid #ccc;" />
+
+#### 2.2.4 发布应用
+
+对应用中的配置做出修改后，需要发布版本才会生效。
+
+如图所示，在应用详情界面选择“版本管理与发布”，输入应用版本号和更新说明，配置“可用范围”，即组织中哪些用户可以使用该应用，保存并选择线上发布即可。
+
+<img src="../assets/didaimayingyongjierufeishudenglu_0417_8.png" style="border: 1px solid #ccc;" />
+
+#### 2.2.5 添加获取AppAccessToken的接口
+
+该接口根据AppID和AppSecret获取AppAccessToken，需要将该接口添加为平台可用的API，后续将在CodeWave应用中调用。官方文档请参考：[自建应用获取 app_access_token](https://open.feishu.cn/document/server-docs/authentication-management/access-token/app_access_token_internal)
+
+接口地址：<https://open.feishu.cn/open-apis/auth/v3/app_access_token/internal>
+
+请求方式：post
+
+请求头
+
+| 名称           | 类型     | 必填 | 描述                                    |
+| :----------- | :----- | :- | :------------------------------------ |
+| Content-Type | string | 是  | 固定值："application/json; charset=utf-8" |
+
+请求体
+
+| 名称          | 类型     | 必填 | 描述                                                                                                                           |
+| :---------- | :----- | :- | :--------------------------------------------------------------------------------------------------------------------------- |
+| app_id     | string | 是  | 应用唯一标识，创建应用后获得。有关app_id 的详细介绍。请参考[通用参数](https://open.feishu.cn/document/ukTMukTMukTM/uYTM5UjL2ETO14iNxkTN/terminology)介绍    |
+| app_secret | string | 是  | 应用秘钥，创建应用后获得。有关 app_secret 的详细介绍，请参考[通用参数](https://open.feishu.cn/document/ukTMukTMukTM/uYTM5UjL2ETO14iNxkTN/terminology)介绍 |
+
+响应体（json）
+
+| 名称                 | 类型     | 描述                            |
+| :----------------- | :----- | :---------------------------- |
+| code               | int    | 错误码，非 0 取值表示失败                |
+| msg                | string | 错误描述                          |
+| app_access_token | string | 应用访问凭证                        |
+| expire             | int    | app_access_token 的过期时间，单位为秒 |
+
+#### 2.2.6 添加获取UserAccessToken的接口
+
+该接口根据app_access_token和code获取UserAccessToken，需要将该接口添加为平台可用的API，后续将在CodeWave应用中调用。官方文档请参考：[获取 user_access_token](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/authen-v1/oidc-access_token/create)
+
+接口地址：<https://open.feishu.cn/open-apis/authen/v1/oidc/access_token>
+
+请求方式：post
+
+请求头
+
+| 名称            | 类型     | 必填 | 描述                                    |
+| :------------ | :----- | :- | :------------------------------------ |
+| Authorization | string | 是  | app_access_token                    |
+| Content-Type  | string | 是  | 固定值："application/json; charset=utf-8" |
+
+请求体
+
+| 名称          | 类型     | 必填 | 描述                                                                                                      |
+| :---------- | :----- | :- | :------------------------------------------------------------------------------------------------------ |
+| grant_type | string | 是  | 授权类型，固定值                                                                                                |
+| code        | string | 是  | 登录预授权码，调用[登录预授权码](https://open.feishu.cn/document/common-capabilities/sso/api/obtain-oauth-code) 获取code |
+
+响应体（json）
+
+| 名称收起子列表                   | 类型          | 描述                                                        |
+| :------------------------ | :---------- | :-------------------------------------------------------- |
+| code                      | int         | 错误码，非 0 表示失败                                              |
+| msg                       | string      | 错误描述                                                      |
+| data                      | token_info | -                                                         |
+| data.access_token        | string      | 字段access_token即user_access_token，用于获取用户资源和访问某些open api |
+| data.refresh_token       | string      | 刷新user_access_token时使用的 refresh_token                  |
+| data.token_type          | string      | token 类型，固定值                                              |
+| data.expires_in          | int         | user_access_token有效期，单位: 秒，有效时间两个小时左右，需要以返回结果为准         |
+| data.refresh_expires_in | int         | refresh_token有效期，单位: 秒，一般是30天左右，需要以返回结果为准                |
+| data.scope                | string      | 用户授予app的权限全集                                              |
+
+#### 2.2.7 添加获取飞书用户信息的接口
+
+该接口根据user_access_token获取飞书用户登录信息，需要将该接口添加为平台可用的API，后续将在CodeWave应用中调用。官方文档请参考：[获取登录用户信息](https://open.feishu.cn/document/server-docs/authentication-management/login-state-management/get?appId=cli_a56037451c31100b)。
+
+注意：参考下方响应体列表中的data数据，用户信息中的部分字段需要自建应用开通相关权限，开通权限请参考：[申请 API 权限 - 飞书开放平台](https://open.feishu.cn/document/server-docs/application-scope/introduction)。
+
+接口地址：<https://open.feishu.cn/open-apis/authen/v1/user_info>
+
+请求方式：get
+
+请求头
+
+| 名称            | 类型     | 必填 | 描述                  |
+| :------------ | :----- | :- | :------------------ |
+| Authorization | string | 是  | user_access_token |
+
+响应体(JSON)
+
+| 名称收起子列表                | 类型         | 描述                                          |
+| :--------------------- | :--------- | :------------------------------------------ |
+| code                   | int        | 错误码，非 0 表示失败                                |
+| msg                    | string     | 错误描述                                        |
+| data                   | user_info | -                                           |
+| data.name              | string     | 用户姓名                                        |
+| data.en_name          | string     | 用户英文名称                                      |
+| data.avatar_url       | string     | 用户头像                                        |
+| data.avatar_thumb     | string     | 用户头像 72x72                                  |
+| data.avatar_middle    | string     | 用户头像 240x240                                |
+| data.avatar_big       | string     | 用户头像 640x640                                |
+| data.open_id          | string     | 用户在应用内的唯一标识                                 |
+| data.union_id         | string     | 用户对ISV的唯一标识，对于同一个ISV，用户在其名下所有应用的union_id相同 |
+| data.email             | string     | 用户邮箱<br>**字段权限要求**：获取用户邮箱信息                                        |
+| data.enterprise_email | string     | 企业邮箱，请先确保已在管理后台启用飞书邮箱服务<br>**字段权限要求**：获取用户受雇信息                     |
+| data.user_id          | string     | 用户 user_id<br>**字段权限要求**：获取用户userID                                 |
+| data.mobile            | string     | 用户手机号<br>**字段权限要求**：获取用户手机号                                       |
+| data.tenant_key       | string     | 当前企业标识                                      |
+| data.employee_no      | string     | 用户工号<br>**字段权限要求**：获取用户受雇信息                                        |
+
+#### 2.2.8 添加自定义参数配置
+
+将AppID、AppSecret、重定向地址添加到自定义参数配置，方便后续使用。
+
+重定向地址为上文创建的回调页面的链接地址，注意，此处的重定向地址必须进行URLEncode编码，URL编码工具：[https://www.kjson.com/url/](https://www.kjson.com/url/)
+
+AppSecret为隐私信息，请勿在前端调用，防止泄漏。
+
+<img src="../assets/didaimayingyongjierufeishudenglu_0417_9.png" style="max-width: 80%;border: 1px solid #ccc;" />
+
+### 2.3 制作登录页面
+
+制作飞书登录的入口，本案例在login（登录页）的基础上添加飞书登录按钮。
+
+<img src="../assets/didaimayingyongjierufeishudenglu_0417_10.png" style="border: 1px solid #ccc;" />
+
+为飞书登录按钮添加点击事件，跳转到飞书登录页面，该跳转链接的详细接口文档请参考：[获取授权登录授权码 - 飞书开放平台](https://open.feishu.cn/document/common-capabilities/sso/api/obtain-oauth-code)。
+
+本案例的网址路径如下，路径中的参数使用上文添加的自定义参数配置：
+
+    https://open.feishu.cn/open-apis/authen/v1/authorize?app_id=【飞书应用的AppId】&redirect_uri=【编码后的重定向地址】
+
+<img src="../assets/didaimayingyongjierufeishudenglu_0417_11.png" style="border: 1px solid #ccc;" />
+
+### 2.4 添加飞书登录的服务端逻辑
+
+添加服务端逻辑用于进行飞书登录，逻辑添加输入参数code、输出参数result。
+
+首先调用获取appAccessToken的接口
+
+<img src="../assets/didaimayingyongjierufeishudenglu_0417_12.png" style="border: 1px solid #ccc;" />
+
+如果appAccessToken接口调用未成功，则输出参数返回错误信息。
+
+<img src="../assets/didaimayingyongjierufeishudenglu_0417_13.png" style="border: 1px solid #ccc;" />
+
+如果appAccessToken接口调用成功，则调用获取UserAccessToken的接口。
+
+<img src="../assets/didaimayingyongjierufeishudenglu_0417_14.png" style="border: 1px solid #ccc;" />
+
+如果UserAccessToken接口调用未成功，则输出参数返回错误信息。
+
+<img src="../assets/didaimayingyongjierufeishudenglu_0417_15.png" style="border: 1px solid #ccc;" />
+
+如果UserAccessToken接口调用成功，则调用获取飞书登录用户信息的接口。
+
+查询该飞书用户是否已经在数据库中存在，如果不存在则录入到数据库中。
+
+<img src="../assets/didaimayingyongjierufeishudenglu_0417_16.png" style="border: 1px solid #ccc;" />
+
+<img src="../assets/didaimayingyongjierufeishudenglu_0417_17.png" style="border: 1px solid #ccc;" />
+
+（成功获取飞书用户信息时）调用lcap_auth依赖库的createToken逻辑创建token，并为输出参数赋值表示微信登录成功。
+
+createToken逻辑的输入参数的类型为lcap_auth依赖库中的LCAPUser数据结构，lcap_auth依赖库的相关内容可参考文档[lcap_auth依赖库使用说明](../050.lcap_auth依赖库使用说明.md)。
+
+<img src="../assets/didaimayingyongjierufeishudenglu_0417_18.png" style="border: 1px solid #ccc;" />
+
+### 2.5 配置回调页面
+
+为回调页面添加进入时事件，进入时判断code是否有值，有值则调用服务端逻辑进行飞书登录，根据逻辑输出参数判断登录是否成功，成功登录则跳转到自定义的页面。
+
+<img src="../assets/didaimayingyongjierufeishudenglu_0417_19.png" style="border: 1px solid #ccc;" />
+
+### 2.6 发布预览
+
+<img src="../assets/didaimayingyongjierufeishudenglu_0417_20.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/%E9%A3%9E%E4%B9%A6%E7%99%BB%E5%BD%95/%E5%BA%94%E7%94%A8%E6%A8%A1%E6%9D%BF_%E9%9B%86%E6%88%90%E9%A3%9E%E4%B9%A6%E7%99%BB%E5%BD%95_1.0.0.zip)
+
+使用模板的注意事项：
+
+* 应自行在CodeWave平台创建飞书相关API并在模板中重新调用。
+* 自定义参数配置替换成自己的实际参数。
+
+## 4. 常见问题
+
+### 4.2 飞书登录后一直停在回调页面
+
+飞书登录后跳转到回调页面，一直停在回调页面没有成功登录CodeWave应用，可能是回调页面调用的服务端逻辑出现异常，例如飞书接口调用失败，建议查看应用日志，或使用[调试功能](../../../../20.应用开发/15.逻辑功能实现/45.逻辑编辑/80.逻辑调试.md)定位故障原因。
+
+### 4.2 登录时提示没有应用的使用权限
+
+进行飞书登录后提示没有权限，请确认当前登录的飞书用户已在飞书应用对应的的企业内，并且发布飞书应用时的“可用范围”有包含该用户，请参考[2.2.4 发布应用](#_2-2-4-发布应用)。
+
+<img src="../assets/didaimayingyongjierufeishudenglu_0417_21.png" style="width:800px;border: 1px solid #ccc;" />
+
+<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月17日</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/60.IAM/345/261/200/351/203/250/346/250/241/347/211/210/010./346/235/203/351/231/220/350/256/244/350/257/201/346/250/241/345/235/227/351/205/215/347/275/256.md

@@ -0,0 +1,143 @@
+# 权限认证模块配置
+
+## 1. 功能概述
+
+通常，制品应用会要求对制品用户的登录或角色进行访问和操作权限的管理和限制。
+
+为了降低开发者对登录和权限的理解和集成成本，CodeWave智能开发平台从3.10版本开始支持一键开启权限认证模版。在原有默认权限的基础上添加了业内常用的登录方式，比如：钉钉、微信公众号、OAuth2.0、CAS等。
+
+<img src="../assets/quanxianrenzhengmokuaipeizhi_202408261558_1.png" class="imgStyle" style="width:400px;" />
+
+## 2. 功能介绍
+
+## 2.1 功能入口
+
+创建应用时，PC端、PC+H5端的应用不会自带登录（login）、权限中心（permissionCenter）相关的实体、逻辑、页面，H5端应用没有权限功能。若有需要，右键PC端或点击PC端后方的按钮，打开下拉框后选择权限模块配置，然后选择实现方式，通常支持3种，这里选择第二种。
+
+<img src="../assets/qxmkpz_20240521_175230_002.png" alt="0" style="width:350px;border: 1px solid #ccc;" />
+
+若未实现权限模块配置，应用没有登陆和鉴权的能力，IDE中无法开启权限控制。此时开启权限控制会有如下提示，在提示中点击“导入”按钮同样可以打开权限模块配置。
+
+![0](../assets/qxmkpz_20240521_175230_003.png)
+
+## 2.2 功能详情
+
+### 2.2.1 功能地图
+
+<img src="../assets/quanxianrenzhengmokuaipeizhi_202408261558_2.png" class="imgStyle" style="" />
+
+<p style="color:red;">备注：目前短信验证码、安全模块、同步中心还在开发中：预计在3.11版本支持。</p>
+
+### 2.2.2 功能介绍
+
+- 针对单应用场景
+- 支持常见的微信公众号、企业微信、钉钉、飞书扫码登录
+- 支持OAuth2.0协议、CAS协议、LDAP协议
+- 支持管理后台自定义登录页
+- 支持多身份源账号绑定
+- 支持工作台免登进入应用
+- 支持无登录框和多身份源场景
+
+### 2.2.3 功能预览
+
+#### 用户端
+
+##### 登录页
+
+页面路径：`/login`
+
+<img src="../assets/quanxianrenzhengmokuaipeizhi_202408261558_3.png" class="imgStyle" style="" />
+
+##### 个人中心页
+
+页面路径：`/permissionCenter/userConfig/userCenter`
+
+<img src="../assets/quanxianrenzhengmokuaipeizhi_202408261558_4.png" class="imgStyle" style="" />
+
+#### 管理端
+
+##### 管理员后台登录页面
+
+页面路径：`/permissionCenter/loginAdmin`
+
+<img src="../assets/quanxianrenzhengmokuaipeizhi_202408261558_5.png" class="imgStyle" style="" />
+
+##### 登录配置页
+
+页面路径：`/permissionCenter/permissionConfig/loginConfig`
+
+<img src="../assets/quanxianrenzhengmokuaipeizhi_202408261558_6.png" class="imgStyle" style="" />
+
+##### 社会化身份源
+
+页面路径：`/permissionCenter/permissionConfig/socializationIdentity/addSocializationIdentity`
+
+<img src="../assets/quanxianrenzhengmokuaipeizhi_202408261558_7.png" class="imgStyle" style="" />
+
+##### 企业身份源
+
+页面路径：`/permissionCenter/permissionConfig/enterpriseIdentity/enterpriseIdentityList`
+
+<img src="../assets/quanxianrenzhengmokuaipeizhi_202408261558_8.png" class="imgStyle" style="" />
+
+## 3. 操作步骤
+
+以集成飞书登录为例。
+
+1. 点击pc端右侧按钮导入权限模块
+
+    <img src="../assets/qxmkpz_20240521_175230_002.png" alt="0" style="width:350px;border: 1px solid #ccc;" />
+
+2. 选择系统默认权限+认证模版
+
+    <img src="../assets/quanxianrenzhengmokuaipeizhi_202408261558_1.png" class="imgStyle" style="width:400px;" />
+
+3. 点击预览
+
+    <img src="../assets/quanxianrenzhengmokuaipeizhi_202408261558_9.png" class="imgStyle" style="" />
+
+4. 应用运行态进入管理员登录页面`/permissionCenter/loginAdmin`输入管理员账号密码进行登录。
+
+    <img src="../assets/quanxianrenzhengmokuaipeizhi_202408261558_10.png" class="imgStyle" style="" />
+
+5. 进入后台配置页面，创建身份源。
+
+    <img src="../assets/quanxianrenzhengmokuaipeizhi_202408261558_11.png" class="imgStyle" style="" />
+
+6. 输入事先准备好ak/sk，进行创建。
+
+    <img src="../assets/quanxianrenzhengmokuaipeizhi_202408261558_12.png" class="imgStyle" style="" />
+
+7. 创建成功后，开启身份源认证.
+
+    <img src="../assets/quanxianrenzhengmokuaipeizhi_202408261558_13.png" class="imgStyle" style="" />
+
+8. 进入登录配置，可配置登录页的登录形式.
+
+    <img src="../assets/quanxianrenzhengmokuaipeizhi_202408261558_14.png" class="imgStyle" style="" />
+
+9. 自此三方登录已经配置完成，预览效果.
+
+    <img src="../assets/quanxianrenzhengmokuaipeizhi_202408261558_15.png" class="imgStyle" style="" />
+
+## 4. 注意事项
+
+- 个人中心页，模版中没有给路由，开发者可根据自己的业务需求，去重定向到该页面/permissionCenter/userConfig/userCenter
+- 登录配置支持两种认证方式：
+
+    1. 单身份源：无登录框，不存在账号密码登录，直接跳转到三方认证中心的登录页。
+    2. 多身份源：有登录框，账号密码登录和多种三方登录同时存在。
+
+    <img src="../assets/quanxianrenzhengmokuaipeizhi_202408261558_16.png" class="imgStyle" style="" />
+
+- 多身份源场景下，为了确保不同登录方式的账号唯一性，在首次三方登录时会弹出账号绑定页。
+
+    <img src="../assets/quanxianrenzhengmokuaipeizhi_202408261558_17.png" class="imgStyle" 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年08月26日</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/60.IAM/345/261/200/351/203/250/346/250/241/347/211/210/020./346/216/245/345/205/245/351/243/236/344/271/246/347/244/276/344/274/232/345/214/226/347/231/273/345/275/225.md

@@ -0,0 +1,80 @@
+# 接入飞书社会化登录
+
+## 1.场景介绍
+
+开发者如果想要将CodeWave制品应用接入飞书的三方登录，则可以参考该文档。
+
+## 2.步骤介绍
+
+1. 在飞书开放平台创建一个企业自建应用
+2. 在CodeWave中开启系统默认权限+认证模版
+3. 开始接入
+
+
+## 3. 在飞书开放平台创建企业自建应用
+
+1. 如果你还没有开通飞书开发者账号，请先前往[飞书开放平台 ](https://open.feishu.cn/)创建账号。
+2. 在飞书开放平台，点击进入开发者后台。
+
+   <img src="../assets/jrfsshhdl_20240422_1126_1.png" alt="0" style="border:1px solid #ccc;" />
+3. 在开发者后台，点击【创建企业自建应用】。
+
+   <img src="../assets/jrfsshhdl_20240422_1126_2.png" alt="0" style="border:1px solid #ccc;" />
+4. 创建成功后记录当前应用的**App ID**和**App Secret**，方便后续使用。
+
+   <img src="../assets/jrfsshhdl_20240422_1126_3.png" alt="0" style="border:1px solid #ccc;" />
+
+## 4.在CodeWave中开启系统默认权限+认证模版并发布
+
+具体步骤可参考[权限认证模块配置](../60.IAM局部模版/010.权限认证模块配置.md)。
+
+1. 发布成功后，进入CodeWave制品应用的身份源配置页面，填写刚才记录的飞书企业自建应用的App Id和App Secret，并填写登录成功后的回调地址
+
+   <img src="../assets/jrfsshhdl_20240422_1126_4.png" alt="0" style="border:1px solid #ccc;" />
+
+2. 复制身份源配置页面的Redirect URL，并添加到飞书开发平台的安全配置中
+
+   <img src="../assets/jrfsshhdl_20240422_1126_5.png" alt="0" style="border:1px solid #ccc;" />
+
+3. 在飞书开发平台中添加网页应用，并配置网页应用，填写CodeWave制品应用的url
+
+   <img src="../assets/jrfsshhdl_20240422_1126_6.png" alt="0" style="border:1px solid #ccc;" />
+
+   <img src="../assets/jrfsshhdl_20240422_1126_7.png" alt="0" style="border:1px solid #ccc;" />
+
+4. 在飞书开发平台的应用的权限管理中，选择所需要的权限，这里可根据业务进行配置，如：
+
+   1. 获取用户邮箱；
+   2. 获取用户手机号；
+   3. 获取用户 userid；
+   4. 获取用户受雇信息；
+
+   <img src="../assets/jrfsshhdl_20240422_1126_8.png" alt="0" style="border:1px solid #ccc;" />
+
+## 5. 发布飞书开放平台企业自建应用
+
+1. 在飞书应用详情的版本管理与发布 创建版本
+
+   <img src="../assets/jrfsshhdl_20240422_1126_9.png" alt="0" style="border:1px solid #ccc;" />
+
+2. 填写应用版本号
+
+   <img src="../assets/jrfsshhdl_20240422_1126_10.png" alt="0" style="border:1px solid #ccc;" />
+
+3. 保存并申请发布，你的企业管理员会进行审核，审核结果会通过飞书和开发者后台发送给你。
+
+## FAQ
+
+### 扫码成功后跳转到飞书的授权页，显示当前账号无该应用的权限
+
+答：需要在飞书管理后台配置该应用的可见范围。
+
+<img src="../assets/jierufeishushehuihuadenglu_202408261354_1.png" 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年08月26日</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/60.IAM/345/261/200/351/203/250/346/250/241/347/211/210/030./346/216/245/345/205/245/351/222/211/351/222/211/347/244/276/344/274/232/345/214/226/347/231/273/345/275/225.md

@@ -0,0 +1,58 @@
+# 接入钉钉社会化登录
+
+## 1. 场景介绍
+
+开发者如果想要将CodeWave制品应用接入钉钉的三方登录，则可以参考该文档。
+
+## 2. 操作介绍
+
+1. 在钉钉开放平台创建一个企业自建应用
+2. 在CodeWave中开启系统默认权限+认证模版
+3. 开始接入
+
+## 3. 具体步骤
+
+### 3.1 在钉钉开放平台创建应用
+
+1. 进入[钉钉开放平台](https://open-dev.dingtalk.com/)，如果没有创建账号，则创建。
+2. 点击应用开发，并创建应用。
+
+   <img src="../assets/jrddshhdl_20240422_1335_1.png" alt="0" style="border:1px solid #ccc;" />
+
+3. 进入新创建的应用，查看凭证与基础信息，记录当前应用的**Client ID**和**Client Secret**。
+
+### 3.2 在CodeWave中开启系统默认权限+认证模版并发布
+
+具体步骤可参考[权限认证模块配置](../60.IAM局部模版/010.权限认证模块配置.md)。
+
+1. 发布成功后，进入CodeWave制品应用的身份源配置页面，填写刚才记录的钉钉自建应用的**Client ID**和**Client Secret**，并填写登录成功后的回调地址。
+
+2. 复制身份源配置页面的Redirect URL，并添加到钉钉开放平台的安全配置中。
+
+    <img src="../assets/jrddshhdl_20240422_1335_2.png" alt="0" style="border:1px solid #ccc;" />
+
+3. 在钉钉开放平台中添加网页应用，并配置网页应用，填写CodeWave制品应用的url
+
+   <img src="../assets/jrddshhdl_20240422_1335_3.png" alt="0" style="border:1px solid #ccc;" />
+
+4. 在钉钉开放平台应用的权限管理中，选择所需要的权限，这里可根据业务进行配置，如：
+
+   a. 个人手机号信息。
+   b. 通讯录个人信息读权限。
+
+   <img src="../assets/jrddshhdl_20240422_1335_4.png" alt="0" style="border:1px solid #ccc;" />
+
+### 3.3 发布钉钉开放平台自建应用
+
+1. 创建新版本，进行发布。
+
+   <img src="../assets/jrddshhdl_20240422_1335_5.png" alt="0" style="border:1px solid #ccc;" />
+
+2. 保存并申请发布，你的企业管理员会进行审核，审核结果会通过钉钉和开发者后台发送给你。
+
+<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年08月26日</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/60.IAM/345/261/200/351/203/250/346/250/241/347/211/210/040./346/216/245/345/205/245/344/274/201/344/270/232/345/276/256/344/277/241/347/244/276/344/274/232/345/214/226/347/231/273/345/275/225.md

@@ -0,0 +1,107 @@
+# 接入企业微信社会化登录
+
+## 1. 场景介绍
+
+开发者如果想要将CodeWave制品应用接入企业微信的三方登录，则可以参考该文档。
+
+## 2. 操作步骤
+
+1. 在企业微信后台创建一个企业自建应用。
+2. 在CodeWave中开启系统默认权限+认证模版。
+3. 开始接入。
+
+## 3. 企业微信后台创建应用
+
+1. 进入[企业微信后台](https://work.weixin.qq.com/wework_admin/frame#index)，如果没有账号则先创建账号。
+
+2. 点击应用管理，并创建应用。
+
+   <img src="../assets/jrqwshhdl_20240422_1350_1.png" alt="0" style="border:1px solid #ccc;" />
+
+3. 进入应用详情，记录AgentId、Secret以及企业Id（Corpid）。
+
+   <img src="../assets/jrqwshhdl_20240422_1350_2.png" alt="0" style="border:1px solid #ccc;" />
+
+## 4. 在CodeWave中开启系统默认权限+认证模版并发布
+
+具体步骤可参考[权限认证模块配置](../60.IAM局部模版/010.权限认证模块配置.md)。
+
+1. 发布成功后，进入CodeWave制品应用的身份源配置页面，填写刚才记录的企业微信自建应用的AgentId、Corpid和Secret，并填写登录成功后的回调地址。
+
+   <img src="../assets/jrqwshhdl_20240422_1350_3.png" alt="0" style="border:1px solid #ccc;" />
+
+2. 复制身份源配置页面的Redirect URL，并添加到企业微信后台的授权登录中。
+
+   <img src="../assets/jrqwshhdl_20240422_1350_4.png" alt="0" style="border:1px solid #ccc;" />
+
+3. 复制当前CodeWave制品应用的url，在企业微信后台配置到应用主页。
+
+   <img src="../assets/jrqwshhdl_20240422_1350_5.png" alt="0" style="border:1px solid #ccc;" />
+
+4. 在企业微信后台配置网页授权及JS-SDK。
+   
+   <div class="yellowBlock">
+
+   注意：
+
+   这一步设置企微的可信域名，需要保证制品的域名主体和企微的备案主体一样。如果是在saas上使用，saas专业版可以在[配置中心-域名管理](../../../../50.平台配置管理/85.域名配置/10.自定义域名配置.md)去配置自定义域名。并且企微还需要配置可信域名，可以联系我们提供证书上传到saas服务器上。
+
+   </div>
+
+   <img src="../assets/jrqwshhdl_20240422_1350_6.png" alt="0" style="border:1px solid #ccc;" />
+
+
+5. 下载证书：
+
+   <img src="../assets/jieruqiyeweixinshehuihuadenglu_202408261431_1.png" style="" />
+
+6. 在CodeWave中进行配置。
+
+   <img src="../assets/jieruqiyeweixinshehuihuadenglu_202408261431_2.png" style="" />
+
+7. 设置企业的可信ip。
+
+   <div class="yellowBlock">
+      <p>
+        CodeWave saas版的IP地址为 <code>59.111.146.228</code>、<code>59.111.146.227</code>
+      </p>
+   </div>
+
+   <img src="../assets/jrqwshhdl_20240523_1.png" alt="0" style="border:1px solid #ccc;" />
+
+## FAQ
+
+### 企微中配置可信域名时，显示域名所有权检验不通过
+
+答：这里配置的域名所有权必须和企微的主题保持一致。saas专业版可以在配置中心-域名管理去配置自定义域名，将域名和企微主体保持一致即可
+
+<img src="../assets/jieruqiyeweixinshehuihuadenglu_202408261431_3.png" style="width:600px;" />
+
+<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年08月26日</span>
+</div>
+
+### redirect_uri与配置的授权完成回调域名不一致
+
+微信扫码登录时显示以下错误，这是由于当前应用的域名和企微应用中设置的域名不一致。
+
+<img src="../assets/jieruqiyeweixinshehuihuadenglu_202501021423_1.png" style="width:400px;" />
+
+进入企业微信应用管理，需要确保**网页授权及JS-SDK**和**企业微信授权登录**中的域名和当前应用的域名是一致的。
+
+<img src="../assets/jieruqiyeweixinshehuihuadenglu_202501021423_2.png" style="width:400px;" />
+
+<style>
+.yellowBlock {
+   /* color: #FFFFFF; */
+   border-left-width: 0.5rem;
+   border-left-style: solid;
+   padding: 0.1rem 1.5rem;
+   margin:1rem 0;
+   background-color: #fcf5e1;
+   border-color: #eaaa08;
+}
+</style>