当前位置： 首页 > article >正文

【Springboot知识】Springboot进阶-实现CAS完整流程

article 2024/12/28 18:38:53

Springboot实现CAS完整流程

    • 服务端搭建
      • 一、准备环境
      • 二、下载并配置CAS服务端软件
      • 三、配置Tomcat服务器
      • 四、配置CAS服务端
      • 五、启动CAS服务端
      • 六、（可选）配置HTTPS
    • 客户端实现
      • 一、后端（Spring Boot）配置
        • 1. 引入CAS客户端依赖
        • 2. 配置CAS属性
        • 3. 配置过滤器
        • 4. 创建登录接口
        • 5. 配置安全策略
      • 二、前端（Vue）配置
        • 1. 创建登录页面
        • 2. 配置路由守卫
        • 3. 处理登录回调
        • 4. 获取用户信息
      • 三、集成与测试
    • 参考文献

服务端搭建

CAS（Central Authentication Service）服务端搭建是一个涉及多个步骤的过程，以下是详细的步骤说明：

一、准备环境

  1. 安装JDK：

    • 确保已安装Java Development Kit (JDK) 版本8或更高版本。CAS 5.x版本推荐使用JDK 8，而CAS 6.x版本则至少需要JDK 11。

  2. 安装Maven：

    • Maven是一个项目管理和构建工具，用于构建和管理Java项目依赖。

  3. 安装Tomcat：

    • Tomcat是一个开源的Web服务器和Servlet容器，用于部署CAS服务端。确保下载的Tomcat版本与CAS版本兼容。

二、下载并配置CAS服务端软件

  1. 访问GitHub仓库：

    • 访问GitHub上的CAS Overlay Template仓库，这是CAS官方提供的用于生成CAS服务端部署包的模板。

  2. 下载CAS版本：

    • 根据需要选择并下载与CAS版本相对应的zip包。例如，如果需要搭建CAS 5.3版本的服务端，则下载对应的zip包。

  3. 解压并构建项目：

    • 解压下载的zip包，并使用Maven构建项目。在解压后的项目目录中执行mvn package命令，Maven会下载所需的依赖并构建项目。构建完成后，会在target目录下生成一个CAS的WAR包（如cas.war）。

三、配置Tomcat服务器

  1. 下载并解压Tomcat：

    • 下载Tomcat服务器，并解压到合适的目录。

  2. 修改server.xml文件：

    • 在Tomcat的conf目录下找到server.xml文件，并修改其中的端口配置。例如，将默认的HTTP端口从8080修改为其他端口（如8888），或者配置HTTPS端口。

  3. 部署CAS应用：

    • 将生成的cas.war包复制到Tomcat的webapps目录下。Tomcat会自动解压WAR包并部署应用。

四、配置CAS服务端

  1. 找到application.properties文件：

    • 在Tomcat的webapps/cas/WEB-INF/classes目录下找到application.properties文件。

  2. 修改配置文件：

    • 根据需要修改application.properties文件中的配置。例如，支持HTTP访问、配置数据库连接等。
    • 如果使用JDBC认证，则需要配置数据库连接信息，包括数据库驱动类、URL、用户名、密码和查询SQL等。

  3. 配置服务：

    • 根据需要配置CAS服务。例如，修改services目录下的JSON文件，以支持所需的服务。

五、启动CAS服务端

  1. 启动Tomcat服务器：

    • 在Tomcat的bin目录下执行启动脚本（start.bat或startup.sh），启动Tomcat服务器。

  2. 访问CAS登录页面：

    • 打开浏览器，访问CAS登录页面（如http://localhost:8888/cas/login，端口号根据配置可能有所不同）。
    • 使用默认的用户名和密码（如casuser:Mellon，或你在application.properties中配置的用户名和密码）进行登录。
    • 登录成功后，你应该会看到CAS的验证成功页面或重定向到你配置的服务页面。

六、（可选）配置HTTPS

  1. 生成密钥库：

    • 使用Java的keytool工具生成密钥库，并配置Tomcat以使用HTTPS。

  2. 修改Tomcat配置：

    • 在Tomcat的conf/server.xml文件中配置HTTPS连接器，并指定密钥库文件和密码。

  3. 重启Tomcat：

    • 重启Tomcat服务器以使HTTPS配置生效。

通过以上步骤，您可以成功搭建并运行CAS服务端。如果遇到任何问题，请检查配置和日志文件以获取更多信息。

客户端实现

实现Spring Boot后端与Vue前端结合CAS（Central Authentication Service）的登录过程，需要分别在后端和前端进行配置和编写代码。以下是一个尽可能详细的指南，包括配置和代码示例。

一、后端（Spring Boot）配置

1. 引入CAS客户端依赖

在Spring Boot项目的pom.xml文件中添加CAS客户端的Maven依赖。这里以cas-client-support-spring-boot-web为例（注意，实际依赖可能有所不同，请查阅最新的Maven仓库）：

<dependency>
    <groupId>org.apereo.cas.client</groupId>
    <artifactId>cas-client-support-spring-boot-web</artifactId>
    <version>YOUR_CAS_CLIENT_VERSION</version>
</dependency>
2. 配置CAS属性

在application.properties或application.yml文件中配置CAS相关的属性。例如：

cas:
  server-url-prefix: https://your-cas-server.com/cas
  server-login-url: ${cas.server-url-prefix}/login
  server-logout-url: ${cas.server-url-prefix}/logout
  client-host-url: http://your-springboot-app.com
  client-callback-url: ${cas.client-host-url}/login/cas
  service: ${cas.client-callback-url}
  validation-type: CAS20
3. 配置过滤器

Spring Boot项目会自动配置CAS过滤器，但您可能需要自定义一些行为。例如，您可以创建一个配置类来覆盖默认的过滤器配置：

import org.apereo.cas.client.session.SingleSignOutFilter;
import org.apereo.cas.client.validation.Cas20ServiceTicketValidator;
import org.apereo.cas.client.validation.Cas20ProxyReceivingTicketValidator;
import org.apereo.cas.client.validation.Cas30ServiceTicketValidator;
import org.springframework.boot.web.servlet.FilterRegistrationBean;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import javax.servlet.Filter;

@Configuration
public class CasConfig {
    @Bean
    public FilterRegistrationBean<SingleSignOutFilter> singleSignOutFilter() {
        FilterRegistrationBean<SingleSignOutFilter> registrationBean = new FilterRegistrationBean<>();
        registrationBean.setFilter(new SingleSignOutFilter());
        registrationBean.addUrlPatterns("/*");
        registrationBean.setOrder(1);
        return registrationBean;
    }

    // 其他过滤器配置，如CasAuthenticationFilter, CasValidationFilter等，
    // 根据您的具体需求进行配置。这里只展示了SingleSignOutFilter的配置作为示例。
}

注意：上面的代码示例只展示了SingleSignOutFilter的配置，实际上您可能还需要配置CasAuthenticationFilter、CasValidationFilter等过滤器。这些过滤器的配置通常涉及到CAS的票据验证、用户认证等流程。由于这些配置可能相对复杂，并且具体实现可能因CAS版本和Spring Boot版本的不同而有所差异，因此建议查阅CAS官方文档和Spring Boot相关配置指南来获取更详细的配置信息。

4. 创建登录接口

由于CAS的登录流程通常是由CAS服务器控制的，因此您不需要在Spring Boot后端创建一个处理用户名和密码的登录接口。但是，您需要创建一个接口来处理CAS登录后的回调。这个接口通常用于接收CAS服务器重定向回来的票据（Service Ticket），并验证其有效性。验证成功后，您可以设置用户的会话信息，并重定向到前端应用的首页或其他页面。

5. 配置安全策略

使用Spring Security来配置安全策略。在Spring Security的配置类中，添加对CAS客户端的支持，并配置哪些URL需要认证。以下是一个简单的Spring Security配置示例：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity;
import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter;
import org.springframework.security.cas.ServiceProperties;
import org.springframework.security.cas.authentication.CasAuthenticationEntryPoint;
import org.springframework.security.cas.authentication.CasAuthenticationFilter;
import org.springframework.security.cas.authentication.CasAuthenticationProvider;
import org.springframework.security.cas.web.CasAuthenticationFilterEntryPoint;
import org.springframework.security.cas.web.CasAuthenticationEntryPoint;
import org.springframework.security.core.userdetails.UserDetailsByNameServiceWrapper;
import org.springframework.security.core.userdetails.UserDetailsService;
import org.springframework.security.web.authentication.logout.LogoutFilter;
import org.springframework.security.web.authentication.logout.LogoutHandler;
import org.springframework.security.web.authentication.logout.SecurityContextLogoutHandler;

import java.util.ArrayList;
import java.util.List;

@Configuration
@EnableWebSecurity
public class SecurityConfig extends WebSecurityConfigurerAdapter {

    // ... 省略了部分代码，如ServiceProperties、UserDetailsService的配置等 ...

    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http
            .csrf().disable() // 禁用CSRF保护，因为CAS登录通常不涉及表单提交
            .authorizeRequests()
                .antMatchers("/public/**").permitAll() // 公开访问的URL
                .anyRequest().authenticated() // 其他URL需要认证
                .and()
            .exceptionHandling().authenticationEntryPoint(casAuthenticationEntryPoint())
            .and()
            .addFilterBefore(casAuthenticationFilter(), BasicAuthenticationFilter.class)
            .addFilterBefore(singleSignOutFilter(), CasAuthenticationFilter.class)
            .logout()
                .logoutUrl("/logout")
                .logoutSuccessUrl("/")
                .addLogoutHandler(casLogoutHandler())
                .deleteCookies("JSESSIONID");
    }

    // ... 省略了casAuthenticationEntryPoint()、casAuthenticationFilter()等方法的实现 ...
}

注意：上面的代码示例是一个简化的Spring Security配置，它展示了如何将CAS集成到Spring Security中。实际上，您可能需要根据您的具体需求进行更详细的配置，如配置用户服务（UserDetailsService）、配置CAS的票据验证器（TicketValidator）等。这些配置通常涉及到CAS服务器的具体实现和您的Spring Boot应用的业务逻辑。

由于CAS集成涉及到多个方面的配置和代码实现，并且具体实现可能因CAS版本、Spring Boot版本以及您的具体需求而有所不同，因此建议查阅CAS官方文档和Spring Security相关配置指南来获取更详细的配置信息和代码示例。

二、前端（Vue）配置

1. 创建登录页面

在Vue项目中创建一个登录页面，提供一个按钮或链接让用户点击后跳转到CAS服务器的登录页面。由于CAS的登录流程是由CAS服务器控制的，因此您不需要在前端处理用户名和密码的输入和验证。相反，您可以简单地将用户重定向到CAS服务器的登录URL。

2. 配置路由守卫

在Vue项目的路由守卫中检查用户是否已经登录。如果用户未登录，则重定向到登录页面（实际上这个登录页面会立即重定向到CAS服务器的登录页面）。如果用户已经登录（例如，从CAS服务器登录成功后重定向回来），则允许用户访问受保护的路由。

3. 处理登录回调

当用户从CAS服务器登录成功后，CAS服务器会重定向回您的Spring Boot应用提供的回调URL（在application.properties或application.yml中配置）。Spring Boot应用会验证票据的有效性，并设置用户的会话信息。然后，Spring Boot应用可以重定向回Vue应用的首页或其他页面，并附带一个表示登录成功的标志（如查询参数、cookie或Vuex状态）。

在Vue项目中，您需要处理这个重定向回调，并根据登录成功的标志来更新Vuex状态或执行其他操作。例如，您可以在Vue的路由守卫中检查查询参数或cookie来确定用户是否已登录，并相应地更新Vuex状态。

4. 获取用户信息

如果需要在Vue项目中显示用户的信息（如用户名、头像等），您可以通过调用后端接口来获取这些信息。后端接口可以从会话中获取用户信息，并返回给前端。在Vue项目中，您可以使用axios或其他HTTP客户端库来调用这个后端接口，并将返回的用户信息存储在Vuex状态或组件的data属性中。

三、集成与测试

  1. 启动后端服务：确保您的Spring Boot应用已经正确配置并启动。

  2. 启动前端服务：确保您的Vue项目已经正确配置并启动。

  3. 测试登录流程：打开Vue项目的登录页面，点击登录按钮或链接。浏览器应该会重定向到CAS服务器的登录页面。输入正确的用户名和密码后，CAS服务器会验证用户身份，并重定向回您的Spring Boot应用的回调URL。Spring Boot应用会验证票据的有效性，并设置用户的会话信息。然后，Spring Boot应用可以重定向回Vue应用的首页或其他页面，并附带一个表示登录成功的标志。在Vue项目中，处理这个重定向回调，并根据登录成功的标志来

参考文献

【知识科普】统一身份认证CAS


http://www.kler.cn/a/455308.html

相关文章：

  • KOI技术-事件驱动编程（前端）
  • 68jQuery【jQuery操作DOM、事件】
  • 云计算时代携程的网络架构变迁
  • 【视觉惯性SLAM：六、图优化库(1):g2o的使用指南】
  • 【漫话机器学习系列】022.微积分中的链式求导法则（chain rule of Calculus）
  • 大模型应用技术系列(三): 深入理解大模型应用中的Cache：GPTCache
  • 计算机网络 （10）网络层
  • LinkedList类 (链表)
  • 线性代数行列式
  • ABC 385G(Counting Buildings-多项式)
  • Perl 特殊变量
  • Java爬虫实战：获取亚马逊商品评论详解
  • 实战案例——ZooKeeper集群部署（新手教程超详细）
  • 【程序】C语言右左法则----复杂指针解析
  • GTM023 W.H.Greub线性代数经典教材：Linear Algebra
  • 如何调用百度文心（Baidu Wenxin）和讯飞星火（iFlytek Spark）API
  • 《一文读懂卷积网络CNN：原理、模型与应用全解析》
  • IBatis和MyBatis在细节上的不同有哪些
  • python递归最多多少层
  • 【YOLOv3】源码（train.py）
  • Cascader 级联选择器一级单选二级多选
  • TCP off-path exploits(又一个弄巧成拙的例子)
  • PyAudio库基本知识详解——为自制PCM音频播放器做准备
  • 指针详解之 难点、易错点一次性彻底击碎！
  • vue3和springboot使用websocket通信
  • AI发展新态势:从技术突破到安全隐忧