View Source

{section}
{column}
h3. Getting started

# Download SSOLoginService.jar [Download|http://mvnrepo.cantara.no/content/repositories/releases/net/whydah/token/SecurityTokenService/]
# Download propertyfile [here|https://raw.githubusercontent.com/altran/Whydah-SecurityTokenService/master/securitytokenservice.DEV.properties] to same location
# Run *java -DIAM_MODE=DEV -DIAM_CONFIG=securitytokenservice.DEV.properties -jar SSOLoginService.jar*
# Point you browser at [http://localhost:9998/tokenservice/]
# Test the operations in the [GUI|https://wiki.altrancloud.com/download/attachments/37388812/STS-testweb.png] (test API driver)
## NOTE: in this mode, you can create and adjust test-data/users/usertokens by creating files in the same directory with naming convension _<my_test_username>.token_ ( See [Example|https://raw.githubusercontent.com/altran/Whydah-SecurityTokenService/master/t_test@hotmail.com.token])


h3. Some tips on parsing the UserToken to check roles

*Xpath examples* (Hint: experiment [here|http://www.freeformatter.com/xpath-tester.html])
{code}

# find my applicationtokeID from returned ApplicationToken
/token/params/applicationtokenID

# check UserToken if the user has the role Employee for the application with a given applicationID
/token/application[@ID="<myApplicationID>"]/role[@name="Employee"]
{code}
Typical datastructures. [ApplicationCredential], [ApplicationToken], [UserCredential], [UserToken]

{column}
{column}
{gliffy:name=Integration - simple standalone|align=left|size=L|version=3}

{column}
{section}


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

* Java web-app example [https://github.com/altran/Whydah-TestWebApp]
* Spring Security example [https://github.com/altran/Whydah-TestWebApp/tree/master/ImplementationExamples/spring-security]
* Django example [https://github.com/altran/Whydah-TestWebApp/tree/master/ImplementationExamples/Django]
* JavaScript example [https://github.com/altran/Whydah-TestWebApp/tree/master/ImplementationExamples/Javascript]
* SharePoint 2013 (.NET) example [https://github.com/altran/Whydah-TestWebApp/tree/master/ImplementationExamples/SharePoint]


-----

h3. Preparation for a more full-stack environment

# Install SSOLoginService in IAM_MODE=DEV on local machine
## Adjust properties to fit your neeed
# Install SecurityTokenService in IAM_MODE=DEV on local machine
## Adjust properties to fit your neeed




# Verify test installation manually or by using the Whydah-TestWebApp

h3. Integration

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

* Java web-app example [https://github.com/altran/Whydah-TestWebApp]
* Spring Security example [https://github.com/altran/Whydah-TestWebApp/tree/master/ImplementationExamples/spring-security]
* Django example [https://github.com/altran/Whydah-TestWebApp/tree/master/ImplementationExamples/Django]
* JavaScript example [https://github.com/altran/Whydah-TestWebApp/tree/master/ImplementationExamples/Javascript]
* SharePoint 2013 (.NET) example [https://github.com/altran/Whydah-TestWebApp/tree/master/ImplementationExamples/SharePoint]


{gliffy:name=AuthSequenceStandAlone|align=left|size=L|version=5}
TODO describe how an application developer or architect can integrate an application with Whydah.