Set up a PrairieLearn exam for use within Honorlock

Create an exam in PrairieLearn however you normally would.

In this example, we've used the infoAssessment.json file to configure a basic exam based on the default sample question available in all PrairieLearn courses.

In the infoAssessment.json file, complete the allowAccess key with the appropriate restrictions. Set the exam mode to Public, specify the credit for the exam, add start & end dates/times, and set a password for the exam. The password will be used later, please remember it.

There are two modes for exams, Public or Exam. The exam mode 'Exam' restricts access to the exam from specific IP ranges and is useful only in a testing center environment.

Students never see the exam password. Do not share the password as otherwise students will be able to access the exam outside of Honorlock.

In PrairieLearn, click on the exam you just created from within your course instance.

On the assessment page, click the red Instructor View button in the navigation bar at the top of the page.

Click on Switch to student view for ExamNameHere to switch to the student view for the exam.

In the student view, copy the URL in your browser's address bar. This is the URL you will use to inform Honorlock of the exam location.

Remember this URL.

Navigate to your course in Canvas & open the Honorlock LTI tool from the left-hand navigation menu.

You may need to add Honorlock to your class if you have not used it previously. To do this, simply go to your course settings, choose the navigation tab, scroll down to Honorlock, click the three dots next to it & click Enable, then save your class.

In the Honorlock app within Canvas, click the three dots in the upper right corner and choose the option for Register Third Party Exam. This is how we will tell Honorlock about the PrairieLearn exam.

Fill in the exam details using the information from the PrairieLearn exam infoAssessment.json file.

The only field that needs to exactly match PrairieLearn is the exam password field. However we suggest you mirror the exam name as well as start & end times for consistency.

In the Exam Platform field, enter UMD PrairieLearn.

In the Exam URL/link field, enter the URL of your PrairieLearn exam. You can get this value by navigating to the exam in PrairieLearn and then switching to student view using the button in the nav bar. The url displayed in your browser's address bar will be the direct link to the exam.

Now configure the proctoring settings for your PrairieLearn exam.

We recommend leaving the default options in proctoring settings and enabling both Browser Guard and Whitelist URLs settings.

Note that if you enable Browser Guard, students will NOT be able to access websites outside of the whitelist you provide in the Whitelist URLs section. Keep this in mind if you are allowing other electronic resources such as student textbooks or websites for use in your exam.

In the Whitelist URLs box, enter prairielearn.umd.edu (omit http/https) and click Add Site.

After you have added the site, it will show up below the text box.

Specify any additional student guidelines in the next section, write in any additional accommodations, and then decide on when your exam will be visible within Honorlock.

After you are satisfied with the configuration, click on the Create button to create the exam within Honorlock.

After you've created the PrairieLearn exam in Honorlock, it will show up in the list of exams within Honorlock and you will see when the exam is available listed below its name.

You can change your exam's settings (for example, to add another whitelisted url) using the settings button.

You can view the results of the exam (incident level, etc.) using the results button.

Finally, you'll need to provide instructions to your students on how to access the exam in Honorlock.

Students can see the exam by opening the Honorlock navigation item in their course.

Note that students will only see the exam in this view during the start & end dates / times you set up in Honorlock.

It's up to you as the instructor to determine how you expose the exam to your students.

We recommend creating an assignment in Canvas that unlocks at the specified times you set in PrairieLearn and Honorlock.

When creating the assignment, under Submission Type specify External Tool & use the Find button to select Honorlock.

When it's time to take the exam, students will open the assignment in Canvas & Canvas will load Honorlock into a window below the assignment description, providing a quick and easy method to launch the exam in Honorlock.