Install the Webex Education Connector in Canvas

When installing the Webex Education Connector in to Canvas, you have the option of installing site-wide in an enabled state, in a single course, or site-wide in a disabled state. A Canvas Administrator must complete the installation.

1

Configure your Cisco Webex Site to allow the Webex Education Connector integration:

  • For sites managed in Cisco Webex Site Administration, sign in to Webex Site Administration and go to Configuration > Common Site Settings > Options.

  • For sites managed in Cisco Webex Control Hub, go to the customer view in https://admin.webex.com, then go to Services, and under Meeting, select Sites. Choose the Webex site to change the settings for, click Configure Site, and then under Common Settings, select Site Options.

2

Scroll to Allow the following URL domain names and enter lti.educonnector.io separated from the other domain names by a comma.

3

Sign in to Canvas as an administrator, select the Admin tab, and then select the name of the account.


 

The account determines which courses the tool is available in.
4

Select Developer Keys > + Developer Key > + API Key and enter the following information:

  • Key Name—Enter Webex.

  • (Optional) Owner Email—Enter an email address.

  • Redirect URIs—Enter both URIs on separate lines.

    • https://lti.educonnector.io/lms_accesses/new

    • https://lti.educonnector.io/lms_accesses/callback

  • Enforce Scopes—Do not enable, scoped developer keys are currently not supported.

5

Select Save Key, and take note of the ID and Key generated in the Details section of the new Developer Key, as you'll need these later. In the State section of the new Developer Key, select ON.

6

Open a new tab in your browser, navigate to: https://lti.educonnector.io/, and enter the following information:

  • Full name—Enter your first and last name.

  • Email—Enter your administrator email address.

  • Institution—Enter the name of your institution.

  • Webex site—Enter the information in your Webex URL before .webex.com. If your site URL is https://myschool.webex.com/, enter myschool.

  • LMS ...—Select Canvas from the drop-down list.

  • Install in a Disabled State—Uncheck if you want Webex to be enabled when installed. Check if you want Webex to be disabled when installed.

  • Canvas Site Domain—Enter the URL of your canvas site. For example, https://college.acme.instructure.com.

  • Canvas Developer ID—Enter the ID from Step 5.

  • Canvas Developer Key—Enter the Key from Step 5.

7

Select Next, and take note of the Your Consumer Key, Your Shared Secret, and LTI Registration URL.

8

Navigate back to Canvas, select the Admin tab, then select the name of the account:

  • If you want to install site-wide—Select a Site, then go to Settings > Apps > + App.

  • If you want to install in a single course—Select a Course, then go to Settings > Apps > + App.

9

Enter the following information:

  • Configuration Type—Select By URL.

  • Name—Enter Webex, or another descriptive name.

  • Consumer Key—Enter the Your Consumer Key from Step 5.

  • Shared Secret—Enter the Your Shared Secret from Step 5.

  • Config URL—Enter the LTI Registration URL from Step 5.

10

Navigate to a course within the site, and confirm that the Webex Education Connector has been installed. Follow the setup prompts.

Install the Webex Education Connector in Blackboard Learn with Ultra Experience Enabled

Use the following steps to install the Webex Education Connector in Blackboard Learn release 3400.5.0-rel.12+393c117. A Blackboard Administrator must complete the installation. The Webex Education Connector can only be installed in Blackboard Learn sites with the Ultra experience enabled. Make sure any courses that use the Webex Education Connector are in Ultra Course View.

1

Configure your Cisco Webex Site to allow the Webex Education Connector integration:

  • For sites managed in Cisco Webex Site Administration, sign in to Webex Site Administration and go to Configuration > Common Site Settings > Options.

  • For sites managed in Cisco Webex Control Hub, go to the customer view in https://admin.webex.com, then go to Services, and under Meeting, select Sites. Choose the Webex site to change the settings for, click Configure Site, and then under Common Settings, select Site Options.

2

Scroll to Allow the following URL domain names and enter lti.educonnector.io separated from the other domain names by a comma.

3

Open a new tab in your browser, navigate to: https://lti.educonnector.io/, and enter the following information:

  • Full name—Enter your first and last name.

  • Email—Enter your administrator email address.

  • Institution—Enter the name of your institution.

  • Webex site—Enter the information in your Webex URL before .webex.com. If your site URL is https://myschool.webex.com/, enter myschool.

  • LMS ...—Select Blackboard from the drop-down list.

  • Blackboard Site Domain—Enter the URL of your Blackboard site. For example, https://myschool.blackboard.com.

  • Blackboard Site Timezone—Select the time zone of your Blackboard site from the drop-down list.

4

Select Next, and take note of the Your Consumer Key, Your Shared Secret, Your LTI Launch URL, and Your Application ID.

5

Sign in to Blackboard as an administrator, and go to System Admin > Integrations > REST API Integrations > Create Integration.

6

Enter the following information:

  • Application ID—Use the Application ID generated in Step 4.

  • Learn User—Enter the administrator user name.

  • End User Access—Select Yes.

7

Return to Blackboard, and go to System Admin > integrations > LTI Tool Providers > Register Provider Domain.

8

Enter the following information:

  • Provider Domain—Enter lti.educonnector.io.

  • Provider Domain Status—Select Approved.

  • Tool Provider Key—Enter the Your Consumer Key from Step 4.

  • Tool Provider Secret—Enter the Your Shared Secret from Step 4.

  • Send User Data—Select Send user data over SSL.

  • User Fields to Send—Check the following options:

    • Role in Course

    • Name

    • Email Address
9

Select Submit and take note of the Client ID and Client Secret.

10

Go back to System Admin > integrations > LTI Tool Providers.

11

Select the down arrow next to Webex, and select Manage Placements.

12

Select Create Placement and enter the following information:

  • Label—Enter Webex.

  • Handle—Enter Webex.

  • Tool Provider URL—Enter https://lti.educonnector.io/launches.

  • Tool Provider Key—Populates from the initial setup.

  • Tool Provider Secret—Populates from the initial setup.

13

Select Submit.

14

To enable the Webex Education Connector in a course, open the course, hover over +, and go to Create > Link.

15

Complete the Link options:

  • Available to Students—Check this option so that students can see the tool.

  • Launch URL—Enter the Your LTI Launch URL from Step 4.

16

Select Save.

Install the Webex Education Connector in Moodle

Use the following steps to install the Webex Education Connector in Moodle version 3.5.2. A Moodle Administrator must complete the installation.

1

Configure your Cisco Webex Site to allow the Webex Education Connector integration:

  • For sites managed in Cisco Webex Site Administration, sign in to Webex Site Administration and go to Configuration > Common Site Settings > Options.

  • For sites managed in Cisco Webex Control Hub, go to the customer view in https://admin.webex.com, then go to Services, and under Meeting, select Sites. Choose the Webex site to change the settings for, click Configure Site, and then under Common Settings, select Site Options.

2

Scroll to Allow the following URL domain names and enter lti.educonnector.io separated from the other domain names by a comma.

3

Select Next and take note of the Your Consumer Key and Your Shared Secret.

4

Sign in to Moodle as an administrator.

5

Enable webservices: Go to Site administration > Advanced features, check Enable web services, and then select Save Changes.

6

Enable protocols: Go to Site administration > Plugins > Web services > Manage protocols, and make sure that the REST protocol is enabled.

7

Enable external services: Go to Site administration > Plugins > Web services > External services > Add. For the External service page, do the following:

  • Name field—Enter a descriptive name.

  • Short Name field—Enter cisco_webex_app.

  • Enabled—Check.

8

Select Add service > Add functions and then select the following functions from the drop-down list:

  • core_calendar_create_calendar_events

  • core_calendar_delete_calendar_events

  • core_enrol_get_enrolled_users

  • core_grades_update_grades

  • core_user_get_users_by_field

  • gradereport_user_get_grade_items

  • core_webservice_get_site_info
9

Select Add Functions.

10

To add a new token, go to Site Administration > Plugins > Web services > Manage tokens > Add. Then enter the following information:

  • User—Select yourself from the drop-down list.

  • Service—Select Webex.

  • Valid until—Enter a future date.

11

Select Save changes.

12

Copy the generated token ID.
13

Open a new window in your browser, go to: https://lti.educonnector.io/, and enter:

  • Email—Enter your administrator email address.

  • Institution—Enter the name of your institution.

  • Webex site—Enter the information in your Webex URL before .webex.com. If your site URL is https://myschool.webex.com/, enter myschool.

  • LMS ...—Select Moodle from the drop-down list.

  • Moodle Site Domain—Enter the URL of your Moodle site. For example, https://myschool.moodlecloud.com.

  • Moodle Web Service Name—Enter cisco_webex_app.

  • Moodle Web Token—Paste the generated token ID that you copied in the previous step.

  • Moodle Site Timezone—Select the time zone of your Moodle site from the drop-down list.

14

Optionally, to allow other user roles to authorize the application, go to Site Administration > Users > Permissions > Define Roles > Manage Roles and select gear next to the role.

15

For Create a web service token, select Allow and Save.

16

Go to Site Administration > Plugins > Activity Modules > Manage tools > configure a tool manually.

17

For External tool configuration, enter the following information:

  • Tool name—Enter Webex.

  • Tool URL—Enter https://lti.educonnector.io/launches.

  • Consumer key—Enter the Your Consumer Key from Step 3.

  • Shared secret—Enter the Your Shared Secret from Step 3.

  • Custom parameters—Leave blank.

  • Show tool type when creating tool instances—Check.

  • Default launch container—Select Embed, without blocks.

18

To add the Webex Education Connector in a Moodle course, create an External Tool activity:

  • Navigate to a Moodle course. Select the gear in the upper right corner and then select Turn editing on.

  • In the section you want to add the Webex Education Connector, select Add an activity or resource > External tool > Add.

  • For Adding a new external tool, enter the following information:

    • Activity name—Enter Webex Education Connector.

    • Preconfigured tool—Enter Webex Education Connector.

    • Tool URL—Leave blank.

    • Launch Container—Select Default.

    • Privacy—Check the following options:

      • Share launcher’s name with the tool

      • Share launcher’s email with the tool

      • Accept grades from the tool

    • Grade—No changes necessary.

    • Common module settings—No changes necessary.

    • Restrict access—No changes necessary.

    • Activity completion—No changes necessary.

    • Tags—No changes necessary.

    • Competencies—No changes necessary.

19

From the course, launch the activity. This shows the Webex Education Connector in a Moodle course.

Install the Webex Education Connector in Brightspace by D2L

Use the following steps to install the Webex Education Connector in Brightspace by D2L version 10.8.6 and later. A D2L Administrator must install the Webex Education Connector in Brightspace by D2L.

1

Configure your Cisco Webex Site to allow the Webex Education Connector integration:

  • For sites managed in Cisco Webex Site Administration, sign in to Webex Site Administration and go to Configuration > Common Site Settings > Options.

  • For sites managed in Cisco Webex Control Hub, go to the customer view in https://admin.webex.com, then go to Services, and under Meeting, select Sites. Choose the Webex site to change the settings for, click Configure Site, and then under Common Settings, select Site Options.

2

Scroll to Allow the following URL domain names and enter lti.educonnector.io separated from the other domain names by a comma.

3

Sign in to D2L as an administrator and go to Admin Tools gear > Organization Related > Manage Extensibility > OAuth 2.0 > Register an app.

4

Enter the following information:

  • Application Name—Enter Webex.

  • Redirect URI—Enter https://lti.educonnector.io/lms_accesses/callback

  • Scope—Enter core:*:* grades:gradeobjects:write grades:gradeobjects:read grades:gradevalues:write

  • Access Token Lifetime (seconds)—Enter 3600.

  • Check the following options:

    • Prompt for user consent

    • Enable refresh tokens

    • I accept the Non-Commercial Developer Agreement
5

Select Register and take note of the Client ID and Client Secret.

6

Open a new tab in your browser, go to: https://lti.educonnector.io/, and enter the following information:

  • Full name—Enter your first and last name.

  • Email—Enter your administrator email address.

  • Institution—Enter the name of your institution.

  • Webex site—Enter the information in your Webex URL before .webex.com. If your site URL is https://myschool.webex.com/, enter myschool.

  • LMS ...—Select D2L from the drop-down.

  • D2L Site Domain—Enter the URL of your canvas site. For example, https://myschool.brightspace.com.

  • D2L Developer ID—Enter the Client ID from Step 5.

  • D2L Developer Key—Enter the Client Secret from Step 5.

7

Select Next and take note of the Your Consumer Key, Your Shared Secret, and Your LTI Launch URL.

8

Return to D2L, go to the course where you would like to use the Webex Education Connector, and then go to Course Tools > Course Admin > Site Resources > External Learning Tools.

9

Select New Link and enter the following information:

  • Title—Enter Webex.

  • URL—Enter https://lti.educonnector.io/launches.

  • Check the following options:

    • Allow users to view this link

    • Sign messages with key/secret

    • Link key/secret

  • Key—Enter the Your Consumer Key from Step 5.

  • Secret—Enter the Your Shared Secret from Step 5.

  • Security Settings—Select Use link security settings and check all options:

    • Send tool consumer information to tool provider

    • Send context information to tool provider

    • Send course information to tool provider

    • Send LTI user ID and LTI role list to tool provider

    • Send user name to tool provider

    • Send user email to tool provider

    • Send system username to tool provider

    • Send system Org Defined ID to tool provider

    • Send system role to tool provider

    • Send link title to tool provider

    • Send link description to tool provider

  • Current Org Unit: Your Course: Check.

10

Select Save and Close.

The Webex Education Connector should now be listed under Manage External Learning Tool Links.

Install Webex Education Connector in Sakai

Use the following steps to install the Webex Education Connector in Sakai 12.x and later. A Sakai Administrator must install the Webex Education Connector in Sakai.

1

Configure your Cisco Webex Site to allow the Webex Education Connector integration:

  • For sites managed in Cisco Webex Site Administration, sign in to Webex Site Administration and go to Configuration > Common Site Settings > Options.

  • For sites managed in Cisco Webex Control Hub, go to the customer view in https://admin.webex.com, then go to Services, and under Meeting, select Sites. Choose the Webex site to change the settings for, click Configure Site, and then under Common Settings, select Site Options.

2

Scroll to Allow the following URL domain names and enter lti.educonnector.io separated from the other domain names by a comma.

3

Go to: https://lti.educonnector.io/ and enter the following information:

  • Full name—Enter your first and last name.

  • Email—Enter your administrator email address.

  • Institution—Enter the name of your institution.

  • Webex site—Enter the information in your Webex URL before .webex.com. If your site URL is https://myschool.webex.com/, enter myschool.

  • LMS ...—Select Sakai from the drop-down list.

  • Sakai Site Domain—Enter your Sakai domain. For example, https://myschool.sakai.com.

  • Sakai Site Timezone—Select the time zone of your Sakai Site from the drop-down list.

4

Select Next and take note of the Your Consumer Key, Your Shared Secret, and Your LTI Launch URL.

5

Sign in to Sakai as an Administrator. Go to Worksite Setup and select the name of the class where you want to install the Webex Education Connector.

6

Then, go to Site Info > Manage Tools and check External Tool. Select Continue.

7

For Customize tool instances, enter a descriptive title for the Webex Education Connector. For example, Webex.

8

Select Continue > Finish.

9

In the left navigation, select Webex > Edit, and enter the following information:

  • Remote Tool URL—Enter the Your LTI Launch URL from Step 2.

  • Remote Tool Key—Enter the Your Consumer Key from Step 2.

  • Remote Tool Secret—Enter the Your Shared Secret from Step 2.

  • Set Button Text—Enter a name that will appear in the navigation.

  • Releasing Roster Information—Check the following options:

    • Send Names to External Tool

    • Send Email Addresses to External Tool

    • Allow the External Tool to retrieve the course roster
10

Select Update Options.

This will navigate you to the page where you can set up and use the Webex Education Connector.