Skip to end of metadata
Go to start of metadata
You are viewing an old version of this page. View the current version. Compare with Current  |   View Page History

1. Getting started - SecurityTokenService, UserToken parsing and app roles

SecurityTokenService is created to give the application an [ApplictionToken] and a UserToken.
It is where to start when you want to integrate your app.

Prerequisties: Development environment Win or Linux with Java installed.

  1. Download SecurityTokenService.jar Download
  2. Download propertyfile here to same location
  3. Run java -DIAM_MODE=DEV -DIAM_CONFIG=securitytokenservice.DEV.properties -jar SecurityTokenService.jar
  4. Point you browser at http://localhost:9998/tokenservice/
  5. Test the operations in the GUI (test API driver)
    -_
    NOTE: In DEV mode, you can create and adjust test-data/users/usertokens by creating files in the same directory with naming convension t_<my_test_username>.token ( See Example)

Some tips on parsing the UserToken to check roles

Xpath examples (Hint: experiment here)

Typical datastructures: ApplicationCredential, ApplicationToken, UserCredential, UserToken

Integration examples

We have provided a few integration examples for a set of different programming languages. See links below.

Full Size

2. Expand with a login GUI - Introduce SSOLoginWebApplication

SSOLoginService as created to present a basic configurable login GUI.
Configure a suitable logo and adjust the properties to fit your need.

  1. Download SSOLoginService.jar Download
  2. Download propertyfile here to same location
  3. Run java -DIAM_MODE=TEST -DIAM_CONFIG=ssologinservice.TEST.properties -jar SSOLoginwebApp.jar
  4. Point you browser at http://localhost:9998/sso/
  5. Test the operations in the GUI (test API driver)
  1. Install SSOLoginService in IAM_MODE=DEV on local machine
    1. Adjust properties to fit your neeed
  1. Install UserIdentityBackend in IAM_MODE=DEV on local machine
    1. Adjust properties to fit your neeed
  1. Verify test installation manually or by using the Whydah-TestWebApp
Full Size

3. Store users and roles - Introduce UserIdentityBackend

  1. Install SSOLoginService in IAM_MODE=DEV on local machine
    1. Adjust properties to fit your neeed
  1. Install UserIdentityBackend in IAM_MODE=DEV on local machine
    1. Adjust properties to fit your neeed
  1. Verify test installation manually or by using the Whydah-TestWebApp
Full Size

TODO describe how an application developer or architect can integrate an application with Whydah.

Labels:
None
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.