izerui/cas-server-integration-redis

Cas ticket registry , This project has been included by cas

Download

Step 1. Add the JitPack repository to your build file

Add it in your root settings.gradle at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url 'https://jitpack.io' }
		}
	}

Add it in your settings.gradle.kts at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url = uri("https://jitpack.io") }
		}
	}

Add to pom.xml

	<repositories>
		<repository>
		    <id>jitpack.io</id>
		    <url>https://jitpack.io</url>
		</repository>
	</repositories>

Add it in your build.sbt at the end of resolvers:

 
    resolvers += "jitpack" at "https://jitpack.io"

Add it in your project.clj at the end of repositories:

 
    :repositories [["jitpack" "https://jitpack.io"]]

Step 2. Add the dependency

	dependencies {
		implementation 'com.github.izerui:cas-server-integration-redis:1.1.1-RELEASE'
	}

	dependencies {
		implementation("com.github.izerui:cas-server-integration-redis:1.1.1-RELEASE")
	}

	<dependency>
	    <groupId>com.github.izerui</groupId>
	    <artifactId>cas-server-integration-redis</artifactId>
	    <version>1.1.1-RELEASE</version>
	</dependency>


                            
    libraryDependencies += "com.github.izerui" % "cas-server-integration-redis" % "1.1.1-RELEASE"


                            
    :dependencies [[com.github.izerui/cas-server-integration-redis "1.1.1-RELEASE"]]

Readme

实现cas ticket基于redis的集群

该项目已经提交到官方cas5.1后续版本模块中。详情见: https://github.com/apereo/cas/pull/2233

目的

克服cas单点故障，将cas认证请求分发到多台cas服务器上，降低负载。

实现思路：

采用统一的ticket存取策略，所有ticket的操作都从中央缓存redis中存取。
采用session共享，session的存取都从中央缓存redis中存取。

前提：

这里只讲解如何实现cas ticket的共享，关于session的共享请移步：

<a href="https://github.com/izerui/tomcat-redis-session-manager">https://github.com/izerui/tomcat-redis-session-manager</a>

实现步骤：

1. 添加相关依赖

maven:

添加仓库:

  <repositories>
      <repository>
          <id>jitpack.io</id>
          <url>https://jitpack.io</url>
      </repository>
  </repositories>

添加依赖:

  <dependency>
	    <groupId>com.github.izerui</groupId>
	    <artifactId>cas-server-integration-redis</artifactId>
	    <version>1.1.1-RELEASE</version>
	</dependency>

gradle:

添加仓库:

  allprojects {
		repositories {
			...
			maven { url 'https://jitpack.io' }
		}
	}

添加依赖

  dependencies {
	        compile 'com.github.izerui:cas-server-integration-redis:1.1.1-RELEASE'
	}

2. 替换默认的ticket存取策略

cas 4.1.x 以前版本

修改文件 WEB-INF\spring-configuration\ticketRegistry.xml

<bean id="ticketRegistry" class="org.jasig.cas.ticket.registry.DefaultTicketRegistry" />

替换为

<bean id="ticketRegistry" class="ren.boot.cas.ticket.registry.RedisTicketRegistry">
    <constructor-arg index="0" ref="redisTemplate" />

    <!-- TGT timeout in seconds -->
    <constructor-arg index="1" value="1800" />

    <!-- ST timeout in seconds -->
    <constructor-arg index="2" value="300" />
</bean>
<!-- redis连接池 -->
<bean id="jedisConnFactory"
      class="org.springframework.data.redis.connection.jedis.JedisConnectionFactory"
      p:hostName="192.168.1.89"
      p:database="0"
      p:usePool="true"/>
<bean id="redisTemplate" class="org.jasig.cas.ticket.registry.TicketRedisTemplate"
      p:connectionFactory-ref="jedisConnFactory"/>

注意：里面的 jedisConnFactory链接信息修改为自己的连接串，这里选择database 0 为存放cas票据的数据库

cas 4.2.x :

在spring 上下文中声明如下即可:

<!-- 票据保存方式及有效期设置 -->
<alias name="redisTicketRegistry" alias="ticketRegistry" />
<bean id="redisTicketRegistry" class="ren.boot.cas.ticket.registry.RedisTicketRegistry"
    p:client-ref="ticketRedisTemplate"
    p:tgtTimeout="28800"
    p:stTimeout="10"/>
<!-- redis连接池 -->
<bean id="jedisConnFactory"
      class="org.springframework.data.redis.connection.jedis.JedisConnectionFactory"
      p:hostName="localhost"
      p:database="0"
      p:usePool="true"/>
<bean id="ticketRedisTemplate" class="ren.boot.cas.ticket.registry.TicketRedisTemplate"
      p:connectionFactory-ref="jedisConnFactory"/>