# bootiful-cas-client

**Repository Path**: mirrors_apereo/bootiful-cas-client

## Basic Information

- **Project Name**: bootiful-cas-client
- **Description**: The simplest CASyfied Spring Boot demo application
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-07-15
- **Last Updated**: 2026-03-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 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:

  ```yaml
  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:
 
 ```yaml
 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

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

To run:

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