Forma.lms accepts SSO from a third-party site for the already registered users

Settings

The SSO functionality has to be enabled in the general settings.
You have to define a secret key that will have to be shared between forma.lms and the third-party portal or website implementing SSO.
We suggest you to use a long and complex secret key (at least 32 characters, including capitalized and not capitalized letter, numbers, symbols). You can generate a complex key with one of the many automatic token generators available on the web.

You can define the validity of the generated token. Default is 60 seconds. The link generated with the token is valid for the time set starting from when it has been generated.

SSO Link

The link for SSO is as follows:

forma.lms version 1.xx

http://.../appLms/index.php?login_user=<username>&time=<str_tempo>&token=<str_token>

forma.lms version 2.xx

http://.../index.php?r=adm/homepage/sso&login_user=<username>&time=<str_tempo>&token=<str_token>

Link parameters

This is the meaning of the parameters you can find in the link:

<username> = this is the user name as registered in the LMS.

<str_tempo> = token generation date and time, in the timestamp format NNNNNNNNNN
(number of seconds since 1970)
<str_token> = encrypted string, with the following algorithm:

md5( <username> + ‘,’ + <str_tempo> + ‘,’ + <shared key> )

The generated token’s validity can be set under the LMS’s settings. By default it’s 60 seconds.

Examples

Example 1

Shared key: parolachiavecondivisasso

Username (login): gverdi

Date and time of generation: 2017-11-20 09:13:42

url parameters:

• Generated Token: d16ea692e74fdd9cbbbd2fb1001c33e1
• time: 1511165622
• login_user: gverdi

URL to be used

forma 1.x:

http://your.domain.com/appLms/index.php?login_user=gverdi&time=1511165622&token=d16ea692e74fdd9cbbbd2fb1001c33e1 

forma 2.x

http://your.domain.com/testing/index.php?r=adm/homepage/sso&login_user=gverdi&time=1511165622&token= d16ea692e74fdd9cbbbd2fb1001c33e1

Example 2

Shared key: ssosharedkeysample

Username (login): johndoe

Date and time of generation: 2017-11-20 09:21:31

url parameters:

• Generated Token: 48e430a787ba544894a092ea2480a244
• time: 1511166091
• login_user: johndoe

URL to be used

forma 1.x:

http://your.domain.com/appLms/index.php?login_user=johndoe&time=1511166091&token=48e430a787ba544894a092ea2480a244

forma 2.x:

http://your.domain.com/index.php?r=adm/homepage/sso&login_user=johndoe&time=1511166091&token=48e430a787ba544894a092ea2480a244