TARA/GovSSO admin application

TARA/GovSSO admin project's main goal is to provide a web application that allows TARA/GovSSO service managers to:

• manage institutions that want to register OIDC clients in TARA/GovSSO
• manage OIDC client registrations
• manage alerts that are to be displayed on the TARA/GovSSO login page

An additional subproject also provides a tool to import TARA clients.

Requirements:

Java (JDK 17+) runtime and Node.js version 14 is required to build and run the webapp.

Maven is used to build and test the software.

Building the project

Execute the following commands, starting in the project's root directory, to build the TARA/GovSSO admin webapp and additional command line tools:

cd tara-admin-ui
npm install
npm run build -- --configuration=dev-local
cd ..
./mvnw clean package

This will produce an executable JAR file for the webapp with embedded Tomcat at tara-admin-api/target/*.jar which can then be run as a web server. See further details here

In addition, another executable JAR file can be found at tara-admin-import/target/client-utils.jar which can be used to import OIDC clients from the command line. See further details here

Building and Running in Docker

Execute the following commands, starting in the project's root directory, to build and run Docker image for TARA/GovSSO admin webapp:

cd tara-admin-ui
npm install
npm run build -- --configuration=dev-local
cd ..
./mvnw clean install
./mvnw --projects tara-admin-api -DskipTests -Djacoco.skip=true spring-boot:build-image
docker run --rm -p 17080:8080 tara-admin:latest