Setup
================================

Access LTI Settings
--------------------------------

.. image:: imgs/lti-admin.png

Login to EON-XR, select the account menu by clicking on your profile icon then navigate to the :class:`Admin` section.
Your account will need a role that allows access to this section.
If you do not have access to :class:`Admin` you will not see this option in the dropdown.

.. image:: imgs/lti-settings.png

Select :class:`Settings`, you will need a role that grants permission to :class:`Modify LTI`
If you do not have this permission, you may be able to access :class:`Settings` but be unable to access :class:`LTI Settings`.
From the :class:`Settings` landing page, select the :class:`Settings` menu and if you have a role that can manage LTI, you will see an :class:`LTI 1.1` option in the dropdown.

Generate Credentials
--------------------------------

.. image:: imgs/lti-generate.png

On the :class:`LTI Settings` page, if credentials have not yet been generated, select the :class:`Generate Credentials` button.
You will then be redirected to the :class:`Roles` tab.

Map LMS Roles to EON-XR Roles
--------------------------------

.. image:: imgs/lti-roles.png

This page allows you to decide which lms role will be assigned to which EON-XR role.
Input the lms role you want associated with the EON-XR role.
EON-XR roles you do not wish to be assigned should be left blank and will not be assigned.

Choose the appropriate weight.
If a user has more than one lms role, the highest weighted role will be assigned.
If a users lms role was not mapped, the lowest weighted role will be assigned by default.

After a user account has been auto provisioned and assigned a role, changes to that account must be made in the :class:`User Management` page, changing this setting will not affect existing accounts.

An actual role in your lms will look like this :class:`http://purl.imsglobal.org/vocab/lis/v2/institution/person#Instructor` however, it is acceptable to enter a keyword such as :class:`Instructor` instead, as long as the keyword matches exactly the characters within the role name and is unique to that role.

.. image:: imgs/lti-credentials.png

When finished, select the :class:`Update` button.
Then select the :class:`Credentials` tab, your lms will need the information listed.

LTI 1.1 Tool Link
--------------------------------

.. image:: imgs/lti-lesson.png

Navigate to the desired lesson on the EON-XR Platform and select :class:`LTI 1.1 Tool Link`

.. image:: imgs/lti-toollink.png

You will need this link to create a new assignment or activity linking to this lesson from your lms.
Note that this link only works for LTI integrations, it cannot be used directly in the browser.