Configuration
Once the server has been correctly installed, you must add LMS's and WIMS servers on WIMS-LTI through the Administration Panel. To add WIMS servers, your must first configure it to accept WIMS-LTI requests.
WIMS
In order for a WIMS server to accept WIMS-LTI requests, you have to create a connection file. The creation of this file is explained here.
It is important to add the IP address of the WIMS-LTI server to the
ident_site
key and not the IP of the LMS.
Remember the value of the ident_password
and the name of the created file,
you will need these to add the server to WIMS-LTI.
WIMS-LTI
-
Go to the administration panel by connecting to
[WIMS-LTI SERVEUR]/admin/
and enter the administration account login and password that you entered when you installed the server (you can create a new one by runningpython3 manage.py createsuperuser
). -
Click on
LMS
(or go to[WIMS-LTI SERVEUR]/admin/lti_app/lms/
) -
Click
ADD LMS
in the top left and fill the form:GUID
: GUID of the LMS corresponding to thetool_consumer_instance_guid
parameter of the LTI request. Most of the time, it is the DNS of the LMS. For example:elearning.u-pem.fr
. See below for a way to retrieve get your GUID.Name
: Name that identifies the LMS, for example:Moodle UPEM
.URL
: URL of the LMS, for example:https://elearning.u-pem.fr/
key
: Key that you'll need to enter on the LMS when creating a LTI activity.secret
: Secret that you'll need to enter on the LMS when creating a LTI activity.
Repeat 3. for each LMS that you want to add.
-
Go back to
[WIMS-LTI SERVEUR]/admin/
and click onwims
(or go to[WIMS-LTI SERVEUR]/admin/lti_app/wims/
) -
Click
ADD WIMS
in the top left, and fill the form:Name
: Name to identify the WIMS server, ex:WIMS UPEM
.URL
: URL of the WIMS server, ex: `https://wims.u-pem.fr/wims/Default student limit
: Default limit of student ifcustom_class_limit
is not provided in the LTI request.Default duration
: Default duration before a class' expiration ifcustom_class_expiration
is not provided in the LTI request.Ident
: Name of the connection file created on the WIMS server. For example, if the file created was[WIMS_HOME]/log/classes/.connections/myself
, entermyself
.Passwd
: Value of the keyident_password
of the configuration file Ident.Rclass
: Identifiers used by WIMS-LTI to create classes on the WIMS server, for example:myclass
.Allowed LMS
: Select the LMS allowed to connect to this WIMS server (use CTRL + click to select more than one).
Repeat 5. for each WIMS server that you want to add.
Get your LMS' GUID
If you cannot find the GUID of your LMS, and if LTI is enable, a good way to get it is to create an LTI activity with the following parameters:
- URL :
https://www.tsugi.org/lti-test/tool.php
- Key :
12345
- Secret :
secret
The activity will redirect you on a webpage displaying the value of each LTI parameters,
including tool_consumer_instance_guid
, which correspond to your LMS' GUID.