LMS: Canvas

Introduction

There are two parts to the SmarterProctoring installation process

  1. Developer Keys: Configuring the developer keys will allow SmarterProctoring the ability to pull the data required for exam import and course roster sync. If those features are not desired this part can be skipped as the omission does not actually inhibit the use of the product.
  2. LTI Configuration: Unlike the first part, the LTI configuration is required for the tool to operate correctly. SmarterProctoring is added as an external tool just like any other external tool. As an administrator, you will choose at what "level" the tool will be installed. The tool can be installed at the system level (all courses have access to use the tool) or on a course-by-course basis (only certain courses have access to use the tool). The LTI Configuration section below has steps for each of these types of installation to help with the installation process.

Developer Keys

In order for SmarterProctoring to communicate properly with the Canvas installation some keys must be configured. These keys will allow SmarterProctoring the ability to pull exam and course roster information which is used to enrich the experience while using SmarterProctoring. While this configuring is NOT REQUIRED, many customers opt to complete these steps to use the product to the fullest extent. If this type of integration is not desired please skip to the next section to configure the LTI tool.

Please note that you must be an administrator of your LMS with access to the LMS account management area - this is NOT the same as your user account management area.

  1. Click on the Admin menu option from your main LMS navigation menu.
  2. Select the account you wish to manage. Our LMS demo account is called "SmarterServices" as shown below.
  3. Click the Developer Keys menu option.
  4. Click the + Developer Key button from the upper right of the screen.
  5. Complete the Developer Key form. The only required items are listed below, the other fields can be completed as desired.
  6. Click Save Key button.
  7. When the list of keys loads, the ID and Key values will need to be copied. Please note the key is much longer than what is visible so when copying, ensure the entire key is being copied.
  8. Copy the ID and Key and email them to Sean Doty at sean@smarterservices.com so the configuration on the SmarterProctoring side can be handled.
  9. Wait for Sean to reply confirming that your SmarterProctoring account has been configured and then continue to the next section.


LTI Configuration

  • Account Level: When installing at the account level, SmarterProctoring will appear in the navigation bar for all courses by default.
  • Course Level: Installing at the course level provides a finer level of control over which courses will use SmarterProctoring. Since the tool is being installed within a specific course it is not possible to impact other courses or for it to appear for courses that do not and/or should not have access to the tool.

Account Level

  1. After logging into the LMS, click the Admin link on the left navigation.
  2. When the menu opens, choose the account in which you would like to install SmarterProctoring and click it.
  3. At the bottom of the sub-menu on the left, click the Settings.
  4. Click the Apps link.
  5. Click View App Configurations, showing all the currently installed tools and allow you to install a new one manually.
  6. Click + App to open the form and add the tool.
  7. Under the Configuration Type drop down box, select Paste XML.
  8. Complete the form by entering the name of the link as you want it to appear within the Navigation. The key and secret that were provided by SmarterProctoring will be added to the proper fields. Once that is done, copy the XML provided below and paste it into the XML Configuration box and click Submit.
    <?xml version="1.0" encoding="UTF-8"?>
    <cartridge_basiclti_link xmlns="http://www.imsglobal.org/xsd/imslticc_v1p0"
        xmlns:blti = "http://www.imsglobal.org/xsd/imsbasiclti_v1p0"
        xmlns:lticm ="http://www.imsglobal.org/xsd/imslticm_v1p0"
        xmlns:lticp ="http://www.imsglobal.org/xsd/imslticp_v1p0"
        xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation = "http://www.imsglobal.org/xsd/imslticc_v1p0 http://www.imsglobal.org/xsd/lti/ltiv1p0/imslticc_v1p0.xsd
        http://www.imsglobal.org/xsd/imsbasiclti_v1p0 http://www.imsglobal.org/xsd/lti/ltiv1p0/imsbasiclti_v1p0.xsd
        http://www.imsglobal.org/xsd/imslticm_v1p0 http://www.imsglobal.org/xsd/lti/ltiv1p0/imslticm_v1p0.xsd
        http://www.imsglobal.org/xsd/imslticp_v1p0 http://www.imsglobal.org/xsd/lti/ltiv1p0/imslticp_v1p0.xsd">
        <blti:title>Proctoring</blti:title>
        <blti:description></blti:description>
        <blti:icon></blti:icon>
        <blti:launch_url>https://signon.smarterservices.com/v1/auth/lti</blti:launch_url>
        <blti:extensions platform="canvas.instructure.com">
          <lticm:property name="tool_id">com.smarterproctoring</lticm:property>
          <lticm:property name="privacy_level">public</lticm:property>
          <lticm:options name="course_navigation">
            <lticm:property name="url">https://signon.smarterservices.com/v1/auth/lti</lticm:property>
            <lticm:property name="text">Proctoring</lticm:property>
            <lticm:property name="visibility">public</lticm:property>
            <lticm:property name="default">enabled</lticm:property>
            <lticm:property name="enabled">true</lticm:property>
          </lticm:options>
        </blti:extensions>
        <cartridge_bundle identifierref="BLTI001_Bundle"/>
        <cartridge_icon identifierref="BLTI001_Icon"/>
    </cartridge_basiclti_link>  

    If you wish to change the title/label of the tool as it appears in your navigation, simply modify the text property of the lticm:property element located under course_navigation in the code above. The image below shows where this property is located.

  9. At this point, SmarterProctoring has been registered as an LTI tool and will be shown in the list of tools.

Course Level

  1. Navigate to the course in which you want SmarterProctoring to be installed.
  2. Click on the Settings link from the lefthand course navigation.

  3. Click the Apps tab.

  4. Click View App Configurations button.

  5. To open the form and add the SmarterProctoring application, click the + App button.

  6. Under the Configuration Type drop down box, select Paste XML.

  7. Complete the form by entering the name of the link as you want it to appear within the Navigation. The key and secret that were provided by SmarterProctoring will be added to the proper fields. Once that is done, copy the XML provided below and paste it into the XML Configuration box and click Submit.


    Menu Item in Course Navigation
    Use the XML below if you wish to have the SmarterProctoring link in the course navigation by default. This is the process most installs will use.

    <?xml version="1.0" encoding="UTF-8"?>
    <cartridge_basiclti_link xmlns="http://www.imsglobal.org/xsd/imslticc_v1p0"
        xmlns:blti = "http://www.imsglobal.org/xsd/imsbasiclti_v1p0"
        xmlns:lticm ="http://www.imsglobal.org/xsd/imslticm_v1p0"
        xmlns:lticp ="http://www.imsglobal.org/xsd/imslticp_v1p0"
        xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation = "http://www.imsglobal.org/xsd/imslticc_v1p0 http://www.imsglobal.org/xsd/lti/ltiv1p0/imslticc_v1p0.xsd
        http://www.imsglobal.org/xsd/imsbasiclti_v1p0 http://www.imsglobal.org/xsd/lti/ltiv1p0/imsbasiclti_v1p0.xsd
        http://www.imsglobal.org/xsd/imslticm_v1p0 http://www.imsglobal.org/xsd/lti/ltiv1p0/imslticm_v1p0.xsd
        http://www.imsglobal.org/xsd/imslticp_v1p0 http://www.imsglobal.org/xsd/lti/ltiv1p0/imslticp_v1p0.xsd">
        <blti:title>Proctoring</blti:title>
        <blti:description></blti:description>
        <blti:icon></blti:icon>
        <blti:launch_url>https://signon.smarterservices.com/v1/auth/lti</blti:launch_url>
        <blti:extensions platform="canvas.instructure.com">
          <lticm:property name="tool_id">com.smarterproctoring</lticm:property>
          <lticm:property name="privacy_level">public</lticm:property>
          <lticm:options name="course_navigation">
            <lticm:property name="url">https://signon.smarterservices.com/v1/auth/lti</lticm:property>
            <lticm:property name="text">Proctoring</lticm:property>
            <lticm:property name="visibility">public</lticm:property>
            <lticm:property name="default">enabled</lticm:property>
            <lticm:property name="enabled">true</lticm:property>
          </lticm:options>
        </blti:extensions>
        <cartridge_bundle identifierref="BLTI001_Bundle"/>
        <cartridge_icon identifierref="BLTI001_Icon"/>
    </cartridge_basiclti_link>  

    If you wish to change the title/label of the tool as it appears in your navigation, simply modify the text property of the lticm:property element located under course_navigation in the code above. The image below shows where this property is located.



    Menu Item NOT in Course Navigation
    Use the XML below if you do not want to have the SmarterProctoring link in the course navigation by default. This is typically used only for very specific use cases.

    <?xml version="1.0" encoding="UTF-8"?>
    <cartridge_basiclti_link xmlns="http://www.imsglobal.org/xsd/imslticc_v1p0"
        xmlns:blti = "http://www.imsglobal.org/xsd/imsbasiclti_v1p0"
        xmlns:lticm ="http://www.imsglobal.org/xsd/imslticm_v1p0"
        xmlns:lticp ="http://www.imsglobal.org/xsd/imslticp_v1p0"
        xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation = "http://www.imsglobal.org/xsd/imslticc_v1p0 http://www.imsglobal.org/xsd/lti/ltiv1p0/imslticc_v1p0.xsd
        http://www.imsglobal.org/xsd/imsbasiclti_v1p0 http://www.imsglobal.org/xsd/lti/ltiv1p0/imsbasiclti_v1p0.xsd
        http://www.imsglobal.org/xsd/imslticm_v1p0 http://www.imsglobal.org/xsd/lti/ltiv1p0/imslticm_v1p0.xsd
        http://www.imsglobal.org/xsd/imslticp_v1p0 http://www.imsglobal.org/xsd/lti/ltiv1p0/imslticp_v1p0.xsd">
        <blti:title>Proctoring</blti:title>
        <blti:description></blti:description>
        <blti:icon></blti:icon>
        <blti:launch_url>https://signon.smarterservices.com/v1/auth/lti</blti:launch_url>
        <blti:extensions platform="canvas.instructure.com">
          <lticm:property name="tool_id">com.smarterproctoring</lticm:property>
          <lticm:property name="privacy_level">public</lticm:property>
        </blti:extensions>
        <cartridge_bundle identifierref="BLTI001_Bundle"/>
        <cartridge_icon identifierref="BLTI001_Icon"/>
    </cartridge_basiclti_link>  

    If you wish to change the title/label of the tool you will want to properly name the tool on the registration form. No changes need to be made to this XML.

  8. At this point, SmarterProctoring has been registered as an LTI tool and will be shown in the list of tools.

  9. After clicking the Home button or Refreshing the page, the Proctoring link should now be showing in the lefthand navigation.