Canvas
=======

.. youtube:: SbB2su6es-0
   :width: 100%

Add LTI Key
------------

.. image:: imgs/canvas-developerkeys.png
    :class: with-border

Navigtate to :class:`Admin > Developer Keys` and add a new :class:`LTI Key`.

.. image:: imgs/canvas-keysettings-uri.png
    :class: with-border

Input required information available in the EON-XR LTI Advantage platform page.

.. image:: imgs/canvas-keysettings-scope.png
    :class: with-border

Select the scopes that will allow the external tool to post grades to a gradebook.

.. image:: imgs/canvas-public.png
    :class: with-border

Select :class:`public` if you wish to share user email and name with the external tool.
If the email already exists on eon-xr that user will be logged in.
If the email does not already exist, an account will be created with that email.
If you do not select public, user accounts will be generated using [canvas userid]@[canvas domain].

.. image:: imgs/canvas-keysettings-placements.png
    :class: with-border

Under :class:`Placements`, ensure that :class:`Link Selection` and :class:`Assignment Selection` are selected.

.. image:: imgs/canvas-keysettings-deeplink.png
    :class: with-border

In the :class:`Link Selection` and :class:`Assignement Selection` sections, set the :class:`Target Link URI` as shown below:

.. list-table:: 
   :align: left
   :width: 95%
   :widths: 25, 75
   :header-rows: 1

   * - Field
     - Value
   * - Target Link URI
     - Paste :class:`Content Selection Deep Link URL` from EON-XR LTI settings page
   * - Select Message Type
     - :class:`LtiDeepLinkingRequest`
   * - Text
     - EON-XR Content

Once done, select Save.

.. image:: imgs/canvas-clientid.png
    :class: with-border

Enable the new key by selecting :class:`On` and make sure to copy the number above the :class:`Show Key` button, this is the :class:`Client Id` and will be needed to complete platform registration on EON-XR.

Platform Settings
--------------------------------

.. image:: imgs/lti-addplatform.png
    :class: with-border

Input the :class:`Client Id` from the :class:`Developer Keys` page.

Issuer: https://canvas.instructure.com

JWK set URL: https://[CANVAS DOMAIN]/api/lti/security/jwks

Access Token URL: https://[CANVAS DOMAIN]/login/oauth2/token

Authorization URL: https://[CANVAS DOMAIN]/api/lti/authorize_redirect

Add External App To A Course
--------------------------------

.. image:: imgs/canvas-addapp.png
    :class: with-border

In the desired course, navigate to :class:`Course Settings > Apps` and add a new app.
Select :class:`By Client ID` configuration type and paste the Client Id from :class:`Admin > Developer Keys`.

.. image:: imgs/canvas-deploymentid.png
    :class: with-border

You must add the :class:`Deployment Id` to the platform in EON-XR LTI Advantage settings.

Add External Tool To A Module
--------------------------------

.. image:: imgs/canvas-addtomodule.png
    :class: with-border

After adding the external app to the course, you should see it available when you add an item to a module.
Select the app, this will launch a catalog where you can choose content.
You must also select :class:`Load in a new tab` or due to security restrictions, the launch connection will be refused.