README.MD

Support project for a Meetup about a sample OpenID "full" stack composed of:

• Keycloak or Auth0 as authorization-server
• Spring RESTfull API as resource-server
• Ionic-Angular Web & Android app as client

Meetup slides are accessible from there for more background info.

Android app on Google Play

"Café Skifo" is submitted for aproval, but still waiting to be processed. Google states that it might take longer than usual because of COVID-19, so please be patient until first public test release is available.

Development environment setup

Prerequisites

• Git (with Git Bash under Windows).
• Node.js with npm.
• JDK 11 or above.
• Decent IDE(s). I use
  • VS Code with John Papa's Angular Essentials extension for Ionic / Angular projects.
  • STS for Eclispe for Spring projects.
  • Android Studio for building and running Android projects.
• Keycloak
• SSL certificate. I wrote a step-by-step tutorial to create a self-signed certificate and register it on Widows, Keycloak, Spring and Ionic app

Build & run

• if you followed the step-by-step tutorial referenced above, Keycloak should be running already, as should a DNS resolving a [hostname] to your machine
• cd api
• copy src/main/resources/application-ch4mpy-bravo.properties to adapt SSL certificate and Keycloak host name
• edit pom.xml to adapt <apiDocsUrl> to your machine host name
• ./mvnw integration-test to generate OpenAPI JSON file describing public Spring API
• cd ../angular-clients
• npm i to install npm dependencies and generate a lib from OpenAPI JSON file generated two steps before
• check you duplicated ch4mpy-bravo entries in angular.json to add equivalents for your SSL certificate
• ionic cap sync
• ionic capacitor run android -l --ssl --external --public-host=[hostanme]
• if you want to test from an android device, check wifi settings are pointing to a DNS knowing your host name