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/40./351/241/265/351/235/242/351/233/206/346/210/220/60.CodeWave/345/205/274/344/270/273/345/255/220/345/272/224/347/224/250/347/232/204micro-app/345/276/256/345/211/215/347/253/257/351/233/206/346/210/220.md

@@ -0,0 +1,215 @@
+# CodeWave兼主子应用的micro-app微前端集成
+
+## 1. 场景介绍
+
+本文将以micor-app为例，全面地介绍CodeWave应用同时作为主应用和子应用的微前端集成完整操作步骤。
+
+## 2. 前提条件
+
+准备两个应用分别作为主应用和子应用，本示例的两个应用均为CodeWave应用。
+
+<img src="../assets/micro_202509161603_1.png" class="imgStyle" style="" />
+
+## 3. 操作步骤
+
+### **3.1 子应用操作**
+
+#### **解决跨域问题**
+
+子应用的资源和接口请求均在主域名发起，因此会产生跨域问题，子应用必须做[cors 设置](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/CORS)。CodeWave应用作为子应用时通过设置服务端扩展逻辑，来实现在Http请求返回头添加CORS相关设置。
+
+在“更多->系统偏好设置”中打开**使用扩展逻辑**和**按需生成接口**。
+
+<img src="../assets/micro_202509161603_2.png" class="imgStyle" style="" />
+
+新建两个扩展逻辑，例如CustomCorsFilter和CustomFilterConfig。注意替换逻辑中真实的包名和类名。
+
+- CustomCorsFilter
+
+<img src="../assets/micro_202509161603_3.png" class="imgStyle" style="" />
+
+```java
+package com.csforkf.subapplication.web.interceptor;
+//修改package
+//修改类名 包名.CustomCorsFilter： com.csforkf.subapplication.web.interceptor.CustomCorsFilter
+
+import javax.servlet.*;
+import javax.servlet.http.HttpServletResponse;
+import javax.servlet.http.HttpServletRequest;
+import java.io.IOException;
+import com.netease.codewave.nasl.java.tools.LogUtils;
+
+
+
+public class CustomCorsFilter implements Filter {
+
+    @Override
+    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
+        throws IOException, ServletException {
+        HttpServletResponse httpResponse = (HttpServletResponse) response;
+        HttpServletRequest httpRequest = (HttpServletRequest) request;
+        LogUtils.info("httpRequest:" + httpRequest.getRequestURI() + "  origin:" + (httpRequest.getHeader("Origin") == null ? "*" : httpRequest.getHeader("Origin")));
+        //如果是OPTIONS请求，直接返回200
+        if (httpRequest.getMethod().equals("OPTIONS")) {
+            // 设置自定义的CORS头部
+            httpResponse.setHeader("Access-Control-Allow-Origin", httpRequest.getHeader("Origin") == null ? "*" : httpRequest.getHeader("Origin"));
+            httpResponse.setHeader("Access-Control-Allow-Credentials", "true");
+            httpResponse.setHeader("Access-Control-Allow-Methods", "GET,POST,PUT,DELETE,OPTIONS");
+            httpResponse.setHeader("Access-Control-Allow-Headers", "Content-Type, Authorization, domainname, timezone, lcap-frontend, lcap-calllogic-uuid, env");
+            httpResponse.setHeader("Access-Control-Expose-Headers", "Content-Disposition");
+            httpResponse.setStatus(HttpServletResponse.SC_OK);
+            return;
+        }
+        // 设置自定义的CORS头部
+        httpResponse.setHeader("Access-Control-Allow-Origin", httpRequest.getHeader("Origin") == null ? "*" : httpRequest.getHeader("Origin"));
+        httpResponse.setHeader("Access-Control-Allow-Credentials", "true");
+        httpResponse.setHeader("Access-Control-Allow-Methods", "GET,POST,PUT,DELETE,OPTIONS");
+        httpResponse.setHeader("Access-Control-Allow-Headers", "Content-Type, Authorization, domainname, timezone, lcap-frontend, lcap-calllogic-uuid, env");
+        httpResponse.setHeader("Access-Control-Expose-Headers", "Content-Disposition");
+
+        // 继续请求处理
+        chain.doFilter(request, response);
+    }
+
+    // 其他方法需要实现，可以为空
+}
+```
+
+- CustomFilterConfig
+
+<img src="../assets/micro_202509161603_4.png" class="imgStyle" style="" />
+
+```java
+package com.csforkf.subapplication.config;
+//1，修改包名：package com.csforkf.subapplication.config;
+//2，修改类名：com.csforkf.subapplication.config.CustomFilterConfig
+
+//TODO：可更新包名，生成源码时按包名路径存放
+import org.springframework.boot.web.servlet.FilterRegistrationBean;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+
+import com.csforkf.subapplication.web.interceptor.CustomCorsFilter;
+//3，修改路径  com.csforkf.subapplication.web.interceptor
+
+import javax.servlet.Filter;
+import javax.servlet.DispatcherType;
+
+@Configuration
+public class CustomFilterConfig {
+
+    @Bean
+    public FilterRegistrationBean<Filter> customCorsFilter() {
+        FilterRegistrationBean<Filter> registrationBean = new FilterRegistrationBean<>();
+        registrationBean.setFilter(new CustomCorsFilter());
+        registrationBean.addUrlPatterns("/*"); // 设置需要应用此过滤器的URL模式
+        registrationBean.setOrder(-10); // 设置过滤器的顺序，确保它覆盖默认的CorsFilter
+        registrationBean.setDispatcherTypes(DispatcherType.REQUEST, DispatcherType.FORWARD);
+        return registrationBean;
+    }
+}
+``` 
+
+#### 发布子应用
+
+点击发布预览，预览发布的子应用如下，等待主应用中直接集成。
+
+<img src="../assets/micro_202509161603_5.png" class="imgStyle" style="" />
+
+可复制子应用的访问地址，备用于在主应用操作中注册微应用。
+
+<img src="../assets/micro_202509161603_6.png" class="imgStyle" style="" />
+
+### **3.2 主应用操作**
+
+#### 注册微应用
+
+在应用端上添加应用进入后事件，在事件逻辑线上拖拽放置一个JS代码块，并输入微应用注册代码。
+
+<img src="../assets/micro_202509161603_7.png" class="imgStyle" style="" />
+
+<img src="../assets/micro_202509161603_8.png" class="imgStyle" style="" />
+
+微应用注册代码如下：
+
+```javascript
+function loadScript(src) {
+    const script = document.createElement('script');
+    script.src = src;
+    const res = new Promise((res, rej) => {
+        script.onload = res;
+        script.onerror = rej;
+    });
+    document.head.appendChild(script);
+    return res;
+}
+const src = 'https://unpkg.com/@micro-zoe/micro-app@1.0.0-rc.27/lib/index.umd.js';
+if (!window.microApp) {
+  await loadScript(src);
+}
+
+window.microApp.default.start();
+```
+
+#### **添加微应用容器**
+
+添加一个供子应用挂载的子页面，在子页面中拖拽放置一个锚点组件，并定义锚点组件的组件名称和标识，例如“subapp”。该锚点组件即作为微应用的放置容器。
+
+<img src="../assets/micro_202509161603_9.png" class="imgStyle" style="" />
+
+#### **渲染子应用**
+
+为子页面添加进入后事件，在进入后事件逻辑里拖拽放置一个JS代码块，并输入加载子应用的代码。
+
+<img src="../assets/micro_202509161603_10.png" class="imgStyle" style="" />
+
+```javascript
+function loadScript(src) {
+    const script = document.createElement('script');
+    script.src = src;
+    const res = new Promise((res, rej) => {
+        script.onload = res;
+        script.onerror = rej;
+    });
+    document.head.appendChild(script);
+    return res;
+}
+const src = 'https://unpkg.com/@micro-zoe/micro-app@1.0.0-rc.27/lib/index.umd.js';
+if (!window.microApp) {
+  await loadScript(src);
+}
+
+window.microApp.renderApp({
+  name: 'subapp1',
+  url: '//dev-microappsub-cstest.lcap.codewave-test.163yun.com/', // 替换成子应用制品 url
+  container: '#subapp1', // 替换成子应用需要渲染的位置对应的锚点id
+}).then((result) => {
+  if (result) {
+    console.log('渲染成功')
+  } else {
+    console.log('渲染失败')
+  }
+});
+```
+
+注意：
+
+- renderApp 函数参数的 url 属性：替换成子应用的制品地址。
+- renderApp 函数参数的 container 属性：换成页面中锚点的标识。
+
+#### 发布主应用
+
+点击发布预览，校验集成效果。
+
+<img src="../assets/micro_202509161603_11.png" class="imgStyle" style="" />
+
+## **4. 效果演示**
+
+<img src="../assets/micro_202509161603_12.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);">2025年09月16日</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/010./347/231/273/345/275/225/350/256/244/350/257/201/345/222/214/346/235/203/351/231/220/351/233/206/346/210/220/346/246/202/350/277/260.md

@@ -0,0 +1,82 @@
+# 登录认证和权限集成概述
+
+在使用CodeWave平台进行应用开发时，如果需要进行登录认证和权限集成操作，可以按照以下步骤进行：
+
+![0](../assets/dlyqxrzjcgs1.svg)
+
+## 1. 什么是认证和鉴权
+
+在集成登录认证和权限之前，我们必须充分理解认证和鉴权这两个登录后的重要步骤的相关概念。这里详细介绍了认证和权限的关系，旨在帮助开发者快速的认识到CodeWave的认证和权限架构，为后续的集成做好前置准备。
+
+### 1.1 概念介绍
+
+认证和鉴权是网络安全中至关重要的两大步骤。认证是确认用户身份的过程，而鉴权则是确定用户是否有权限执行特定操作的过程。但是在很多时候，认证和鉴权这两个概念一直被混淆，这主要是因为认证和鉴权都发生在用户登录的同一时刻，导致被误解为认证就是鉴权，鉴权就是认证。
+
+### 1.2 从一个简单的应用场景谈起
+
+**认证**：比如说我们入职网易，我们提供身份证、手机号后就会给我们一个工牌。这里的身份证、手机号就代表我们的账号密码，工牌代表我们登录成功后的令牌。后续我们就可以通过工牌随意的进入网易园区了，而不需要每次都提供账号密码。我们通过工牌进入园区，园区门禁校验我们工牌信息的过程就是认证。
+
+**鉴权**：上文说到我们已经通过令牌随意的进入网易园区了，但是当我们坐电梯刷卡选择楼层时，可能无法选择某些楼层的按钮，这说明我们并没有那些楼层的权限。这个过程就是鉴权。
+
+### 1.3 认证、授权、鉴权和权限控制的关系
+
+上文已经聊到鉴权了，谈到鉴权，授权肯定是必不可少的。管理员用户可以在后台对某个用户授权角色权限，那么这个用户在登录鉴权时则可以访问这个资源了。
+
+注意：一般用户注册可以授权给用户一个基础角色，可以让其访问基础的资源
+
+![0](../assets/dlyqxrzjcgs2.svg)
+
+## 2. 为什么要集成登录认证和权限
+
+在当今数字化环境中，传统的账号密码登录由于其复杂性高，需要额外的人力去维护，且安全性无法保证，在B端场景正在逐渐被单点登录（SSO）所替代。而SSO极大地提高了用户的便携性和安全性，同时大幅降低了管理成本。这让开发者能够专注于业务开发，无需再编写一个用户管理系统，从而提高了生产效率。接入SSO需要您提前对OAuth2.0、CAS等相关协议有所了解，这将有助于您更好地理解和应用我们的多场景集成单点登录（SSO）认证平台。
+
+## 3. 如何实现认证和鉴权
+
+### 3.1 平台默认
+
+CodeWave自带默认的登录组件和基本的RBAC权限模型，帮助开发者实现了基本的账号密码登录和权限管理。
+
+### 3.2 自定义登录流程
+
+如果开发者想要自定义登录流程（例如：SSO），就需要在在获取用户信息后手动去调用lcap_auth依赖库createToken方法用于创建token，以便于后续完成认证。此外开发者也可以复写lcap_auth依赖库逻辑来满足复杂的登录认证场景。可参考文档：[lcap_auth依赖库使用说明](../50.登录认证与权限集成/050.lcap_auth依赖库使用说明.md)
+
+> 注意：
+>
+> 开发者如果想要使用OAuth2.0对接sso，需要提前了解OAuth2.0协议相关流程，可参考[OAuth2.0协议介绍](../50.登录认证与权限集成/040.OAuth2.0协议介绍.md)。
+>
+> CodeWave的应用默认认证失败会跳转到login页面，开发者也可以在login页面做一次转发，让其跳转到统一认证中心的页面。
+
+### 3.3 自定义权限集成
+
+如果开发者想要接入权限中心，还需要去复写应用中的LCAPGetUserResources逻辑和lcap_permission依赖库的各类方法，从而完成权限的获取和鉴权。可参考文档：[lcap_permission依赖库使用说明](../50.登录认证与权限集成/060.lcap_permission依赖库使用说明.md)。
+
+![0](../assets/dlyqxrzjcgs3.svg)
+
+## 4. 登录认证和权限集成场景
+
+平台目前已支持的六大集成场景，具体场景详情可参考文档[集成场景介绍](../50.登录认证与权限集成/020.集成场景介绍.md)。
+
+![0](../assets/denglurenzhenghequanxianjichenggaishu_0206_1.svg)
+
+## 5. 相关术语介绍
+
+* **应用**：一般指通过CodeWave平台开发出来的应用。
+* **父域**：通常指的是在计算机网络中，一个域（或子域）的上级域。父域包含了子域，并且在域名系统（DNS）中通常使用来表示域名的层级关系。例如，对于域名b.lcap.163yun.com和a.lcap.163yun.com，163yun.com就是他们的父域。
+* **认证中心**：一般是指开发者现有的统一认证中心或者是github、微信开发者平台等。
+* **权限中心**：一般是指开发者现有的统一权限系统，也可以在CodeWave应用中搭建。
+* **认证**：即访问接口需要判断用户的登录状态，存在登录状态则放行，否则跳转到登录页面。
+* **AK/SK**: 密钥id和密钥，本文档中代表在认证中心生成的 client id 和 secert key。
+* **权限管理**：
+  * **RBAC**：基于角色的访问控制，资源分配和管理都是基于角色的，用户只有加入到角色中才有具体的访问权限。
+  * **角色（role）**：是多个用户或者权限集合的一个抽象概念，RBAC权限模型中都是基于权限来让用户和资源进行关联的。
+  * **用户（user）**：需要访问资源的用户，一般与角色进行直接关联。
+  * **资源（resource）**：页面、按钮这些都属于资源，单个资源没有任何意义，资源只有绑定到权限后才能达到访问控制的效果。
+  * **鉴权（checkPermission）**：当前用户是否有该资源（页面、按钮）的权限。
+  * **授权（authorize）**：将资源授权给角色的过程。
+
+<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>

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/020./351/233/206/346/210/220/345/234/272/346/231/257/344/273/213/347/273/215.md

@@ -0,0 +1,30 @@
+# 集成场景介绍
+
+CodeWave智能开发平台目前支持六种常见的登录和权限场景，涵盖了业内常见的认证场景。开发者可以参考每个场景的介绍，结合自身业务需求选择最适合的场景，并查看详细的接入文档和示例。如果当前的六个场景无法满足需求，开发者可以联系官方人员获取更多支持。
+
+集成场景列表如下：
+
+| 集成场景                    | 场景描述                                                                            | 接入文档                                                                                                                                                                                                                                                                                                                   |
+| --------------------------- | ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 单体应用接入SSO（OAuth2.0） | - 针对一个和或者几个的少量应用 <br> - 每个应用都需要实现SSO                         | [单体应用对接SSO（OAuth2.0）](../50.登录认证与权限集成/20.认证集成场景列表/010.单体应用对接SSO（OAuth2.0）.md)                                                                                                                                                                                                             |
+| 网关应用接入SSO             | - 只用申请一套AK/SK即可完成所有应用的SSO登录 <br> - 存在网关应用，控制所有应用的SSO | [网关应用接入SSO](../50.登录认证与权限集成/20.认证集成场景列表/020.网关应用接入SSO（OAuth2.0）.md)                                                                                                                                                                                                                         |
+| 父子应用登录认证和权限集成  | - 父应用充当权限中心、认证中心控制子应用的登录、权限<br> - 门户网站（工作台模式）   | - 认证：根据不同场景请参考[同父域父子应用实现免登](../50.登录认证与权限集成/20.认证集成场景列表/030.同父域父子应用实现免登.md)、[实现多应用免登](../50.登录认证与权限集成/20.认证集成场景列表/040.实现多应用免登.md) <br> - 权限：[父子应用权限管理](../50.登录认证与权限集成/30.权限集成场景列表/010.父子应用权限管理.md) |
+| 权限中心集成                | - CodeWave应用对接外部应用的权限中心                                                  | [权限中心集成](../50.登录认证与权限集成/30.权限集成场景列表/020.权限中心集成.md)                                                                                                                                                                                                                                           |
+| 多应用跳转实现免登          | - 外部应用登录后免登访问CodeWave应用                                                  | [实现多应用免登](../50.登录认证与权限集成/20.认证集成场景列表/040.实现多应用免登.md)                                                                                                                                                                                                                                       |
+| 单体应用接入SSO（CAS）      | - CAS协议 <br> - 单点登录                                                           | [CAS协议登录集成](../50.登录认证与权限集成/20.认证集成场景列表/050.CAS协议登录集成.md)                                                                                                                                                                                                                                     |
+
+<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/040.OAuth2.0/345/215/217/350/256/256/344/273/213/347/273/215.md

@@ -0,0 +1,52 @@
+# OAuth2.0协议介绍
+
+## 1. 概念介绍
+
+OAuth2.0是一个业界标准的授权协议，其定义了四种可以适用于各种应用场景的授权交互模式：授权码模式、应用授信模式、用户授信模式、简化模式。其中，授权码模式被广泛应用于第三方互联网开放平台，通过第三方登录是其最常见应用场景之一，比如使用微信、QQ和Github账号进行登录。
+
+在OAuth2.0的协议交互中，有四个角色的定义：
+
+* 资源所有者（Resource Owner）：顾名思义，资源的所有者，很多时候就是我们普通的自然人（但不限于自然人，如某些应用程序也会创建资源），拥有资源的所有权。
+* 资源服务器（Resource Server）：保存着受保护的用户资源。
+* 应用程序（Client）：准备访问用户资源的应用程序，其可能是一个web应用、一个后端web服务应用、一个移动端应用或是一个桌面可执行程序。
+* 授权服务器（Authorization Server）：授权服务器，在获取用户的同意授权后，颁发访问令牌给应用程序，以便其获取用户资源。
+
+## 2. 从一个简单的应用场景谈起
+
+例如员工入职公司，人事部门需要员工填写个人信息。审批后会发给员工工牌，这里的工牌就是员工的凭证，员工们可以通过工牌随意进入网易园区，但是员工只能去使用园区内电脑、网络、健身房，而不能去随意的去更改和破坏它。换而言之，人事部给员工授权只是可读权限，而不是所有权限。
+
+上述例子当中：公司相当于资源服务器（RO），人事部门相当于授权服务器（AS），工牌就是我们在授权服务器上登录账号密码后颁发的访问凭证，我们拿到这个凭证后就可以随意的访问资源服务器。
+
+## 3. OAuth2.0基本授权流程：授权码模式
+
+![](../assets/OAuth1.svg)
+
+如上图所示，授权流程场景可以描述为如下几个步骤，前提是用户已提前将应用程序注册到授权服务器，并拿到了client id和secret。
+
+1. 用户在应用程序中，应用程序尝试获取用户保存在资源服务器上的信息，比如用户的身份信息和头像，应用程序首先让重定向用户到授权服务器，告知申请资源的读权限，并提供自己的client id到授权服务器，用户输入用户名和密码，服务器对其认证成功后，提示用户即将要颁发一个读权限给应用程序，在用户确认后，授权服务器颁发一个授权码（authorization code）并重定向用户回到应用程序。
+2. 应用程序获取到授权码之后，使用这个授权码和自己的client id/secret向授权服务器申请访问令牌/刷新令牌（access token/refresh token）。授权服务器对这些信息进行校验，如果通过校验，则颁发给应用程序访问令牌/刷新令牌。
+3. 应用程序在拿到访问令牌之后，向资源服务器申请用户的资源信息。
+4. 资源服务器在获取到访问令牌后，对令牌进行解析（如果令牌已加密，则需要进行使用相应算法进行解密）并校验，并向授权服务器校验其合法性，如果通过校验，则返回应用程序所需要的资源信息。
+
+## 4. 补充说明
+
+* secret需要保存到服务端，并且获取token和获取user的步骤都应该在服务端，不能在客户端。
+* token不是永久的，一般有过期时间，有些场景token甚至只能使用一次。
+* 开发者需要提前在授权服务器（微信后台、QQ后台、Github后台）上注册当前应用，拿到对应的AK/SK,也就是client id 和 secret。
+* OAuth2.0有四种授权模式，本文档只介绍了最为常用也是最安全的授权码模式。
+
+<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月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/050.lcap_auth/344/276/235/350/265/226/345/272/223/344/275/277/347/224/250/350/257/264/346/230/216.md

@@ -0,0 +1,142 @@
+# lcap_auth依赖库使用说明
+
+## 1. 概念介绍
+
+在实际业务中，B端场景通常需要实现单点登录。因此在IDE3.0版本后，应用默认引入了lcap-auth依赖库，用于处理登录流程中的token颁发、认证和清除操作。
+
+## 2. 功能介绍
+
+### 2.1 内置逻辑
+
+依赖库包含以下逻辑：
+
+* createToken：创建token，并将token加到cookie中；
+* getUser：获取并解析cookie中的jwt token，并返回用户信息；
+* removeToken：清空cookie。
+
+> 开发者可复写lcap_auth，复写优先级：复写逻辑 > 内置逻辑。
+
+### 2.2 逻辑介绍
+
+#### 2.2.1 getUser
+
+用于获取当前的用户信息，拦截器中调用，无需手动调用，可以重写。每个认证接口都会走当前逻辑，分为以下几个步骤：
+
+* 从浏览器中拿到cookie；
+* 从cookie中拿到token；
+* 解析token得到用户信息。
+
+输出参数：
+
+| 参数名         | 类型                 | 描述     | 是否必传 |
+| -------------- | -------------------- | -------- | -------- |
+| userId         | `String`             | 用户id   | 是       |
+| userName       | `String`             | 用户名   | 是       |
+| extensionInfos | `Map<String,String>` | 扩展信息 | 否       |
+
+#### 2.2.2 createToken
+
+自定义登录完成拿到用户信息后调用该逻辑，用于颁发token，分为以下几个步骤：
+
+* 拿到用户信息后，颁发token；
+* 将token塞到cookie中，便于认证。
+
+输入参数：
+
+| 参数名         | 类型                 | 描述     | 是否必传 |
+| -------------- | -------------------- | -------- | -------- |
+| userId         | `String`             | 用户id   | 是       |
+| userName       | `String`             | 用户名   | 是       |
+| extensionInfos | `Map<String,String>` | 扩展信息 | 否       |
+
+输出参数：true/false，创建token成功后注意需要返回true。
+
+#### 2.2.3 removeToken
+
+删除cookie，制品应用退出登录组件默认调用该逻辑
+
+输出参数：true/false，删除cookie成功后注意需要返回true。
+
+#### 2.2.4 结构体
+
+LCAPUser结构体如下：
+
+```Java
+public class LCAPUser {
+    @Required
+    public String userId;
+    @Required
+    public String userName;
+    public Map<String,String> extensionInfos;
+}
+```
+
+### 2.3 流程介绍
+
+#### 2.3.1 登录流程
+
+![0](../assets/lcap_auth1.svg)
+
+#### 2.3.2 认证流程
+
+![0](../assets/lcap_auth2.svg)
+
+## 3. 实现方式
+
+* 应用实际上是通过spi的形式引入当前依赖。
+* 现有的lcap_auth依赖库已经默认实现登录的认证逻辑。开发者只需要在对应地方手动调用createToken即可，而不需要去写里面的任何逻辑。
+* 如果当前应用的默认认证逻辑满足不了需求，比如当前应用是门户网站，需要管理所有子应用的登录、用户信息。那么这个时候就可以去复写createToken、getUser、removeToken这三个方法里面的逻辑，例如createToken就需要去手动创建token然后加到同一父域的cookie当中。
+
+## 4. 操作示例
+
+参考：[lcap_auth复写案例](../50.登录认证与权限集成/055.lcap_auth复写案例.md)
+
+### 4.1 案例一：当前默认认证逻辑满足需求，不需要重写createToken
+
+* 未重写的createToken、getUser、removeToken。
+
+  ![0](../assets/lcap_auth3.png)
+
+  ![0](../assets/lcap_auth4.png)
+* 自定义登录完成拿到用户后，直接调用createToken，默认逻辑会创建token并加到cookie中。
+
+  ![0](../assets/lcap_auth5.png)
+* 应用中getUser会在拦截器里面自动调用，无需开发者手动调用。
+
+### 4.2 案例二：需要重写createToken、getUser、removeToken的场景，以门户网站举例
+
+注意：在开始之前需提前引入 auth_library_tools依赖库。
+
+![0](../assets/lcap_auth_5.png)
+
+* 可按照下图内容重写createToken逻辑。
+
+  ![0](../assets/lcap_auth6.png)
+
+  ![0](../assets/lcap_auth7.png)
+
+  ![0](../assets/lcap_auth8.png)
+* 可按照下图内容重写getUser逻辑。
+
+  ![0](../assets/lcap_auth9.png)
+
+  ![0](../assets/lcap_auth10.png)
+* 可按照下图内容重写removeToken逻辑。
+
+  ![0](../assets/lcap_auth11.png)
+
+<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>
+
+<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/055.lcap_auth/345/244/215/345/206/231/346/241/210/344/276/213.md

@@ -0,0 +1,73 @@
+# lcap_auth复写案例
+
+## 1. 概念介绍
+
+在实际的业务场景中，CodeWave应用中内置的账号密码登录可能无法满足开发者的需求， 可以通过自定义登录来实现具体的业务场景。本文提供了常见几种场景的解决方案，包括修改登录的过期时间、同父域能访问的cookie。
+
+## 2. 案例
+
+### 2.1 修改登录的过期时间
+
+
+**操作步骤**：
+
+1. 提前引入auth_library_tools依赖库，便于后续创建token。[点击下载依赖库文件](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%BE%9D%E8%B5%96%E5%BA%93/library-auth_library_tools-1.2.1.zip)。
+2. 根据业务需求编写账号密码登录逻辑。
+3. 登录逻辑执行完成后，调用lcap_auth依赖库的createToken方法，颁发token。
+4. 复写lcap_auth的createToken方法，自定义token的过期时间。
+
+    <img src="../assets/lcapauthfuxieanli_0521_1.png" style="border: 1px solid #ccc;" />
+
+    <img src="../assets/lcapauthfuxieanli_0521_2.png" style="border: 1px solid #ccc;" />
+
+    <img src="../assets/lcapauthfuxieanli_0521_3.png" style="border: 1px solid #ccc;" />
+
+5. 复写lcap_auth的getUser逻辑，便于后续认证。
+
+    <img src="../assets/lcapauthfuxieanli_0521_4.png" style="border: 1px solid #ccc;" />
+
+    <img src="../assets/lcapauthfuxieanli_0521_5.png" style="border: 1px solid #ccc;" />
+
+### 2.2 同父域能访问的cookie
+
+**操作步骤**：
+
+1. 提前引入auth_library_tools依赖库，便于后续创建token。
+2. 根据业务需求编写账号密码登录逻辑。
+3. 登录逻辑执行完成后，调用lcap_auth依赖库的createToken方法，颁发token。
+4. 参考下图添加配置。
+
+    <img src="../assets/lcapauthfuxieanli_0521_6.png" style="border: 1px solid #ccc;" />
+
+5. 复写lcap_auth的createToken方法，将cookie加到同一个父级域名中。
+
+    <img src="../assets/lcapauthfuxieanli_0521_7.png" style="border: 1px solid #ccc;" />
+
+    <img src="../assets/lcapauthfuxieanli_0521_8.png" style="border: 1px solid #ccc;" />
+
+    <img src="../assets/lcapauthfuxieanli_0521_9.png" style="border: 1px solid #ccc;" />
+
+    颁发token后注意为result赋值为true。
+
+6. 复写lcap_auth依赖库的getUser逻辑，发起认证。
+
+    <img src="../assets/lcapauthfuxieanli_0521_10.png" style="border: 1px solid #ccc;" />
+
+    <img src="../assets/lcapauthfuxieanli_0521_11.png" style="border: 1px solid #ccc;" />
+
+7. 复写lcap_auth依赖库下的removeToken逻辑，便于在退出时清除token。
+
+    注意，在清除成功之后需要为result赋值为true。
+
+    <img src="../assets/lcapauthfuxieanli_0521_12.png" style="border: 1px solid #ccc;" />
+
+8. 在注销登录时，手动调用removeToken。
+
+    <img src="../assets/lcapauthfuxieanli_0521_13.png" style="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年05月21日</span>
+</div>