cas5.3的详细配置(一)

        网上有很多帖子都介绍都介绍了cas的安装配置文件，产生了兴趣，就试着自己配置了一下，结果运气不好，各种出问题，现将我的配置过程共享出来，免得大家走弯路：

1、我的环境：

1.1、jdk-18.0.2.1_windows-x64_bin、apache-tomcat-8.5.89-windows-x64、maven3.9.9（关于jdk、tomcat、maven的环境配置，请参考我前面的帖子）

        因为后面会用jdk的keytool来成生key,所以有多个jdk的同学，一定要注意，不要换来换去，另外后面打包的时候，也跟jdk有关。只有一个jdk的同学，直接忽略。maven的环境配置也要弄好，不然mvn打包的时候，也各种问题。

        因为最开始只想把cas配置一个简单的，可以用就可以，暂时不考虑SSL这些配置。所以先简单配置一下tomcat，在tomcat/conf目录下server.xml，修改里面的下面一句

<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" />

 因为cas里面的默认端口为:8332，所以将上面一句修改为如下

 <Connector connectionTimeout="20000" maxParameterCount="1000" port="8443" protocol="HTTP/1.1" redirectPort="8444" />

         前面一定要改成:8443，后面的8444可以随便搞个没有被占用的端口就可以，如果你的8444没有被占用，就象我上面修改就可以了。

2、cas5.3

        网上说cas5.3以后的版本需要gradle来打包，所以只好下载cas5.3以前的版本，到网上找一个cas5.3以前的版本就可以。下载地址如下：

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

 界面如下：

 下载的时候，看一下，这个5.3目录下应该有pom.xml，不然没法用maven来打包。

下载下来解压后，如下界面：

有了这个文件，需要说明两点：

        1、这是一个模板项目，我们可以简单的在这个项目做改动，以支持简单的使用，也可以根据这个模板项目，完善处理，以便以后要做服务端的扩展处理。

        2、这个模板项目要简单使用，还需要cas-server-webapp-tomcat支持，所以我们还需要对这个模板项目做一些处理。

        根据以上两点，分别简单都做一下介绍。因为老一辈程序员，更习惯eclipse，所以就以eclipse为例。也可以不用eclipse,直接在上面的项目上做修改，都差不多。

        如果要将这个模板项目导入到eclipse中，可以先用maven对项目做eclipse处理：在命令提示符下，定位到D:\cas-overlay-template-5.3这个目录下，输入如下指令（把其变为eclipes项目）：

mvn eclipse:eclipse

成功后，如下：

        成功后，就可以把上述项目，导入eclipse中，不做上一步，也可以直接导入到eclipse，但是配置起来麻烦一些，最好还是做一下上述步骤。打开eclipse，点击File ->import，如下：

选择刚刚eclipse化了的项目，如下图：

点击Finish，完成项目导入的工作。

        如果是没有改动的项目，导入后有错，大部分情况就是pom.xml里面的某些配置出错了，对这个页面的配置做处理就好了。我出错大体上的情况就是maven-war-plugin或maven-compiler-plugin的版本换成你本地maven有的版本，

<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-war-plugin</artifactId>
<version>2.6</version>

 不知道什么版本的，在本地库如下目录去看，有没有对应的jar，例如我的本地库，如下：

 比如我的有3.3.1,我就在pom.xml把这个版本换成3.3.1，如下：

<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-war-plugin</artifactId>
<version>3.3.1</version>

 如果你换成本地库没有的版本，换了后，直接在这个目录下，执行：

mvn install

 这样也可以。导入上述工程后，就可以在项目中进行配置,右键点击cas-overlay项目，点属性，在下述界面中可以看到如下界面：

 （缺失src.main.java、src.main.resource等等,可进行完善，以便以后做扩展开发。）

直接在cas-overlay下，新建两个包：src.main.java、src.main.resource即可，

建src.main.java，如下：

 另外在main下新建一个resources包，即可。同时我们在这里也为我们上文提到的要在这相模板项目中，引入cas-server-webapp-tomcat做支持，同时在cas-overlay项目下，新建文件夹overlays，新建好后，如下图所示：

resources文件夹，后面会提到，就暂时不做处理，这里详细说一下overlays这个文件夹的准备工作，网上很多文章在这里都没有讲清楚，这个文件夹是用来存放pom.xml里声明的这一段文件：

<overlays>
     <overlay>
        <groupId>org.apereo.cas</groupId>
        <artifactId>cas-server-webapp${app.server}</artifactId>
     </overlay>
</overlays>

而这个文件我们要提前在本地库中准备好，准备也简单，一是在如下界面中去查看，有没有对应的包，如下图：

        没有这个包，也不要着急。有的话，直接用解压工具将共解压出来，如上图的那个cas-server-webapp-tomcat-5.3.16文件夹，即是解压出来的。没有的话，在cas-overlay这个项目下的pom.xml里加入依赖：

<dependency>
    <groupId>org.apereo.cas</groupId>
    <artifactId>cas-server-webapp-tomcat</artifactId>
    <version>5.3.16</version>
</dependency>
                <!--
                ...Additional dependencies may be placed here...
                -->

这个pom.xml做得很体贴，加入的位置用下面都声明了。

 <!--
 ...Additional dependencies may be placed here...
 -->

 加入这段后，在eclipse中用maven更新项目，在本地库中，就会出现这个war包：

cas-server-webapp-tomcat-5.3.16.war

特别强调，一定要解压，到上图所示的目录。这样准备工作就结束了。切换到命令提示符中：

分别输入如下指令：

build.cmd run

成功后在前面建的文件夹中出现如下文件

 这样就算是准备完成了，确认打包一下：

mvn clean package

 将如下的cas文件夹拷贝到\apache-tomcat-8.5.89\webapps\目录下。

启动tomcat，如果控制台看到如下界面，恭喜你，成功了。

 赶紧去浏览器里，输入：

http://localhost:8443/cas/login

你就可以看到：

 系统默认的用户名和密码为：

cas.authn.accept.users=casuser::Mellon

 用户名输入:casuser，密码输入：Mellon，则可以看到如下界面：

cas的详细配置

另外在main下新建一个resources包，即可。同时我们在这里也为我们上文提到的要在这相模板项目中，引入cas-server-webapp-tomcat做支持，同时在cas-overlay项目下，新建文件夹overlays，新建好后，如下图所示： 

累了，以后再讲后续配置和使用吧，毁灭吧，什么不好的bug都被我碰到了。我估计我算写得比较细的了，对你有用的话，一定帮忙多点点赞。