Page Comparison

...

...

1 A SSO, what for?

SSO allows for users to launch your application within Maestrano without having to type in credentials. This enhances the user experience of customers by skipping a step to access your app.

2 What is supposed to happen when a Maestrano user launch my application for the first time?

When accessing your application for the first time, a new account must be created based on the user details including first and last name, email, company name etc... You may have different subscription plans to be offered to the user. The recommended approach is to setup the user account under a free trial if you support this kind of subscription. Otherwise it is recommended to provide the user with a basic subscription plan so he can try out your application functionalities. After the free trial has expired, the user will be charged via the Maestrano billing API.

As part of the SSO process, the user details are passed on (first and last names, email). You can decide to use these to match the user against an existing user inside your application rather than creating a new account. This will give the end user a better user experience.

3 What is the Workflow?

The Single Sign On process is initiated from the Maestrano website when a user clicks on your application tile. This redirects the user to the configured SSO initialization endpoint which then redirects back to Maestrano IDM endpoint. The user is then redirected to your SSO consume endpoint with all the User details required to either log the user in or create a new account.

4 What do I have to pay attention to?

As the user email is unique on Maestrano, it is safe to match users by email or user_id. The user_id must be stored against the User record so even if a user changes its email, you can still uniquely identify its account.

...

5 SSO Consume process