servicecatalog / oscm-identity

Identity service for managing authentication with external IdPs using OpenId Connect.
2 stars 2 forks source link
external-idps oauth2 oidc oscm single-sign-on

Maven codecov

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.

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.