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
