Note: This integration does require the user to be on a paid/trial license. For instructions on using this integration after it's installed, see https://help.kamiapp.com/en/articles/3161100-using-kami-s-canvas-integration
Please read the final notes at the end of this article for some further tips to avoid a commonly reported problem that may affect your ability to open files.
1. The Kami LTI integration can be added to either a specific course, or to all the courses within your Canvas site if you are an administrator. Browse to the Settings section of your site or course, and then choose the 'Apps' tab.
That will bring up the App Center.
2. In the External Apps Center, there will be a search bar on the right. From there, you should be able to search for Kami.
3. Click 'Add app' and when prompted, you will need to input a Consumer key and Shared Secret.
Click the following button to generate your LTI Key and Secret.
(please ensure that you use the same Key and Secret across all of your course, more on this below):
Generating a Key for the integration is restricted to users on either a paid or trial license. Previously, The Kami LTI Integration was available to anyone as part of the beta phase, or testing phase, of the integration which was launched last school year. This has now ended. All existing keys will still remain active until the end of the 2020-2021 school year unless the user tied with the key has a paid license which will let the user use the integration until this paid license expires instead.
Then click "Add App" to add the integration.
Things to bear in mind
The most common issue people run into is the error shown below:
"Kami was unable to load this document. Please try again later or contact Kami support.
There appears to be a configuration error with the Kami LTI integration. This file was loaded with the consumer key 08d2ab10-e364-421a-bd42-88b4d49f608f, however the assignment was created with 65f619de-af1f-4bfa-967f-30df287fae82. You can contact us at firstname.lastname@example.org for help resolving this."
Explanation: This happens when there is a mismatch between LTI key and secret entered on the course and the LTI key and secret used to open the file. This is most commonly the case when you have manually installed Kami to Canvas whilst there is also version of the Kami LTI that has been installed by your Canvas admin across your school domain.
Solution: To troubleshoot this, please go to your course settings then navigate to the Apps tab. Once there you can remove the copy of Kami that you have manually installed (it will be the one without a lock icon next to it). We recommend that you check this for each of the courses that you have set up.
This will apply to any new assignment you create using the Kami integration. However, if you have any courses that are currently live then please write to us at email@example.com with both the LTI key used for your manual install and the LTI key used by your Canvas Admin (you may need to cc your Canvas Admin a swell) and we'll manually migrate your assignments over to the campus or district-wide key.
Alternative Install Method: External URL
In the event that you do not have a hosted domain, or are unable to see the App Center, you can still install Kami via the External URL Method:
When you brin up the Apps Center, you will need to click the button at the top right - '+App' .
Choose 'By URL' as the configuration type then setup the settings as follows, using https://api.kamihq.com/lti/config.xml as the configuration URL and the key and secret from step 3 above.
Click submit to add the integration.
For help using this integration, see https://help.kamiapp.com/en/articles/3161100-using-kami-s-canvas-integration
Feel free to send us a message if you are having any other Canvas related issues and we'll be able to help you get that up and running.
Lastly for help on using this integration to push out assignments to your class, see https://help.kamiapp.com/en/articles/3161100-using-kami-s-canvas-integration