Guide to setup SensusAccess LTI with Blackboard

1. Register an account with SensusAccess LTI. Register. Once registered with SensusAccess LTI, one can receive an email confirmation mail with an approval link. Once clicked on the link and successful confirmation message, one can log in into the SensusAccess LTI portal. Remember to check spam email, if you do not see the confirmation email in the inbox.

2. Contact Sensus in order to get your LTI access credentials. In order to process your request please make sure to specify in your email/call/letter the following:

   • A mention that you are requesting a SensusAccess LTI account
   • Organization name (School/University)
   • Full name of contact the person responsible for the SensusAccess LTI account
   • The desired email address associated with the SensusAccess LTI account
   • Name of the LMS Type (Blackboard), you are requesting for

3. Go to your SensusAccess LTI account, and if your account is already associated with Blackboard you will see the following page:
   

4. Once you click on the consumer key associated with Blackboard LMS, you will get your details.

   
   Use these in order to link your LMS system to the SensusAccess LTI Tool.

5. Log into your Blackboard Learn instance with an Administrator account.

6. In Admin Panel, go to Integrations section and click on REST APIs Integrations.
7. Click on the link Create Integration and fill the form. To fill the form, you need to have Application ID and you can get it from Step 4 in BlackboardLearn details page. Copy Application Id from above and paste on Application ID field as below and hit the Submit button.

8. In the Admin Panel, go to Integrations section and click on LTI Tool Providers.

9. In LTI Tool Providers page, click on Register Provider Domain. Fill the required fields (*) with the followings:

   • Provider Domain: lti.sensusaccess.com
   • Tool Provider key: Consumer key (step 5 or 6 from the previous page)
   • Tool Consumer key: Shared secret (step 5 or 6 from the previous page)
   • Tool Provider Custom Parameters: This is an optional parameter. To get globalization/localization resources, one can provide culture specific value. For example, to support Danish specific culture, one can give language=da-DK in this field.
   

10. As SensusAccess LTI is using Blackboard Learn REST APIs to communicate with a course, one needs to enable REST API Integrations in Blackboard Learn instance. To enable APIs for SensusAccess LTI, follow the following

11. After registering provider domain, go to the Manage Placements and click on Create Placement link:
    
    Probably you need an Icon for the Tool configurations and if needed save the icon by right clicking and save the image .
    
    Follow below screenshot to fill the form.
    
    Note: Blackboard Learn generates a few cookies during issuing access token in OAuth 2.0 work flow. As Safari browser by default does not allow third party cookies in an iframe. To make the tool runable in Safari browser, there are two workarounds. First method is to check the checkbox Launch in New Window and once this option is checked the tool will be opened in a new windows instead of opening in an iframe in the same page. The another option is, the user has to uncheck the checkbox Prevent Cross-Site Tracking in Safari browser. See the screenshots below:
    
    Safari browser settings in Mac
    
    
    Safari browser settings in iPhone/iPad
    

12. That’s all about the configuration and now one could access the conversion tool inside all the courses.

    • Classic course
    • Ultra course

13. Click on the SensusAccess Tool and for the first time the tool would ask permission and click on Allow and the final landing page will be presented with all the conversion options.

14. Once done you will be able to add the LTI Tool to any course and the SensusAccess form will appear.

    The form will load automatically when clicking on the embedded link inside any course, as in the Demo. It should also be able to list all files within the course and the conversion results will be available either for direct download or sent to the email address of the logged in user.

    If instead of the SensusAccess form you are presented with the SensusAccess LTI home page. Please check again that all the necessary configurations have been done correctly and that you have added the correct Consumer key/shared secret/Application Id etc. inside your SensusAccess LTI account.

Note: If you experience problems with any of the above steps, please contact us via the contact options on sensusaccess.com