Introduction
Brightspace courses can be manually configured to rely on BioSig-ID™ tool-instances or quiz-intercepts in adding student identification.
The BioSig-ID™ Admin App for Brightspace adds an even easier method via REST-API calls to automate the manual steps.
Please follow all of the steps below to begin using BioSig-ID™ in your courses.
Step 1: Registering BioSig-ID™ Application
1. Click on the gear icon and go to Manage Extensibility.
Where to find Manage Extensibility 2. Click Register an App .
Locate Register an App 3. Complete the following fields:
Field
| Value
|
Application Name
| BioSig-ID™
|
Trusted URL
| Pick only one.
|
Enable this application | Check-mark
|
Register Application | Check-mark
|
I accept the Non-Commercial Developer Agreement | Read the Non-Commerical Developer Agreement and check-mark the box.
|
Register an Application - fields to be completed.
4. D2L will generate
the App ID\Key pair.
Provide both the Application ID and the Application Key to a member of the BSI team.
This is needed to generate the key and secret used in Step 2.
Record the application ID and Key. Step 2: Add the Remote Plugin - Guarded Quiz
1. Click on the Admin Gears and select Remote Plugins.
Find Remote Plugin 2. Click New Remote Plugin to create a new plugin.
Create New Remote Plugin 3. Enter the following information:
Field
| Value
|
Plugin Type
| Quicklink (CIM)
|
Name
| BioSig-ID™ Guarded Quiz
|
Launch URL
| Pick only one.
|
LTI Key/Secret
| (Reach out to BSI for this information.)
|
"OAuth Signature Method" | set to HMAC-SHA1. Ignore if not shown.
|
Small and Large Icon URL
| |
Add Org Units | Make it available to the course. |
Create Plugin fields 5. Click Save when complete.
Step 3: Add the Guarded Quiz Template
1. Open External Learning Tools from the Admin menu.
Locate External Tools 2. Click on Manage Tool Links (Legacy) and choose New Deployment.
Manage Tool Links (Legacy) location 3. Enter the following fields:
Field
| Value
|
Title
| BioSig-ID Guarded Quiz Template
|
URL
| Pick only one.
|
Description | Please validate your BioSig-ID™ profile to make the next item(s) available |
link/secret | Activate
|
LTI Key and Secret | Input the key and secret provided by BSI.
|
Use link security settings | Activate, and enable all checkboxes below.
|
Add Org Units | Make it available to the course. |
Update the followings fields.
5. Finally save the changes, and look in the address bar for the Link ID that is now available (Example 16). Write this down now.
Example Link ID
Step 4: Edit the Guarded Quiz Launch
1.Return to Remote Plugins.
Remote Plugins location.
2. Edit the BioSig-ID™ Guarded Quiz launch entry by clicking the drop-down arrow.
Edit the Guarded Quiz launch.
3. Click the + Add custom parameters link.
Click Add custom parameters. 4. This will create a custom parameter row that needs to be filled in as follows:
#
| Name
| Value
|
1
| custom_biosig_link_id
| (Link ID from
Step 3, our example is 16. Your value will differ.)
|
Adding custom parameters. Step 5: Add the BioSig-ID™ Admin App
1. Open External Learning Tools from the Admin menu.
External Learning Tools location.
2. Go to the Manage Tool Links (Legacy) tab and click New Link.
Manage Tool Links (Legacy) tab with New Link button. 3. Enter the following fields, and click the Save button to continue. Do not click "Save and Close".
Field
| Value
|
Title
| BioSig-ID™ Admin App
|
URL
| Pick only one.
|
Description | (leave blank) |
"Key/Secret" | Select, and Input the LTI key/secret provided by BSI |
Fields to complete for BioSig-ID Admin App. 4. Scroll down to the + Add custom parameters section.
Change the value to 2 and click the the words Add custom parameters.
Add custom parameters for 2 fields.
5. Fill in the custom parameter rows as follows:
#
| Name
| Value
|
1
| custom_biosig_link_id
| (Link ID from
Step 3, our example is 16. Your value will differ.) |
2
| custom_biosig_admin
| true
|
Adding the custom parameters.
6. Activate Use link security settings and check all boxes.
Add Org Units to make it available in the course
Click Save and Close.
Activate all Security Settings.
Step 6: Add BioSig-ID™ to Navigation
To add BioSig-ID to the navigation bar at the Admin level, it is strongly advised to copy your existing default theme and add the custom link in there. This will
allow you to easily switch between navigation themes to allow for the
BioSig-ID Admin link to show in just those courses using BioSig-ID or
all courses at your institution. Quiz-Intercepts only work within the course content section of Brightspace, so any navigational menus that provide end-users with direct access need to be removed. If this is not desired then only rely on the tool-instances which force the adaptive release conditions throughout any section. This then ends up hiding those course items until the conditions have been met, which might lead to other confusion. Contact your BioSig-ID™ representative to review the options available as almost everything is configurable.
If you want the BioSig-ID Admin tool to show in ALL courses change
the navigation theme to the default that includes the custom link.
If you want the BioSig-ID Admin tool to show in ONLY those courses
that use BioSig-ID, you will want to change the navigation theme at the
course level for each course.
1. From within the course click the Course Admin menu and open Navigation & Themes, or use the three little dots at the end of your navigation bar to Manage All Course Navbars.
You will need to hover over the end of the menu bar to activate the three dots.
Course Admin bar three dots location. Manage All Course Navbars.
2. Switch to the Custom Links tab, and click Create Link.
Switch to the Custom Links tab and click Create Link. Enter the following fields and Finally click Save.
Field
| Value
|
Name
| BioSig-ID Admin |
Insert Quicklink | Click the button Insert Quicklink, expand External Learning Tools, then choose BioSig-ID Admin App from the list |
Behavior | Adjust the behavior according to your preference with Same window as our recommendation (the "New window/tab" option resolves any potential issues with the Safari browser for Apple users). |
Limit to specific roles | Our recomendation is to select Super Administrator, Administrator, Designer, Instuctor and any roles your institution deems necessary. |
Edit Custom Link fields to modify.
3. Switch back to the Navbars tab.
Next to the active theme (by default "Brightspace Course Navigation"), click on the chevron and Copy the theme.
Switch to the Navbars tab and Copy your theme.
4. Open the copied theme by clicking the blue link Edit the following fields. Then click Save and Close.
Field
| Value
|
Name
| Edit the name to replace the word "Copy" with "BioSig-ID". Leave everything else the same.
|
Add Links
| Click the Add Links button and select BioSig-ID Admin app. Then click add.
|
Optionally, drag-and-drop the BioSig-ID Admin item to a preferred location, otherwise it will be listed under "More".
Edit Navbar fields to update. 8. Adjust the active Navbar to the new BioSig-ID one, and click Apply.
Changing the Active Navbar. 9.The BioSig-ID admin will now be available on your Navbar.
If you don't see the BioSig-ID Admin option go to the More option and click the drop down arrow.
The Safari browser now has the default setting active to prevent
cross-site tracking under the "Privacy" preference section. This blocks
not only malicious advertisement sites from tracking you, but it also
blocks server-session cookies. The BioSig-ID™ Admin App needs those to
function, so the option is to disable cross-site tracking or to adjust
the navigation bar item to launch in a new window/tab.
Change
the drop-down menu option under `Behavior` to "New window/tab", and
deselect both checkboxes below it. Once the activity in the BioSig-ID™
Admin App are concluded the window can simply be closed and refreshing
the 'Content' in Brightspace should reveal all the changes that have
been applied.