Blackboard LTI 1.1 Setup Guide [FOR ADMINISTRATORS]

IN THIS ARTICLE
Install Yellowdig at the Root- or Account-Level
Make Yellowdig Available for Course Placement

To integrate Yellowdig with Blackboard, make sure you have your LMS Key and Secret for your Institutional Organization. Your Institutional Organization is the broadest Organization that belongs to your institution. For example, if you are an Administrator at Yellowdig University, your Institutional Organization might be called "Yellowdig University". To create a Yellowdig assignment in a Blackboard course, see this guide.

Install Yellowdig at the Root- or Account-Level

1. Navigate to System Admin.

2. Under "Integrations", select LTI Tool Providers.

3. Navigate to Register LTI 1.1 Provider.

4. In the "Provider Domain" field, enter api.yellowdig.app.

5. Make sure "Provider Domain Status" is set to Approved.

6. If you wish to distribute keys and secrets to faculty on an ad hoc basis, set the "Default Configuration" to Set separately for each link. Otherwise, select Set globally.

7. If Set globally is selected, enter the key and secret for your Yellowdig organization in the respective "Tool Provider" fields. 

8. Set "Send User Data" to Send user data over any connection.

9. For "User fields to send", make sure each item is selected, as Yellowdig relies on Name and Email Address to authenticate users and Role in Course to set user permissions.

10. In the lower right-hand corner, click the Submit button.

Please click here if you're unable to watch the video below.

Make Yellowdig Available for Course Placement

1. Navigate to the LTI Tool Providers page.

2. Locate the api.yellowdig.app tool in the Tool/Provider list on the page.

3. Click the down caret (▼) icon next to api.yellowdig.app. In the drop-down menu, select Manage Placements.

4. Select Create Placement.

5. For "Label" and "Handle", enter Yellowdig.

6. Set "Availability" to Yes.

7. Under "Type", select Course content tool and check Allows grading.

8. Check "Launch in new window".

9. Set "Tool Provider URL" to https://api.yellowdig.app/launch.

10. If default configuration is set to Set globally, set the "Tool Provider Key" and "Tool Provider Secret" to your Yellowdig organization key and secret, respectively.

11. In the lower right-hand corner, click the Submit button.

Please click here if you're unable to watch the video below.

Audience: This help article is for Yellowdig Organization Administrators. Users without this level of permission will not have access to these settings. Students, learners, and most instructors cannot access these settings.