LTI 1.3 Installation Guide

LTI 1.3 Installation Guide

The LTI 1.3/Advantage-Proctoring solution relies on the Ultra Extended Framework which only works on Ultra View courses in a Blackboard Ultra Navigation environment.

That means access to the Admin section is achieved by the left-sided menu item that looks like:

Blackboard menu item for Admin
 

Do NOT proceed on an Original Navigation environment and instead refer to the Building Block (B2) installation then (unless BioSight-ID™ is used).


Known issue: Secondary submission in student preview mode will result in an error. "Oops, something went wrong. Unable to start assessment due to invalid settings received from the proctoring tool.". Anthology is working on identifying the cause of this Blackboard issue to resolve it.  A temporary workaround is exiting student preview mode and select the option to delete all data.

Restricting API access

Creating API role

First we will create an API user with a restricted role:
  1. In the "Users" section, select System Roles
  2. Use the Create Role button
  3. Role name = BioSigAPI
  4. Role ID = BioSigAPI
  5. Click Submit to proceed
This should bring us to the page to manage privileges for this user, but otherwise use the chevron menu to select Privileges on the BioSigAPI user that now exists.

First let us remove ALL standard privileges
  1. At the bottom of the page first click the Show All button
  2. Then click on the [ ] box in the header left of the PERMITTED text to select all entries
  3. Use the Privileges button above it to select Restrict Privileges from the drop-down menu
We will now select the following privileges. Feel free to use the search box to find them easier, but then remember to trigger the Permit Privileges action each time.
  1. Grade Approval and Transfer > Execute
  2. Course/Organization Control Panel (Grade Center) > Full Control
  3. Course/Organization (Content Areas) > Create Materials
  4. Course/Organization (Content Areas) > Edit Materials
  5. Course/Organization Control Panel (Users and Groups) > Users
Click on the PERMITTED header text to sort the column ascending with the yellow arrow pointing upward. Verify that the five primary privileges are approved with the green-checkmarks, and below are all the indirect privileges listed marked via green-hyphens.

Blackboard overview showing all the permitted privileges

Creating API user

Now it is time to create the user that this role will be assigned to.
  1. In the "Users" section, select Users
  2. Use the Create User button
  3. First name = BioSig
  4. Last name = API User
  5. Email = app@biosig-id.com
  6. Username = BioSigAPI
  7. Password = [allow the browser to generate a secure password, or type one in manually]
  8. In the SYSTEM ROLES section select BioSigAPI as available role and use the [>] button to add it as the Primary System Role
  9. Click Submit to proceed

Adding integration

In the Integrations section open the REST API Integrations link, and use the Create Integration button
  1. Application ID (pick the right environment as both cannot be used simultaneously):
    1. Sandbox Testing = 9609dbb2-5419-45be-a90e-a199f76ffab1
    2. Production = 1e351ffc-a897-4088-903b-320fd593958d
  2. Learn User = BioSigAPI
  3. End User Access = Yes
  4. Authorized To Act As User = Yes
  5. Click Submit to proceed
In the Integrations section open the LTI Tool Providers link, and use the Register LTI 1.3/Advantage Tool button
  1. Client ID (match the environment from the REST API integration):
    1. Sandbox Testing = 9609dbb2-5419-45be-a90e-a199f76ffab1
    2. Production = 1e351ffc-a897-4088-903b-320fd593958d
  2. Scroll down to Tool Status and select Approved
  3. Check the box for Role in Course
  4. Check the box for Name
  5. Check the box for Email Address
  6. Allow grade service access = Yes
  7. Allow Membership Service Access = Yes (this will make the View User Acknowledgement Message option disappear)
  8. Click Submit to proceed

Review placements

Feel free to examine all the LTI 1.3 Tool placements by using the chevron menu and select Manage Placements.
  1. The Deep Link entry is for usage in the Ultra View content market to easily add BioSig-ID™ tool-instances and instructions to courses
  2. The BioSight-ID™ Dashboard link is available to instructors as a course tool to view student's activity
  3. Both Proctoring tool entries are the respective proctoring solutions that can be attached to Test Assessments and Assignments
  4. The Ultra Extension is the core Ultra Extended Framework integration required to make everything functional

Finalize installation

To make everything functional an active Biometric Signature ID interface account needs to be created. Provide the full FQDN of your Blackboard instance to your Biometric Signature ID contact representative. An example of this would be biosig-test.blackboard.com which is what we use ourselves for Blackboard Partner Support testing.

If you try to use the BioSig-ID™ integration in Blackboard without this step completed the following error message will show:

BioSig-ID™ interface error that requires contacting BSI support to obtain more details.


Testing the proctoring solution can only be done after installation if you first completely log out of Blackboard and log back in. This is because the proctoring configuration is only loaded once during login, and otherwise the following error message is shown:

Blackboard error message when proctoring fails

That concludes the installation, and BioSig-ID™ with BioSight-ID™ are now available to use.

Original View: BioSight-ID™ Dashboard

Building Blocks have an end-of-life date set, so all new development has been focused on LTI 1.3. This results in the weird situation that the new feature to allow instructors to access the BioSight-ID™ Dashboard in their courses requires the LTI 1.3 installation to arrange placement. However, this also prepares clients to get ready for Ultra View courses, because Original View courses are bound for extinction as well.


    • Related Articles

    • B2 Installation Guide

      Introduction The Biometric Signature ID (BSI) Building Block for Blackboard Learn 9.1 provides a mechanism to require a user/student to validate their identity when needed. This process is split between enrollment for the user to create their initial ...

    • Moodle Installation (LTI)

      Please follow the Moodle LTI instructions on adding BioSig-ID™ as an external tool. The LTI Consumer key, Shared secret, and Tool URL will be provided upon request to existing clients. The privacy settings as shown by the Moodle's instructions need ...

    • Canvas Installation Guide

      Introduction Recently, BioSig-ID created an additional app that reduces the manual processes of creating guarded quizzes and tool instances. This app will allow you to efficiently create guarded quizzes, tool instances and instructions within your ...

    • Schoology Installation

      Follow these steps to set up an LTI External Tool in Schoology at the institution level: Click System Settings on the left menu of your System Admin home page Click Integration (directly below System Settings) in the left navigation Select External ...

    • Moodle Installation (Module)

      Introduction ATTENTION: Moodle 3.10+ requires BioSig-ID™ Moodle module v2020122400 or higher. The BioSig-ID™ Module for Moodle provides a mechanism by which a user may be redirected to BSI's BioSig-ID™ Identity verification system and the ...