Note: this article helps with trouble shooting issues of LTI integrations that have already been successfully installed. The article is NOT directed at admins installing the integration of Grasple with their LMS. If you encounter difficulties during the installation, please reach out to support@grasple.com.
What happens if my settings are incorrect?
When Grasple is loaded within your Learning Management System (e.g. Brightspace, Canvas, Moodle, Blackboard, etc.), your browser should allow third-party-cookies for grasple.com and allow Javascript to be run.
If you don't have the correct settings, launching Grasple within your LMS will not work. This can result in one of the following errors:
Grey screen with "app.grasple.com refused to connect"
Error screen explaining Javascript should be enabled.
A completely white screen (usually in Safari)
How do I configure my browser correctly?
Safari
By default Safari on both Macbook and iPhone do not allow third-party-cookies. Change your settings if you want to use Grasple within your LMS while using Safari.
Macbook:
Go to Safari > Settings...
Go to Privacy
For Safari 11+: uncheck "Prevent cross-site tracking"
For Safari 10 and lower: set "Cookies and website data" to "Always allow"
iPhone:
Go to Settings > Apps > Safari
For iOS 11:
Scroll to 'Privacy and Security'
Prevent Cross-site tracking is turned off
Scroll to the end, click 'Advanced'
Make sure 'Block All Cookies' is turned off
For iOS 10 and lower: Make sure that Always Allow is selected from the “Cookies” drop-down menu
Chrome
By default Chrome allows third-party-cookies. If you switched it off, please follow these steps below:
Go to Chrome Settings > Privacy and security > Site Settings
Go to Cookies
Enable "Allow sites to save and read cookie data" and disable "Block third-party cookies
Firefox
By default Firefox allows third-party-cookies. If you switched it off, please follow these steps below:
Go to Content Blocking
If Custom is selected, make sure that the Cookies settings is set to "Third-Party trackers" and not any of the other options.
Edge
By default Edge allows third-party-cookies. If you switched it off, please follow these steps below:
Go to Edge > Settings
Click View Advanced Settings
Select the dropdown under Cookies
Select "Don't block cookies"
Need support
If the issue persists after having followed the instructions in this guide, please contact us at support@grasple.com or via the chat. Please add screenshots of the page where you're experiencing the issues with your browser console clearly visible (article: how do I open my browser console).