Moodle LTI Configuration Guide

This guide explains how to configure a Moodle LTI integration with Apporto NextGen and complete the authorization flow required for course launch and user provisioning.

Overview

The configuration requires work in two systems:

  • Apporto NextGen to create the LTI configuration

  • Moodle to generate the Client ID, API Key used for authentication and API access

Once setup is complete, the integration can be authorized, added to a Moodle course, and used to launch Apporto from within Moodle.

Prerequisites

  • Administrator access to the Moodle instance

  • Administrator access to the Apporto Portal / NextGen environment

  • An Apporto instance URL

  • A Moodle course available for launch testing

Step 1: Sign in to both platforms

  1. Log in to Moodle using administrator credentials. Example: https://moodle.apporto.com/

  2. Log in to the Apporto Portal as an administrator. Example: https://{instancename}.apporto.com

Step 2: Create the LTI configuration in Apporto NextGen

  1. In NextGen, go to Setup > LTI Configuration.

  2. Select Create New LTI Configuration.

  3. image-20261109-174438.png

    Complete the LTI configuration form using the values below.

Field

Value / Guidance

LTI Type

Moodle

LTI Course Type

Choose how Apporto maps your LMS course structure:

  • Course and Section: Syncs at both the course and section levels, allowing rosters and grades to be tracked separately for each section within a course.

  • Course Only: Treats the entire LMS course as a single group; section level distinctions are not considered.

  • Section Only: Provisions users by section only, the parent course is not used as a grouping level.

LTI Base URL

Example: http://moodle.apporto.com/

Auth Login URL

Example: https://moodle.apporto.com/mod/lti/auth.php

Auth Token URL

Example: https://moodle.apporto.com/mod/lti/token.php

Keep this page open. You will need to return to it after generating the required keys in Moodle.

Step 3: Generate credentials in Moodle

  1. In Moodle, go to Site Administration.

    image-20261109-181756.png
  2. Select Plugin tab > Activity modules section >> under external tools > manage tools.

    image-20261109-182646.png
  3. Click Manage tools button.

    image-20261109-183002.png
  4. Click on configure a tool manually. In the LTI 1.3 Configuration Field,

Field

Value / Guidance

Tool name

Example: Apporto LTI Moodle

Description:

Example: Apporto LTI Moodle

Tool URL:

Example: https://{instancename}.apporto.com/api/auth/lti/v2/moodle/launch

LTI version:

Select LTI 1.3 from the dropdown menu.

Public key type:

 Select Keyset URL from the dropdown menu.

Public keyset:

Example: https://{instancename}.apporto.com/api/auth/lti/v2/moodle/keys

Initiate login URL:

Example: https://{instancename}.apporto.com/api/auth/lti/v2/moodle/login

Redirection URI(s):

Example: https://{instancename}.apporto.com/api/auth/lti/v2/moodle/launch

Custom parameters:

Instruction for Direct Linking 

Add Custom parameter while creating the LTI application or you can add in edit option as well. 
Example: nid=cmvkp123u000407wkivy0dho7
“nid” is a static value. 

Note:- You can fetch the value for nid from the AppStore by hovering the name of the app or you can ask the Apporto support team to share the nid for the particular app. 

 Note:- For every direct link you have to create a new LTI Application and need to pass different “nid” for different Apporto applications. 

image-20261109-185107.png
image-20261109-185159.png
  1. Create the LTI key to generate the Client ID.

    image-20261109-185306.png
  2. After the Client ID is created, Click on this URL {https://{instancename}/admin/webservice/tokens.php} and generate an API key token. We need to add this API key to the LTI configuration.

    image-20261109-185537.png

At the end of this step, Moodle provides the values needed to complete the Apporto configuration: Client ID, API Key.

 

Step 4: Complete the Apporto LTI configuration

Return to the LTI configuration form in Apporto and populate the Moodle-generated values along with the Apporto redirect endpoints.

Field

Value / Guidance

Client ID

Use the Moodle LTI Client ID.

Client Secret

Use the Client Secret associated with the Moodle LTI key.

OIDC Login Redirect

{instanceName}/api/auth/lti/v2/moodle/launch
Example: https://test-ng.apporto.com/api/auth/lti/v2/moodle/launch

API Key / API Client ID

Use the API Key generated in Moodle.

App Identifier

nid
This is used in deep linking. Pass the desktop ID you want to deep link with in custom fields.

Caution: Ensure the configured redirect URLs exactly match the environment being used. Mismatched URLs are a common cause of authorization failure.

Step 5: Save and authorize the integration

  1. Save the configuration in Apporto.

  2. Select the Authorize link.

  3. In Moodle, click Authorize to approve the integration.

  4. After successful authorization, the browser redirects back to the Apporto configuration area, typically to the system configuration page.

Example redirect pattern: https://{instancename}.apporto.com/system-config?tabIndex=6

Expected result: If authorization succeeds, the LTI configuration is now connected and ready to be used in Moodle courses.

Step 6: Testing the integration - Create the Moodle app

  1. In Moodle, go to the course from which you want to launch app.
    e.g: First Course

    image-20261109-190227.png
  2. Turn on the editing toggle, then click the Add an activity or resource button.

    image-20261109-190607.png
  3. Select External Tool, fill in the required details, and then choose the tool you previously created from the Preconfigured Tool dropdown. Once you've completed the configuration, click Save and return to course. You should now see the tool added to your course.

    image-20261109-190923.png
    image-20261109-190944.png


  4. Click on the tool to open it.

    image-20261109-191356.png

Troubleshooting

Authorization fails

  • Confirm that the Client ID, API Key were copied from the correct Moodle entries.

  • Verify that the redirect URLs exactly match the configured Apporto environment.

  • Make sure you are not using localhost.

Course launch does not open Apporto

  • Confirm the LTI tool has been correctly added to the course.

  • Check that the integration was fully authorized before launch testing.

  • Validate that the user has access to an assigned desktop after provisioning.

Deep linking does not open the expected desktop

  • Confirm the App Identifier is set to nid.

  • Verify that the correct desktop ID is being passed in the custom fields.