安装 CAS 服务器

jopen 10年前

1 下载 CAS 服务器

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

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

  2. 解压程序包

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

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

  1. 创建 CAS 密钥库

  2. 使 Tomcat 支持 HTTPS

2 创建 CAS 密钥库

使用 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 通道）带来的安全性。

2.1 生成 keypair

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

keytool -genkeypair -alias cas -keyalg RSA -storepass changeit

安装 CAS 服务器

默认情况下，生成的 keystore 就是用户目录下的 .keystore 文件。对于 Win8 而言，默认的用户目录为 C:\Users\用户名。

以上命令执行完毕后，会在用户目录下生成一份 .keystore 文件（如果以前不存在该文件的话），其中包括一个 keypair。

注意：

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

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

    127.0.0.1 cas

查看 keypair：

keytool -list -storepass changeit

删除 keypair：

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

2.2 从 keystore 中导出证书

使用以下命令导出证书：

keytool -exportcert -alias cas -file cas.crt -storepass changeit

生成的证书文件为 cas.crt，位于运行该命令所在的当前目录下。

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

2.3 导入证书到 JVM 中

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

keytool -importcert -alias cas -file cas.crt -keystore "%JAVA_HOME%\jre\lib\security\cacerts" -storepass changeit -noprompt

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

注意：

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

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

3 使 Tomcat 支持 HTTPS

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

修改以下配置：

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

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

...  <!--<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 服务器。

4 运行 CAS 服务器

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

https://cas:8443/login

安装 CAS 服务器

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

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

注销 CAS：

https://cas:8443/logout

 

如何应用 CAS 实现单点登录？如何定制 CAS 的认证方式？如何将 CAS 集成到 Smart 框架中？下回分解！