How to setup Single Sign-On with D2L|Brightspace

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

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".

Step 2. Register an OAuth 2.0 Application

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

Step 3.  Fill Out the Form

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

Step 4.  Outcome

Your result will be similar to the results seen below. 

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”.

Step 2. Create a New Learning Tool Link

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

Step 3.  Fill in the Link Form

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

Step 4.  Get the Tenant ID 

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

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.

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 your organization from the list. 

Step 2. Open up Your Organization | Product | D2L Settings

• Select the "PRODUCTS" tab
• Select a Membership under the Product Settings section
• Select the "SETTINGS" tab under that product
• Select the "D2L | SSO" section to open it

Step 3. Setup the D2L App 

Paste in your Tenant ID, Client ID, Client Secret and your school board's Brightspace URL. When you are finished, click the "Save" 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.

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.

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.

Step 2a. Add a resource

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

Step 2b. 

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

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.

Step 4.

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

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.

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. 

Part 5. Creating a "Class Toolkit" dropdown 

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.

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.

Step 5. 

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

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