1. Help Desk
  2. IT and Technical Requirements

How to setup Single Sign-On with D2L|Brightspace

Learn how to setup single-on with D2L Brightspace for the students at your school.

NOTE:  We recommend that you ask your IT team to help you set this up.

Click here to learn how you can use Edge Factor in your D2L courses.

Outline:

1. Create an OAuth2 Application

2. Create an External Link

3. Enable the D2L Brightspace App in Edge Factor

4. How Educators Can Add SSO to a Class/Course

5. Creating a "Class Toolkit" dropdown 

Part 1. Creating an OAuth2 application

Step 1. Open Extensions

Begin by logging into Brightspace. Then click the gear icon in the top right hand corner. From the drop-down list, click "Manage Extensibility".

1-Main-Screen

Step 2. Register an OAuth 2.0 Application

Click on the OAuth 2.0 tab. Then click the "Register an app" button. 

Screen-Shot-2020-08-19-at-11.49.53-AM

Step 3.  Fill Out the Form

Input the following information. Then click the "Register" button.

Application Name: Edge Factor
Redirect URL: https://edgefactor.com/rostering/d2l_lti.aspx
Scope: content:*:* core:*:* enrollment:*:* globalusermapping:*:* grades:*:* role:*:* user:*:*
Access Token Lifetime: 72000
Description: Edge Factor OAuth2 Connection

Screen Shot 2020-08-20 at 9.26.53 AM

Step 4.  Outcome

Your result will be similar to the results seen below. 

Screen-Shot-2020-08-20-at-8.48.03-AMM

You will need to use the Client ID and Client Secret to setup the Brightspace app within Edge Factor. You may want to keep this page open in another tab so that you can easily copy and paste them when you complete Part 3.

 

Part 2. Creating an External Link

Step 1. Load Your External Learning Tools

While you are still logged into Brightspace, click the gear icon in the top right hand corner. From the drop-down click on “External Learning Tools”.

1-Main-Screen-1

Step 2. Create a New Learning Tool Link

Click the "Manage External Learning Tool Links" tab. Then click the "New Link" button.

Screen Shot 2020-08-20 at 9.59.15 AM

Step 3.  Fill in the Link Form

Input the following information. Then click the "Save and Close" button.

Title:

Edge Factor Login

URL:

https://edgefactor.com/rostering/d2l_access.aspx

Description:

Log in to Edge Factor
Visibility: Check “Allow users to view this link”
Key/Secret:

Check “Sign messages with key/secret with”
Check “Tool consumer key/secret”

Key:

Leave blank

Secret:

Leave blank

Custom Parameters:

Leave blank

Security Settings:

Check “Use link security settings”
Check all boxes under this header.

NOTE: If your district uses the Org Defined ID field to store a users Ministry Education Number or OEN please uncheck "Org Defined ID".

Make link available to:

Check “Current Org Unit: <your org name>”

Click “Add Org Units”:

Select all of the departments at your district or school (i.e. Arts, Technology, etc.). Be sure to select the “All descendants” option. This will allow all classes in those departments access to the Edge Factor platform. 
(Note, If you click the "show search options" you can filter to show only departments.)

Screen Shot 2020-08-05 at 12.21.00 PM copy

Screen Shot 2020-08-05 at 12.21.15 PM

Step 4.  Get the Tenant ID 

Click the down arrow next to your new link, and click the option labeled “View Link Request”

Screen-Shot-2020-08-19-at-11.31.01-AM-1-1

Step 5.  Outcome

You should see a page like this. Scroll down until you find name=”ext_d2l_tenantid”. You will need this information for the next step.

You may want to keep this page open in another tab so that you can easily copy and paste the Tenant ID when you complete Part 3.


Part 3.
Enabling the Brightspace App in Edge Factor

Step 1. Go to My Account

Login to the Edge Factor platform. Then click the gear icon in the top right hand corner and select "My Account". 

NOTE: If you're part of an IT team setting this up and do not have login credentials please email support@edgefactor.com.

Pull Up My Account

Step 2. Open up Your Rostering Apps 

Select "Rostering" from the list. Then click the "Manage Rostering Apps" button.

Screen Shot 2021-02-01 at 1.42.55 PM

Step 3. Choose the Brightspace App 

When the window opens click on the "D2L | Brightspace" application. 

Screen Shot 2021-02-01 at 1.46.56 PM

Step 3. Setup the Brightspace App 

Begin by clicking the "Activate" button. Then paste in your Tenant ID, Client ID, Client Secret and your school board's Brightspace URL. When you are finished, click the "Save Settings" button and close the window.

The "Client ID" and the "Client Secret" was generated in Step 4 of Part 1. 
The "Tenant ID" was generated in Step 5 of Part 2.

When adding the base URL please exclude the https:// and any additional slashes (/). Your base URL will probably be similar to this:  yourorganization.elearningontario.ca 

Layer 1Group-11

Step 4. Testing 

Head back into Brightspace and pull up your list of "External Learning Tools".  Click on the "dropdown" icon and select "Preview Link". This will log you into the Edge Factor platform.

Note: If you are a board admin with access to all of the D2L shells/courses it may take a few minutes to load all of your information and sign you into Edge Factor. You may have to reload the page a few times. The next time you login to the platform it will sign you in with a few seconds. 


Preview-Link

Part 4. How Educators Can Add SSO to a Class/Course 

Step 1. Begin by opening up a course

Have the educator log into Brightspace and pull up the class where they want to use the Edge Factor resources. At this point they can choose from an existing unit or create a new one.1-1

Step 2a. Add a resource

Once you've opened up the course click the blue "Add Existing" button. 

2-3

Step 2b. 

When you are asked what you want to add to the course, choose "external tool activity".

3-1-1

Step 2c.

Choose "Edge Factor" from the list of learning tools. 

Step 3.

Finally, make the resource visible to students by using the toggle in the top.

5-png-1

Step 4.

Click on the 3 dots in the top right hand corner and select Edit. Step6

Then select "Open in a new tab" and click "Save".  When you click the "Open Link" button it will open a new tab and sign you into the Edge Factor platform.Step1UsageEdited-1

Step 5.

The first time that teachers and students click on Edge Factor it will ask them to verify that they want to sign into Edge Factor using their D2L account. 

Confirm-Login

Note: If you are a board admin with access to all of the D2L shells/courses it may take a few minutes to load all of your information and sign you into Edge Factor. You may have to reload the page a few times. The next time you login to the platform it will sign you in with a few seconds. 


Par
t 5.
Creating a "Class Toolkit" dropdown 

This process is similar to adding an external learning tool to a unit in a course but cuts out some steps for teachers to use it with their class. Since it's a "Quicklink" it'll update the link to reflect whichever course you're in. 

Step 1. 

Click on the settings gear and select "Navigation and Themes".

Step 2. 

Then click on the "Custom Links" tab and filter the results by "Groups". Find the group that you want to add the link too. In this case it is the "Class Toolkit" that we have made available to almost every course.

image-Oct-01-2020-01-34-24-49-PM

Step 3. 

You'll want to "edit" this Link Group. At the bottom of the edit page there's an option to "Create Link".  

Step 4. 

On the "Create Link " page give the link a name, ex. Edge Factor. Then click the "Insert Quicklink" button and select "External Learning Tools". Select the Edge Factor External Learning Tool and then click "Create".

Optional: Click here to download an icon that you can use for the Edge Factor app.

unnamed (1)-Oct-01-2020-01-47-04-37-PM

Step 5. 

You will now see Edge Factor show up in your "Class Toolkit" dropdown! 

NOTE: If you have different navigation bars setup for students and teachers you will want to make sure you add Edge Factor to both. This will ensure that both students and teachers can easily login to Edge Factor.


unnamed (2)-2

Click here to learn how your teachers can use the Brightspace integration in their courses.

Please let us know if you have any suggestions on how to improve this article!