CAS 5.2.X 使用cas-overlay-template 搭建cas-server

1、下载 cas-overlay-template

地址：https://github.com/apereo/cas-overlay-template
选择需要的版本：
cas 6.x开始使用gradle构建，我选择的是5.2.x版本使用maven构建

目录结构：

.
└── cas-overlay-template
    ├── LICENSE.txt
    ├── README.md
    ├── build.cmd
    ├── build.sh
    ├── etc
    │   └── cas
    │       └── config
    │           ├── application.yml
    │           ├── cas.properties
    │           └── log4j2.xml
    ├── maven   
    │   ├── maven-wrapper.jar
    │   └── maven-wrapper.properties
    ├── mvnw
    ├── mvnw.bat
    └── pom.xml

2、构建前准备

1、用国内仓库
pom.xml 里面定义了repository 国内如果拉不下来包，注掉，用阿里云（不会弄百度搜索）

pom.xml 里注掉 <repositories>

<!--    <repositories>-->
<!--        <repository>-->
<!--            <id>sonatype-releases</id>-->
<!--            <url>http://oss.sonatype.org/content/repositories/releases/</url>-->
<!--            <snapshots>-->
<!--                <enabled>false</enabled>-->
<!--            </snapshots>-->
<!--            <releases>-->
<!--                <enabled>true</enabled>-->
<!--            </releases>-->
<!--        </repository>-->
<!--        <repository>-->
<!--            <id>sonatype-snapshots</id>-->
<!--            <url>https://oss.sonatype.org/content/repositories/snapshots/</url>-->
<!--            <snapshots>-->
<!--                <enabled>true</enabled>-->
<!--            </snapshots>-->
<!--            <releases>-->
<!--                <enabled>false</enabled>-->
<!--            </releases>-->
<!--        </repository>-->
<!--        <repository>-->
<!--            <id>shibboleth-releases</id>-->
<!--            <url>https://build.shibboleth.net/nexus/content/repositories/releases</url>-->
<!--        </repository>-->
<!--    </repositories>-->

2、macOS下 build
需要看一下自己的JAVA_HOME 在mvnw文件里是不是能匹配到
执行：

➜  cas-overlay-template git:(5.2) ✗ where java
/Library/Java/JavaVirtualMachines/jdk1.8.0_261.jdk/Contents/Home/bin/java

mvnw文件：

case "`uname`" in
  CYGWIN*) cygwin=true ;;
  MINGW*) mingw=true;;
  Darwin*) darwin=true
           #
           # Look for the Apple JDKs first to preserve the existing behaviour, and then look
           # for the new JDKs provided by Oracle.
           # 
           if [ -z "$JAVA_HOME" ] && [ -L /System/Library/Frameworks/JavaVM.framework/Versions/CurrentJDK ] ; then
             #
             # Apple JDKs
             #
             export JAVA_HOME=/System/Library/Frameworks/JavaVM.framework/Versions/CurrentJDK/Home
           fi
           
           if [ -z "$JAVA_HOME" ] && [ -L /System/Library/Java/JavaVirtualMachines/CurrentJDK ] ; then
             #
             # Apple JDKs
             #
             export JAVA_HOME=/System/Library/Java/JavaVirtualMachines/CurrentJDK/Contents/Home
           fi
             
           if [ -z "$JAVA_HOME" ] && [ -L "/Library/Java/JavaVirtualMachines/CurrentJDK" ] ; then
             #
             # Oracle JDKs
             #
             export JAVA_HOME=/Library/Java/JavaVirtualMachines/CurrentJDK/Contents/Home
           fi           

           if [ -z "$JAVA_HOME" ] && [ -x "/usr/libexec/java_home" ]; then
             #
             # Apple JDKs
             #
             export JAVA_HOME=`/usr/libexec/java_home`
           fi
           ;;
esac

我的JAVA_HOME 在 /Library/Java/JavaVirtualMachines/jdk1.8.0_261.jdk/Contents 路径下，所以我在

esac

下面加了

export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_261.jdk/Contents/Home

3、构建

./build.sh package

build后如果想自定义配置就需要overlay了，在项目目录下新建

src
└── main
    ├── java
    └── resources

1、自定义日志路径
默认日志路径：

/etc/cas/logs

如果想自定义日志输出就把

target/cas/WEB-INF/classes/log4j2.xml

复制到

src/main/resource/log4j2.xml

修改

<Properties>
			<!--改成你想改的路径-->
    <Property name="baseDir">./logs</Property>
</Properties>

控制台输出
修改

etc/cas/config/log4j2.xml

<Property name="cas.log.dir" >.</Property>
#改为
<Property name="cas.log.dir" >./logs/console/</Property>

2、修改ssl证书路径或关闭ssl

复制

target/cas/WEB-INF/classes/application.properties

到

src/main/resource/application.properties

修改证书路径：

##改为你的公钥存放的文件夹
server.ssl.key-store=file:/etc/cas/thekeystore

或

去掉ssl：

server.ssl.enabled=false

4、运行

正常运行：

./build.sh run

debug模式：

./build.sh debug

springboot方式运行（java -jar 运行）

./build.sh bootrun

cas-server搭建完毕，默认端口8443

访问：
http://127.0.0.1:8443/cas

官方建议使用HTTPS，我没有证书，用的HTTP
建议集成LDAP或JDBC用于身份验证，我用的默认写在配置文件里的账号密码cas.authn.accept.users