GeniusIntegrationSetup May2016

Genius
B2 & Integration with Learn

Overview ............................................................................................................................................................................. 1
Dependencies necessary to setup the Integration ............................................................................................... 2
Steps to Integrate Genius .............................................................................................................................................. 2
Step 1 – Setup New Role for Genius in Learn .......................................................................................................................... 2
Step 2 -‐ Install the Genius-‐SSO B2 ........................................................................................................................................... 4
Step 3 -‐ Create a Link Tab and top Frame tab in Learn to Access Genius ............................................................................... 7
Step 4 – Activate Web Services in Learn ............................................................................................................................... 10
Step 5 -‐ Register Genius as a Proxy Tool with Learn ............................................................................................................. 12
Step 6 – Install the AutoSignon B2 ........................................................................................................................................ 20
Appendix (Optional) ..................................................................................................................................................... 28

Setup a different IV/Key* for the Genius SSO ....................................................................................................................... 28
Revision History
Version Author Date Changes
1.0 Jace Howard 03/38/2016 Initial Completed Draft
1.1 Jace Howard 03/31/2016 Additional Screenshots and Text changes
1.2 Sinora Dabney
1.3 Jace Howard Step 6 Overhaul to cover configuring Autosignon

Added links to the B2s under Dependencies
1.4 Jace Howard 04/25/2016 Added “bbsupport” to setup flow
1.5 Jace Howard 05/17/2016 Updated Screenshots for Custom SSO URL flow

Overview
Blackboard has partnered with Genius SIS to offer a full-‐service Registration Module. It’s integrated with Bb Learn via
SOAP Web Services and a building block to support organizations with registration, reporting, enrollment management,
ecommerce and end-‐to-‐end training management needs. Each client is able to customize their experience. Blackboard
product name for this full service integrated solution was changed in April 2016 to Blackboard Registration &
Management.
Genius Registration Module encompasses the following primary areas:
• Registration -‐ self and manual registration

• Enrollment Management
• Reporting in the form of dashboard and reports
• Transcripting
• E-‐commerce
1 | P a g e

Genius B2 & Integration with Learn

Dependencies necessary to setup the Integration
• A licensed version of Learn that includes the Blackboard Registration & Management bundle (SaaS in Progress)
• Admin Access to Learn
• Confirmation of a sandbox instance of Genius SIS setup for the client with Admin Access
• Use of the Administrator Username in Learn and Genius to setup the SSO
• Genius SSO Building Block (ICM -‐ Blackboard Consulting)
• AutoSignOn Building Block (OSCELOT v2.0.1)
Steps to Integrate Genius

• Step 1 – Create a @Genius Institution Role / Constituency and assign to the Administrator and Bbsupport
• Step 2 – Install the Genius-‐SSO B2
• Step 3 – Create a Tab in Learn for accessing Genius
• Step 4 – Activate Web Services in Learn
• Step 5 – Register Genius as a Proxy Tool with Learn
• Step 6 – Install the AutoSignon B2 that allows an Admin to SSO from Genius to Learn
• Appendix (Optional): Update the IV/Key in Learn & Genius
• Optional: Create additional Tabs for Registration of Courses (To Do)

Step 1 – Setup New Role for Genius in Learn

As of March 30, 2016, ALL New Genius installs will include a matching Administrator and Bbsupport credential. In doing,
so this allows a Blackboard employee with Admin rights to setup the SSO with a new Genius instance without needing the
Genius password information to match. However, as not everyone on the client side will need to have access to the
Genius Dashboard initially, the recommendation is to first setup an Institution Role or Constituency in Learn and assign it
the Administrator only.
As a Learn System Admin, click “Constituencies” (or Institutional Roles) from Users Tab
Add a new Role and Role ID for @Genius and click “Submit”
2 | P a g e


As a Learn System Admin, click “Users” from the Users Tab
Edit User “Administrator” and “Bbsupport” and Add @Genius to Selected Roles as shown below and click “Submit”
3 | P a g e


Step 2 -‐‑ Install the Genius-‐‑SSO B2

Here are the instructions to setup a single sign-‐on back to Genius, so a Bb Admin can access via a matching SSO account
of “Administrator” in Genius.
As a Learn System Admin, click “Building Blocks” from the Building Blocks Tab
4 | P a g e


Click “Installed Tools”
Verify the ICM-‐Blackboard Consulting version of the Genius SSO Building Block is installed
Once installed, Edit the Genius B2 settings
5 | P a g e


A “blank” settings page looks as follows:
Update the Settings as follows and click “Submit”
1. Target: URL of Genius instance for Client + bbsso.aspx (Ex: https://company.geniussis.com/bbsso.aspx)
2. Encryption Key*: 12345678901234567890123456789012
3. Encryption Vector*: 12345678
4. SSO URL: /webapps/bbgs-‐Genius-‐SSO-‐BBLEARN/ssoforward
5. Log Verbosity: leave default of “Info”
6 | P a g e


Note: See Appendix for an option to update the IV/Key from the default values once the initial SSO between
Blackboard and Genius is Setup and working
Step 3 -‐‑ Create a Link Tab and top Frame tab in Learn to Access Genius
Create a Tab Link for accessing Genius and the Dashboard that does a single sign-‐on back to Genius, so a Bb Admin can
access via a matching SSO account in Genius

A. Creating a Link Tab
In Backboard Learn, access > Tabs and Modules > Tabs and Create a New Link Tab

Enter the following for the Tab properties:

1. Title: Genius Dashboard
2. Reference Name: Genius Dashboard
3. Web Link: Enter the “SSO URL” from the Genius-‐SSO B2 Settings (as shown in image below). Thus, you would
enter for this setup example: /webapps/bbgs-‐Genius-‐SSO-‐BBLEARN/ssoforward
7 | P a g e


The completed link tab properties page will look as follows:

B. Next, create a top frame Tab.

8 | P a g e


Enter the following and click “Submit”

Under Properties:
• Title: Dashboard
• Reference Name: Dashboard

Under Availability:
• System Availability: Yes
• Available to Constituencies (or Institutional Roles):
• Be sure to select the radio button for Selected “Constituencies” (or Institutional Roles). If not the tab will be visible
to all users.
• Add “@Genius” to the list of Selected Items

Under Membership
• Add “Genius Dashboard” to Selected Items

A completed Top Frame Tab page would look as follows:

With the Tab in Place, the Learn Administrator and Bbsupport should see the below when logged into Learn

9 | P a g e


With the Tab in place, the Learn Administrator and Bbsupport will be able to access Genius now when they click the
“Dashboard” Tab

Step 4 – Activate Web Services in Learn

For user, enrollment and grade data between the two systems, you need to make the Web Services for Context, Course,
Coursemembership, Gradebook, and User Available and Discoverable. The easiest way to accomplish this is to make ALL
Web Services Available and Discoverable. Genius needs the Blackboard Web Services in order to work as it connects to
Blackboard via the SOAP Web Services.
As a Learn System Admin, click “Web Services” from the Building Blocks Tab

10 | P a g e


Select All Web Services and choose “Make Available” from the dropdown menu
You will see a notice that the changes were Successful at the top left-‐hand side of the screen. Next, select All Web
Services and choose “Make Discoverable” from the dropdown menu
Verify the changes are saved and that All Web Services show YES now under the first two columns:
11 | P a g e


Step 5 -‐‑ Register Genius as a Proxy Tool with Learn
For Genius to communicate with Blackboard Web Services, it needs to register as a Proxy Tool.
In Backboard Learn, access Building Blocks > Proxy Tools
Click “Manage Global Properties”
12 | P a g e


Enter a Tool Registration Password* of your choosing (Ex: 61A33785), remove the flag for Allow Unknown Proxy Tools
and click “Submit”
Important: This password entered here must be the same as the registration password you enter in Genius
* You can run “uuidgen” from a Command prompt to generate a random Globally unique identifier (GUID), and use the
FIRST 8 Characters from the GUID for the password.
Next, Access Genius from the Dashboard Tab in Learn

13 | P a g e


Access the Administration Tab in Genius
Click “LMS” from the Left-‐hand Menu under System Setup
Click “Add new LMS”

14 | P a g e


Select the LMS Type as “Blackboard”
You will see the following Fields presented to you:
1. LMS Type – Genius allows for clients to connect to different systems
2. LMS Name – Add a reference name for the LMS Entry
3. Encryption Key – Must Match the Key entered in the Genius-‐SSO B2 Settings in Learn
4. Encryption IV -‐ Must Match the Key entered in the Genius-‐SSO B2 Settings in Learn
5. Status – Active or Archived
6. Blackboard Base URL -‐ The https:// URL of your Learn instance
7. Login as Tool -‐ This must always be checked for Learn and Genius to talk to each other via the SOAP Web
Services
8. Username – n/a
9. Password – This is the Proxy Tool Registration password used to register Genius as a Proxy Tool in Learn
10. Estimated Connection Time = Typically = 30 (seconds)
11. Hours adjustment offset – Typically = 0
12. Minutes adjustment offset -‐ Typically = 0
13. SSO shared secret – This is used only with the AutoSignon settings in Step 6 and is entered there
14. Blackboard Instance – This is a legacy setting. Should be “New Blackboard Learn 9.1 Environment” unless advised
otherwise
15. Custom SSO URL – See Step 6 on setting this up as part of configuring the Autosignon settings

15 | P a g e


Note: There are two ways to authenticate: “Login as Tool” or use username/password (create an admin account the
client would log into). In general, “Login as Tool” is the right pattern for the most control, security wise, between the two
systems.

A completed form would look as follows:

16 | P a g e


Click Save and Enter the “Tool Registration Password” you entered in Learn that matches the ‘Single Sign-‐On Shared
Secret” field from the LMS Setup in Genius
Click “Register” and you will see that the Tool was registered successfully

Login to Learn and Approve the Registration at Building Blocks > Proxy Tools
17 | P a g e


Edit the “Genius SIS” tool
Make the Proxy Tool Available and click “Submit”
18 | P a g e


Notice the same Shared Password listed in the Genius SIS Proxy Tool Settings in Learn matches the Blackboard Password
entered in Genius as identified below:
A successful execution of this flow is shown below
19 | P a g e


You’ve now enabled Genius to talk to Blackboard through Web Services. Genius can now create user, courses, and pull
the Grade data from Blackboard -‐ all done through the web services
Step 6 – Install the AutoSignon B2

In order for a client to single sign on from Genius to back to Blackboard Learn, v2.0.1 of the OSCELOT AutoSignon B2 must
be installed and configured.
In Backboard Learn, access Building Blocks > Building Blocks

Verify v2.0.1 of the AutoSignOn Building Block from OSCELOT is installed

Once installed, as a Learn System Admin, click “Authentication” from the Building Blocks Tab
20 | P a g e


Click “Create Provider” and select “Autosignon from the drop-‐down menu
Create the “Autosignon Provider Properties” by verifying that the the form is filled out as follows:
1. Name: Genius Autosignon

2. Description: (Optional)
3. Authentication Provider Availability = Active
4. User Lookup Method = Username
5. Link Text: Genius SSO
Click “Save and Configure”
21 | P a g e


22 | P a g e


Create the “Autosignon Settings” by verifying that MAC Algorithm: MD5 Legacy Compatibility is selected and Timestamp
Delta = 60000 under Security Settings
Enter the same Shared Secret password in the AutoSignon settings that was entered as part of the LMS Setup in Genius
as shown below:

Verify the Building Block is “Enabled,” that the rest of the form is filled out as follows, and click “Submit”

23 | P a g e


24 | P a g e


A successful execution of this flow is shown below

Log into Genius and update the Custom SSO URL in the LMS Setup in Genius by copying the AutoSignon URL into the
Custom SSO URL text field in Genius, as shown below:

25 | P a g e


You can now verify it is working by clicking the “MyGenius” Tab

Click “Go to LMS” and select the one listed in the Menu by clicking the “Monitor” icon

26 | P a g e


Once clicked, this will auto log you into Blackboard Learn in a separate browser tab. (Note: you must have a matching
username in Blackboard Learn for this to work).

27 | P a g e


Appendix (Optional)

Setup a different IV/Key* for the Genius SSO

First make the change in Genius, by updating the Key and IV, and Hit Save (as shown below):
*To generate a random set of characters for the two entries, you can run “uuidgen” from a Command prompt. This will
generate two random GUIDs. Remove the dashes and use ALL 32 characters from the first GUID for the Encryption Key
and use the FIRST 8 Characters from the second GUID for the Encryption Vector as follows:
Now the same change must be made in Learn
As a Learn System Admin, click “Building Blocks” from the Building Blocks Tab
28 | P a g e


Click “Installed Tools”
Edit the Genius B2 settings
29 | P a g e


To change the Default Key/IV, Update the Settings as follows and click “Submit”
1. Target: URL of Genius instance for Client + bbsso.aspx (Ex: https://company.geniussis.com/bbsso.aspx)
2. Encryption Key*: 24 or 32 characters (Ex: 38AD0CFA379F4FE88332CD8B5C25AE39)
3. Encryption Vector*: 8 characters (Ex: F0AC724B)
4. Log Verbosity: leave default of “Info”
*To generate a random set of characters for the two entries, you can run “uuidgen” from a Command prompt. This will
generate two random GUIDs. Remove the dashes and use ALL 32 characters from the first GUID for the Encryption Key
and use the FIRST 8 Characters from the second GUID for the Encryption Vector as follows:
30 | P a g e

GeniusIntegrationSetup May2016

Hochgeladen von

Dokumentinformationen

Originaltitel

Copyright

Verfügbare Formate

Dieses Dokument teilen

Dokument teilen oder einbetten

Freigabeoptionen

Stufen Sie dieses Dokument als nützlich ein?

Sind diese Inhalte unangemessen?

Copyright:

Verfügbare Formate

GeniusIntegrationSetup May2016

Hochgeladen von

Copyright:

Verfügbare Formate

Genius

B2 & Integration with Learn

Appendix (Optional) ..................................................................................................................................................... 28

1.0 Jace Howard 03/38/2016 Initial Completed Draft

1.1 Jace Howard 03/31/2016 Additional Screenshots and Text changes

1.2 Sinora Dabney

1.3 Jace Howard Step 6 Overhaul to cover configuring Autosignon

Genius Registration Module encompasses the following primary areas:

• Registration -­‐ self and manual registration

Steps to Integrate Genius

Step 1 – Setup New Role for Genius in Learn

As a Learn System Admin, click “Users” from the Users Tab

Step 2 -­‐‑ Install the Genius-­‐‑SSO B2

Click “Installed Tools”

Once installed, Edit the Genius B2 settings

A “blank” settings page looks as follows:

Update the Settings as follows and click “Submit”

Step 4 – Activate Web Services in Learn

In Backboard Learn, access Building Blocks > Proxy Tools

Click “Manage Global Properties”

Next, Access Genius from the Dashboard Tab in Learn

Click “LMS” from the Left-­‐hand Menu under System Setup

Click “Add new LMS”

Select the LMS Type as “Blackboard”

You will see the following Fields presented to you:

Edit the “Genius SIS” tool

Make the Proxy Tool Available and click “Submit”

A successful execution of this flow is shown below

Step 6 – Install the AutoSignon B2

In Backboard Learn, access Building Blocks > Building Blocks

1. Name: Genius Autosignon

Click “Save and Configure”

Setup a different IV/Key* for the Genius SSO

Now the same change must be made in Learn

Click “Installed Tools”

Edit the Genius B2 settings

Das könnte Ihnen auch gefallen

• Registration -‐ self and manual registration

Step 2 -‐‑ Install the Genius-‐‑SSO B2

Click “LMS” from the Left-‐hand Menu under System Setup