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/20./350/256/244/350/257/201/351/233/206/346/210/220/345/234/272/346/231/257/345/210/227/350/241/250/030./345/220/214/347/210/266/345/237/237/347/210/266/345/255/220/345/272/224/347/224/250/345/256/236/347/216/260/345/205/215/347/231/273.md

@@ -0,0 +1,101 @@
+# 同父域父子应用实现免登
+
+## 1. 场景介绍
+
+通过CodeWave平台开发的应用在成功登录后会将生成的token添加到cookie中。为了实现子应用的免登功能，需要让子应用能够获取到这个cookie。而具有相同父域的两个应用正好满足这个要求。
+
+本文档用来介绍如何将子应用集成到**同父域**的父应用中，从而实现免登。关于其它五种场景介绍请参考[集成场景介绍](../020.集成场景介绍.md)。
+
+> 由于该场景要复写登录认证逻辑，开发者需要提前了解[lcap_auth依赖库使用说明](../050.lcap_auth依赖库使用说明.md)。
+
+![0](../assets/fatherAndson2.svg)
+
+## 2. 如何开发
+
+### 2.1 示例应用模版
+
+可下载应用模板后上传至资产中心-应用模板后，通过模板创建应用并查看其中的具体操作。
+
+> 注意：
+> - 该应用模版里面包含权限以及其它业务场景，使用时请只参考SSO登录流程。
+> - 应用模板的版本较低，基于模板生成应用后建议升级IDE版本。
+> - 需要自行修改应用配置中的参数。
+> - 应用中使用到的第三方API需要手动在租户下导入对应的API，因为基于模板创建的应用会丢失应用中使用的第三方API信息，导致应用在运行时无法成功调通第三方API。
+
+* 父应用：
+
+  下载链接：[template_iam_应用模板_父应用模版--统一认证权限中心_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/%E6%9D%83%E9%99%90%E4%B8%AD%E5%BF%83%E9%9B%86%E6%88%90/template_iam_%E5%BA%94%E7%94%A8%E6%A8%A1%E6%9D%BF_%E7%88%B6%E5%BA%94%E7%94%A8%E6%A8%A1%E7%89%88--%E7%BB%9F%E4%B8%80%E8%AE%A4%E8%AF%81%E6%9D%83%E9%99%90%E4%B8%AD%E5%BF%83_1.0.0.zip)
+
+* 子应用：
+
+  下载链接：[template_iam_应用模板_子应用模版_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/%E6%9D%83%E9%99%90%E4%B8%AD%E5%BF%83%E9%9B%86%E6%88%90/template_iam_%E5%BA%94%E7%94%A8%E6%A8%A1%E6%9D%BF_%E5%AD%90%E5%BA%94%E7%94%A8%E6%A8%A1%E7%89%88_1.0.0.zip)
+
+### 2.2 时序图
+
+![0](../assets/fatherAndson1.svg)
+
+### 2.3 接口文档
+
+1. 获取authorize的地址，注意拼接上clientId参数：[https://github.com/login/oauth/authorize?scope=user:email&client_id=](https://github.com/login/oauth/authorize?scope=user:email&client_id=)
+2. 通过code调用接口获取access_token，接口文档可参照： [https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/authorizing-oauth-apps](https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/authorizing-oauth-apps)
+3. access_token调用接口获取UserInfo，接口文档可参照： [https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/authorizing-oauth-apps#3-use-the-access-token-to-access-the-api](https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/authorizing-oauth-apps#3-use-the-access-token-to-access-the-api)
+
+### 2.4 具体操作步骤
+
+> 详细步骤可参照应用模版中的内容。
+
+* 父应用：
+
+  1. 注册github应用程序，申请入口 [https://github.com/settings/applications/new](https://github.com/settings/applications/new)
+
+     ![0](../assets/fatherAndson3.png)
+  2. 在应用IDE中，点击右上角更多设置-应用配置，在自定义参数配置中配置github应用参数。
+
+     ![0](../assets/fatherAndson4.png)
+  3. 发起授权请求，可参考父应用模板中login（登录页）中的logic1逻辑。
+
+     ![0](../assets/fatherAndson5.png)
+  4. 创建页面作为登录的回调页面，并设置页面进入时事件，可参考父应用模版中的logback页面。
+
+     ![0](../assets/fatherAndson6.png)
+  5. code1逻辑调用服务端的loginGithub方法。
+  6. 在服务端定义loginGithub，并根据code依次请求github获取token、user。
+  7. 调用lcap_auth依赖库的createToken方法。并复写createToken的内容，创建token、创建cookie，写入同一父域。
+
+     ![0](../assets/fatherAndson7.png)
+  8. 在服务端定义获取用户信息的逻辑getUser并开放为接口/rest/user，供子应用去调用，详细请参考父模版的getUser接口。
+  9. 在服务端定义删除token的逻辑deleteToken并开放为接口/rest/token，供子应用去调用，详细请参考父模版的deleteToken接口。
+  10. 复写lcap_auth依赖库的getUser，完成认证。详细请参考父模版的getUser扩展逻辑。
+
+      ![0](../assets/fatherAndson8.png)
+  11. 复写lcap_auth依赖库的removeToken，注销用户。
+
+      ![0](../assets/fatherAndson9.png)
+
+* 子应用：
+
+  1. 复写lcap_auth的getUser逻辑，调用父应用的开放接口/rest/user，详细请参考子模版的lcap_auth扩展逻辑。
+  2. 复写lcap_auth的remove逻辑，调用父应用的开放接口/rest/token，详细请参考子模版的lcap_auth扩展逻辑。
+
+## 3. 补充说明
+
+1. 这里以github登录举例。父应用如果使用账号密码登录，则去除父应用到SSO网关的流程。
+2. 父子应用要属于同一父域，否则cookie无法共享。
+3. 由于父应用重写了createToken，并且写入了同一cookie，子应用也需复写getUser和removeToken。
+4. 建议在使用完退出登录时清除cookie，防止因重写cookie的key和其它应用cookie的key出现冲突，导致无法登录。
+5. 提供的应用模版中包含权限等其他逻辑，开发者无需关注，仅关注文档中提及的部分即可。
+
+<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年02月07日</span>
+</div>
+<style>
+  h4 {
+    font-size: 18px;
+  }
+  h5 {
+    font-size: 16px;
+  }
+</style>

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/20./350/256/244/350/257/201/351/233/206/346/210/220/345/234/272/346/231/257/345/210/227/350/241/250/040./345/256/236/347/216/260/345/244/232/345/272/224/347/224/250/345/205/215/347/231/273.md

@@ -0,0 +1,159 @@
+# 实现多应用免登
+
+## 1. 场景介绍
+
+如果开发者有一个主应用，并且想要使用 CodeWave 开发的应用作为子应用，在主应用登录后实现免登访问子应用页面，可以参考本文档。文档中介绍了三种解决方案。
+
+![](../assets/sxdyymdl1.svg)
+
+## 2. 三种方案对比
+
+| 方案                | 登录状态同步 | 性能 | 是否需要中间件 |
+| ------------------- | ------------ | ---- | -------------- |
+| 子应用自身管理token | 无法同步     | 高   | 否             |
+| 父应用统一管理token | 可以同步     | 中   | 否             |
+| 代理实现共享cookie  | 可以同步     | 高   | 是             |
+
+## 3. 方案介绍
+
+### 3.1 子应用自己管理token
+
+> 该方案中主应用和子应用的token没有实时同步，子应用无法感知主应用是否退出登录。如果需要共享登录状态，建议参考3.2中的方案。
+
+#### 3.1.1 时序图
+
+这里包含登录访问和未登录访问，可根据业务自行选择，也可以两种结合。
+
+* 父应用未登录，直接访问子应用。
+
+  ![](../assets/shixianduoyingyongmiandeng_1.svg)
+* 父应用已登录，点击子应用链接。
+
+  ![](../assets/shixianduoyingyongmiandeng_2.svg)
+
+#### 3.1.2 接入步骤
+
+1. 在应用中新建callback回调页面，用于接受门户网站的token和redirect_url。
+2. 收到回调后在服务端通过token获取用户信息。
+3. 根据用户信息调用lcap_auth依赖库的createToken从而创建应用内部token，便于之后的认证使用，lcap_auth依赖库的相关内容可参考文档：[lcap_auth依赖库使用说明](../050.lcap_auth依赖库使用说明.md)。
+4. 创建token成功后跳转到redirect_url页面。
+
+#### 3.1.3 注意事项
+
+1. 主应用需要暴露获取用户信息的接口，供子应用去调用。
+2. 上述接入方式存在一定的安全问题，开发者可以提前将制品子应用id注册到父应用当中，子应用每次获取用户信息可以将应用id和token传过去，父应用则去校验appid。但是这需要开发者去修改自身的应用，可以根据自身业务灵活使用。
+
+### 3.2 token由父应用统一管理
+
+> 该方案虽然父子应用可以共享登录状态，但是子应用每次请求都需要请求父应用的接口，这会造成一部分的性能损耗。
+
+#### 3.2.1 时序图
+
+这里包含登录访问和未登录访问，这里根据业务自行选择，也可以两种结合。
+
+* 父应用未登录，直接访问制品子应用。
+
+  ![](../assets/shixianduoyingyongmiandeng_3.svg)
+* 父应用已登录，点击子应用链接。
+
+  ![](../assets/shixianduoyingyongmiandeng_4.svg)
+
+#### 3.2.2 集成步骤
+
+1. 应用新建callback回调页面：用于接受门户网站的token和redirect_url。
+2. 收到回调后需要将token存在cookie中，并且在cookie创建成功后跳转到redirect_url页面。
+3. 复写lcap_auth依赖库中的getUser，从cookie中拿到token后去调用父应用开放的获取用户信息的接口，lcap_auth依赖库的相关内容可参考文档：[lcap_auth依赖库使用说明](../050.lcap_auth依赖库使用说明.md)
+
+#### 3.2.3 注意事项
+
+1. 主应用需要暴露获取用户信息api，供子应用去调用。
+2. 上述接入方式存在一定的安全问题，开发者可以提前将子应用id注册到父应用当中，子应用每次获取用户信息可以将应用id和token传过去，父应用则去校验appid。但是这需要开发者去修改自身的应用，可以根据自身业务灵活使用。
+
+### 3.3 通过代理的形式共享cookie
+
+这里以微前端和nginx举例，微前端相关文档请参考：[什么是微前端集成？](../../40.页面集成/10.什么是微前端集成.md)
+
+#### 3.3.1 时序图
+
+![](../assets/shixianduoyingyongmiandeng_5.svg)
+
+#### 3.3.2 接入步骤
+
+1. 代理配置，以nginx为例：
+
+   ```nginx
+   server {
+       listen 80;
+       server_name mainapp.com;   # 这里是用户访问的网站地址
+
+       location / {
+           proxy_pass http://localhost:3000;  # 这里假设主应用运行在3000端口上
+           proxy_set_header Host $host;
+           proxy_set_header X-Real-IP $remote_addr;
+           proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+           proxy_set_header X-Forwarded-Proto $scheme;
+
+       # 传递主应用的cookie给微前端应用
+           proxy_set_header Cookie $http_cookie;
+       }
+
+       location /microapp1 {
+           proxy_pass http://localhost:4000;  # 这里假设微应用1运行在4000端口上
+           proxy_set_header Host $host;
+           proxy_set_header X-Real-IP $remote_addr;
+           proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+           proxy_set_header X-Forwarded-Proto $scheme;
+
+       # 传递主应用的cookie给微前端应用
+           proxy_set_header Cookie $http_cookie;
+       }
+
+       location /microapp2 {
+           proxy_pass http://localhost:5000;  # 这里假设微应用2运行在5000端口上
+           proxy_set_header Host $host;
+           proxy_set_header X-Real-IP $remote_addr;
+           proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+           proxy_set_header X-Forwarded-Proto $scheme;
+
+       # 传递主应用的cookie给微前端应用
+           proxy_set_header Cookie $http_cookie;
+       }
+   }
+   ```
+2. 复写lcap_auth依赖库中的getUser，通过cookie去请求主应用开放的获取用户信息的接口，lcap_auth依赖库的相关内容可参考文档：[lcap_auth依赖库使用说明](../050.lcap_auth依赖库使用说明.md)。
+3. 拿到用户信息后，跳转到指定页面。
+
+#### 3.3.3 注意事项
+
+1. 子应用中需要重写lcap_auth依赖库下的getUser方法，且内容是通过cookie调父应用中的获取用户信息的接口。
+2. 基本上和同父域免登的场景类似，只不过由nginx实现了Domain。可以参考：[同父域父子应用实现免登](../20.认证集成场景列表/030.同父域父子应用实现免登.md)
+3. 本文档是用的nginx实现代理，在实际业务中开发者也可以选择其它的代理方式。
+
+### 3.4 微前端形式，实现免登
+
+该场景下应用已经内嵌到主应用中了，和主应用用的是同一个域名，这里应用已经是可以拿到主应用的cookie了。我们只需要复写getUser去调主应用的接口即可。
+
+#### 3.4.1 接入步骤
+
+1. 复写lcap_auth依赖库中的getUser，通过cookie去请求主应用开放的获取用户信息的接口，lcap_auth依赖库的相关内容可参考文档：[lcap_auth依赖库使用说明](../050.lcap_auth依赖库使用说明.md)。
+2. 拿到用户信息后，跳转到指定页面。
+
+#### 3.4.2 注意事项
+
+1. 主应用需要开发接口，供子应用去拿用户信息
+2. 子应用中需要重写lcap_auth依赖库下的getUser方法，且内容是通过cookie调父应用中的获取用户信息的接口。
+3. 基本上和同父域免登的场景类似，只不过本来就是同域名下的，父应用不用考虑写cookie到domain。可以参考：[同父域父子应用实现免登](../20.认证集成场景列表/030.同父域父子应用实现免登.md)。
+<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/20./350/256/244/350/257/201/351/233/206/346/210/220/345/234/272/346/231/257/345/210/227/350/241/250/050.CAS/345/215/217/350/256/256/347/231/273/345/275/225/351/233/206/346/210/220.md

@@ -0,0 +1,124 @@
+# CAS协议登录集成
+
+## 1. 概念介绍
+
+CAS (Central Authentication Service ) 是一种用于 Web 的单点登录/单点登出协议。 它允许用户访问多个应用程序，同时仅向中央 CAS 服务器应用程序提供一次凭据（例如用户 ID 和密码）。
+
+![0](../assets/CAS1.svg)
+
+## 2. CAS协议通用步骤
+1. 用户访问客户端应用程序，并尝试访问受保护的资源。
+2. 客户端应用程序检测到用户未经身份验证，将用户重定向到 CAS 服务器。
+3. CAS 服务器要求用户提供凭据（例如用户名和密码）。
+4. 用户提供凭据后，CAS 服务器验证这些凭据。
+5. 如果验证成功，CAS 服务器会颁发票据给客户端应用程序。票据是加密的令牌，用于证明用户的身份。
+6. 客户端应用程序将服务票据发送回 CAS 服务器进行验证。
+7. CAS 服务器验证服务票据，并向客户端应用程序颁发令牌，使用户被授权访问所需的资源。
+8. 客户端应用程序使用令牌向资源服务器请求访问受保护资源。
+9. 资源服务器验证令牌，并决定是否授予用户访问所请求的资源。
+
+## 3. 如何开发
+
+### 3.1 环境准备
+
+* 开发者需要提前准备CAS服务端，否则无法接入。
+* 开发者需要提前将应用的域名在CAS服务端进行注册。
+
+### 3.2 示例应用模版（仅做参考）
+
+可下载应用模板后上传至**资产中心>应用模板**后，通过模板创建应用并查看其中的具体操作。该模板应用仅供参考，需要实现CAS登录时请自行手动搭建应用实现。
+
+下载链接：[template_iam_应用模板_CAS协议_1.0.1.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/CAS%E5%8D%8F%E8%AE%AE%E7%99%BB%E5%BD%95%E9%9B%86%E6%88%90/template_iam_%E5%BA%94%E7%94%A8%E6%A8%A1%E6%9D%BF_CAS%E5%8D%8F%E8%AE%AE_1.0.1.zip)
+
+### 3.3 时序图
+
+![0](../assets/casxieyidenglujicheng_0207_1.svg)
+
+### 3.4 操作步骤
+
+1. 将应用的地址在CAS服务端中注册。
+2. 下载CAS依赖库。
+
+   下载链接：[library-auth_library_cas-1.1.5.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/CAS%E5%8D%8F%E8%AE%AE%E7%99%BB%E5%BD%95%E9%9B%86%E6%88%90/library-auth_library_cas-1.1.5.zip)
+3. 在**资产中心>依赖库**中上传依赖库文件。
+
+   ![0](../assets/CASxieyidenglujicheng_202503051058_1.png)
+
+4. 进入应用IDE，点击左上角的**更多设置>依赖库管理**，引入该依赖库。
+
+   ![0](../assets/CASxieyidenglujicheng_202503051058_2.png)
+
+5. 在应用IDE中，点击右上角的**更多设置>应用配置**，修改参数配置。
+
+   ![0](../assets/CAS5.png)
+
+   配置介绍：
+
+   | 配置                        | 详情                        | 默认值          |
+   | :------------------------ | :------------------------ | :----------- |
+   | filterUrl                 | 拦截接口，固定为/rest/filter，不用改动 | /rest/filter |
+   | filterVersion             | 票据过滤器版本，cas2 或者 cas3      | cas3         |
+   | casServerLoginUrl         | 认证中心登录页面地址                |              |
+   | casServerLogoutUrl        | 认证中心注销地址                  |              |
+   | casServerLogoutServiceUrl | 注销地址的service参数            |              |
+   | authenticationUrl         | 认证中心的服务端地址，一般不带login      |              |
+   | appServerUrl              | 低代码应用的访问地址                |              |
+   | successRedirectPage       | 登录成功，默认跳转页面               |              |
+   | sessionExpireSeconds      | 会话过期时间，单位为秒               |              |
+
+6. 删除登录页面的所有内容，并添加一个页面进入时的事件逻辑。当用户未登录时，访问页面将触发该事件。跳转至cas服务端的统一登录页。
+
+     1. 依赖库register逻辑：注册用户入库函数，后续登录成功后将用户入库。
+
+     2. 页面跳转/rest/filter接口，执行依赖库统一拦截逻辑，未登录则跳转到登录页面执行认证。
+     
+     ![0](../assets/CAS6.png)
+
+7. 新增用户入库逻辑，依赖库中登录成功后自动执行该逻辑。
+
+   ![0](../assets/CAS7.png)
+
+8. 退出登录时，调用依赖库logout逻辑删除token，并跳转指定页面。
+   
+   ![0](../assets/CAS8.png)
+
+## 4. 补充说明
+
+依赖库中的Structure为CasUserInfo，数据结构如下。
+
+```Java
+public class CasUserInfo {
+    /**
+     * 用户唯一标识
+     */
+    public String userId;
+    /**
+     * 用户名
+     */
+    public String userName;
+    /**
+     * 认证来源
+     */
+    public String source;
+
+    /**
+     * 扩展信息,json字符串，可以在ide中反序列化
+     */
+    public String attributesStr;
+}
+```
+
+<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年03月05日</span>
+</div>
+<style>
+  h4 {
+    font-size: 18px;
+  }
+  h5 {
+    font-size: 16px;
+  }
+</style>

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/30./346/235/203/351/231/220/351/233/206/346/210/220/345/234/272/346/231/257/345/210/227/350/241/250/010./347/210/266/345/255/220/345/272/224/347/224/250/346/235/203/351/231/220/347/256/241/347/220/206.md

@@ -0,0 +1,140 @@
+
+
+# 父子应用功能权限管理
+
+## 1. 场景介绍
+
+开发者如果想通过一个应用充当统一的权限中心来控制所有应用的权限，可以参考本文档。本文档介绍了实现父子应用的权限管理以及简单的RBAC权限模型表设计的方法，能够帮助开发者快速准确地接入。关于其它五种认证集成的场景请参考[集成场景介绍](../020.集成场景介绍.md)。
+
+## 2. 前提准备
+
+1. <span style="color:red;">本方案是针对父子应用在同一个父域共享cookie，请保证多应用都处着同父域下，否则父应用无法正常免登子应用。</span>
+2. 开发者需要有权限管理相关的概念，可以查看[登录认证和权限集成概述](../010.登录认证和权限集成概述.md)当中的术语介绍。
+3. 开发者需要提前阅读CodeWave提供的权限扩展逻辑文档[lcap\_permission依赖库使用说明](../060.lcap_permission依赖库使用说明.md)。
+
+## 3. 如何开发
+
+### 3.1 示例应用模版（参考）
+
+可下载应用模板后上传至资产中心-应用模板后，通过模板创建应用并查看其中的具体操作。
+
+- 父应用
+
+  - [3.8版本模板下载](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/%E7%88%B6%E5%AD%90%E5%BA%94%E7%94%A8%E6%9D%83%E9%99%90%E7%AE%A1%E7%90%86/template_dogfood_%E5%BA%94%E7%94%A8%E6%A8%A1%E6%9D%BF_%E7%88%B6%E5%BA%94%E7%94%A8%E6%A8%A1%E6%9D%BF_1.0.0.zip)
+
+  - [3.13版本模板下载](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/%E7%88%B6%E5%AD%90%E5%BA%94%E7%94%A8%E6%9D%83%E9%99%90%E7%AE%A1%E7%90%86/%E5%BA%94%E7%94%A8%E6%A8%A1%E6%9D%BF_%E7%88%B6%E5%AD%90%E5%BA%94%E7%94%A8-%E7%88%B6%E5%BA%94%E7%94%A8_1.0.0%EF%BC%883.13%EF%BC%89.zip)
+
+- 子应用：这里用来对接父应用的权限管理。只用参考LCAPGetUserResources和lcap\_permission下三个方法的复写逻辑。
+
+  - [3.8版本模板下载](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/%E7%88%B6%E5%AD%90%E5%BA%94%E7%94%A8%E6%9D%83%E9%99%90%E7%AE%A1%E7%90%86/template_dogfood_%E5%BA%94%E7%94%A8%E6%A8%A1%E6%9D%BF_%E5%AD%90%E5%BA%94%E7%94%A8%E6%A8%A1%E6%9D%BF_1.0.1.zip)
+
+  - [3.13版本模板下载](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/%E7%88%B6%E5%AD%90%E5%BA%94%E7%94%A8%E6%9D%83%E9%99%90%E7%AE%A1%E7%90%86/%E5%BA%94%E7%94%A8%E6%A8%A1%E6%9D%BF_%E7%88%B6%E5%AD%90%E5%BA%94%E7%94%A8-%E5%AD%90%E5%BA%94%E7%94%A8_1.0.0%EF%BC%883.13%EF%BC%89.zip)
+
+### 3.2 时序图
+
+注意：红色字体代表需要复写的逻辑。
+
+![](../assets/fuziyingyongquanxianguanli_0606_1.svg)
+
+### 3.3 父应用
+
+#### 3.3.1 改动点
+
+1. 父应用权限中心使用的还是系统自带的RBAC权限模型,并且新增了应用表（NodeApp）用来区分多个应用的权限
+2. 开放获取**用户权限**、**鉴权**两个接口。详细逻辑请参考父应用模版中的listPermissionByUserId和checkPermission。
+3. 复写LCAPGetUserResources，getUserResources、checkPermission逻辑，完成权限的集成。
+4. 添加扩展逻辑，拦截原有资源上报流程。
+
+#### 3.3.2 操作步骤
+
+1. 下载父应用模版并导入生成应用
+
+    <img src="../assets/fuziyingyonggongnengquanxianguanli_202502191604_1.png" class="imgStyle" style="" />
+
+2. 进入**应用配置**，修改自定义参数。
+
+    <img src="../assets/fuziyingyonggongnengquanxianguanli_202502191604_2.png" class="imgStyle" style="" />
+
+    参数介绍：
+
+    |   参数名   |                                                             参数值                                                             |       备注      |
+    | :-----: | :-------------------------------------------------------------------------------------------------------------------------: | :-----------: |
+    | app\_id | <img src="../assets/fuziyingyonggongnengquanxianguanli_202502191604_3.png" class="imgStyle" style="" /> |      应用id     |
+    |  domain | <img src="../assets/fuziyingyonggongnengquanxianguanli_202502191604_4.png" class="imgStyle" style="" /> | 多个应用的一级域名（父域） |
+
+3. 修改扩展逻辑，将包名换成当前的应用的包名。
+
+    格式为：`租户标识+应用标识`
+
+    这里模版应用的租户标识为iam，应用标识为parentfuncpermission。开发者应用结合自己的应用标识和租户标识去修改。
+
+    <img src="../assets/fuziyingyonggongnengquanxianguanli_202502191604_5.png" class="imgStyle" style="" />
+
+### 3.4 子应用
+
+#### 3.4.1 改动点
+
+- 复写权限扩展逻辑，让其去调用父应用暴露的接口。这部分逻辑都无需开发者手动调用。
+
+    - LCAPGetUserResources（获取当前用户有权限的资源列表）：进入任意页面都会在前端调用这个接口。
+    - getUserResources（获取当前用户有权限的资源列表）：应用服务端filter中调用。
+    - checkPermission（鉴权）：服务端filter中调用。
+
+#### 3.4.2 子应用操作步骤
+
+1. 下载子应用模版并导入生成应用。
+
+    <img src="../assets/fuziyingyonggongnengquanxianguanli_202502191604_6.png" class="imgStyle" style="" />
+
+2. 进入**应用配置**，修改自定义参数。
+
+    <img src="../assets/fuziyingyonggongnengquanxianguanli_202502191604_7.png" class="imgStyle" style="" />
+
+    参数说明：
+
+    |      参数名称     |                                                             参数值                                                             |         说明        |
+    | :-----------: | :-------------------------------------------------------------------------------------------------------------------------: | :---------------: |
+    | no\_auth\_url |                                                         父应用的login页面                                                         | 未登录访问子应用页面，重定向的页面 |
+    |    app\_id    | <img src="../assets/fuziyingyonggongnengquanxianguanli_202502191604_8.png" class="imgStyle" style="" /> |        应用id       |
+    |   parentUrl   |                                                            父应用的地址                                                           |                   |
+
+## 4. 运行态如何配置权限
+
+1. 创建应用
+
+    <img src="../assets/fuziyingyonggongnengquanxianguanli_202502191604_9.png" class="imgStyle" style="" />
+
+2. 创建资源（也可以通过excel导入）
+
+    <img src="../assets/fuziyingyonggongnengquanxianguanli_202502191604_10.png" class="imgStyle" style="" />
+
+3. 创建权限
+
+    <img src="../assets/fuziyingyonggongnengquanxianguanli_202502191604_11.png" class="imgStyle" style="" />
+
+4. 创建授权角色
+
+    <img src="../assets/fuziyingyonggongnengquanxianguanli_202502191604_12.png" class="imgStyle" style="" />
+
+    说明：子应用附带资源导出页面
+
+    <img src="../assets/fuziyingyonggongnengquanxianguanli_202502191604_13.png" class="imgStyle" style="" />
+
+## 5. 补充说明
+
+- 父模版是使用的简单RBAC模型，开发者可以根据自己的业务来设计更复杂的RBAC。
+- 父应用至少需要暴露获取用户权限、鉴权这两个接口。
+- 引用依赖库：
+
+    - [auth-library-tools](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/%E7%88%B6%E5%AD%90%E5%BA%94%E7%94%A8%E6%9D%83%E9%99%90%E7%AE%A1%E7%90%86/library-auth_library_tools-1.2.2.zip)
+
+    - [encrypt-tool](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/%E7%88%B6%E5%AD%90%E5%BA%94%E7%94%A8%E6%9D%83%E9%99%90%E7%AE%A1%E7%90%86/library-encrypt_tool-1.0.29.zip)
+
+    - [dist-id-gen](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/%E7%88%B6%E5%AD%90%E5%BA%94%E7%94%A8%E6%9D%83%E9%99%90%E7%AE%A1%E7%90%86/library-dist_id_gen-1.0.0.zip)
+
+<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年04月15日</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/30./346/235/203/351/231/220/351/233/206/346/210/220/345/234/272/346/231/257/345/210/227/350/241/250/020./346/235/203/351/231/220/344/270/255/345/277/203/351/233/206/346/210/220.md

@@ -0,0 +1,78 @@
+# 权限中心集成
+
+## 1. 场景介绍
+
+如果开发者已有一个权限中心，通过CodeWave平台开发的应用只想关注于业务开发，而应用的权限由权限中心控制，则可以参考本文档。关于其它五种认证集成的场景请参考[集成场景介绍](../020.集成场景介绍.md)。
+
+![0](../assets/qxzxjc1.svg)
+
+## 2. 如何开发
+
+   由于没有现成的第三方认证和权限中心，这里用CodeWave平台简单搭建了一个权限中心（下文简称父应用），用来管理所有子应用以及当前应用的权限。由于场景是对接第三方权限中心，所以不需要关注父应用内部的业务实现。
+
+### 2.1 接入须知
+
+1. 开发者需要有权限管理相关的概念，可以查看[登录认证和权限集成概述](../010.登录认证和权限集成概述.md)当中的权限部分。
+2. 开发者需要提前阅读CodeWave提供的权限扩展逻辑文档[lcap_permission依赖库使用说明](../060.lcap_permission依赖库使用说明.md)。
+3. 该场景和[父子应用权限管理](../30.权限集成场景列表/010.父子应用权限管理.md)类似。不同的是该场景权限中心由开发者提供，这样我们就不需要关注权限表的设计，开发者只需要在应用中接入权限中心即可。
+
+### 2.2 环境准备
+
+1. 开发者需要提前准备一个权限中心，如果没有请参考[父子应用权限管理](../30.权限集成场景列表/010.父子应用权限管理.md)。
+2. 权限中心需要至少暴露两个接口，用于获取用户权限、鉴权。
+
+### 2.3 示例应用模版（仅做参考）
+
+可下载应用模板后上传至[资产中心-应用模板](../../../../20.应用开发/30.资产复用/10.应用模板.md)后，通过模板创建应用并查看其中的具体操作。
+
+* 父应用：这里只是用来模拟的第三方权限中心
+
+  下载链接：[template_iam_应用模板_父应用模版--统一认证权限中心_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/%E6%9D%83%E9%99%90%E4%B8%AD%E5%BF%83%E9%9B%86%E6%88%90/template_iam_%E5%BA%94%E7%94%A8%E6%A8%A1%E6%9D%BF_%E7%88%B6%E5%BA%94%E7%94%A8%E6%A8%A1%E7%89%88--%E7%BB%9F%E4%B8%80%E8%AE%A4%E8%AF%81%E6%9D%83%E9%99%90%E4%B8%AD%E5%BF%83_1.0.0.zip)
+* 子应用：这里用来对接权限中心的权限管理。只用参考LCAPGetUserResources和lcap_permission下三个方法的复写逻辑。
+
+  下载链接：[template_iam_应用模板_子应用模版_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/%E6%9D%83%E9%99%90%E4%B8%AD%E5%BF%83%E9%9B%86%E6%88%90/template_iam_%E5%BA%94%E7%94%A8%E6%A8%A1%E6%9D%BF_%E5%AD%90%E5%BA%94%E7%94%A8%E6%A8%A1%E7%89%88_1.0.0.zip)
+
+### 2.4 时序图
+
+![0](../assets/quanxianzhongxinjicheng_0606_1.svg)
+
+### 2.5 操作步骤
+
+> 详细步骤可参照应用模版中的内容。
+
+* 复写权限扩展逻辑，让其去调用权限中心暴露的接口。
+  * LCAPGetUserResources（获取当前用户有权限的资源列表）：进入任意页面会前端调用这个接口。
+  * getUserResources（获取当前用户有权限的资源列表）：应用服务端filter中调用。
+  * checkPermission（鉴权）：服务端filter中调用。
+  * uploadResource（上报资源）：**这里不推荐复写**。
+
+  ![0](../assets/qxzxjc3.png)
+
+## 3. 为什么不推荐复写uploadResource？它的优缺点是什么
+
+* **优点**：每次修改页面权限不需要手动去权限中心创建资源，程序启动时会自动上报调用权限中心的上报资源接口，进行入库。
+* **缺点**：
+  * 父应用需要多暴露一个资源上报的接口，用来接收和处理上报的资源并进行入库。
+  * 现有应用每次重启都会调用uploadResource，而入参是当前开启权限页面的资源列表。这样就无法区分哪些资源是新增、修改、删除的。如果在权限中心进行全量覆盖资源的话，这样又会出现以下两个问题：
+    1. 需要区分资源是应用上报的还是权限中心手动创建的，需增加资源来源来区分。
+    2. 全量覆盖资源需要同步修改资源角色关联表，还需要筛选出哪些是修改的资源，需要重新绑定，业务复杂度高，很容易出现问题。
+
+## 4. 推荐在权限中心资源管理页面手动去创建资源
+
+该方式的优缺点如下：
+
+* **优点**：无需复杂的复写逻辑，即可降低风险，也可提高应用的发布效率。
+* **缺点**：制品开发态开启和关闭权限开关，权限中心无法感知，需要手动在权限中心创建和更新资源。但是应用开发态，权限不会频繁的去修改，所有这一点影响相对较小。
+
+## 5. 补充说明
+
+1. 所有应用模版只用做参考，内部包含了其它的业务代码，开发者只需关注权限这部分。
+2. 这里给出的权限模版，因为是父应用模拟的第三方权限中心，所以子应用和父应用是同父域的，在子应用中调用父应用接口之所以传了cookie过去，是因为在父应用中做了用户参数校验的。在实际的场景中可以忽略。
+3. 权限中心至少需要提供获取用户权限和鉴权的接口。
+
+<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年06月06日</span>
+</div>