Quick set-up (Using Docker on development machine)
- Install docker
- Start Whydah, ready for Integration
- Add your application to the Whydah componnets (in Whydah 2.0: add it in securitytykenservice.TEST_LOCALHOST.properties)
Client code example
(Example using Apache HTTP Components Fluent API and jOOX Fluent API)
1. Getting started - SecurityTokenService and parsing of UserToken
SecurityTokenService is created to give the application an ApplicationToken and a UserToken. Prerequisties:
NOTE: Some tips on parsing the UserToken to check rolesXpath examples (Hint: experiment here Typical datastructures: Integration examplesWe have provided a few integration examples for a set of different programming languages.
|
|
2. Expand with a login GUI - Introduce SSOLoginWebApplication
SSOLoginWebApplication is created to present a basic configurable login GUI, reset password GUI and user registration.
|
|
3. Store users and roles - Introduce UserIdentityBackend
UserIdentityBackend is created to store user identities, store user roles and integrate with 3rd party IDP's.
|
|
4. User administration for administrators - Introduce UserAdminWebApp
You might want to have a look at the registered users and change them.
For that you might want to run UserAdminWebApp - UAWA.
Whydah 2.1+ introduces administration of collaborating applications
5. User administration self service - Introduce UserAdminService
You might want to include some simple self service features in your application, like adding roles to certain users or self registration.
UserAdminService is created to allow for exactly that.
It is however still in an early release.
Whydah development Express-route for linux and osx/mac
![]() | Pre-requisites: JDK 8, maven 3 and wget installed |
- run bootstrapAndRunWhydah.sh (wget https://raw.githubusercontent.com/Cantara/Whydah/master/dev-quickstart/bootstrapAndRunWhydah.sh
) which will do the following
- clone all main Whydah repositories
- build all modules on local machine
- start all built modules in a TEST_LOCALHOST configuration
- verify that it is working before starting to code (http://localhost:9997/sso/welcome
u:useradmin pw:useradmin567)