apereo / bootiful-cas-client

The simplest CASyfied Spring Boot demo application

Bootiful CAS-enabled web application

This is the simplest CASyfied Spring Boot application that there could be.

It could be used as a template to build more complex CAS-enabled Spring Boot apps, or simply as a quick tester for various CAS servers installations.

Getting Started

• Make sure you have (at minimum) Java 11 installed (it won't work on Java versions less than 8)

• Clone this repository

• Change 3 required URL properties in src/main/resources/application.yml pointing to the desired CAS server and client host. For example:

  cas:
    #Required properties
    server-url-prefix: https://localhost:8143/cas
    server-login-url: https://localhost:8143/cas/login
  
    
    client-host-url: https://localhost:8443

• Change SSL settings in src/main/resources/application.yml pointing to your local keystore and truststore. For example:

server:
  port: 8443
  ssl:
    enabled: true
    key-store: /Users/path/to/.keystore
    key-store-password: changeit     

Note: you also might need to do the self-cert generation/importing dance into the JVM's trust store for this CAS client/server SSL handshake to work properly.

• From the command line run: ./gradlew clean bootRun

• Visit https://localhost:8443 in the web browser of choice and enjoy the CASyfied Spring Boot app!

Create Docker Image

./gradlew bootBuildImage
docker push apereo/bootiful-cas-client

To run:

docker run --rm -p 8444:8444 --name "bootiful" \
  --mount type=bind,source=/etc/cas/thekeystore,target=/etc/cas/thekeystore,readonly \
  apereo/bootiful-cas-client