Guide to setup SensusAccess LTI with Desire2Learn

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 (Desire2Learn), you are requesting for

3. Log into your Desire2Learn account (Administrator).

4. From the Admin Tools menu, click Manage Extensibility.
   

5. Select the OAuth 2.0 tab and then click Register an app.

6. Fill the details as shown below and click on the Register button.
   Application Name: SensusAccess LTI
   Redirect URI: https://lti.sensusaccess.com/home/oauth2Response
   Scope: content:*:* core:*:*
   Access Token Lifetime (seconds): 3600

7. After a successful registration, you should get the following page with a Client ID and Client Secret.
   

8. You can note down the Client ID and Client Secret because these pieces of information will be needed in the SensusAccess LTI portal later.

9. Go to your SensusAccess LTI account and then click on the LTI accounts navbar option. There might be more than one LTI accounts listed in "Associated LTI accounts" section, if the account is associated with multiple LMS.
   

10. You have to input Client ID and Client Secret that you received in step 7.

    
    

11. Insert the Client ID and Secret key and then click Save.

    
    

12. Remaining in the LTI account page, you will see the Consumer Key, Shared Secret and Tool URL.
    

13. Now lets embed the SensusAccess LTI form inside any course within your D2L instance.

Configure the external tool

You can configure LTI tool globally. To do so follow the following steps:

1. Click on the Administration Tool on the top right of the page.

2. Click on External Learning Tools.

   

3. After this, you should go to the Manage External Learning Tool Links and Click on New Link to add a new tool.

4. Fill the form with the below mentioned fields:
   
   Title : Name of the tool
   URL : https://lti.sensusaccess.com/home/index
   Key/Secret : Select Sign messages with key/secret with and then select Link key/secret radio button.
   Key : Consumer key provided by Sensus ApS.
   Secret : Consumer secret provided by Sensus ApS.
   Custom Parameters : English is the default display language for the SensusAccess LTI tool, if you desire the form in another language add in the Custom parameters the following: langauge="(two letter langauge code)(two letter country code)", for example language="daDK" will enable the form display language to be in Danish.
   Security Settings : In security settings, select Use link security settings and select all options.
   Make link available to : One can add the org units in which they want to include the LTI Tool. You can see 3 org units added in the following figure.
   

5. After filling all the details one should click on Save and Close button and the added link can be seen in the Title list. Once saved it can be added to the selected org units.

Add the tool to courses

There are two ways to add an LTI link to the course. Please choose one option based on your needs:

1. Add the tool to the navbar in all courses.
2. Add the tool to a specific individual course.

Add the tool to the navbar in all courses

To add the external tool in the navbar for all courses, follow these steps:

1. From the Admin Tools menu, click Navigation & Themes.

   

2. Click on the course navbar you want to modify. The active one is the one that says Default.

   

3. Click Add Links.

   

4. Click Create Custom Link.

5. Ensure the following fields are filled in:

   1. Name: The name of the link as it appears in the navbar.

   2. URL: Click Insert Quicklink > External Learning Tools and then select the LTI tool you want to create a navbar link for.

      

   3. Behavior:Determines the behavior of the user interface when the link is clicked. Seleted Same window if you want to open the tool on the same window with Navbar.

      1. If you selected New window/tab, specify the Width (px) and Height (px) of the new window/tab.

      2. Under Browser Attributes, specify if you want the new window to include the Menubar (File, Edit, etc.), or the Toolbar (Back, Refresh, etc.) or neither of these options.

   4. Dscription:Provides an optional description of the custom link.

   5. Icon:An icon to use with the custom link.

   6. Availability:An icon to use with the custom link.

      1. To share with child organization units, select the Share with child org units checkbox.

      2. To limit the visibility of the custom link to specific roles, select the Limit to specific roles check-box and then select the roles.

      3. To limit thevisibility of the custom links to users with specific locales, select the Limit to specific locales checkbox and then select the locales

6. Click Create.

   

7. Click Add, having the recently created tool selected by default.

   

8. You will find the recently created link under the Links section.

   

9. Click Save and Close.

10. You can find the tool link in the Navbar for all the courses. It should appear in the More dropdown of the Navbar or directly on the Navbar itself, depending on the positioning.

    

To add only to specific individual course

To add the external tool for a specific individual course, follow these steps:

1. In order to add the configured tool, you have to go to the course where you need to add the tool and click on Add Existing Activities and click External Learning Tools.

   

2. After this you need to select the added tool from the list of the LTI links and click on it to add it.

3. 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. 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 etc. inside your SensusAccess LTI account.

Note: Now, after logging into the SensusAccess LTI portal the Associated LTI account you have just finished setting up will appear in green.

Follow the steps below only if you want to remove the authorization of each application registered using OAuth 2.0

1. It is possible to revoke authorization of an anthorized application and once revoked, the application will ask again for authorization. Go to the Account Settings.
   

2. Scroll to the bottom of the page.

3. And Click on Manage applications registered with OAuth 2.0 in OAuth 2.0 section.

4. You can see the list of the registered applications and you can expand the application which you want to revoke access to and click on Remove App button to revoke the application access.
   

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