The Integrations page provides options to configure integrations with variety of third-party services, such as cloud storage providers and Learning Management Systems.
The Storage Providers page allows administrators to view and manage connections with various cloud storage providers such as OneDrive and Dropbox. End-users may then use these connections to login to their cloud storage accounts and access their files while running applications.
Storage Provider configurations may be tested before committing any changes by clicking the Test button on the settings page. Common errors such as invalid or missing credentials or application registration misconfigurations will be reported during the testing process.
Learning Management Systems (LMS)
The Learning Management Systems (LMS) page allows administrators to view and manage connections with various LMSs such as Canvas, Moodle, and Blackboard. Once configured, students may access the Turbo Portal and launch applications through their LMS.
The following sections describe the avaiable LMS configurations:
Show in Course Navigation
When the LTI Configuration URL is used, Turbo Server sends user interface instructions to the LMS Platform. These UI instructions include a Turbo icon, description and the following fields:
- Placement location: Course Navigation
- Link text: Apps (customizable)
- Visibility: public
- Default: enabled (customizable)
When Show in Course Navigation is disabled, the Default setting changes to disabled. New courses then hide the apps link from students by default until an Instructor chooses to enable it.
Show in course navigation and link text settings will not affect LMS Platforms using the LTI Tool Provider URL.
Turbo must be removed and then re-added to the LMS for changes to these settings to take effect.
Upon receiving a LTI 1.0/1.1 Launch Request from the LMS platform, Turbo Server must determine the user identity requesting access. Turbo identifies users with two values, both of which must be unique and immutable:
- Login Name: User friendly identifier for signing in to Turbo resources.
- User ID: User's primary key in your organization's Learning Information System (LIS) or Directory Service.
By default, Turbo will look for these values in LTI Launch Request fields specific to each LMS Product. The following table describes the default fields used for identity for a given LMS.
|LMS||Login Name||User ID|
If your organization has modified the platforms’ identity settings, you may configure Turbo Server to find the Login Name and User ID under custom field names.
Navigate to the LTI page of the Turbo administrator site. Under the relevant value, check Custom to override the default field, then type in the name of the LTI Launch Request field for Turbo Server to use.
Associating a workspace with the LMS integration allows configuration of where end users will be redirected to when launching Turbo from the LMS. Additionally, this determines the workspace to which channels will be added when Automatically Create Channels is enabled.
Selecting "None" will redirect users to the Turbo Portal homepage. If the user has access to exactly one workspace then that workspace will be displayed, otherwise a list of available workspaces will be displayed.
Adding a Course to the Turbo Server allows configuration of a custom link to a particular Workspace or Channel. When a user launches Turbo from a known course, they are routed directly to the configured view.
To add a course to Turbo, it must first exist in the LMS. To edit an existing course, click on its name in the Courses table.
- Name: Administrative display name for the course, not seen by users.
- Course ID: Unique identifier for the course given by the LMS. Refer to the section below to obtain the value for the desired courses.
- Workspace: The Workspace users from the course will be routed to.
- Channel: The Channel view that users will be routed to. If left blank, users will be routed to the Workspace view.
- Default Channel Access: Automatically grant channel access to users from the LMS course. If the setting is not enabled, users must be granted permissions to the channel manually. Users must also have access to workspace regardless of this setting.
Renaming or deleting a course does not affect the LMS itself; these properties affect only how Turbo interacts with the course.
The following section desribes how to locate the course ID for supported LMS.
Navigate to any page of the desired course in Canvas. The URL will take a form similar to:
The number immediately after /courses/ is the Course ID. In this example, that number is 2307642.
Navigate to the Blackboard Administrator Panel. Under the section Courses, click on the Courses link.
Locate your course in the table. The Course ID is shown for the course.
Navigate to the settings page of the desired course.
The settings page can be reached by clicking the gear icon on the course’s home page or the gear icon on the listing in Course and category management.
The Course ID is located under General. If the course does not yet have an ID, one must be given.