Integrating Cadmus + Blackboard

Follow these steps to integrate Cadmus as an external tool in Blackboard using LTI 1.3

Cadmus supports the following LTI 1.3 enabled integrations:

1. Launching into Cadmus as a configured external LTI Tool / Application. 

2. Grade pass-back through the LTI 1.3 Assignment and Grade Services.

3. LTI Membership service (Names and Role Provisioning Services) for Student list synchronisation between Cadmus and the LMS.

To integrate Cadmus and Blackboard, you will need to:

1. Register an LTI 1.3/Advantage Tool
2. Update the Institution Policies
3. Approve Cadmus as a Tool Provider
4. Manage the placement of the tool
5. Make the Cadmus tool available
6. Share keys with Cadmus

The Deployment ID generated through this process must be shared with Cadmus to complete the integration.

Stage 1: Register an LTI 1.3/Advantage Tool

Begin by creating a new LTI 1.3/Advantage Tool for Cadmus. This will configure the LTI 1.3 OAuth2 settings, and generate a Client ID for the Cadmus external Tool in your LMS.

1. Log into Blackboard as an administrator.
2. Navigate to the System Admin tab.
3. Under the Integrations section, find the LTI Tool Providers section.
4. Click Register LTI 1.3/Advantage Tool.
   
   
   
   
5. Input the following Client ID:
   
   

   Client ID (Please note this is location-specific)

   AU	cde4adaf-6527-4513-ac25-5bafa6200e88
   UK	7ed7083e-1d1c-48c7-8f1c-62061bf20bf8

6. Click Submit.
7. You will be directed to the Modify LTI 1.3 Tool page where you can find the Deployment ID under the Tool Status section.
8. Record or copy this Deployment ID — you will need to share it with Cadmus.

 

Stage 2: Update the Institution Policies

Cadmus requires access to user information and key services within Blackboard in order to provide functionality.

1. Go to the Institution Policies section and select the following options:
   
   1. Role in course
   2. Name
   3. Email Address
   4. Allow grade service access — Yes
   5. Allow membership service access — Yes
2. Click Submit.
   
   

 

Stage 3: Approve Cadmus as a Tool Provider

Once the LTI 1.3 Tool has been configured, it must be approved before it can be used.

1. In the LTI Tool Providers list, hover over the newly configured Cadmus LTI tool.
2. Click the Arrow icon to open the options menu.
3. Click Approve.

 

Stage 4: Manage the placement of the tool

With the Cadmus LTI tool configured in Blackboard, you can now set up how users find and access the tool.

1. In the LTI Tool Providers list, hover over the newly configured Cadmus LTI tool.
2. Click the Arrow icon to open the options menu.
3. Click Manage Placements.
4. Click Create Placement.
5. Under the Placement Information section, add a Label. This will be the option users see when creating Cadmus assessments.
6. Add the following details:
    
   

   Label

   Cadmus

   Handle

   Cadmus

7. Set the Availability to yes.

8. Under Type, select Course content tool and enable the Allows grading option.

9. Select Launch in a New Window.

10. Upload a copy of the Cadmus icon, which can be saved/downloaded from here.

11. Under the Tool Provider Information section, add the Target Link URI:
    

    Target Link URI (Please note this is location-specific)

    AU	https://api.cadmus.io/accounts/lti1p3/launch
    UK	https://api-uk.cadmus.io/accounts/lti1p3/launch

12. Click Submit.
    
    
    

 

Stage 5: Make the Cadmus tool available

Finally, you will need to ensure that the new Cadmus tool is available for users.

1. Navigate to the System Admin tab.
2. Under the Tools and Utilities section, navigate to Tools.
3. Find the Cadmus tool by searching for the Label or Handle configured in Stage 4.
4. Toggle the Availability to ON.
   
   
   

 

Stage 6: Share keys with Cadmus

To complete the integration process in Blackboard, you will need to share some important details with Cadmus. We will use this information to identify and authenticate your integration.