You must setup an LTI app in regular way. We will provide you with a lti-key and lti-secret.

You will need to provide us with the url of your LMS as well give as access to a subset of moodle's REST API functions. We provide a small tutorial here about how to create a REST API user and grant that with the access to some functions. Once it is setup, you will need to provide us that user's REST API token.

The app uses REST API of moodle, which requires moodle's admin to do a setup once

Admin of moodle must provide us with rest api token and enable a function called `core<sub>coursegetcontents</sub>` in web services . The minimal user for which a token must be created must have these permissions: webservice/rest:use, moodle/course:update, moodle/course:viewhiddencourses, moodle/course:view, mod/assign:viewgrades, mod/quiz:view.

If you have never done with as a moodle admin, you read below an explicit step by step guide how to do that.

1. Site Administration / Advanced Features -> Enable web -> Check the Enable web services option
2. Site Administration / Plugins / Web services / Manage Protocols -> Enable Rest protocol
3. Site Administration / Plugins / Web services / External services -> Add custom service. Give a name, for example, "protos-proctor-lti", check the enable option too. Once you save, an option saying add functions to this service will pop up. Search a function "core_{coursegetcontents}" and add it.
4. Site Administration / Users / Accounts / Add a new user -> create a user, which will use the web service web created before.
5. Site Administration / Users / Permissions / Define roles -> add new role. Select System in "Context types where this role..". Add moodle/course:update, moodle/course:viewhiddencourses (required by the function). Actually only these are required: moodle/course:view, webservice/rest:use, mod/assignment:view, mod/quiz:view
6. Site Administration / Users / Permissions / Assign system roles -> Connect the role with user created.
7. Site Administration / Plugins / Web services / Manage tokens -> Create a token connecting our created user and rest service. You need to provice us with this token.

In site administration look for "Allow frame embedding" or allowframembedding and enable it.

>= 3200.10.0

You will need to create a "Rest API Integration", which can be found in [ System admin -> REST API Integrations -> Create Integration ]. You will be asked there to introduce Application Id, which we will provide.

Then you have to add our app [ System admin -> LTI Tool Providers -> Register Provider Domain ]. Here you will need to introduce the lti-key and lti-secret, which we will provide. Next, you simply add this lti tool to the course of your choice.

You will also need to give the url of your LMS