oscm-identity

Identity Service for managing authentication with external IdPs using OpenID Connect

Building from source

To build the application

1. Download and install lombok for you IDE. Instructions for Eclipse and IntelliJ can be found here.
2. Run mvn clean package

Starting the application

1. Copy config directory to the same path, where You've put Your JAR file
2. Provide default tenant configuration in config/tenants/tenant-default.properties as described in the tenant configuration template
3. Start the application using java -jar command

Application profiles

To make development process as easy as possible, this application supports several profiles, which can be used to run it in a way approprieate to the use case. By default, application starts with prod profile, it is however possible to override this setting and specify active profile manually. To do that, just execute application with -Dspring.profiles.active=[profileName] JVM parameter.

• prod - default profile for the application, where tenant config is retrieved from mapped, local file system directory
• test - profile used for testing. All required resources are retrieved from the classpath
• dev - development profile. It allows application to run under IDE. Retrieved resources from the classpath.

Setup with Docker

The Identity Service is included with the OSCM Docker installation. Find the description in the oscm-dockerbuild repository on how to install OSCM with docker-compose.

API Documentation

The OpenAPI/Swagger documentation is provided for the oscm-identity module.

• OpenAPI 3.0 JSON documentation is accessible at <your-app-host>/oscm-identity/api/docs
• Swagger UI for the documentation is accessible at <your-app-host>/oscm-identity/api/ui