Sugoi provides an API to manage users with multi tenancy in mind.

• Sugoi: User management Api
• Installation
• Configuration
• Contributing
• License

Sugoi is an API to manage users, organizations and applications. These objects are scoped to realms to isolate object with separated purposes (employees, clients, contacts...).

View more

A react frontend for this API can be found here : https://github.com/InseeFrLab/sugoi-ui.

A Keycloak storage extension is here : https://github.com/InseeFrLab/keycloak-http-storage-provider (Work in Progress)

Download and extract release zip, modify configuration file as needed and launch :

java -jar -Dspring.profiles.active=local sugoi-api.jar

Some other ways could be found in docs/install.md

All configuration is done through an application.properties file a la spring-boot.

Configuration.md for details.

Pull requests are welcome. We ask that all pull request are linked to an issue. The source code format should be in conformance with google guidestyles for java. this is checked for each PR, you can enforce it with mvn spotless:apply.

We also check that all commit are signed-off in accordance with DCO

All feature creation or update should be reflected in the documentation. All new configuration keys of the instance or realm should be documented.

Please make sure to update or create tests as appropriate.

Apache License, Version 2.0