CAS 6.5 安装部署

从cas-overlay-template安装apereo cas 6.5并连接CAS客户端cas-overlay-template

一 什么是单点登录

简单点说 单点登录的英文名称为Single Sign-On，简写为SSO，它是一个用户认证的过程，允许用户一次性进行认证之后，就访问系统中不同的应用；而不需要访问每个应用时，都重新输入密码。

二 认证流程

用户第一次访问受保护的应用，将会重定向到cas登录页面 用户输入用户名和密码，cas server 认证用户创建sso
session,并生成TGT和改客户端的服务票据（ST） 应用拿着ST到 CAS
服务验证ST,验证通过后设置session和cookie返回浏览器 用户浏览器携带cookie访问，应用验证后返回内容 访问第二个cas
client 应用，此时cookie中有TGT但是没有ST，应用要求去CAS 服务获取ST,cas 服务验证TGT并生成一个ST
客户端携带ST访问应用，应用服务区Cas server 验证ticket,验证成功后设置session,cookie,重定向到应用服务地址
展示第二个应用的内容

三. cas-overlay-template安装环境

JDK11
TOMCAT 9
GRADLE
GIT

四.下载项目并编译

git clone https://github.com/apereo/cas-overlay-template.git

执行./gradlew.bat clean build 第一次构建比较慢，耐心等待
./gradlew.bat explodeWar 解压
此时将会在bulid目录下生成一个cas-resources 文件夹，我们把里面的文件全部拷贝到src/main/resources,将\etc\cas\thekeystore 也拷贝到该目录下

更改配置application.properties server.ssl.key-store=classpath:thekeystore

./gradlew.bat run 将cas运行在内嵌的 Embedded Tomcat 中

启动完成后浏览器中打开 https://localhost:8443/cas/login ，

此时我们的cas已经部署成功 在登录也面输入用户名和密码 casuser Mellon ,出现下面界面表明cas已经部署成功

五.客户端应用接入CAS 服务

github 上有个简单的demo我们下载下来 https://github.com/casinthecloud/java-jasig-cas-client-demo.git

有一点错误，修改一下,加入如下依赖

   javax.servlet
   javax.servlet-api
   3.0.1
   provided

接入cas 主要需要配置三个filter即可，下面是完整的web.xml配置

   Demo webapp protected by the Java Jasig / Apereo CAS client

   
   
      CAS Single Sign Out Filter
      org.jasig.cas.client.session.SingleSignOutFilter
      
         casServerUrlPrefix
         http://localhost:8080/cas
      
   
   
      CAS Single Sign Out Filter
      /*
   
   
   
      org.jasig.cas.client.session.SingleSignOutHttpSessionListener
      
   

   
   
   
      CAS Authentication Filter
      org.jasig.cas.client.authentication.AuthenticationFilter
      
      
         casServerLoginUrl
         https://localhost:8443/cas/login
         
      
      
         serverName
         http://localhost:8081
      
      
         method
         redirect
      
   
   
      CAS Authentication Filter
      /protected/*
   

   
   
   
      CAS Validation Filter
      org.jasig.cas.client.validation.Cas30ProxyReceivingTicketValidationFilter
      
      
         casServerUrlPrefix
         https://localhost:8443/cas
      
      
         serverName
         http://localhost:8081
      
   
   
      CAS Validation Filter
      *
   

   
   
      CAS HttpServletRequest Wrapper Filter
      org.jasig.cas.client.util.HttpServletRequestWrapperFilter
   
   
      CAS HttpServletRequest Wrapper Filter
      *
   
 

NOW让我们部署一下该项目，逐一端口为8081，启动服务后打开http://localhost:8081，激动人心的时刻到了。。。。

发现在访问受保护的页面时 出现如下问题：

未认证授权的服务
不允许使用CAS来认证您访问的目标应用。

什么问题呢，看起来是CAS服务不认识我们的应用。是的，我们并没有在CAS中注册该应用，那接下来注册一下应用

Cas 6 提供了已json格式的文件来完成客户端应用的注册

现在 我们将 /etc/cas/services目录也拷贝到 src\main\resources\下，简单做一下修改即可

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

在原有的https和imaps基础上增加了http应用,我们还需要再application.properties中配置注册文件的位置

cas.serviceRegistry.initFromJson=false
cas.serviceRegistry.json.location=classpath:/services

并且需要在build.gradle中加入依赖包

dependencies {
    // Other CAS dependencies/modules may be listed here...
    compile "org.apereo.cas:cas-server-support-json-service-registry:${casServerVersion}"

}

好了一切就绪，重新编译，重启服务，再次访问我们看到如下界面

ok，我们输入静态认证用户casuser和密码Mellon 登录
CAS客户端不信任CAS服务器提供的证书。我们使用keytool工具生成证书并导入jdk信任库中，

keytool -genkeypair -alias cas -keyalg RSA -keypass changeit -storepass changeit -keystore D:/sso-crt/thekeystore

keytool -exportcert -alias cas -storepass changeit -keystore D:/sso-crt/thekeystore  -file D:/sso-crt/cas.cer

keytool -import -keystore "D:/tool/jdk-11/lib/security/cacerts" -file D:/sso-crt/cas.cer -alias cas

一切就绪，重新启动项目并登录

六.部署在外部的Tomcat中

在tomcat的server.xml中配置ssl

另外根据文档我们还需添加下面的依赖

dependencies {
    // Other CAS dependencies/modules may be listed here...
    compile "org.apereo.cas:cas-server-webapp:${casServerVersion}"

}

将bulid/lib中的cas.war 拷贝到tomcat的webapp中，启动即可正常访问

七.参考资料

https://apereo.github.io/cas/6.1.x/installation/WAR-Overlay-Installation.html

https://github.com/apereo/cas-overlay-template