Configuring the Honorlock Integration
Access the admin menu by selecting the gear icon at the top right of your screen. Next, locate the Honorlock section and select Manage.
Next, to configure Honorlock initially, select Configure Honorlock.
In the resulting slide-in window, enter your API key and API secret, then select confirm.
Your Docebo for Honorlock integration is now connected.
Setting Flag Thresholds
After successfully connecting Honorlock, the first step is configuring your integration’s flag threshold settings. The threshold setting tab on the Honorlock administration screen allows you to set limits for certain flags that, when exceeded, cause the test to be automatically failed or sent for manual proctoring review.
If you would like to enable the automatic failing of a test once any of the thresholds have been met or exceeded, select the Enable automatically invalid test exceeding threshold checkbox. Enabling this will bypass the proctoring setup.
By default, this integration uses all high, medium and low flags. By setting a threshold greater than zero for each group, you activate those flags. Once the threshold has been exceeded, the test is marked for review or failure depending on the test threshold automation setting.
If you wish to limit the types of flags used to count against a test taker to specific flags, instead of using the default proctoring session flag thresholds option in the threshold settings, select the custom selection of flag types radio button. This will allow you to choose all the necessary flags, ignoring the ones you wish to not count toward a negative assessment.
Once you have selected the custom selection of flag types radio button, you can choose your custom flag selection by pressing the Add New Flag Type button.
Next, in the slide-in window, select all the types of events you wish to monitor and, when done, press the confirm button.
Once you have selected the flags for which you wish to monitor, you can set the number of flags for each item needed before the test taker is marked as failed or needing further review.
If you have added a flag by mistake, you can always press the trashcan icon at the right of the flag to delete it.
Customizing Test Messages
After the test has been completed, Honorlock will display a particular message for the proctoring status. The defaults for the messages are:
If you wish to customize the message or messages displayed after the test has been completed, select the checkbox next to the message or messages you wish to customize.
Once you select the checkbox, you can use a WYSIWYG editor to customize each message.
Once you have added custom messages, you will be able to activate the Translate Fields switch, should you wish to also localize the custom message. As soon as you activate the Translate fields switch, a drop-down box will appear giving you a list of languages that you can translate the custom message into. This list of languages will reflect the list of active languages in your platform. Depending on which language you select in this list, you will see the language you are currently editing in noted above the text editor for the customized test completion messages.
Configuring Notification Settings
By default, Docebo for Honorlock does not send additional notifications beyond the error messages visible on the screen in case of an integration issue. If you wish to change this behavior and receive notifications via email at your verified email address, you may add up to five recipients by accessing the Notifications Setting tab.
You can select the Enable Integrations Issue Notifications settings there. You will be presented with a recipients list area where you can either type the email address, press the Add Recipients button at the end of the row, or select the Docebo users to be recipients of the notification via a slide-in window.
Reviewing your API or Resetting Your Integration
If you wish, you can view the API key you are using with the integration or remove it entirely. To do so, access the Authentication tab. Your API key is displayed in a read-only field. The API secret is not visible in the platform for security reasons.
If you wish to remove the Honorlock integration, press the Reset Credentials button. This removes the API key and the API secret from the platform but does not remove other configuration steps performed allowing you to re-authenticate using different credentials without loss of data.
When you press the Reset Credentials button, a modal window will appear asking you to confirm this step. Press the Reset button to confirm the resetting of your credentials; otherwise, press the Cancel button.
Accessing the Integration Logs
To access the logs for the integration, press the logs tab. You will be presented with a list of all the proctoring activities over the course of the previous sixty (60) days. Every event is listed and can be filtered by using the Filters button. You can download events that are completed with Errors by pressing the download button at the end of each event’s row.
Please note:
-
We support only new course player.
-
The Honorlock browser extension for the learner is only available for Google Chrome only. Test takers must use Google Chrome as their web browser.
-
When you enable proctoring on tests, the proctoring will only be activated with new tests. Docebo cannot enable proctoring on the fly. Proctoring will only be valid for tests that have yet to start.
-
There is a known issue that freezes Google Chrome when refreshing a page that contains a test in progress using the Honorlock extension. If the test freezes, you will need to restart the browser.
-
The instructor’s email address can only be present in one Honorlock platform globally. If a user is created in Honorlock during the exam review phase in Docebo and this email address already exists in another Honorlock platform, a generic error will be displayed. In order to unblock the user, the user must be moved from the other Honorlock environment to the one being used with Docebo.
-
The default behaviors traced by Honorlock are set by Honorlock, if you do not see a flag in Honorlock associated with the behaviors configurable in the Docebo for Honorlock integration, contact your Honorlock Customer Success Manager to activate all behaviors. Any behavior configured to be tracked by Docebo for Honorlock but not set in Honorlock itself will not be tracked.