08-17 04:13 阅读 587

CAS5.3服务器搭建与客户端整合SpringBoot以及踩坑笔记

cas服务器的搭建

导出证书(1和2步骤是找了课程，随便写了一下存记录，不过对于自己测试不投入使用应该不影响)

C:\Users\Ddlm2>keytool -genkey -alias testcas -keystore D:/testcas -storepass 123456 -keyalg RSA -validity 3650
您的名字与姓氏是什么?
  [Unknown]:  test您的组织单位名称是什么?
  [Unknown]:  test您的组织名称是什么?
  [Unknown]:  test您所在的城市或区域名称是什么?
  [Unknown]:  test您所在的省/市/自治区名称是什么?
  [Unknown]:  test该单位的双字母国家/地区代码是什么?
  [Unknown]:  testCN=test, OU=test, O=test, L=test, ST=test, C=test是否正确?
  [否]:  Y

输入 <testcas> 的密钥口令
        (如果和密钥库口令相同, 按回车):
再次输入新口令:

Warning:
JKS 密钥库使用专用格式。建议使用 "keytool -importkeystore -srckeystore D:/testcas -destkeystore D:/testcas -deststoretype pkcs12" 迁 移到行业标准格式 PKCS12。



C:\Users\Ddlm2>keytool -genkey -alias testcas -keystore D:/testcas -storepass 123456 -keyalg RSA -validity 3650 -export -trustcacerts -file D:/testcas.cer
存储在文件 <D:/testcas.cer> 中的证书

Warning:
JKS 密钥库使用专用格式。建议使用 "keytool -importkeystore -srckeystore D:/testcas -destkeystore D:/testcas -deststoretype pkcs12" 迁 移到行业标准格式 PKCS12。

导入jdk的证书库

C:\Users\Ddlm2>keytool -import -trustcacerts -alias testcas -file D:/testcas.cer输入密钥库口令:再次输入新口令:所有者: CN=test, OU=test, O=test, L=test, ST=test, C=test发布者: CN=test, OU=test, O=test, L=test, ST=test, C=test序列号: 429f9b95生效时间: Fri Aug 13 11:15:22 CST 2021, 失效时间: Mon Aug 11 11:15:22 CST 2031证书指纹:
         SHA1: 3A:20:B4:25:12:96:6E:EB:F7:15:15:BE:11:A7:C5:66:60:25:D6:A8
         SHA256: 06:80:FC:34:63:27:20:ED:6E:74:CB:51:2B:5B:86:E0:70:C2:CD:65:36:46:52:13:25:0A:B4:9B:7F:67:31:B7签名算法名称: SHA256withRSA主体公共密钥算法: 2048 位 RSA 密钥版本: 3扩展:#1: ObjectId: 2.5.29.14 Criticality=falseSubjectKeyIdentifier [KeyIdentifier [0000: 24 05 3F B0 42 A4 02 84   70 D1 F2 09 4A AB D8 93  $.?.B...p...J...0010: 8B 29 85 BB                                        .)..]
]是否信任此证书? [否]:  y证书已添加到密钥库中

注：应该是在webapps\cas\WEB-INF\classes中的application.properties中配置(开头7行左右)

不过自己测试，只会提示密码泄露不安全什么的，无大碍。

下载 cas server 安装包，这里使用的是5.3。下面的链接都可以使用

https://github.com/apereo/cas-overlay-template/tree/5.3
----------------------------------------
https://wwa.lanzoui.com/b010pvygd
密码:casserver

打war包。安装maven的环境变量(或者导入idea打包)，在cas-overlay-template-5.3目录打开cmd命令行使用mvn package进行打包，会在target目录下出现cas.war文件，
部署tomcat。将本地tomcat服务器拷贝出来一份，作为cas服务器，将war包复制到webapps下面。运行tomcat，war包会自动解压到car文件夹中。
注：如果cas使用5以上，tomcat必须8以上。

端口映射。在tomcat目录下的conf目录下的server.xml中添加

<Connector port="8332" protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="8443" /><!-- 意为将8332接口转到8443接口 --><!-- 8332是对外的，那么8443呢，cas默认端口就是8443，applicaion.properties中的第5行左右 -->

注：主要为了防止端口号冲突，都可以任意修改。

添加http协议。 webapps\cas\WEB-INF\classes\services下的HTTPSandIMAPS-10000001.json的第三行修改成"serviceId" : "^(https|http|imaps)://.*",使其接受http协议。
也可以自定义用户名。 webapps\cas\WEB-INF\classes下的application.properties 最后那里
cas.authn.accept.users=casuser::Mellon
是默认的用户名和密码，可以修改为自己喜欢的。
重启tomcat，访问localhost:8332/cas/login输入7步骤中的账号密码进行测试。

接下来整理，springboot整合cas client。cas服务器端返回数据在下面。

SpringBoot整合cas客户端

新建maven或者springboot项目都可以，打开pom文件添加依赖。

<dependencies>

    <!-- cas的客户端 -->
    <dependency>
        <groupId>net.unicon.cas</groupId>
        <artifactId>cas-client-autoconfig-support</artifactId>
        <version>2.2.0-GA</version>
        <exclusions>
            <exclusion>
                <groupId>org.jasig.cas.client</groupId>
                <artifactId>cas-client-core</artifactId>
            </exclusion>
        </exclusions>
    </dependency>

    <!-- 使用更高版本的cas-client-core -->
    <dependency>
        <groupId>org.jasig.cas.client</groupId>
        <artifactId>cas-client-core</artifactId>
        <version>3.5.0</version>
    </dependency>

    <!-- 故意降的版本 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
        <version>2.1.3.RELEASE</version>
    </dependency></dependencies>

注：若启动时候报错，且去掉cas相关东西又可以正常启动。可以尝试降一下你自己的springboot版本。

添加启动类，切记@EnableCasClient

import net.unicon.cas.client.configuration.EnableCasClient;import org.springframework.boot.SpringApplication;import org.springframework.boot.autoconfigure.SpringBootApplication;/**
 * @author ddlm
 * @date 2021/08/17 10:53
 */@EnableCasClient@SpringBootApplicationpublic class CASClientOne {    public static void main(String[] args) {
        SpringApplication.run(CASClientOne.class, args);
    }
}

添加配置，这里使用的yml，properties就是:变.和=而已。

server:
  port: 9101cas:
  # cas服务器端的地址和端口，注意端口号。
  server-url-prefix: http://localhost:8332/cas
  server-login-url: http://localhost:8332/cas/login
  # 本地的地址，用于回调回来
  client-host-url: http://localhost:9101
  # 需要拦截的地址(所有为"/*")，可配置数组
  authentication-url-patterns:
    - "/auth/login"
    - "/auth/createOrder"
  validation-type: CAS3

注：拦截的接口是个例子。因为使用场景场景不同：全由cas控制或者只需要登录在自己项目控制。

如果服务端不需要关，只需要使用cas实现单点登录，且获取数据，如果从session中获取，需要配置中开启一下：
cas: use-session: true，对应获取数据就request.getSession().getAttribute("key");

随便写个接口测试。

@RestControllerpublic class TestController {    @RequestMapping("/testFirst")
    public String TestMethod() {        return "This is First Method.";
    }
}

注：确保url在配置中的拦截范围内。

为了方便对比，再新建一个项目，步骤一致，起码接口名、端口名和返回内容修改一下。
启动两个项目，访问第一个项目中的接口，需要登录，登录后。
访问第二个项目的接口，此时不需要登录即为成功。

扩展: 一些博客中，结合了拦截器进行匹配，这个看需要进行添加，主要是可以忽略接口，加几层一般都可以避免，如果使用过滤器注意与配置的交集。

@Configurationpublic class CASConfig {    @Value("${cas.server-url-prefix}")
    private String serverUrlPrefix;    @Value("${cas.server-login-url}")
    private String serverLoginUrl;    @Value("${cas.client-host-url}")
    private String clientHostUrl;    @Value("${ignore-host-url}")
    private String ignoreHostUrl;    /**
     * 授权过滤器
     */
    @Bean
    public FilterRegistrationBean filterAuthenticationRegistration() {
        FilterRegistrationBean registration = new FilterRegistrationBean();
        registration.setFilter(new AuthenticationFilter());        // 设定匹配的路径
        registration.addUrlPatterns("/*");
        Map<String,String> initParameters = new HashMap<>();
        initParameters.put("casServerLoginUrl", serverUrlPrefix);
        initParameters.put("serverName", clientHostUrl);        //忽略的url，"|"分隔多个url
        initParameters.put("ignorePattern", ignoreHostUrl);
        registration.setInitParameters(initParameters);        // 设定加载的顺序
        registration.setOrder(1);        return registration;
    }
}

其中ignore-host-url需要另外在yml中配置。

接下来配置cas服务器从数据库中获取用户名和密码，并返回该人员所有信息(只是测试使用)。

cas服务器连接数据库

获取登录名。为什么多返回更多内容呢，因为用户名默认会返回，这里介绍获取用户名的三种方法。

request.getRemoteUser();

((Assertion) request.getSession().getAttribute(AbstractCasFilter.CONST_CAS_ASSERTION)).getPrincipal().getName();

第二步不getName()，getAttributes();在得到的集合中去get("username"),大概，可以打印出来找一下。

注：从request中能get到的都get过来了，然后转成json输出找到的...

CAS服务器配置连接数据库。

我测试时候是重新打包的，也可以参考这位大佬的博客tomcat8搭建cas服务器，使用MYSQL数据库

或者这位大佬的：cas5.3.1 从搭建到连接mysql(简而优美)，是直接复制jar包进来，不需要重新打包的。

添加需要访问数据库的依赖，在cas-overlay-template-5.3/pom.xml

<dependency>
    <groupId>org.apereo.cas</groupId>
    <artifactId>cas-server-support-jdbc</artifactId>
    <version>${cas.version}</version></dependency><dependency>
    <groupId>org.apereo.cas</groupId>
    <artifactId>cas-server-support-jdbc-drivers</artifactId>
    <version>${cas.version}</version></dependency><dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <!-- 与数据库版本一致 -->
    <version>8.0.23</version></dependency>

注：切记最后面那个版本号一定一定一定要跟自己mysql的版本一致。可百度查看如何查看MySQL版本。

小版本号也要保证一致！！！

打包，部署，重新按照服务器的部署修改一下。

修改 webapps\cas\WEB-INF\classes下的application.properties最后部分，注释掉默认或者自定义的账号密码：
# cas.authn.accept.users=casuser::Mellon

添加：

cas.authn.jdbc.query[0].url=jdbc:mysql://localhost:3306/cas_server_demo?useUnicode=true&characterEncoding=UTF-8&autoReconnect=true&useSSL=false&serverTimezone=Asia/Shanghaicas.authn.jdbc.query[0].principalAttributeList=id,username,password,stunumber,stuclasscas.authn.jdbc.query[0].user=rootcas.authn.jdbc.query[0].password=123456cas.authn.jdbc.query[0].sql=select id,username,password,stu_number as stuNumber,stu_class as stuClass from student where username=?cas.authn.jdbc.query[0].fieldPassword=password# cas.authn.jdbc.query[0].driverClass=com.mysql.jdbc.Drivercas.authn.jdbc.query[0].driverClass=com.mysql.cj.jdbc.Driver# 忽略https安全协议，使用 HTTP 协议cas.tgc.secure=false# 是否开启json识别功能,默认为falsecas.serviceRegistry.initFromJson=true# 指明路径cas.serviceRegistry.json.location=classpath:/services

注：

principalAttributeList中是返回的字段名，如果想要定义别名，需要在sql中使用as重新命名。
注意mysql版本号与driverClass的对应。
未涉及密码加密。
当不需要定义别名时候，sql可以直接select *
见网上说数据库字段名带下划线返回不回来，经过测试可以返回，如果失败定义别名可解决。

修改webapps\cas\WEB-INF\classes\services\HTTPSandIMAPS-10000001.json，最后添加：

{  "@class" : "org.apereo.cas.services.RegexRegisteredService",  "serviceId" : "^(https|http|imaps)://.*",  "name" : "HTTPS and IMAPS",  "id" : 10000001,  "description" : "This service definition authorizes all application urls that support HTTPS and IMAPS protocols.",  "evaluationOrder" : 10000,  "attributeReleasePolicy" : {  "@class" : "org.apereo.cas.services.ReturnAllAttributeReleasePolicy"
  }
}

添加attributeReleasePolicy，注意json格式，上面要添加,

准备MySQL数据库数据

/*
 Navicat Premium Data Transfer

 Source Server         : localMysql
 Source Server Type    : MySQL
 Source Server Version : 80023
 Source Host           : localhost:3306
 Source Schema         : cas_server_demo

 Target Server Type    : MySQL
 Target Server Version : 80023
 File Encoding         : 65001

 Date: 17/08/2021 13:56:44
*/SET NAMES utf8mb4;SET FOREIGN_KEY_CHECKS = 0;-- ------------------------------ Table structure for student-- ----------------------------DROP TABLE IF EXISTS `student`;CREATE TABLE `student`  (  `id` int(0) NOT NULL AUTO_INCREMENT,  `username` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NULL DEFAULT NULL,  `password` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NULL DEFAULT NULL,  `stu_number` int(0) NULL DEFAULT NULL,  `stu_class` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NULL DEFAULT NULL,
  PRIMARY KEY (`id`) USING BTREE
) ENGINE = InnoDB AUTO_INCREMENT = 3 CHARACTER SET = utf8mb4 COLLATE = utf8mb4_0900_ai_ci ROW_FORMAT = Dynamic;-- ------------------------------ Records of student-- ----------------------------INSERT INTO `student` VALUES (1, 'admin', 'admin', 222222424, '234');INSERT INTO `student` VALUES (2, 'test1', 'test1', 123454321, '235');SET FOREIGN_KEY_CHECKS = 1;

重启tomcat，注意启动日志。

springboot cas client取数据，我整理了一个简易工具类。

import org.jasig.cas.client.authentication.AttributePrincipal;import org.jasig.cas.client.util.AbstractCasFilter;import org.jasig.cas.client.validation.Assertion;import javax.servlet.http.HttpServletRequest;import java.util.Map;public class CASUtil {    private static HttpServletRequest request;    /**
     * 从cas中获取用户名
     *
     * @param request Http请求
     * @return 登录cas服务器的用户名
     */
    public static String getAccountNameFromCas(HttpServletRequest request) {
        CASUtil.request = request;
        Assertion assertion = (Assertion) request.getSession().getAttribute(AbstractCasFilter.CONST_CAS_ASSERTION);        if (assertion != null) {
            AttributePrincipal principal = assertion.getPrincipal();            return principal == null ? null : principal.getName();
        } else {            return null;
        }
    }    /**
     * 从cas返回值中获取内容
     *
     * @param request Http 请求
     * @param attr 需要获取值的键名
     * @return 键名attr对应的值
     */
    public static String getAttributeFromCas(HttpServletRequest request, String attr) {
        CASUtil.request = request;
        Assertion assertion = (Assertion) request.getSession().getAttribute(AbstractCasFilter.CONST_CAS_ASSERTION);        if (assertion != null) {
            AttributePrincipal principal = assertion.getPrincipal();            // 一般不会为空，因为有attributes
            if(principal != null) {
                Object obj = principal.getAttributes().get(attr);                return obj == null ? null : obj.toString();
            }
        }        return null;
    }
}

至此，完毕。
整理要点

依赖版本号(cas和springboot的)
@EnableCasClient注解
配置文件中的cas服务器地址、本机地址和需要验证的接口
通过request获取即可
端口(server.xml)
连接数据库(application.properties)
修改json配置文件(HTTPSandIMAPS-10000001.json)
连接数据库依赖的驱动版本号
cas与tomcat版本
cas服务器
cas客户端

当用户名登录不上时候，查看cas服务器命令行是否有异常。

服务器评测 http://www.cncsto.com/

服务器测评 http://www.cncsto.com/

站长资源 https://www.cscnn.com/