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
-
Log in to Moodle using administrator credentials. Example: https://moodle.apporto.com/
-
Log in to the Apporto Portal as an administrator. Example: https://{instancename}.apporto.com
Step 2: Create the LTI configuration in Apporto NextGen
-
In NextGen, go to Setup > LTI Configuration.
-
Select Create New LTI Configuration.
-
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:
|
|
LTI Base URL |
Example: http://moodle.apporto.com/ |
|
Auth Login URL |
|
|
Auth Token URL |
Keep this page open. You will need to return to it after generating the required keys in Moodle.
Step 3: Generate credentials in Moodle
-
In Moodle, go to Site Administration.
-
Select Plugin tab > Activity modules section >> under external tools > manage tools.
-
Click Manage tools button.
-
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.
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. |
-
Create the LTI key to generate the Client ID.
-
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.
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 |
|
|
API Key / API Client ID |
Use the API Key generated in Moodle. |
|
App Identifier |
|
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
-
Save the configuration in Apporto.
-
Select the Authorize link.
-
In Moodle, click Authorize to approve the integration.
-
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
-
In Moodle, go to the course from which you want to launch app.
e.g: First Course
-
Turn on the editing toggle, then click the Add an activity or resource button.
-
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.
-
Click on the tool to open it.
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.