Connecting to Foliotek with LTI
Connecting to Foliotek with LTI
Foliotek conforms to IMS LTI (Learning Tools Interoperability) standards making it easy to connect and access our system. Most LMS (Learning Management Systems), such as Blackboard and Moodle, provide tools for easy set up.
Getting Started:
-
We will provide you with a Key and Secret.
-
We will need to define the unique account identifier field. Foliotek defaults to lis_person_sourcedid, however some LMS versions do not pass this field. It is possible to define a custom parameter or possibly use lis_person_contact_email_primary or user_id.
-
Additionally we will need to define your organization within our system. This can be done in one of two ways. Normally, we can set a parameter on your LTI instance mapping you to an organization in our system. Second, if you wish to use the same LTI instance with different organizations we can set up a custom parameter and have the organization's id passed along with the request.
-
We need to define the roles parameter. Following the IMS standards, this is simply set to "roles". We currently accept student, learner, faculty and instructor.
-
Your request needs to follow the basic LTI message signing. It is necessary that your signature method is HMAC-SHA1 and that you send both a timestamp and nonce. Most LMS will do this automatically.
-
Depending on your LMS, you will need to select the options to provide Foliotek with the users data. This could include their name and email address to help with identifying the user attempting to access Foliotek.
IMS Global - Learning Tools Interoperability
Basic Parameters:
Launch URL: https://secure.foliotek.com/blti
Key: Provided by Foliotek
Secret: Provided by Foliotek
roles: Learner
lis_person_sourcedid: This field needs to match an existing user in our system. Your organization would have provided Foliotek with an external id.
lis_person_contact_email_primary: If
sourcedid fails, Foliotek will fall back to
lis_person_contact_email_primary to identify the user.