Installation

Obtain SmarterProctoring LTI Keys

SmarterProctoring LTI keys can be obtained via the SmarterProctoring administrative area, to login to your account and locate your keys please follow these steps:

1. Navigate to your SmarterProctoring administrative area in your browser. Your SmarterProctoring administrator was provided your account special administrative area URL. If you do not have this information please contact them.
2. Enter your username and password and click Login.
3. Once logged in, click your name in the upper right, then click Integration Settings.
   
4. Find the integration that you need to update, typically there will only be one integration. Then in the Actions menu, select Integration settings. This will drawer open the settings form, you will use the information on this form in step 13 below.

Configure the External Service

External services can be added to individual courses or to all courses in an institution. The scope of your SmarterProctoring implementation will dictate how you create these links. The process for adding the links to course is virtually the same regardless of method. It's much easier if you setup the external service in the site administration first.

1. Click the Site administration menu option.
   
2. Click on the Plugins tab.
   
3. Scroll to the Webservices section and click External services.
   
4. Under the Custom services section, click the Add link.
   
5. Complete this form using the following information:
   1. Name: SmarterProctoring
   2. Enabled: checked
   3. Click Add service
      
6. The "Add functions to the service" page will then appear, click Add functions.
   
7. The following functions will need to be added, once they have been selected click the Add functions button.
   1. core_course_get_contents
   2. core_course_get_courses
   3. core_user_get_users
   4. core_enrol_get_enrolled_users
   5. core_user_get_course_user_profiles
   6. core_webservice_get_site_info
      
8. From the breadcrumb menu, click the Web services link.
   
9. Click the Enable protocols link.
   
10. Ensure that the REST protocol is marked to enabled. If the eye is closed, then click it to open the eye. Next, click Save changes. If the eye is already open, you may skip this step.
    
11. From the breadcrumb menu, click the Web services link.
    
12. Click the Create a specific user link to setup a service user that will be used for the SmarterProctoring integration.
    
13. Complete the user creation form. We suggest entering the following, however the user can be setup however makes the most sense for you organization.
    1. Username: SmarterProctoring
    2. New Password: manually enter a suitable password 
    3. First name, Surname, and Email address: enter whatever is suitable here, maybe the SmarterProctoring product owner in your organization.
    4. Click Create user.
       
14. Navigate back to the Web services area by clicking Site Administration > Plugins > Web services.
15. Click the Create a token for a user link. 
    
16. Complete the token creation form based on the following:
    1. User: Select the service user that was created in step 13.
    2. Service: Select the service that was created in step 5.
    3. Click Save changes.
       
17. Return back to the SmarterProctoring administration tab or browser window from the section above.
18. Copy the Token for the new user and paste it in the Token field within the SmarterProctoring integration settings.
    
19. Click Save.

Configure the External Tool

1. Click the Site administration menu option.
   
2. Click on the Plugins tab.
   
3. Scroll down to the Activity modules section and click Manage tools.
   
4. Click the Configure a tool manually link.
   
5. Complete the External tool configuration form as follows:
   1. Tool name: SmarterProctoring
   2. Tool URL: Launch URL provided on the SmarterProctoring integration settings page.
   3. Tool Description:  Any description can be added here to help describe SmarterProctoring to your students.
   4. Consumer key: Consumer key provided on the SmarterProctoring integration settings page.
   5. Shared secret: Secret provided on the SmarterProctoring integration settings page.
   6. Tool configuration usage: Select the option here that fits your organization the best.
   7. Default launch container: Select the option here that fits your organization the best. We suggest "Embed, without blocks"
   8. Content-Item Message: unchecked
   9. Icon URL: (click show more if needed): http://smarterservices-cdn.s3.amazonaws.com/S%20Icon/web/s_icon_trans_purple_50.png
   10. Secure icon URL: https://smarterservices-cdn.s3.amazonaws.com/S%20Icon/web/s_icon_trans_purple_50.png
   11. Share launcher's name with tool: Always
   12. Share launchers email with tool: Always
   13. Accept grades from the tool: Never
   14. Force SSL: checked
   15. Click Save changes.
6. At this point the tool should be showing as a registered and active tool
   

Adding SmarterProctoring to a Course

Once the External Tool has been created, then it can be added to a course's content. This section will walk-through placing a SmarterProctoring link in a course.

1. Navigate to the course dashboard.
2. Click an Add an activity or resource link.
   
3. Select External Tool, and then click the Add button.
   
4. You will need to complete the form using the following settings:
   
   1. Activity Name: SmarterProctoring
   2. Preconfigured tool: SmarterProctoring
   3. You may also change the Activity Description and check any of the Display checkboxes.
5. Click the Save and display button.
   
6. SmarterProctoring will launch.