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

package/skills/meritdata-dev-docs-file-finder/references/dev-docs//346/224/273/347/225/245-06-/347/263/273/347/273/237/350/256/244/350/257/201-/347/253/240/350/212/20202_token_/350/256/244/350/257/201/351/233/206/346/210/220.md

@@ -0,0 +1,568 @@
+---
+name: 攻略-06-系统认证-章节02_token_认证集成
+description: token 认证集成 — 美林平台系统认证集成攻略（token 认证 / CAS 统一认证 / 第三方认证中心）
+keywords: [系统认证, token认证, CAS单点登录, 第三方认证, SSO, JRE证书, RSAUtils, token 认证集成]
+use-cases: [token 集成, CAS 单点登录集成, 第三方认证中心对接, 认证中心端配置]
+source-section: 2. token 认证集成
+source-file: 应用开发平台-基础平台-使用攻略（四）：系统认证集成.md
+---
+
+# 2 token 认证集成
+
+## 📋 API 契约（机器可读）
+
+```json
+{
+  "apiName": "IPortalSSOApi",
+  "type": "java",
+  "signature": "class IPortalSSOApi",
+  "functionDesc": "2nd-dev 必实现的 SSO 接口（getUserIdAndToken）",
+  "module": "platform",
+  "methods": [
+    "String[] getUserIdAndToken(Map)"
+  ],
+  "bestPractice": "确保方法抛出的异常已被 Service 层 catch 或全局异常处理器处理"
+}
+```
+
+### 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)

package/skills/meritdata-dev-docs-file-finder/references/dev-docs//346/224/273/347/225/245-06-/347/263/273/347/273/237/350/256/244/350/257/201-/347/253/240/350/212/20203_cas_/347/273/237/344/270/200/350/256/244/350/257/201/344/270/255/345/277/203.md

@@ -0,0 +1,128 @@
+---
+name: 攻略-06-系统认证-章节03_cas_统一认证中心
+description: cas 统一认证中心 — 美林平台系统认证集成攻略（token 认证 / CAS 统一认证 / 第三方认证中心）
+keywords: [系统认证, token认证, CAS单点登录, 第三方认证, SSO, JRE证书, RSAUtils, cas 统一认证中心]
+use-cases: [token 集成, CAS 单点登录集成, 第三方认证中心对接, 认证中心端配置]
+source-section: 3. cas 统一认证中心
+source-file: 应用开发平台-基础平台-使用攻略（四）：系统认证集成.md
+---
+
+# 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 用户认证成功后会默认跳转到系统首页。如果访问的是系统内的某个业务页面，会跳转至该页面