LMS Integration Details


GoReact partners can integrate with the GoReact experience through the Learning Tools Interoperability (LTI) v1.1 specification. This is a standardized interface for establishing trust between the two systems and passing needed information such as course and user names. LTI is most commonly used by learning management systems (LMS) such as Canvas and Blackboard, but has received adoption from a number of host systems and a countless number of tool providers, providing add-on solutions for specialized activity and assignment functionalities.

When setting up the GoReact integration with your chosen LMS, there are some fields in the LTI v1.1 specification that are required in order for it to launch properly. If you are seeing an error message when trying to launch your integration, this list will help you identify what data is not being passed and why GoReact needs it. 

 

Launch Data Required 

Parameter What it is What it is used for
 context_id  unique ID

 This ID corresponds with a GoReact course ID.

 context_title  human-readable string

 This string corresponds with the GoReact course title.

 resource_link_id  unique ID

 This ID corresponds with a GoReact activity ID. 

 resource_link_title  human-readable string

 This string corresponds with the GoReact activity name.

 user_id  unique ID

 This ID corresponds with a GoReact user ID.

 lis_person_contact_email_primary  email

 The email is imported as GoReact user's email.

 lis_person_name_family  last name

 The name is imported as GoReact user's last name.

 lis_person_name_given  first name

 The name is imported as GoReact user's first name.

 lis_person_name_full  full name

 The name is imported as GoReact user's full name.

 roles  Learner, Instructor,  Teacher's Aid, Observer or Administrator

 The role corresponds with a GoReact role: Admin, Instructor, Reviewer, Presenter.

 lti_version  lti-1p1

 GoReact will check compatibility with this version. 

 tool_consumer_info_product_family_code  

 LMS or system name, e.g. Canvas

 Used to identify which LMS our tool is being integrated with. 

custom_goreact_partner_guid* [provided by GoReact for partner integrations]  unique ID

 This ID corresponds with a GoReact organization ID.

 tool_consumer_instance_guid  unique ID

 This ID corresponds with a GoReact organization ID.

 tool_consumer_instance_name  your organization name

 This name is imported as the corresponding GoReact organization name.

 tool_consumer_instance_contact_email  technical contact email

 The email is imported as technical contact email.

 oauth_consumer_secret  provided by GoReact

 Insures a secure integration.

 oauth_consumer_key  provided by GoReact

 Insures a secure integration.

 oauth_signature_method  HMAC-SHA1

 Used to identify which authentication method is being implemented. 

 oauth_timestamp  unix timestamp

 Insures a secure integration.

 oauth_version  1.0

 Used to identify which authentication version is being implemented. 

 oauth_nonce

 unique token generated per each unique request

 Insures a secure integration.
 oauth_signature  oauth signature

 Insures a secure integration.

 *Only required for partner integrations without a tool_consumer_instance_guid

Optional Data

Parameter What it is What it is used for
 lis_result_sourcedid  unique hash across resource_link_id / user_id

 Used for grade passback.

 custom_goreact_total_points_possible    number

 Points possible for grade passback.

 lis_outcome_service_url  URL

 Used for grade passback.

 user_image  URL

 Imported as profile picture of user.

 

 

 

Was this article helpful?
0 out of 1 found this helpful

Comments

0 comments

Article is closed for comments.