安装 CAS 服务器

目录[-]

• 1 CAS 简介
• 2 下载 CAS 服务器
• 3 创建密钥库
• 3.1 生成 keypair
• 3.2 从 keystore 中导出证书
• 3.3 导入证书到 JVM 中
• 4 使 Tomcat 支持 HTTPS
• 5 运行 CAS 服务器 
• 6 部署CAS-Client
• 7 测试验证SSO

• 1 CAS 简介

  CAS 全称为 Central Authentication Service（中央认证服务），它是耶鲁大学发起的一个开源项目，为 Web 应用系统提供一种可靠的单点登录方式，CAS 在 2004 年 12 月正式成为 JA-SIG 的一个项目，它具有以下特点：

  • CAS 是一款开源的企业级单点登录解决方案，为应用系统提供中央认证服务。

  • CAS 服务器是独立部署的 Web 应用，可运行在主流的 Web 容器上，例如：Tomcat、Jetty 等。

  • CAS 客户端支持许多不同语言开发的应用系统，包括：Java、.Net、PHP、Apache、Perl、Ruby 等。

  2 下载 CAS 服务器

  可以从 CAS 官网：http://www.jasig.org/cas 下载，这可能需要FQ，如果你不太愿意FQ的话，可以访问这个地址：http://downloads.jasig.org/cas/，同样可以下载。

  1. 下载 CAS 服务器最新版：cas-server-4.0.0-release.zip

  2. 解压程序包

  3. 复制 cas-server-4.0.0/modules/cas-server-webapp-4.0.0.war 到 Tomcat 的 webapps 目录下，并重命名为 ROOT.war。

  在启动 Tomcat 之前，还需要做两件事情：

  1. 创建 CAS 密钥库

  2. 使 Tomcat 支持 HTTPS

  3 创建密钥库

  使用 JDK 的 keytool 命令生成密钥库（keystore），其实就是一份 keystore 文件，keystore 必须通过密码才能访问。

  keystore 里包含了多个密钥对（keypair），每个 keypair 都有一个别名（alias），alias 必须保证唯一性，而且都有一个密码，有此可知，keystore 与 keypair 都有自己的密码。

  JDK 也有自己的 keystore，位于 %JAVA_HOME%\jre\lib\security\cacerts，其密码就是 changeit，当然也可以通过 keytool 命令来修改。

  我们首先生成 keypair 及其存放 keypair 的 keystore，然后从 keystore 里导出证书，最后将证书导入 JDK 的 keystore 里，Tomcat 在运行时就会自动读取 JDK 的 keystore，以确保所部署的应用可以享受 HTTPS 协议（SSL 通道）带来的安全性。

  3.1 生成 keypair

  使用以下命令生成密钥对：

• keytool -genkey -alias ssodemo -keyalg RSA -keysize 1024 -keypass 123456 -validity 365 -keystore D:\crt\ssodemo.keystore -storepass 123456 或者 
• keytool -genkeypair -alias ssodemo -keyalg RSA -keysize 1024 -keypass 123456 -validity 365 -keystore D:\crt\ssodemo.keystore -storepass 123456

 

注意：

1. 为了简化操作，建议 keystore 与 keypair 的密码相同，且均为 123456。

2. 提示“您的名字与姓氏是什么？”，这里需要输入一个域名，例如：www.xxx.com，本例中输入 cas 需要在 hosts 文件中做如下映射：

   127.0.0.1 demo.ssoserver.com

还有几条常用的 keytool 命令：

查看 keypair：

keytool -list -storepass 123456

删除 keypair：

keytool -delete -alias <别名> -storepass 123456

 

3.2 从 keystore 中导出证书

使用以下命令导出证书：

keytool -export -alias ssodemo -keystore D:\crt\ssodemo.keystore -file D:\crt\ssodemo.crt -storepass 123456  或者 

keytool -exportcert -alias ssodemo -keystore D:\crt\ssodemo.keystore -file D:\crt\ssodemo.crt -storepass 123456

生成的证书文件为 cas.crt，位于D:\crt\的目录下。

可双击该证书文件，将该证书安装到“受信任的根证书颁发机构”中，这样在浏览器中使用 HTTPS 协议访问时才不会出现一个红色的叉叉。

 

3.3 导入证书到 JVM 中

使用以下命令导入证书到 JVM 的 keystore 中：

keytool -import -keystore D:\deploy\Java\jdk1.8.0_25\jre\lib\security\cacerts -file D:\crt\ssodemo.crt -alias ssodemo 或者

keytool -importcert  -keystore D:\deploy\Java\jdk1.8.0_25\jre\lib\security\cacerts -file D:\crt\ssodemo.crt -alias ssodemo -storepass changeit -noprompt

默认情况下，Tomcat 将读取 JVM 中的密钥库，而不是用户目录下的 .keystore 密钥库，当然也可以配置 Tomcat 使其读取指定的密钥库。

注意：

1. 在执行以上命令前，必须需要保证 cacerts 文件对当前用户有写权限。

2. JDK 的 keystore 的密码必须为 changeit，这样 Tomcat 无需做任何配置就能访问。

 

 

 

 

4 使 Tomcat 支持 HTTPS

4.1

方式一：

打开 Tomcat 的 conf/server.xml 文件。

修改以下配置：

1

2

3

...

<Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="off" />

...

 

将以上配置中的 SSLEngine 改为 off，默认为 on。

1

2

3

4

5

6

7

8

9

10

11

...

<!--<Connector port="8080" protocol="HTTP/1.1"

               connectionTimeout="20000"

               redirectPort="18443" />-->

...

<Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true"

           maxThreads="150" scheme="https" secure="true"

           clientAuth="false" sslProtocol="TLS" />

...

<!--<Connector port="8009" protocol="AJP/1.3" redirectPort="18443" />-->

...

 

禁用 HTTP 8080 端口，开启 HTTPS 8443 端口，禁用 AJP 8009 端口，以确保只能通过 HTTPS 协议访问 CAS 服务器。

若将 HTTPS 端口号配置为 443，则可以使用无端口方式发送 HTTPS 请求。

 

4.2

方式二：

4.2.1 配置HTTPS

解压apache-tomcat-8.0.20.tar.gz并重命名后的路径为D:\deploy\tomcat-cas，在文件 conf/server.xml文件找到：

<!--

<Connectorport="8443" protocol="HTTP/1.1" SSLEnabled="true"

  maxThreads="150" scheme="https"secure="true"

  clientAuth="false" sslProtocol="TLS" />

 

-->

修改成如下：

<Connector port="8443"protocol="org.apache.coyote.http11.Http11Protocol" SSLEnabled="true"

  maxThreads="150" scheme="https" secure="true"

  keystoreFile="D:/crt/ssodemo.keystore" keystorePass="123456"

  clientAuth="false" sslProtocol="TLS" URIEncoding="UTF-8"/>

参数说明：

• keystoreFile 就是3.1中创建证书的路径

• keystorePass 就是3.1中创建证书的密码

 

4.2.2 验证HTTPS配置

其他按照默认配置不作修改，双击%TOMCAT_HOME%\bin\startup.bat启动tomcat-cas 验证https访问配置:

 

如果看到上述界面表示https访问配置成功。

5 运行 CAS 服务器

启动部署了 CAS 服务器的 Tomcat，并使用以下地址访问 CAS 登录页面：

https://demo.ssoserver.com:8443/cas/login

 

 

CAS-server的默认验证规则：输入casuser：Mellon 点击登录，就可以看到登录成功的页面

 

一定要使用域名 demo.ssoserver.com 来访问，实际上 demo.ssoserver.com 指向了 127.0.0.1（需要在本机的 hosts 中进行配置）。

CAS 默认采用了最简单的认证，即用户名与密码必须有，但两者必须相同，也可对 CAS 做个性化认证配置。

可以使用如下 URL 注销 CAS：

https://demo.ssoserver.com:8443/cas/logout

 

6 部署CAS-Client

6.1Cas-Client下载

CAS-Client下载地址：http://developer.jasig.org/cas-clients/

以cas-client-3.3.3-release.tar.gz

为例，解压提取cas-client-3.3.3/modules/cas-client-core-3.3.3.jar

借以tomcat默认自带的webapps\examples 作为演示的简单web项目

6.2 安装配置tomcat-app1

解压apache-tomcat-8.0.20.tar.gz并重命名后的路径为D:\deploy\tomcat-app1，修改tomcat的启动端口（共计5处），在文件conf/server.xml文件找到如下内容：

<Serverport="8005" shutdown="SHUTDOWN">

<Connectorport="8080" protocol="HTTP/1.1"

  connectionTimeout="20000"

  redirectPort="8443" />

<Connectorport="8009" protocol="AJP/1.3"redirectPort="8443" />

 

修改成如下：

<Serverport="18005" shutdown="SHUTDOWN">

<Connectorport="18080" protocol="HTTP/1.1"

  connectionTimeout="20000"

  redirectPort="18443" />

<Connectorport="18009" protocol="AJP/1.3"redirectPort="18443" />

 

 

启动tomcat-app1，浏览器输入http://app1.ssojmust1.com:18080/examples/servlets/回车：

 

看到上述界面表示tomcat-app1的基本安装配置已经成功。

接下来复制client的lib包cas-client-core-3.3.3.jar和commons-logging-1.1.jar到 tomcat-app1\webapps\examples\WEB-INF\lib\目录下，在tomcat-app1\webapps\examples\WEB-INF\web.xml 文件中增加如下内容：

 

1. <span style="font-size:18px;"><!-- ========================单点登录开始 ========================-->  
2.                 <!--用于单点退出，该过滤器用于实现单点登出功能，可选配置-->  
3.                 <listener>  
4.                         <listener-class>org.jasig.cas.client.session.SingleSignOutHttpSessionListener</listener-class>  
5.                 </listener>  
6. <!--该过滤器用于实现单点登出功能，可选配置。-->  
7.                 <filter>  
8.                         <filter-name>CASSingle Sign OutFilter</filter-name>  
9.                         <filter-class>org.jasig.cas.client.session.SingleSignOutFilter</filter-class>  
10.                 </filter>  
11.                 <filter-mapping>  
12.                         <filter-name>CASSingle Sign Out Filter</filter-name>  
13.                         <url-pattern>/*</url-pattern>  
14.                 </filter-mapping>  
15. <filter>  
16.                         <filter-name>CASFilter</filter-name>  
17.                         <filter-class>org.jasig.cas.client.authentication.AuthenticationFilter</filter-class>  
18.                         <init-param>  
19.                                 <param-name>casServerLoginUrl</param-name>  
20.                                 <param-value>https://demo.ssoserver.com:8443/cas/login</param-value>  
21.                         </init-param>  
22.                         <init-param>  
23.                                 <param-name>serverName</param-name>  
24.                                 <param-value>http://app1.ssojmust1.com:18080</param-value>  
25.                         </init-param>  
26.                 </filter>  
27.                 <filter-mapping>  
28.                         <filter-name>CASFilter</filter-name>  
29.                         <url-pattern>/*</url-pattern>  
30.                 </filter-mapping>  
31.                 <!--该过滤器负责对Ticket的校验工作，必须启用它-->  
32.                 <filter>  
33.                         <filter-name>CASValidationFilter</filter-name>  
34.                         <filter-class>  
35.                                 org.jasig.cas.client.validation.Cas20ProxyReceivingTicketValidationFilter</filter-class>  
36.                         <init-param>  
37.                                 <param-name>casServerUrlPrefix</param-name>  
38.                                 <param-value>https://demo.ssoserver.com:8443/cas</param-value>  
39.                         </init-param>  
40.                         <init-param>  
41.                                 <param-name>serverName</param-name>  
42.                                 <param-value>http://app1.ssojmust1.com:18080</param-value>  
43.                         </init-param>  
44.                 </filter>  
45.                 <filter-mapping>  
46.                         <filter-name>CASValidationFilter</filter-name>  
47.                         <url-pattern>/*</url-pattern>  
48.                 </filter-mapping>  
49. <!--  
50.                         该过滤器负责实现HttpServletRequest请求的包裹，  
51.                         比如允许开发者通过HttpServletRequest的getRemoteUser()方法获得SSO登录用户的登录名，可选配置。  
52.                 -->  
53.                 <filter>  
54.                         <filter-name>CASHttpServletRequest WrapperFilter</filter-name>  
55.                         <filter-class>  
56.                                 org.jasig.cas.client.util.HttpServletRequestWrapperFilter</filter-class>  
57.                 </filter>  
58.                 <filter-mapping>  
59.                         <filter-name>CASHttpServletRequest WrapperFilter</filter-name>  
60.                         <url-pattern>/*</url-pattern>  
61.                 </filter-mapping>  
62. <!--  
63.                 该过滤器使得开发者可以通过org.jasig.cas.client.util.AssertionHolder来获取用户的登录名。  
64.                 比如AssertionHolder.getAssertion().getPrincipal().getName()。  
65.                 -->  
66.                 <filter>  
67.                         <filter-name>CASAssertion Thread LocalFilter</filter-name>  
68.                         <filter-class>org.jasig.cas.client.util.AssertionThreadLocalFilter</filter-class>  
69.                 </filter>  
70.                 <filter-mapping>  
71.                         <filter-name>CASAssertion Thread LocalFilter</filter-name>  
72.                         <url-pattern>/*</url-pattern>  
73.                 </filter-mapping>  
74. <!-- ========================单点登录结束 ======================== --></span>  

 

6.3 安装配置 tomcat-app2

解压apache-tomcat-8.0.20.tar.gz并重命名后的路径为D:\deploy\tomcat-app2，修改tomcat的启动端口，在文件conf/server.xml文件找到如下内容：

<Serverport="8005" shutdown="SHUTDOWN">

<Connectorport="8080" protocol="HTTP/1.1"

  connectionTimeout="20000"

  redirectPort="8443" />

<Connectorport="8009" protocol="AJP/1.3"redirectPort="8443" />

 

修改成如下：

<Server port="28005" shutdown="SHUTDOWN">

<Connector port="28080" protocol="HTTP/1.1"

  connectionTimeout="20000"

  redirectPort="28443"/>

<Connector port="28009" protocol="AJP/1.3" redirectPort="28443" />

启动tomcat-app2，浏览器输入http://app2.ssojmust2.com:28080/examples/servlets/回车，按照上述6.2中的方法验证是否成功。

同6.2中的复制client的lib包cas-client-core-3.2.1.jar和commons-logging-1.1.jar到 tomcat-app2\webapps\examples\WEB-INF\lib\目录下，在tomcat-app2\webapps\examples\WEB-INF\web.xml 文件中增加如下内容：

 

1. <span style="font-size:18px;"><!-- ========================单点登录开始 ========================-->  
2.                 <!--用于单点退出，该过滤器用于实现单点登出功能，可选配置-->  
3.                 <listener>  
4.                         <listener-class>org.jasig.cas.client.session.SingleSignOutHttpSessionListener</listener-class>  
5.                 </listener>  
6. <!--该过滤器用于实现单点登出功能，可选配置。-->  
7.                 <filter>  
8.                         <filter-name>CASSingle Sign OutFilter</filter-name>  
9.                         <filter-class>org.jasig.cas.client.session.SingleSignOutFilter</filter-class>  
10.                 </filter>  
11.                 <filter-mapping>  
12.                         <filter-name>CASSingle Sign Out Filter</filter-name>  
13.                         <url-pattern>/*</url-pattern>  
14.                 </filter-mapping>  
15. <filter>  
16.                         <filter-name>CASFilter</filter-name>  
17.                         <filter-class>org.jasig.cas.client.authentication.AuthenticationFilter</filter-class>  
18.                         <init-param>  
19.                                 <param-name>casServerLoginUrl</param-name>  
20.                                 <param-value>https://demo.ssoserver.com:8443/cas/login</param-value>  
21.                         </init-param>  
22.                         <init-param>  
23.                                 <param-name>serverName</param-name>  
24.                                 <param-value>http://app2.jmust2.com:28080</param-value>  
25.                         </init-param>  
26.                 </filter>  
27.                 <filter-mapping>  
28.                         <filter-name>CASFilter</filter-name>  
29.                         <url-pattern>/*</url-pattern>  
30.                 </filter-mapping>  
31.                 <!--该过滤器负责对Ticket的校验工作，必须启用它-->  
32.                 <filter>  
33.                         <filter-name>CASValidationFilter</filter-name>  
34.                         <filter-class>  
35.                                 org.jasig.cas.client.validation.Cas20ProxyReceivingTicketValidationFilter</filter-class>  
36.                         <init-param>  
37.                                 <param-name>casServerUrlPrefix</param-name>  
38.                                 <param-value>https://demo.ssoserver.com:8443/cas</param-value>  
39.                         </init-param>  
40.                         <init-param>  
41.                                 <param-name>serverName</param-name>  
42.                                 <param-value>http://app2.jmust2.com:28080</param-value>  
43.                         </init-param>  
44.                 </filter>  
45.                 <filter-mapping>  
46.                         <filter-name>CASValidationFilter</filter-name>  
47.                         <url-pattern>/*</url-pattern>  
48.                 </filter-mapping>  
49. <!--  
50.                         该过滤器负责实现HttpServletRequest请求的包裹，  
51.                         比如允许开发者通过HttpServletRequest的getRemoteUser()方法获得SSO登录用户的登录名，可选配置。  
52.                 -->  
53.                 <filter>  
54.                         <filter-name>CASHttpServletRequest WrapperFilter</filter-name>  
55.                         <filter-class>  
56.                                 org.jasig.cas.client.util.HttpServletRequestWrapperFilter</filter-class>  
57.                 </filter>  
58.                 <filter-mapping>  
59.                         <filter-name>CASHttpServletRequest WrapperFilter</filter-name>  
60.                         <url-pattern>/*</url-pattern>  
61.                 </filter-mapping>  
62. <!--  
63.                         该过滤器使得开发者可以通过org.jasig.cas.client.util.AssertionHolder来获取用户的登录名。  
64.                         比如AssertionHolder.getAssertion().getPrincipal().getName()。  
65.                 -->  
66.                 <filter>  
67.                         <filter-name>CASAssertion Thread LocalFilter</filter-name>  
68.                         <filter-class>org.jasig.cas.client.util.AssertionThreadLocalFilter</filter-class>  
69.                 </filter>  
70.                 <filter-mapping>  
71.                         <filter-name>CASAssertion Thread LocalFilter</filter-name>  
72.                         <url-pattern>/*</url-pattern>  
73.                 </filter-mapping>  
74. <!-- ========================单点登录结束 ======================== --></span>  

 

7 测试验证SSO

启动之前配置好的三个tomcat分别为：tomcat-cas、tomcat-app1、tomcat-app2.

7.1 基本的测试

预期流程：打开app1 url —->跳转cas server验证 —->显示app1的应用 —->打开app2 url —->显示app2应用 —->注销cas server —->打开app1/app2url —->重新跳转到cas server验证.

打开浏览器地址栏中输入：http://app1.ssojmust1.com:18080/examples/servlets/servlet/HelloWorldExample