CAS的安装与配置

柔光的暖阳◎ 2024-02-18 21:21 2阅读 0赞

### 一、搭建Java Web服务器环境 ###

CATALINA\_HOME = D:\\Java\\apache-tomcat-6.0.14  
安装完毕，启动Tomcat ，在浏览器上 测试 http://localhost:8080/  
![ba32f1af-7d93-3e62-8025-c6030be36e14.gif][]  
出现上述界面，表明系统成功搭建。

### 二、使用Java Keytool工具为系统生成HTTPS证书，并为系统注册 ###

#### 1. 删除已有 ####

C:\\Program Files\\Java\\jdk1.6.0\_10\\bin>keytool -delete -alias tomcat(随意起的别名) -keystore D:/Java/jdk1.6.0\_33/jre/lib/security/cacerts -storepass changeit

#### 2. 生成密匙库 ####

输入密钥密码和相应参数，（注意：第一个参数CN要输入域名sso.shipengzhi.com，其他参数就随便了），结果是在用户目录中创建了名为server.keystore的密钥文件。

C:\\Program Files\\Java\\jdk1.6.0\_10\\bin>keytool -genkey -alias tomcat -keypass changeit -keyalg RSA -keystore server.keystore(密钥文件名)

在当前目录下多出一个文件server.keystore

#### 3. 导出数字证书 ####

C:\\Program Files\\Java\\jdk1.6.0\_10\\bin>keytool -export -alias tomcat -keypass changeit -file server.crt -keystore server.keystore

输入keystore密码：changeit

输入上一步中的密码，结果在当前目录生成server.crt密钥文件。（注意：这个文件是要导入客户端的JVM上的）

#### 4.将数字认证导入jre可信任区 ####

C:\\Program Files\\Java\\jdk1.6.0\_10\\bin>keytool -import -alias tomcat -file server.crt -keypass changeit -keystore D:/Java/jdk1.6.0\_33/jre/lib/security/cacerts

这里的jre地址和tomcat使用的jre必须一致

输入密码（注意：这里的密码不是上面设定的密码，而是changeit），将创建cacerts文件。

#### 5. 查看可信证书列表（检查证书是否加入成功） ####

C:\\Program Files\\Java\\jdk1.6.0\_10\\bin>keytool -list -keystore D:\\Java\\jdk1.6.0\_33/jre/lib/security/cacerts

![638423f6-375e-3e46-aa9d-dbff289ab02b.gif][]

#### 6.命令解释(转) ####

\-genkey 在用户主目录中创建一个默认文件".keystore",还会产生一个mykey的别名，mykey中包含用户的公钥、私钥和证书

\-alias 产生别名

\-keystore 指定密钥库的名称(产生的各类信息将不在.keystore文件中

\-keyalg 指定密钥的算法

\-validity 指定创建的证书有效期多少天

\-keysize 指定密钥长度

\-storepass 指定密钥库的密码

\-keypass 指定别名条目的密码

\-dname 指定证书拥有者信息例如： "CN=firstName,OU=org,O=bj,L=bj,ST=gd,C=cn"

\-list 显示密钥库中的证书信息 keytool -list -v -keystore 别名 -storepass ....

\-v 显示密钥库中的证书详细信息

\-export 将别名指定的证书导出到文件 keytool -export -alias 别名 -file 文件名.crt

\-file 参数指定导出到文件的文件名

\-delete 删除密钥库中某条目 keytool -delete -alias 别名 -keystore sage

\-keypasswd 修改密钥库中指定条目口令 keytool -keypasswd -alias 别名 -keypass .... -new .... -storepass ... -keystore 别名

\-import 将已签名数字证书导入密钥库 keytool -import -alias 别名 -keystore 证书名-file 文件名(可以加.crt 后缀)

以上是服务器端导入证书，放在tomcat用的jre下的证书库中

### 三、配置Tomcat的HTTPS服务 ###

在tomcat的server.xml中添加配置信息

keystorePass="changeit"参数，即为上面几步中涉及到的密 码，keystoreFile＝".keystorePath",.keystorePath即为在第一步中生成的文件.keystore的全路径，如: C:/Users/shipengzhi/server.keystore。

绑定hosts  
10.1.164.118 sso.shipengzhi.com

启动Tomcat，访问https://localhost:8443/，出现以下界面说明HTTPS配置生效：  
![7aada184-731a-390e-bcb2-a5c538fdd4bf.gif][]

### 四、构建CAS服务器和过滤器 ###

#### 1.部署JA-SIG（CAS）服务器 ####

cas官方网站

[http://www.jasig.org/cas][http_www.jasig.org_cas]

下载最新的服务端 [CAS Server 3.5.0 Final][]

解压后将modules下面的cas-server-webapp-3.3.3.war改名为cas.war部署到web服务器，作为单点登录的服务器。

启动Tomcat，访问网址http://localhost:8080/cas/index.jsp或https://localhost:8443,出现以下画面：  
![19fcb758-d705-3445-b6d4-9e883dc2f0e5.gif][]  
输入用户名/密码 ：linly/linly（任意两个相同的字窜），点击“登录”，出现以下画面：  
![2dbb6405-2cd2-3bb6-92bf-2a13404fab37.gif][]  
表示CAS服务器配置运行成功。

#### 2.为HelloWorldExample程序配置CAS过滤器 ####

访问http://shipengzhi:8080/examples/servlets/servlet/HelloWorldExample，出现以下界面说明应用正常启动：  
![7beec055-6090-354c-ae06-61776ab4e42c.gif][]  
编辑D:\\Java\\apache-tomcat-6.0.14\\webapps\\examples\\WEB-INF下的web.xml文件，添加如下信息：

<listener>  
　　<listener-class>org.jasig.cas.client.session.SingleSignOutHttpSessionListener</listener-class>  
</listener>

<filter>  
　　<filter-name>CAS Single Sign Out Filter</filter-name>  
　　<filter-class>org.jasig.cas.client.session.SingleSignOutFilter</filter-class>  
</filter>  
<filter-mapping>  
　　<filter-name>CAS Single Sign Out Filter</filter-name>  
　　<url-pattern>/\*</url-pattern>  
</filter-mapping>

<filter>  
　　<filter-name>CASFilter</filter-name>  
　　<filter-class>org.jasig.cas.client.authentication.AuthenticationFilter</filter-class>  
　　<init-param>  
　　　　<param-name>casServerLoginUrl</param-name>  
　　　　<param-value>https://sso.shipengzhi.com:8443/cas/login</param-value>  
　　　　  
　　</init-param>  
　　<init-param>  
　　　　<param-name>serverName</param-name>  
　　　　<param-value>http://localhost:8080</param-value>  
　　</init-param>  
</filter>  
<filter-mapping>  
　　<filter-name>CASFilter</filter-name>  
　　<url-pattern>/\*</url-pattern>  
</filter-mapping>

<filter>  
　　<filter-name>CAS Validation Filter</filter-name>  
　　<filter-class>  
　　　　org.jasig.cas.client.validation.Cas20ProxyReceivingTicketValidationFilter</filter-class>  
　　<init-param>  
　　　　<param-name>casServerUrlPrefix</param-name>  
　　　　<param-value>https://sso.shipengzhi.com:8443/cas</param-value>  
　　</init-param>  
　　<init-param>  
　　　　<param-name>serverName</param-name>  
　　　　<param-value>http://localhost:8080</param-value>  
　　</init-param>  
</filter>  
<filter-mapping>  
　　<filter-name>CAS Validation Filter</filter-name>  
　　<url-pattern>/\*</url-pattern>  
</filter-mapping>

拷贝cas-client-core-3.2.1.jar,commons-logging-1.1.jar文件到目录D:\\Java\\apache-tomcat-6.0.14\\webapps\\examples\\WEB-INF\\lib下。

启动Tomcat。  
测试使用浏览器登陆以下网址：http://shipengzhi:8080/examples/servlets/servlet/HelloWorldExample，页面将弹出以下认证框，点击“确定”  
![c93c4ce6-b32f-3581-8a24-d26e62bdb8cd.gif][]  
  
页面将重定向到JA-SIG的SSO登录认证页面  
  
![dfcedb9b-e2e7-308a-8a77-f36b5f4da310.gif][]  
  
输入用户名=密码，如：linly/linly，则通过验证，进入应用的入口界面，如下：  
![819ae74c-e01c-3057-834f-7f1fac2649b5.gif][]  
  
细心的用户将发现，此时的URL不再是：  
http://shipengzhi:8080/examples/servlets/servlet/HelloWorldExample，  
URL的尾端带上了一个ticket参数：  
http://linly:8080/examples/servlets/servlet/HelloWorldExample?ticket=ST-2-qTcfDrdFb0bWndWgaqZD  
到此，JA-SIG（CAS）服务器的初步SSO部署宣告成功。

### 异常Q&A ###

1.验证ticket时，抛出异常

avax.servlet.ServletException: javax.net.ssl.SSLHandshakeException: sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target

解决办法：

tomact使用的jvm的jre必须和数字认证导入jre可信任区时的jre一样，抛出这个异常就是因为不一样导致的。

2.如何将CAS和应用分布部署在不同的机器？

机器A： 部署CAS服务  
机器B： 部署OA应用  
机器C： 用户浏览器端  
  
1.由机器A上生成.keystore的证书文件，证书颁发者是机器A的完全域名  
2.机器A上用于部署CAS的Tomcat的server.xml文件中定义HTTPS的配置，指向.keystore文件证书  
  
3.从.keystore中导出的凭证文件要copy到机器B上，并导入机器B的JRE环境的证书库中

4.机器B上部署OA的Tomcat必须指定运行在导入凭证JRE环境上，而不是JDK，这点常有人搞错。

### 五、扩展认证接口（JDBC） ###

当然，在实际使用的时候，这样做肯定是不行的，还需要根据实际概况做扩展和定制，最主要的是扩展认证 (Authentication) 接口和 CAS Server 的界面。我们通常都会使用jdbc连接数据库进行认证，这种情况，用户名和密码被保存在数据库的某个表中。需要进行如下配置。

在MySQL数据库下创建一个叫做CAS的数据，然后在该数据库中创建一张app\_user表，然后在这张表中插入数据，创建表和插入记录的sql脚本如下：

![复制代码][copycode.gif]

CREATE TABLE `app_user` (  
      `username` varchar(30) NOT NULL default '',  
      `password` varchar(45) NOT NULL default '',  
      PRIMARY KEY  (`username`)  
    ) ENGINE=InnoDB DEFAULT CHARSET=utf8;  
    --并添加如下用户：  
    INSERT INTO `app_user` (`username`,`password`) VALUES   
     ('test','111'),  
     ('user','222'),  
     ('tom','333'),  
     ('jim','000');

![复制代码][copycode.gif]

用编辑器打开%CATALINA\_HOME%/webapps/cas/WEBINF/deployerConfigContext.xml,找到

将其注释掉，然后在同一级别下面添加一个bean，其内容如下所示：

![复制代码][copycode.gif]

<bean class="org.jasig.cas.adaptors.jdbc.QueryDatabaseAuthenticationHandler"> 
                        <property name="sql" value="select password from app_user where username=?" /> 
                        <property name="dataSource" ref="dataSource" /> 
                     </bean>

![复制代码][copycode.gif]

然后在添加一个bean，这个bean是跟authenticationManager同一级别的，注意这个很重要，这个bean不是跟之前那个bean class同级。其内容如下：

![复制代码][copycode.gif]

<bean id="dataSource" class="org.springframework.jdbc.datasource.DriverManagerDataSource" > 
                        <property name="driverClassName"><value>com.mysql.jdbc.Driver</value></property> 
                        <property name="url"><value>jdbc:mysql://localhost:3306/cas</value></property> 
                        <property name="username"><value>root</value></property> 
                        <property name="password"><value>root</value></property> 
                    </bean>

![复制代码][copycode.gif]

如果不想单独再创建一个bean id的话，可以通过通过如下配置完成，并且这个bean使用了密码校验，可以从数据表user中查询用户密码，并对密码进行MD5加密校验，这个认证器位于cas-server-support-jdbc包中。

![复制代码][copycode.gif]

![复制代码][copycode.gif]

然后从\\cas-server-3.5.2-release\\cas-server-3.5.2\\modules目录下拷贝cas-server-support-jdbc-3.5.2.jar，再下载mysql-connector-java-5.1.26-bin.jar，将这两个文件拷贝到%CATALINA\_HOME%/webapps/cas/WEB-INF/lib目录下。

此时在登录[https://localhost:8443/cas][https_localhost_8443_cas]，然后使用jim/000,test/111,tom/333,user/222,test/test,test/1234，可以发现，前面四组是可以通过验证的，而后面两组验证失败。通过验证以后，再次登陆[https://localhost:8443/cas][https_localhost_8443_cas]，会提示已经登录，此时如果要注销，可以在输入：[https://localhost:8443/cas/logout][https_localhost_8443_cas_logout]。

在配置文件中可以看到，这里的认证器配置的是一个list，默认情况下，只要有一个认证器通过认证，就认为是合法的用户，建议选择合适的认证器放在最前面。比如说，如果不注释之前的SimpleTestUsernamePasswordAuthenticationHandler这个认证器。

[ba32f1af-7d93-3e62-8025-c6030be36e14.gif]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/acc7135c40d442a3a963c99ac7a02cfb.png
[638423f6-375e-3e46-aa9d-dbff289ab02b.gif]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/0a28e3e30ba949088a4c56e8238cbe22.png
[7aada184-731a-390e-bcb2-a5c538fdd4bf.gif]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/460965ee16c942ac953561d89dafb316.png
[http_www.jasig.org_cas]: http://www.jasig.org/cas
[CAS Server 3.5.0 Final]: http://www.jasig.org/cas/download/cas-server-333-final
[19fcb758-d705-3445-b6d4-9e883dc2f0e5.gif]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/43539d68e6ef465c84760eeb0dcf4fb0.png
[2dbb6405-2cd2-3bb6-92bf-2a13404fab37.gif]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/2d232a975911423c831d00f8c07792dc.png
[7beec055-6090-354c-ae06-61776ab4e42c.gif]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/5a265afaf3fc4453941ceb5c150cc85f.png
[c93c4ce6-b32f-3581-8a24-d26e62bdb8cd.gif]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/77a460f34c8a4d13a5436c891183e615.png
[dfcedb9b-e2e7-308a-8a77-f36b5f4da310.gif]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/95a34f72dc28422da0e4098878cb6c91.png
[819ae74c-e01c-3057-834f-7f1fac2649b5.gif]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/f4573ad69fb74bf99aec0a0c864bcd57.png
[copycode.gif]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/50c67ae5707e4a7cbf221c6bae2663bf.png
[https_localhost_8443_cas]: https://localhost:8443/cas
[https_localhost_8443_cas_logout]: https://localhost:8443/cas/logout