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 Advantage` option in the dropdown.

Add Platform
--------------------------------

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

Select :class:`Add Platform` and enter the required information provided by your lms.
Some information may not be generated by your LMS until the next step below.

Copy Information Into Your LMS
--------------------------------

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

Copy the information into your lms and finish registering EON-XR as an external tool provider.
The lms will generate information such as the :class:`Client Id` that is required to finish adding the platform.

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

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

Input the lms role you want associated with the EON-XR role.
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.
Select the EON-XR role you want associated with the lms role in the dropdown and add the entry.

Add Deployments
--------------------------------

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

When adding the EON-XR tool to a course in your lms you will need to add the associated :class:`Deployment Id` provided by your lms.
In most cases courses will share the same LTI 1.3 tool registration, but only courses with their associated :class:`Deployment Id` added will be authorized to launch the tool.