Integrate Straatos to business apps with Single-Sign-On (SSO-enabled)

With the method described below, it is possible to integrate CumulusPro Straatos with your application with SSO.

Two use cases:

- Send a Link via Email to a user

- Integrate Straatos seemlessly into your application

The URL can point the user to the right place in Straatos, for example directly to MyHome, to an organisation or a workflow.

The Single-Sign on is done in two steps:

1. Create a token

To create a token, submit the follwoing URL:

https://iconnector-configuration.cumuluspro.net/v2.0/AuthService.svc/json/TokenForFederatedAccount?loginName=<username>&password=<userpassword>&system=myhome&absoluteexpiry=<date>

Where:

iconnector-configuration.cumuluspro.net  = cumuluspro server, note, different regions have different URL's

<username> = a cumuluspro username that should be used for the login

<userpassword> = the password for the user account

<absoluteexpiry> = the expiry date in format YYYY-MM-DD when the token expires
 

To access to a specific document, use customdata=_documentId

https://iconnector-configuration.cumuluspro.net/v2.0/AuthService.svc/json/TokenForFederatedAccount?loginName=<username>&password=<userpassword>&system=myhome&absoluteexpiry=<date>&customdata=<documentId>

2. Using the token

When the above URL returns the token, the token can be used as follows to open the CumulusPro site:

https://adminpanel.cumuluspro.net/?t=<token>

Note: The adminpanel URL depends on the Region. The above is for Europe