Creating an integration requires accessing Blackboard Developer Portal, Blackboard LMS and Oxford English Hub. We suggest keeping these platforms open in separate windows or tabs to easily navigate between them as required.
Add Integration in Developer Portal
Access the Blackboard Developer Portal and create an account: https://developer.blackboard.com
Log in to your account.
Choose Register a REST or LTI application.
If you have previously created integrations, then choose the + symbol and choose Manual Integration in the menu.
Add a name in Application Name.
Add a description in Description.
Add the domain in Domain: lti.englishhub.oup.com
Toggle My Integration supports LTI 1.3 to on.
Add the Login initiation URL:
https://lti.englishhub.oup.com/api/edu/open/ltitool1v3/login/initiate
Add the Tool redirect URI(s):
https://lti.englishhub.oup.com/api/edu/open/ltitool1v3/content/launch
https://lti.englishhub.oup.com/api/edu/open/ltitool1v3/content/selection
Separate the two URLs with a comma and without a space.
Add the Tool JWKS URL:
https://lti.englishhub.oup.com/api/edu/open/ltitool1v3/jwks
Choose Register Application.
In the other browser tab, copy each of the values from Blackboard and add them to the Oxford English Hub Tool panel.
| From Blackboard | To Oxford English Hub |
| Application ID | Client ID |
| Issuer | Issuer / Platform ID |
| Public Keyset URL | Public keyset URL (JWKS) |
| Auth token endpoint | Access token URL |
| OIDC auth request endpoint | Authentication request URL |
Add a name for the tool in Display name.
In Oxford English Hub the tool integration panel should look like the above screen grab.
You will need to access Blackboard LMS to register a tool and create a Deployment ID.
In Blackboard, go to Administrator tools. In the administrator panel choose LTI Tool Providers.
Choose Register LTI 1.3 Advantage Tool.
Enter the Client ID (This is Application ID from the Blackboard panel).
Choose Submit.
The tool information will populate automatically from the developer site.
Check Tool Status to Approved.
Ensure all User Fields to Send boxes are checked.
Choose Submit.
The tool will appear in the list of LTI Tool Providers.
Open the menu next to the tool name and select Manage Deployments.
Copy the Default Deployment ID.
In the Oxford English Hub panel add the Deployment ID.
Choose Add integration.
Choose Done.
The deployment will appear under My Deployments.
In Blackboard Developer choose Done.
The deployment will appear under My Applications.
Create a Node in Blackboard
If you want to deploy additional tools it must be added to a new node in Blackboard.
If you do not need to do this now, skip this step and go to the next section – Add a Placement in Blackboard.
Go to Administrator tools / Communities / institutional Hierarchy.
Choose Create Node.
Add a name for the node.
The identifier will fill automatically.
The description is optional.
Choose Submit.
The node will appear in the list with any others in your institution.
Open the node and choose Add course.
A window will display showing a list of your courses.
Select the course you want to add to the node.
Choose Submit.
The course will appear in your node.
Add a Placement in Blackboard
Adding a placement allows the LTI tool to be available in a Blackboard course.
Go to the Administrator dashboard and choose LTI Tool Providers.
Select the tool and choose Manage Placements.
Choose Create a placement on the next screen.
Add a label in Label.
Add a handle in Handle.
Availability should have Yes selected by default.
Under Type, Deep Linking content tool should be selected by default.
Ensure Allow student access is not selected.
Select Launch in New Window. Oxford English Hub will not open in an iFrame.
Add the URL to Target LINK URI.
https://lti.englishhub.oup.com/api/edu/open/ltitool1v3/content/selection
Choose Submit.
The placement has been created.
You will now be able to access and assign Oxford English Hub content from your Blackboard LMS courses.
Assign yourself as a course builder to Blackboard course
In Blackboard Courses find the course you wish to assign the OUP product to.
Important: When using a ‘Deep Linking Content Tool’ placement type the user must be enrolled in the course for it to function.
Click in the course ID. This will display the course home page.
Under Course management choose Users and groups then Users.
Under Enroll User choose Find users to enroll.
Add your username.
In Role choose Course Builder.
Choose Submit.
You will be enrolled to the course.
Assign a product launch link to a Blackboard course
In the course navigation bar, choose Content.
Under Build Content select the label of your tool placement.
The Oxford English Hub Content Selection Menu will open.
Search for your course by product title or ISBN. Searching with the product ISBN will ensure you find the correct product without confusing it with another.
Select the product you wish to assign to your Blackboard course.
Choose Next.
Check that the materials are correct and choose Add learning materials.
(If you want to make use of deep linking to content and grade-synchronization, please see the separate Help sections for those capabilities.)
Blackboard will display a success message.
Refresh the page of your Blackboard. The LTI launch link will be displayed in your course.
Teachers and students can launch their product using the link.
Important:
Teachers/instructors can only access teacher products.
Students can only access student products.
For a Blackboard Course Builder to access products they must change their user role in their Blackboard course to instructor or student.
If license credits for the product have not been assigned to the Hub organization, the first time a student or teacher launches a product, they will be presented with a field to enter their product access code.
If license credits have been assigned to the Hub organization, then the access code prompt will not appear, and the product will launch.
The student or instructor should enter their product access code and choose Continue.
On first use, some Terms and Conditions may have to be accepted.
The product can then be used.
Assign Oxford English Hub to a Blackboard Course
You can assign a launch link to the Oxford English Hub in your Blackboard course. Students and teachers will be able to launch the Hub to access the Resources area, Gradebook and any Assessment material if available for your course.
On your Blackboard Home page choose Content in the navigation bar.
Choose Build content.
Choose the LTI tool from the menu. This will launch the OUP content selection menu.
Select the Oxford English Hub in the content selection menu.
Choose Next.
Check and choose Add learning materials.
Blackboard will display a message confirming the Oxford English Hub has been added to your course.
Refresh your Blackboard page to see the link.
Click the link to launch the Oxford English Hub.
You will see a confirmation message.
Agree to the Terms and Conditions and select an age option.
Select your marketing preference.
Choose Update my account.
You will see a message confirming your account has been created.
Choose Get Started.
Administrators, students, and teachers will be able to use Oxford English Hub to access any resources and gradebooks for products they are entitled to.
Important:
If a student has not redeemed a licence for a product, they will not see any related course materials in Oxford English Hub.
If a student has already redeemed a pack licence, they will see the pack course materials available within Oxford English Hub.
If a student has redeemed an Online Practice licence, they will be able to access course Resources in Oxford English Hub.
Students and teachers cannot launch Online Practice, e-books, or Class Presentation Tools from Oxford English Hub. They must launch this products using their own launch link from the LMS.
Students and teachers can only access Oxford English Hub from their LMS. They cannot access their account or course material by signing in to Oxford English Hub directly.