Guide to setup SensusAccess LTI with Canvas

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

  3. Log into your Canvas account (Administrator).

  4. In Global Navigation, click the Admin link, then click the name of the Admin account.

  5. In the Account Navigation, click the Developer Keys.

  6. In the screen, click on the API Key

    Screenshot showing how to add api key.
  7. Fill the fields as per below:
    Screenshot showing how to register tool to get Developer Keys.

  8. This step is an optional. This step is to enable "Enforce Scopes" to limit the access token to selected endpoints. If this is not your concern, you could skip this step. When scope enforcement is disabled, tokens have access to all endpoints available to the authorizing user.

    If you enable "Enforce Scopes" in Developer Keys, you must check 9 endpoints to run SensusAccess LTI plug-in.

    In "Courses" section you have to check 1 endpoint as below:

    Screenshot showing enpoints to check to enable scopes.

    In "Files" section you have to check 4 endpoints as below:

    Screenshot showing enpoints to check to enable scopes.

    In "Modules" section you have to check 4 endpoints as below:

    Screenshot showing enpoints to check to enable scopes.

  9. Once the form is filled, click on the Save Key.

  10. In the Developer Keys listing, click ON in the State field and once clicked, the color of the ON would be green. (By default the State field is OFF and color of the button is red).

  11. Now you have Client Id and Client Secret ready and its time to attach these values into your SensusAccess LTI account. Client Id is displayed in the Developer keys listing (For example, 10000000000001 as highlighted in the picture) and to view the Client secret, click on the Show Key and the value will be displayed in the dialog.

    Screenshot showing how to see OAuth 2.0 Client Id and Client Secret.

  12. Go to your SensusAccess LTI account, click on the desired Associated LTI account. There might be more than one LTI accounts listed in "Associated LTI accounts" section, if your account is associated with multiple LMS. Screenshot showing where to click for the associated lti accounts
  13. You have to input Client Id and Client Secret that you received in step 9. Screenshot showing where to click to insert Client Id and Client secret

  14. Insert the Client Id and Secret key and then click Save. Screenshot showing where to insert Client Id and Client secret

  15. Remaining in the LTI account page, you will see the Consumer Key, Shared Secret and the link to the cartrige.xml for the LTI tool.
    Canvas Screenshot showing where to find the consumer key, shared secret and cartrige xml
    Use these in order to link your LMS system to the SensusAccess LTI Tool.

  16. Note: Now, after logging into the SensusAccess LTI page the Associated LTI account you have just finished setting up will appear in green. Screenshot showing that the associated lti account is set up correctly

  17. Now lets embed the SensusAccess form inside any course within your LTI.

  18. There are two ways to configure the SensusAccess LTI tool to Canvas i.e. just for a course or for all courses in the Canvas instance.

  19. To configure for all courses in the system, click on the Admin link and click on the account. Go to the Account Settings page (On the left submenu it is the last item).

  20. To configure for a course, navigate to the course where the SensusAccess form will be embedded. Go to the course Settings page (On the left submenu it is the last item).

  21. Go to the Apps tab and click on the View App Configurations button on the top right side. The form is similar in both All courses level or for a course level configuration.

  22. In the External Apps menu click on the + App button on the top right side.

  23. In the Add App modal under the Configuration Type select By URL, then add your desired name such as SensusAccess, insert the Consumer Key, Shared Secret and Config URL that is associated with this specific Canvas website from your SensusAccess LTI account. Note: if your Canvas website is running under a secure https connection please make sure to copy the Secure Tool URL for the Config URL. If you want the tool to hide for all courses by default and the teachers would like to enable the tool for particular courses, you could use URL as

    By default, the tool runs as British English and if you want to run as different language, you could set a custom parameter as shown in the screenshot. Custom parameters field is used to support localization. The tool's default language (if not supplied any value) is en-GB (British English). Currently, the tool supports the options en-AU, en-US, da-DK. Screenshot showing how to edit the tool

  24. Click on the Submit button and navigate back to the Home page (On the left submenu it is the first item) of your course.

  25. To enable/disable the tool for a course, Go to Settings and click on Navigation and Disable or Move the tool down the area "Drag items here to hide them from students." as shown below.

    Screenshot showing how to enable the tool
    Follow the screen below to enable the tool again for a course.
    Screenshot showing how to disable the tool

  26. On the course menu on the left side, you will see a menu item SensusAccess. Clicking on the SensusAccess link will redirect you to Canvas authorize page, and clicking on the Authorize button will issue a token to the SensusAccess LTI tool and the SensusAccess conversion form will be displayed. Screenshot showing that the associated lti account is set up correctly

  27. If you want to revoke the token from the SensusAccess LTI, you can do so by deleting the token associated with the tool from the Account and Profile link. Screenshot showing that the associated lti account is set up correctly

  28. 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 API token/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