@alanwang-merit/meritdata-platform-skill-package 1.0.0

package/skills/meritdata-dev-docs-file-finder/references/dev-docs/.bak//345/272/224/347/224/250/345/274/200/345/217/221/345/271/263/345/217/260-/345/237/272/347/241/200/345/271/263/345/217/260-/344/275/277/347/224/250/346/224/273/347/225/245/357/274/210/345/233/233/357/274/211/357/274/232/347/263/273/347/273/237/350/256/244/350/257/201/351/233/206/346/210/220.md

@@ -0,0 +1,907 @@
+---
+title: 应用开发平台使用攻略（四）：系统认证集成
+date: 2023.03.30
+categories:
+  - 开发攻略
+  - C6.9.0
+---
+
+# 应用开发平台使用攻略（四）：系统认证集成
+
+## 1 系统认证集成介绍
+
+针对不同项目集成场景的不同，平台目前提供三种集成方式： token 认证，Cas 统一认证中心，第三方认证中心。
+
+- token 认证：目前平台提供两种登录方式，分别为平台默认 token 登录、自定义 token 登录。
+
+## 2 token 认证集成
+
+### 2.1 token 集成适用场景
+
+平台中的页面或接口通过其他系统直接访问，或将平台中的页面直接嵌入到其他系统中而未通过统一认证中心进行登录时可通过 userId+token 方式进行登录
+
+### 2.2 集成前置操作
+
+- 根据应用开发平台使用攻略(三)：组织人员同步完成平台的组织人员同步
+
+### 2.3 集成操作
+
+如果要使用 token 认证集成，通常有两种应用场景
+
+- 1.平台默认 token 登录：使用平台默认方式进行校验登录；
+- 2.自定义 token 登录：为了满足其他系统自有的加密校验，应用开发平台提供了自定义 token 登录方式。
+
+#### 2.3.1 平台默认 token 登录
+
+为了完成应用开发平台和其他系统进行单点集成，应用开发平台不做修改，其他系统通过传递 userId+token 方式进行集成登录。
+
+- 操作步骤：
+  新建 java 应用（如果是适配微服务6.13版本，则使用jdk21），如图：
+  ![image](./imgs/系统认证集成/token集成/3-1.png)
+  选择 maven，直接 next
+  ![image](./imgs/系统认证集成/token集成/3-2.png)
+  可按示例内容填入:
+  ![image](./imgs/系统认证集成/token集成/3-3.png)
+
+  继续按图示操作：
+  ![image](./imgs/系统认证集成/token集成/3-4.png)
+  ![image](./imgs/系统认证集成/token集成/3-5.png)
+
+  继续修改 pom 文件
+  将 pom.xml 内容替换为（目的为了导入 RSAUTils 所需 jar 包）：
+
+  ```xml
+  <?xml version="1.0" encoding="UTF-8"?>
+  <project xmlns="http://maven.apache.org/POM/4.0.0"
+          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+      <modelVersion>4.0.0</modelVersion>
+
+        <groupId>com.meritdata.cloud</groupId>
+        <artifactId>project-business-token</artifactId>
+        <version>1.0-SNAPSHOT</version>
+        <dependencies>
+            <dependency>
+                <groupId>commons-codec</groupId>
+                <artifactId>commons-codec</artifactId>
+                <version>1.11</version>
+            </dependency>
+        </dependencies>
+  </project>
+  ```
+
+- 集成 token 后端应用结构：
+
+进行两个类的创建,分别为 RSAUtils 和 SSOMain。
+RSAUtils 工具类（将整个类内容替换即可）：
+
+```java
+import org.apache.commons.codec.binary.Base64;
+
+import javax.crypto.Cipher;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.ObjectInputStream;
+import java.security.Key;
+
+public class RSAUtils {
+    private static String ALGORITHM = "RSA";
+    public static int KEYSIZE = 1024;
+    public static String ENCODE = "UTF-8";
+    public static String encrypt(String source, String path) throws Exception {
+        ObjectInputStream ois = new ObjectInputStream(new FileInputStream(path + File.separator +"public.pem"));
+        Key key = (Key) ois.readObject();
+        ois.close();
+        Cipher cipher = Cipher.getInstance(ALGORITHM);
+        cipher.init(1, key);
+        byte[] b = source.getBytes();
+        byte[] b1 = cipher.doFinal(b);
+        return new String(Base64.encodeBase64(b1), ENCODE);
+    }
+}
+```
+
+- 平台中对 token 的生成方式进行升级，采用非对称的 RSA 加密方法，提供公钥证书生成 token(公钥证书随平台发放，文件名为 public.pem),可以通过以下代码来获取用户的 token 信息:
+  SSOMain（将整个类内容替换即可） :
+
+```java
+import java.text.SimpleDateFormat;
+import java.util.Date;
+public class SSOMain {
+
+    public static void main(String[] args) throws Exception {
+        String cloudHome = "D://8.0.0//run//merit_cloud//key"; //public.pem的文件存储路径(公钥地址)
+        SimpleDateFormat sdf=new SimpleDateFormat("yyyy-MM-dd");
+        String userId = "admin";// 以admin为例
+        String token= RSAUtils.encrypt(sdf.format(new Date())+userId,cloudHome);
+        System.out.println(token);
+    }
+}
+```
+
+- 该 userId 必须为平台中已存在的用户，如果暂时只是作为功能体验，使用 admin 更稳妥一些。
+
+```
+ String userId = "admin";// 以admin为例
+```
+
+结构图：
+![image](./imgs/系统认证集成/token集成/3-6.png)
+
+在 SSOMain 中运行项目，鼠标右键启动，如图：
+![image](./imgs/系统认证集成/token集成/3-7.png)
+生成的 token 打印在控制台,如图所示:
+![image](./imgs/系统认证集成/token集成/3-8.png)
+
+- 平台 token 登录展示
+
+使用 userId 和程序生成的 token 值进行登录<br>
+格式：http://服务ip地址:Nginx端口号/portal/#/?userId=登录用户名&token=生成的token值<br>
+例如：http://191.168.2.90:8080/portal/#/?userId=merit&token=kK+7QHYuVHToVyYch0ksOCn6isbaDIx6/6ftcSumS247lRkKTIhb4+0kyGr9JTVHRqU8/LGOrcBVAJxSdRstIDzPwpks/wfLiLnISEue4MFqMskmDip6yU++InrDobIuaqL2ycQRkJMJsHUal7jLHl/cRMnKtgnCUdc0R1N2RBo=
+
+如图：
+![image](./imgs/系统认证集成/token集成/3-9.png)
+认证成功后跳转如图：
+![image](./imgs/系统认证集成/token集成/3-10.png)
+
+#### 2.3.2 自定义 token 单点登录(内置服务,推荐使用)
+
+- 简述：
+  除了上述第一种平台提供的默认单点登录方式外，还可以自定义 token 单点集成，可根据在请求中传递的用户标识信息生成 token 后进行请求访问。应用开发平台为分布式架构。实现自定义单点登录方式需要在业务应用中实现 com.meritdata.cloud.security.sso.IPortalSSOApi 接口类，返回所需的数据格式，返回数据中包含了用户名信息和 token 信息。系统在访问非匿名请求在进行会话信息校验之前，会跳转至该接口进行处理。如果正确返回了用户信息和 token,则会生成会话信息，直接访问接口。
+- 操作步骤： 1.使用 IntelliJ IDEA 新建一个 Maven 工程；按照工程创建操作步骤，生成后端工程；创建CustomSSOApi类，写入对应的内容，编译后将其嵌入到应用工程中，重新启动应用工程；
+  根据《应用开发平台使用攻略(一)：系统环境搭建》 的后端工程创建，进行后端工程搭建。
+  创建 project-business-sso 工程
+
+  工程创建完毕后的目录结构如图所示：
+  ![image](./imgs/系统认证集成/token集成/3-11.jpg)
+
+  pom.xml 文件
+  
+```xml
+  <?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+           xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+      <modelVersion>4.0.0</modelVersion>
+  
+      <parent>
+          <artifactId>cloud-starter-parent</artifactId>
+          <groupId>com.meritdata.cloud</groupId>
+          <version>C.6.9.0</version>
+      </parent>
+      <groupId>com.meritdata.cloud</groupId>
+      <!--服务名称，可自拟-->
+      <artifactId>project-business-sso</artifactId>
+      <version>1.0-SNAPSHOT</version>
+  
+      <dependencies>
+          <dependency>
+              <groupId>com.meritdata.cloud</groupId>
+              <artifactId>cloud-starter-core</artifactId>
+              <version>C.6.9.0</version>
+          </dependency>
+          <dependency>
+              <groupId>commons-codec</groupId>
+              <artifactId>commons-codec</artifactId>
+              <version>1.11</version>
+          </dependency>
+       </dependencies>
+      <build>
+      <plugins>
+          <plugin>
+              <groupId>net.alchim31.maven</groupId>
+            <artifactId>yuicompressor-maven-plugin</artifactId>
+              <version>1.3.0</version>
+              <executions>
+                  <execution>
+                      <phase>prepare-package</phase>
+                      <goals>
+                          <goal>compress</goal>
+                      </goals>
+                  </execution>
+              </executions>
+              <configuration>
+                  <encoding>UTF-8</encoding>
+                  <jswarn>false</jswarn>
+                  <nosuffix>true</nosuffix>
+                  <linebreakpos>-1</linebreakpos>
+                  <force>true</force>
+                  <includes>
+                      <include>**/*.css</include>
+                      <include>**/*.js</include>
+                  </includes>
+              </configuration>
+          </plugin>
+      </plugins>
+  </build>
+```
+
+  2.集成 token 后端应用结构：
+  （1）在 com.meritdata.cloud 包下新建 package，命名：security.sso.token;
+  （2）创建单点登录集成实现类：
+  在 security.sso.token 下新建类，命名：CustomSSOApi
+
+CustomSSOApi（将整个类内容替换即可） ：
+
+```java
+package com.meritdata.cloud.security.sso.token;
+
+
+import com.meritdata.cloud.security.sso.IPortalSSOApi;
+import com.meritdata.cloud.utils.RSAUtils;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.io.*;
+import java.text.SimpleDateFormat;
+import java.util.Date;
+import java.util.Map;
+
+
+@RestController
+public class CustomSSOApi implements IPortalSSOApi {
+
+    private static Logger logger = LoggerFactory.getLogger(CustomSSOApi.class);
+
+    @Value("${CLOUD_HOME}")
+    private String cloudHome; //公钥public.pem路径
+
+    @Override
+    public String[] getUserIdAndToken(@RequestParam(required = false) Map param) throws Exception {
+        logger.info("--------进入getUserIdAndToken------------");
+        String[] userToken = new String[2];
+        SimpleDateFormat sdf=new SimpleDateFormat("yyyy-MM-dd");
+        String userId = String.valueOf(param.get("userId"));//从request中获取用户标识后生成userId信息
+        String token= RSAUtils.encrypt(sdf.format(new Date())+userId,cloudHome + File.separator + "key");
+        userToken[0] = userId;
+        userToken[1] = token;
+        logger.info("--------userId------------" + userId);
+        logger.info("--------token------------" + token);
+        logger.info("--------结束------------");
+        return userToken;
+    }
+}
+```
+
+RSAUtils 工具类应用开发平台已经提供，可直接引用。
+
+RSAUtils 内容如下：
+
+```java
+package com.meritdata.cloud.security.sso.token;
+
+import org.apache.commons.codec.binary.Base64;
+
+import javax.crypto.Cipher;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.ObjectInputStream;
+import java.security.Key;
+
+public class RSAUtils {
+    private static String ALGORITHM = "RSA";
+    public static int KEYSIZE = 1024;
+    public static String ENCODE = "UTF-8";
+    public static String encrypt(String source, String path) throws Exception {
+        ObjectInputStream ois = new ObjectInputStream(new FileInputStream(path + File.separator +"public.pem"));
+        Key key = (Key) ois.readObject();
+        ois.close();
+        Cipher cipher = Cipher.getInstance(ALGORITHM);
+        cipher.init(1, key);
+        byte[] b = source.getBytes();
+        byte[] b1 = cipher.doFinal(b);
+        return new String(Base64.encodeBase64(b1), ENCODE);
+    }
+}
+```
+
+工程创建完成后结构如图：
+![image](./imgs/系统认证集成/token集成/3-13.jpg)
+
+实现以上步骤之后，将项目编译，然后将编译后的文件target下面的CustomSSOApi.class,(完整路径为cloud.meritdata.cloud\security\sso\token\CustomSSOApi.class复制，建议在文件夹下复制。
+
+![image](./imgs/系统认证集成/token集成/3-13-1.jpg)
+
+- 配置项管理配置 ：
+
+  Nacos 中 common.properties 中需要修改配置自定义 token 认证接口类。此处的配置为业务应用的 spring.application.name 的值
+  如图： ![image](./imgs/系统认证集成/token集成/3-14.png)
+
+  ```
+  #自定义认证token接口类应用名,实现自定义token认证
+  meritdata.cloud.custom-sso-application-name=none
+  ```
+
+  如果希望自定义工程，这里将默认值更改，在 Nacos 中改为需要嵌入的工程服务名即可，例如：
+
+  ```
+  meritdata.cloud.custom-sso-application-name=cloud-system-manage
+  ```
+
+  如图：修改后,点击发布
+  ![image](./imgs/系统认证集成/token集成/3-15.png)
+
+将 security\sso\token\CustomSSOApi.class放到所需要嵌入的工程服务下：
+本案例中放在 manage 中：apps\system\server\manage\WEB-INF\classes\com\meritdata\cloud 中,完整路径为：apps\system\server\manage\WEB-INF\classes\com\meritdata\cloud\security\sso\token\CustomSSOApi.class
+
+- 重新启动 cloud-system-gateway 服务
+- 重新启动 cloud-system-manage 服务
+
+* 自定义 token 登录展示
+  在自定义接口 CustomSSOApi 中制定加密逻辑，目前没有进行加密，只需要使用 userId 进行登录即可进行访问：
+  格式：http://服务ip地址:Nginx端口号/portal#/?userId=登录用户名<br>
+* 这里使用的登录用户名必须为已在应用开发平台完成新建
+  例如：http://127.0.0.1:8080/portal/#/?userId=admin
+
+  注意服务器 ip：查看 Nacos 中 common.properties 文件中 meritdata.cloud.server.ip 值
+  如下图所示：
+
+  ![image](./imgs/系统认证集成/token集成/3-16.png)
+
+  进行访问：
+  ![image](./imgs/系统认证集成/token集成/3-17.png)
+  成功后跳转如图：
+  ![image](./imgs/系统认证集成/token集成/3-10.png)
+
+#### 2.3.3 自定义 token 单点登录(独立服务)
+
+- 简述：
+  除了上述第一种平台提供的默认单点登录方式外，还可以自定义 token 单点集成，可根据在请求中传递的用户标识信息生成 token 后进行请求访问。应用开发平台为分布式架构。实现自定义单点登录方式需要在业务应用中实现 com.meritdata.cloud.security.sso.IPortalSSOApi 接口类，返回所需的数据格式，返回数据中包含了用户名信息和 token 信息。系统在访问非匿名请求在进行会话信息校验之前，会跳转至该接口进行处理。如果正确返回了用户信息和 token,则会生成会话信息，直接访问接口。
+- 操作步骤： 1.使用 IntelliJ IDEA 新建一个 Maven 工程；按照工程创建操作步骤，生成后端工程；修改相关配置信息；加载依赖包，启动工程，nacos 中查看。
+  根据《应用开发平台使用攻略(一)：系统环境搭建》 的后端工程创建，进行后端工程搭建。
+  创建 project-base-demo 工程
+
+  工程创建完毕后的目录结构如图所示：
+  ![image](./imgs/系统认证集成/token集成/3-11.PNG)
+
+- 后端工程配置
+  点击工程名选择编辑配置，配置 key 路径，更改为自己的本地 key 路径即可
+- ![image](./imgs/系统认证集成/token集成/3-18.png)
+  ![image](./imgs/系统认证集成/token集成/3-19.png)
+
+注：
+
+-DCLOUD_HOME=D:/merit_cloud_run/windows/merit_cloud（具体路径以实际存放key为准）
+-Dmeritdata.cloud.authentication-server-url=${CLOUD_HOME}/key
+-Dspring.main.allow-circular-references=true
+
+修改 bootstrap.properties 文件
+
+在 src 目录->resources 目录-> bootstrap.properties 文件
+修改 server.port = 8099
+防止端口冲突
+
+完整配置信息如下:
+
+```properties
+#启动端口
+server.port=8099
+#nacos的启动地址，在nacos的启动日志中查看
+meritdata.cloud.nacos-addr=127.0.0.1:8848
+spring.cloud.nacos.config.server-addr=${meritdata.cloud.nacos-addr}
+spring.cloud.nacos.discovery.server-addr=${meritdata.cloud.nacos-addr}
+#程序加载的配置文件
+#服务启动的时候会读取 prefix.properties 和 prefix-profiles.properties 文件下的配置项
+spring.profiles.include=server,cache,freemarker,datasource,sentinel,cloud-system-cas,oauth2,@project.artifactId@
+spring.cloud.nacos.config.prefix=common
+#nacos的配置的命名空间，默认为空
+spring.cloud.nacos.config.namespace=
+#系统的程序名，在创建工程的时候确定，挂载到nacos中的名称
+spring.application.name=project-base-demo
+meritdata.cloud.product-name=cloud-system-framework
+spring.main.allow-bean-definition-overriding=true
+#日志文件最长保存添加
+logfile-max-history=30
+#应用日志级别
+logging-level=info
+```
+
+2.集成 token 后端应用结构：
+（1）在 com.meritdata.cloud 包下新建 package，命名：security.sso.token;
+（2）在包下新建 RSAUtils 工具类，该类和平台 token 默认登录的工具类一致,命名为 RSAUtils;
+（3）创建单点登录集成实现类：
+在 security.sso.token 下新建类，命名：CustomSSOApi
+
+CustomSSOApi（将整个类内容替换即可） ：
+
+```java
+package com.meritdata.cloud.security.sso.token;
+
+import com.meritdata.cloud.security.sso.IPortalSSOApi;
+import com.meritdata.cloud.utils.RSAUtils;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+import java.io.*;
+import java.text.SimpleDateFormat;
+import java.util.Date;
+import java.util.Map;
+
+
+@RestController
+public class CustomSSOApi implements IPortalSSOApi {
+
+    private static Logger logger = LoggerFactory.getLogger(CustomSSOApi.class);
+
+    @Value("${CLOUD_HOME}")
+    private String cloudHome; //公钥public.pem路径
+
+    @Override
+    public String[] getUserIdAndToken(@RequestParam(required = false) Map param) throws Exception {
+        logger.info("--------进入getUserIdAndToken------------");
+        String[] userToken = new String[2];
+        SimpleDateFormat sdf=new SimpleDateFormat("yyyy-MM-dd");
+        String userId = String.valueOf(param.get("userId"));//从request中获取用户标识后生成userId信息
+        String token= RSAUtils.encrypt(sdf.format(new Date())+userId,cloudHome + File.separator + "key");
+        userToken[0] = userId;
+        userToken[1] = token;
+        logger.info("--------userId------------" + userId);
+        logger.info("--------token------------" + token);
+        logger.info("--------结束------------");
+        return userToken;
+    }
+}
+```
+
+RSAUtils 类内容：
+
+```java
+package com.meritdata.cloud.security.sso.token;
+
+import org.apache.commons.codec.binary.Base64;
+
+import javax.crypto.Cipher;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.ObjectInputStream;
+import java.security.Key;
+
+public class RSAUtils {
+    private static String ALGORITHM = "RSA";
+    public static int KEYSIZE = 1024;
+    public static String ENCODE = "UTF-8";
+    public static String encrypt(String source, String path) throws Exception {
+        ObjectInputStream ois = new ObjectInputStream(new FileInputStream(path + File.separator +"public.pem"));
+        Key key = (Key) ois.readObject();
+        ois.close();
+        Cipher cipher = Cipher.getInstance(ALGORITHM);
+        cipher.init(1, key);
+        byte[] b = source.getBytes();
+        byte[] b1 = cipher.doFinal(b);
+        return new String(Base64.encodeBase64(b1), ENCODE);
+    }
+}
+```
+
+IPortalSSOApi类内容：
+
+```java
+package com.meritdata.cloud.security.sso.token;
+
+import com.meritdata.cloud.base.DisableEncrypt;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestMethod;
+import org.springframework.web.bind.annotation.RequestParam;
+
+import java.util.Map;
+
+/**
+ * @author liu yong
+ * @data 2022/8/11 14:25
+ */
+@DisableEncrypt
+public interface IPortalSSOApi {
+
+    /**
+     * 如果验证成功 返回用户id和token信息
+     * 否则返回长度为2的空数组即可
+     *
+     * @param param
+     * @return
+     * @throws Exception
+     */
+    @RequestMapping(value = "get-userid-token", method = RequestMethod.GET)
+    String[] getUserIdAndToken(@RequestParam Map param) throws Exception;
+}
+```
+
+工程创建完成后结构如图：
+
+![image](./imgs/系统认证集成/token集成/3-20.jpg)
+
+- 配置项管理配置 ：
+
+  nacos 访问地址：http://localhost:8848/nacos/#/
+  账号：admin  
+  密码：BigData.2018v6
+  
+  Nacos 中 common.properties 中需要修改配置自定义 token 认证接口类。此处的配置为业务应用的 spring.application.name 的值
+  如图： ![image](./imgs/系统认证集成/token集成/3-14.png)
+
+  ```properties
+  #自定义认证token接口类应用名,实现自定义token认证
+meritdata.cloud.custom-sso-application-name=none
+  ```
+  
+  如果希望自定义工程，这里将默认值更改，在 Nacos 中改为对应工程服务名即可，例如：
+  
+```properties
+  meritdata.cloud.custom-sso-application-name=project-business-sso
+```
+
+  如图：修改后,点击发布
+  ![image](./imgs/系统认证集成/token集成/3-21.png)
+
+* 启动服务：
+  ![image](./imgs/系统认证集成/token集成/3-22.jpg)
+  启动后进入 nacos 查看服务列表，出现服务名则启动成功：
+  ![image](./imgs/系统认证集成/token集成/3-23.jpg)
+
+- 自定义 token 登录展示
+  在自定义接口 CustomSSOApi 中制定加密逻辑，目前没有进行加密，只需要使用 userId 进行登录即可进行访问：
+  格式：http://服务ip地址:Nginx端口号/portal#/?userId=登录用户名<br>
+- 这里使用的登录用户名必须为已在应用开发平台完成新建
+  例如：http://127.0.0.1:8080/portal/#/?userId=admin
+
+  注意服务器 ip：查看 Nacos 中 common.properties 文件中 meritdata.cloud.server.ip 值
+  如下图所示：
+
+  ![image](./imgs/系统认证集成/token集成/3-16.png)
+
+  进行访问：
+  ![image](./imgs/系统认证集成/token集成/3-17.png)
+  成功后跳转如图：
+  ![image](./imgs/系统认证集成/token集成/3-10.png)
+
+## 3 cas 统一认证中心
+
+### 3.1 CAS 单点登录集成方式
+
+CAS(Central Authentication Service – 中心认证服务)是 SSO 的一种解决方案。通过一个公用的认证系统统一管理和验证用户的身份。在 CAS 上验证的用户将获得 CAS 颁发的一个证书，使用这个证书用户可以在承认 CAS 证书的各个系统上自由访问，不需要再次登录认证。
+平台在与外部系统使用 CAS 进行集成时，可以使用平台提供的 CAS 服务或者使用由外部系统提供的 CAS 服务。
+分为两部分，认证中心和应用程序端都需要进行相关配置
+
+参考附录 1:认证中心配置，仅限开发演示使用
+
+### 3.2 应用程序服务端配置
+
+#### 3.2.1 配置虚拟域名
+
+打开文件路径：C:\Windows\System32\drivers\etc\hosts
+在最后一行中加入： 191.168.3.212 cas.merit.com
+说明：IP 地址为认证中心所在服务器 IP
+
+#### 3.2.2 删除应用开发平台原有的 JRE 证书
+
+执行如下命令时首先需要将认证中心端生成的证书拷贝到应用程序所在的服务器端。例如 D 盘根目录
+步骤如下：开始 > 运行 > cmd
+
+```
+keytool -delete -alias tomcatMerit -file D:\server.crt -keystore D:\8.0.0\run\merit_cloud\jdk\windows\jdk1.8.0_111\jre\lib\security\cacerts
+```
+
+证书所在路径：D:\server.crt
+应用开发平台应用程序中 jre 下 cacerts 文件的所在路径：D:\8.0.0\run\merit_cloud\jdk\windows\jdk1.8.0_111\jre\lib\security\cacerts
+注意：此处的 JRE 一定是应用开发平台应用程序所使用的 JRE，并且目录中不能有空格，通常默认的 jdk 安装路径都会含有空格，所以需要重新复制 JDK 目录。
+
+#### 3.2.3 将证书导入 JRE
+
+步骤如下：开始 > 运行 > cmd
+
+```
+keytool -import -alias tomcatMerit -file D:\server.crt -keystore D:\8.0.0\run\merit_cloud\jdk\windows\jdk1.8.0_111\jre\lib\security\cacerts
+```
+
+证书所在路径：D:\server.crt
+应用开发平台应用程序中 jre 下 cacerts 文件的所在路径：D:\8.0.0\run\merit_cloud\jdk\windows\jdk1.8.0_111\jre\lib\security\cacerts
+
+注意：此处的 JRE 一定是启动应用开发平台应用所使用的 JRE，并且目录中不能有空格，通常默认的 jdk 安装路径都会含有空格，所以需要重新复制 JDK 目录。
+
+#### 3.2.4 数据项配置
+
+nacos 平台访问地址：http://localhost:8848/nacos/#/
+账号：admin  
+ 密码：BigData.2018v6
+
+nacos 配置文件修改:
+1)common-cloud-system-cas.properties 文件
+
+```properties
+    cas.app-host=${meritdata.cloud.web-server}/cas
+    cas.app-validationtype=CAS2
+    cas.app-login=/security/login
+    cas.app-logout=/security/logout
+    ####CAS服务地址前缀####
+    cas.server-prefix=https://cas.merit.com:8443/cas_server
+    ####CAS服务认证地址####
+    cas.server-host=${cas.server-prefix}
+    ####CAS登录路径####
+    cas.server-login=${cas.server-host}/login
+    ####CAS注销路径####
+    cas.server-logout=${cas.server-host}/logout?service=${cas.app-host}
+    #cas 认证成功后的自定义认证接口的应用名  根据此接口自定义首页地址
+    meritdata.cloud.custom-cas-auth-application-name=none
+```
+
+只需要修改 CAS 服务地址前缀 即可，该配置为 cas 认证中心的认证地址
+cas.server-prefix=https://cas.merit.com:8443/cas_server
+
+2).common.propertis 文件
+修改认证模式为 cas
+
+```properties
+#认证模式 standard oauth2 cas
+meritdata.cloud.authentication-mode=cas
+```
+
+#### 3.2.5 Nginx 添加 cas 首页代理配置
+
+在安装目录/mids/nginx/conf/nginx.conf 文件
+
+server 节点下添加如下配置(注意：先检查一下是否存在以下内容，存在则不用添加)
+给 cas 登录一个入口，跳转到 cloud-system-manage 进行登录
+
+```conf
+    #给cas登录一个入口，跳转到cloud-system-manage进行登录
+	location /cas/ {
+            proxy_pass http://localhost:8081/;
+
+            add_header 'Access-Control-Allow-Origin' '*';
+            add_header 'Access-Control-Allow-Credentials' 'true';
+            add_header 'Access-Control-Allow-Methods' 'GET, POST';
+        }
+	#给cas跳转前端页面提供代理接口，通过这个接口调整前端页面
+	location /cas/portal/ {
+            proxy_pass http://localhost:8081/cloud-system-manage/cas/portal;
+
+            add_header 'Access-Control-Allow-Origin' '*';
+            add_header 'Access-Control-Allow-Credentials' 'true';
+            add_header 'Access-Control-Allow-Methods' 'GET, POST';
+        }
+```
+
+注意：配置项修改完成之后重启 cloud-system-manage 服务和 Nginx
+
+#### 3.2.6 重新启动系统后 访问 http:nginx_ip:nginx_port/cas 触发登录
+
+浏览器输入http://localhost:8080/cas 后跳转到如下进入 cas 登录页面
+
+登录名：admin
+密码：BigData.2018v6
+
+![image](./imgs/系统认证集成/cas集成/1-2.jpg)
+
+cas 用户认证成功后会默认跳转到系统首页。如果访问的是系统内的某个业务页面，会跳转至该页面
+
+## 4 第三方认证中心
+
+### 4.1 前置准备
+
+根据应用开发平台使用攻略(一)：系统环境搭建完成业务应用工程搭建
+
+### 4.2 适用场景
+
+项目现场多数情况是客户提供认证中心，在访问应用开发平台时对请求进行拦截，跳转至客户方的统一认证中心进行登录，在认证中心登录后回调至应用开发平台进行访问。由于第三方认证的认证机制的不统一性，平台提供统一认证拦截机制。
+
+### 4.3 认证流程
+
+<img src="./imgs/系统认证集成/cas集成/1-3.jpg" width="350px">
+
+- 1.客户端请求接口，filter 进行拦截。如果没有回话跳转至配置的认证中心地址进行登录，如果有会话到步骤 2；
+- 2.校验会话，如果有会话直接请求接口。如果没有会话，访问自定义 token 接口，根据返回的用户标识在接口中返回 userId 和 token 信息；
+- 3.根据自定义接口返回的 userId 和 token 生成会话对象，访问接口。
+
+### 4.4 配置信息
+
+- 认证首页控制层接入
+
+```java
+@RestController
+@RequestMapping(value = "/api/business")
+public class SsoController {
+    @Autowired
+    private MeritdataCloudProperties meritdataCloudProperties;
+    @RequestMapping("portal")
+    public void casPortal(@RequestParam(required = false) String url, HttpServletResponse response) throws IOException {
+        if(StringUtils.isBlank(url)) {
+            response.sendRedirect(meritdataCloudProperties.getIndex());
+            return;
+        }
+        response.sendRedirect(meritdataCloudProperties.getWebServer()+url);
+    }
+}
+```
+
+- 认证 nginx 首页接入
+  在运行环境中修改 mids/nginx/conf/nginx.conf 配置文件，内容如下：
+
+```conf
+location /business/portal {
+    proxy_pass http://localhost:8081/project-business-sso/api/business/portal;
+
+    add_header 'Access-Control-Allow-Credentials' 'true';
+    add_header 'Access-Control-Allow-Methods' 'GET, POST';
+}
+```
+
+- 认证 Filter 接入
+  通过配置项接入 filter,需要将以下配置项添加至 nacos 的 common.properties 中。参数配置示例如下：
+
+```properties
+meritdata.cloud.third-filter.class-name=com.meritdata.cloud.filter.ThirdSSoFilter
+meritdata.cloud.third-filter.enable=true
+meritdata.cloud.third-filter.order=1
+meritdata.cloud.third-filter.urlPatterns=/**
+meritdata.cloud.third-filter.parmaters[0].key=clientId
+meritdata.cloud.third-filter.parmaters[0].value=service
+meritdata.cloud.third-filter.parmaters[1].key=userAuthorizationUri
+meritdata.cloud.third-filter.parmaters[1].value=https://cas.merit.com:8443/cas_server/login
+```
+
+![image](./imgs/系统认证集成/cas集成/1-4.jpg)
+<br>
+
+- filter 类示例：
+
+```java
+package com.meritdata.cloud.filter;
+import com.meritdata.cloud.security.standard.service.SkipPathRequestMatcher;
+import org.apache.commons.lang3.StringUtils;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.security.authentication.UsernamePasswordAuthenticationToken;
+import org.springframework.security.core.context.SecurityContextHolder;
+import javax.servlet.*;
+import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpServletResponse;
+import java.io.IOException;
+import java.net.URLEncoder;
+import java.util.*;
+/**在会话之前进行拦截跳转至认证页面*/
+public class ThirdSSoFilter implements Filter {
+    private static Logger logger = LoggerFactory.getLogger(ThirdSSoFilter.class);
+    private String webServerUri;
+    private String securityAnon;
+    private String clientId;
+    private String userAuthorizationUri;
+    /**
+     * 默认传递参数，匿名配置项和系统入口url信息，其余通过配置meritdata.cloud.third-filter.parmaters传递的参数，可通过filterConfig.getInitParameter("key")获取
+     */
+    @Override
+    public void init(FilterConfig filterConfig) throws ServletException {
+        logger.info("filterConfig is init");
+        this.webServerUri = filterConfig.getInitParameter("webServer");
+        this.securityAnon = filterConfig.getInitParameter("securityAnon");
+        this.clientId = filterConfig.getInitParameter("clientId");
+        this.userAuthorizationUri = filterConfig.getInitParameter("userAuthorizationUri");
+    }
+
+    @Override
+    public void doFilter(ServletRequest servletRequest, ServletResponse servletResponse, FilterChain filterChain) throws IOException, ServletException {
+        String processingPath = "/**"; //　需要登录认证的url
+        List<String> pathsToSkip = Arrays.asList(securityAnon.split(","));  //匿名url
+        SkipPathRequestMatcher skipPathRequestMatcher = new SkipPathRequestMatcher(pathsToSkip, processingPath);
+        HttpServletRequest request = (HttpServletRequest) servletRequest;
+        //如果是匿名的资源链接,或者已经有会话信息则直接跳过
+        if (skipPathRequestMatcher.matches(request) ||
+                (SecurityContextHolder.getContext().getAuthentication() instanceof UsernamePasswordAuthenticationToken)) {
+            filterChain.doFilter(servletRequest, servletResponse);
+            return;
+        }
+        //判断是否有用户标识，如果有则跳过，如果没有则回调到认证地址
+        if(StringUtils.isNotBlank(request.getParameter("userId"))||StringUtils.isNotBlank(request.getHeader("userId"))) {
+            filterChain.doFilter(servletRequest, servletResponse);
+        } else {
+            ((HttpServletResponse)servletResponse).sendRedirect(getAuthorizationUri());
+        }
+    }
+    private String getAuthorizationUri() {
+        String webUrl = URLEncoder.encode(webServerUri+"/business/portal");
+        return this.userAuthorizationUri+"?"+this.clientId+"="+webUrl;
+    }
+    @Override
+    public void destroy() {}
+}
+```
+
+### 4.4 部署步骤
+
+​	如果是6.9版本及之前，将filter的jar包放在apps/system/server/gateway/WEB-INF/lib目录下
+
+​	如果是1.10-6.12版本，将filter的jar包放在apps/system/server/gateway-dev-lib目录下，如果没有gateway-dev-lib目录则新建
+
+​    如果是6.13版本，将filter的jar包放在apps/system/server/manage-dev-lib目录下，如果没有manage-dev-lib目录则新建
+
+### 4.5 认证登录
+
+认证登录地址：http://localhost:8080/business/portal
+
+## 附录 1: 认证中心端配置
+
+#### 1.1 创建证书
+
+a.在 C 盘新建目录/resource/cas
+b.开始 > 运行 > cmd ：cd resource/cas
+
+```
+keytool -genkey -alias tomcat -keystore C:\resource\cas\mykeystore -keyalg RSA -validity 2000
+
+```
+
+![image](./imgs/系统认证集成/cas集成/1-5.jpg)
+| 名称 | 值 |
+| -------------------- | ------------- |
+| 口令 | changeit |
+| 名字和姓氏 | cas.merit.com |
+| 组织名称/单位名称 | merit |
+| 所在的城市或区域名称 | Xian |
+| 所在的州或者省份 | Shanxi |
+如果顺利执行以上的代码 则会在电脑的 C:/resource/cas 目录下生成 mykeystore 的文件。
+
+#### 1.2 导出证书
+
+步骤如下：开始 > 运行 > cmd ：cd resource/cas
+
+```
+ keytool -export -alias tomcat -keystore C:\resource\cas\mykeystore -file server.crt
+```
+
+输入密码：changeit
+如果顺利执行， 则会在电脑的 C:/resource/cas 目录下生成 server.crt 的文件。
+
+#### 1.3 删除 tomcat 中原有 JRE 证书
+
+步骤如下：开始 > 运行 > cmd ：cd resource/cas
+
+```
+keytool -delete -alias tomcatMerit -file C:\resource\cas\server.crt -keystore D:\cas-server\jdk1.7.0_07\jre\lib\security\cacerts
+```
+
+证书所在路径：C:\resource\cas\server.crt
+Tomact 中 jre 下 cacerts 文件的所在路径：D:\cas-server\jdk1.7.0_07\jre\lib\security\cacerts
+
+注意：
+此处的 JRE 一定是 tomcat 所使用的 JRE，并且目录中不能有空格，通常默认的 jdk 安装路径都会含有空格，所以需要重新复制 JDK 目录。
+
+#### 1.4 将证书导入 JRE
+
+步骤如下：开始 > 运行 > cmd ：cd resource/cas
+
+```
+keytool -import -alias tomcatMerit -file C:\resource\cas\server.crt -keystore D:\cas-server\jdk1.7.0_07\jre\lib\security\cacerts
+```
+
+证书所在路径：C:\resource\cas\server.crt
+Tomact 中 jre 下 cacerts 文件的所在路径：D:\cas-server\jdk1.7.0_07\jre\lib\security\cacerts
+
+注意：
+此处的 JRE 一定是 tomact 所使用的 JRE，并且目录中不能有空格，通常默认的 jdk 安装路径都会含有空格，所以需要重新复制 JDK 目录。
+
+#### 1.5 cas_server 数据库配置
+
+在 cas-server\webapps\cas_server\WEB-INF\deployerConfigContext.xml 修改如下，这里根据实际情况填写，如果认证中心使用的 MYSQL 数据库，则需要在
+（cas-server\webapps\cas_server\WEB-INF\lib）目录下添加相应的数据库驱动包。
+本案例中使用的是 mysql 数据库，添加的驱动包为 mysql-connector-java-5.1.12.jar,如果是其他数据库，操作相同
+
+```xml
+<bean id="dataSource" class="org.springframework.jdbc.datasource.DriverManagerDataSource">
+   <property name="driverClassName"><value>com.mysql.jdbc.Driver</value></property>
+   <property name="url"><value>jdbc:mysql://191.168.4.17:3336/cloud</value></property>
+   <property name="username"><value>用户名</value></property>
+   <property name="password"><value>密码</value></property>
+</bean>
+```
+
+注意： cas_server 所配置的数据库中表信息中存在登录使用的账号和密码，在应用开发平台数据库中也必须存在，并且保持账号和密码一致。
+
+如果 cas_server 数据库配置连接的是应用开发平台的数据库，
+由于加密方式不同，需要在数据库改一下登录密码
+本案例使用登录的账号如下：
+登录名：admin
+密码：111111
+则需要在应用开发平台的数据库中更改账号名为 admin 用户的密码为：96e79218965eb72c92a549dd5a330112