The present document has the objective of specifying and describing the series of required steps to configure a Blackboard installation in order
1. BLACKBOARD DEVELOPER
a. Go to https://developer.blackboard.com/
b. Sign-up and log in (or just log in if you already have an account)
c. Go to “My Apps” (https://developer.blackboard.com/portal/applications) if you’re not already there after logging in.
d. Click on the plus icon. This will open a modal box called Register Your Application, which has a form.
e. Fill the form (both fields are required) and click on Save.
f. Once your application is registered, you’ll be given a Application Key and a Secret Key for it. Don’t lose them as Blackboard won’t give them again.
g. Also, you’ll find in https://developer.blackboard.com/portal/applications your Application ID. This id will be needed on the next step.
2. BLACKBOARD LEARN (PART 1: Retrieving LTI Consumer Keys)
a. In order to advance, you must have a Customer Account in NameCoach.
b. Log in into NameCoach with your Customer Account.
c. On the upper right corner, hover on ACCOUNT, and then select LTI Consumer Keys.
d. Click on New LTI Consumer Key. This will open a modal box.
e. On Type, select Blackboard.
f. On API endpoint URL, write the url of your Blackboard Learn installation.
g. Put something descriptive on Name.
h. For API Application ID and API Key, use the values you obtained in the Blackboard Developer configuration.
i. Click on Create.
j. Your new Consumer will appear on screen. Take note of Consumer Key and the Secret Key, as you will need to provide them to the Blackboard Learn installation.
3. BLACKBOARD LEARN (PART 2: Registering Application)
a. Go to your Blackboard Learn installation URL
b. Log in as an Administrator.
c. Click on the System Admin tab (upper right corner).
d. On the Building Blocks section, click on REST API Integrations.
e. Click on Create Integration.
f. Provide the Application ID which Blackboard Developer offered and the Blackboard Learn User (see 1.g). Click on Submit.
g. Go back to System Admin, but this time select Building Blocks from the Building Blocks section.
h. Click on LTI Tool Providers.
i. Click on Register Provider Domain.
j. In Provider Domain, write the host url of the provider application (www.name-coach.com)
k. In Default Configuration, select Set Globally.
l. In Tool Provider Key write the Consumer Key obtained from the provider app (see 2.j.)
m. In Tool Provider Secret write the Secret Key obtained from the provider app (see 2.j.)
n. In Tool Provider Custom Parameters write:
This will allow Blackboard to send its course id when communicating with the provider. In the case of NameCoach, it needs the course id to be able to later on make calls to the Blackboard API. More on available custom variables here: https://community.blackboard.com/docs/DOC-1148.
o. On Send User Data, select Send user data only over SSL (or Send user data over any connection if no vulnerable information is going to be sent).
p. On User Fields to Send check all options.
q. Click on Submit.
4. BLACKBOARD LEARN (PART 3: Adding Placements)
a. Your Provider Domain should know appear in the Provider Domain’s list.
b. Hover over your recently added Provider Domain. A dropdown arrow icon should appear. Click on it and select Manage Placements.
c. Click on Create Placement.
d. On Label, write the the label that will show up in the course when you’re selecting what tool to add (for example, Name Coach Roster).
e. On Handle write something that uniquely identifies the placement.
f. On Tool Provider URL, write the full url path of the provider’s tool. These URLs can be found in your customer account under 'Account -> Settings -> LTI Consumer Keys'
g. Click on Submit.
h. Repeat process if needed.
5. BLACKBOARD LEARN (PART 4: Adding Tool Link to courses)
a. Go to any Blackboard course that has been created (create one if needed).
b. On the left sidebar, click on the plus sign and then click on Tool Link. For schools using the new Blackboard view, it's necessary to click on the Course name on the left sidebar for the plus sign to appear.
c. This will open a form. Type the name of the tool on Name. This will be what the users will see in the sidebar menu.
d. On Type, select the Label you specified for your tool link (see 4.d.).
e. Check Available to Users.
f. Click on Submit. This will add the tool link to the bottom of left sidebar menu.
g. Repeat process for any additional tool links.
Below is a short screencast showing the NameCoach LTI tools in Blackboard: