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. You need to be a Canvas Administrator and a Webex site administrator to 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 and select Configure Site > Common Settings > 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.example.instructure.com, enter college.example.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 > View App Configuration > + App.

  • If you want to install in a single course—Select a Course, then go to Settings > View App Configuration > + 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.

  • Launch 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.

11

Launch the Webex Education Connector.
12

Go to the Setup tab and select Authorize, then follow the authorization steps.

13

To sync the time zone, go to the Setup tab and select Sync.

14

To enable site-wide features available for instructor configuration, go to the Setup tab and select Admin Panel. Click Back to App to return to the Webex Education Connector once complete.

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. You need to be a Blackboard Administrator and a Webex site administrator to complete the installation. Make sure any courses that use the Webex Education Connector are in Ultra Course View.


These steps are for Blackboard courses created 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 Ultra from the drop-down list.

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

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

Select Next.


 

Take note of the Your Consumer Key, Your Shared Secret, Your LTI Launch URL, and Your Application ID information, you'll need it later.

4

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

5

Enter the following information:

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

  • Learn User—Enter the administrator user name.

  • End User Access—Select Yes.

  • Authorized to Act as user— choose Service Default (No).

Click Submit.

6

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

7

Enter the following information:

  • Provider Domain—Enter lti.educonnector.io.

  • Provider Domain Status—Select Approved.

  • Default Configuration—Select Globally.

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

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

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

  • User Fields to Send—Check the following options:

    • Role in Course

    • Name

    • Email Address

  • Allow Membership Service Access—Select Yes.

Select Submit.

8

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

9

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

10

Select Create Placement and enter the following information:

  • Label—Enter Webex.

  • Handle—Enter Webex.

  • Availability—Select Yes.

  • Type—Course tool. Select Student and Non-student.

  • 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.

Select Submit.

11

To open the Webex Education Connector in a course, open the course, and click Books and Tools > Installed WEC name (Webex).

12

Go to the Setup tab and select Authorize, then follow the authorization steps.

Only administrators can authorize the application. Administrators need to authorize once, and the authorization applies for all courses where the administrator is enrolled. The administrator must be enrolled in the courses for the authorization to apply.

Install the Webex Education Connector in Blackboard Learn

Use the following steps to install the Webex Education Connector in Blackboard Learn release 3400.5.0-rel.12+393c117. You need to be a Blackboard Administrator and a Webex site administrator to 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, select Configure Site > Common Settings > 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 myschool.webex.com/, then enter myschool.

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

  • Blackboard Site Domain—Enter the URL of your Blackboard site. For example, 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.

  • Authorized to Act as User— Choose Service Default (No)

Click Submit.

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.

  • Default Configuration— Select Globally.

  • 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

  • Allow Membership Service Access—Select Yes.

Select Submit
9

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

10

Select the drop-down arrow next to Webex and select Manage Placements > Create Placements.

11

Enter the following information:

  • Label—Enter Webex.

  • Handle—Enter Webex.

  • Availability—Select Yes.

  • Type—Course tool. Select Student and Non-student.

  • 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.

12

Select Submit.

13

To open the Webex Education Connector in a course, click Tools > Installed WEC name (Webex).

14

Go to the Setup tab and select Authorize, then follow the authorization steps.

Only administrators can authorize the application. Administrators need to authorize once, and the authorization applies for all courses where the administrator is enrolled. The administrator must be enrolled in the courses for the authorization to apply.

Install the Webex Education Connector in Moodle

Use the following steps to install the Webex Education Connector in Moodle version 3.5.2. The Moodle site must have SSL configured before installation. You need to be a Moodle Administrator and Webex site administrator to 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, then select Configure Site > Common Settings > 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 Moodle as an administrator and go to Site Administration.

4

Enable webservices: Go to Access Administration > Site Administration > Advanced Features, check Enable web services, and then select Save Changes.

5

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

6

Create an external services: Go to Site administration > Plugins > 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.

7

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

  • core_course_get_courses
8

Select Add Functions.

9

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.

10

Select Save changes.

11

Copy the generated token ID.
12

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 enter, 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.

13

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

14

Go to Site Administration > Plugins > Activity Modules > External Tool > Manage preconfigured tools > Add preconfigured tool.

15

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 12.

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

  • Custom parameters—Leave blank.

  • Tool configuration usage—Select Show as preconfigured tool when adding an external tool.

  • Default launch container—Select Embed, without blocks.

  • Privacy—Optional.

  • Miscellaneous—Optional.

16

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.

    • 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.

17

From the course, launch the activity to see the Webex Education Connector.

18

Go to the Setup tab and select Authorize, then follow the authorization steps.

19

To enable site-wide features available for instructor configuration, go to the Setup tab and select Admin Panel. Click Back to App to return to the Webex Education Connector once complete.

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. You need to be a D2L Administrator and Webex site administrator to 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 then select Configure Site > Common Settings > 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, enter myschool.

  • 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 Admin Tools Gear > Organization Related > External Learning Tools.

9

Select New Link and enter the following information:

  • Title—Enter Webex.

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

  • Visibility—Select Allow users to view this link.

  • 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 7.

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

  • 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 Add Org Units, and locate the course you want to enable Webex Education Connector for and click Insert.

11

Select Save and Close.

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

Go to the course and select Content > Add a module.

13

Enter a name for the module then select Existing Activities > Select External Learning Tool.

14

Select the provider name of your LTI tool.
15

Launch the Webex Education Connector app, and go to the Setup tab.

16

Click Authorization and follow the steps.

17

Click Sync on the Setup tab to sync the timezone.

18

To enable site-wide features available for instructor configuration, go to the Setup tab and select Admin Panel. Click Back to App to return to the Webex Education Connector once complete.

Follow these steps if you’d like an instructor to be able to authorize the app and sync the time zone.

  1. From the D2L home page, go to Admin Tools in the top right-hand corner.

  2. In the Security section, select Roles & Permissions.

  3. In the Role and Description section, select Instructor.

  4. Choose the instructor from the Filter by role drop-down list.

  5. Select Config Variable Browser from the Filter by tool drop-down list and select Apply Filter.

  6. In the Can Edit Config Variable Values row, check the box in the Organization column.

  7. Click Save and Close.

Install the Webex Education Connector in Sakai

Use the following steps to install the Webex Education Connector in Sakai 12.x and later. You need to be a Sakai Administrator and Webex site administrator to 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

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.
11

Go to the Setup tab and select Authorize, then follow the authorization steps.

12

To enable site-wide features available for instructor configuration, go to the Setup tab and select Admin Panel. Click Back to App to return to the Webex Education Connector once complete.