LTI Integration Guide

This guide is for a tenant who wants to connect ICT Exam to their own LTI 1.3 compliant LMS rather than the hosted Moodle. ICT Exam is a standards-conformant LTI 1.3 / LTI Advantage tool, verified against the saLTIre / 1EdTech reference platform, so it launches from any LMS that implements LTI 1.3. Each customer’s LMS issuer becomes its own tenant key, so your data stays fully isolated from every other customer.

How an LTI 1.3 connection works

LTI 1.3 is a two-way trust setup, where each side registers the other:

1. The LMS (platform) is told about the tool (ICT Exam): where to start a launch, where to send the user, and where to fetch the tool’s public keys.
2. ICT Exam (tool) is told about the platform (your LMS): its issuer, client id, and its OIDC, token and keyset endpoints.

Then a user clicks the activity in the LMS, an OIDC handshake runs, a signed launch is sent, and ICT Exam opens.

Known LTI 1.3 compliant platforms

ICT Exam works with any LTI 1.3 platform. Open-source LMSs known to support LTI 1.3 as a platform (so they can launch external tools like ICT Exam) include:

Commercial platforms such as Blackboard, Brightspace/D2L and Schoology work too; they simply are not open source. The integration mechanism is identical for all of them, only the admin screens differ.

Values ICT Exam gives your LMS

Configure these in your LMS’s external tool or LTI Advantage registration. The hosted service host is https://app.ictlms.net:

Grant these LTI Advantage services so grade passback and roster sync work:

• Assignment & Grade Services (AGS), line item and score scopes:
  • https://purl.imsglobal.org/spec/lti-ags/scope/lineitem
  • https://purl.imsglobal.org/spec/lti-ags/scope/score
  • https://purl.imsglobal.org/spec/lti-ags/scope/result.readonly
• Names & Role Provisioning Services (NRPS):
  • https://purl.imsglobal.org/spec/lti-nrps/scope/contextmembership.readonly

Set the launch privacy to share name and email if you want roster sync and per-user grades to carry real identities.

Values your LMS gives ICT Exam

After you create the tool in your LMS, the LMS exposes its own LTI 1.3 endpoints. Send these to ICT Exam staff so we can add a registration:

ICT Exam stores this as a registration entry, keyed by issuer:

{  "https://lms.yourschool.edu": [    {      "issuer": "https://lms.yourschool.edu",      "client_id": "ABC123clientid",      "auth_login_url": "https://lms.yourschool.edu/mod/lti/auth.php",      "access_token_url": "https://lms.yourschool.edu/mod/lti/token.php",      "key_set_url": "https://lms.yourschool.edu/mod/lti/certs.php",      "deployment_ids": ["1"]    }  ]}

We also create your tenant row (issuer = your LMS, so the issuer alone identifies you) and enable AGS and NRPS. The backend is restarted once and the connection is live.

Step by step: Moodle

1. Site administration → Plugins → Activity modules → External tool → Manage tools → Configure a tool manually.
2. Set:
   • Tool name: ICT Exam
   • Tool URL: https://app.ictlms.net/lti/launch
   • LTI version: LTI 1.3
   • Public key type: Keyset URL
   • Public keyset: https://app.ictlms.net/.well-known/jwks.json
   • Initiate login URL: https://app.ictlms.net/lti/login
   • Redirection URI(s): https://app.ictlms.net/lti/launch
3. Under Services, set IMS LTI Assignment and Grade Services to Use this service for grade sync and column management, and IMS LTI Names and Role Provisioning to Use this service to retrieve members’ information.
4. Under Privacy, set share launcher’s name and email to Always.
5. Save, then open Tool configuration details (the “i”) to read Moodle’s Platform ID (issuer), Client ID, Deployment ID, and the auth, token and public-keyset URLs. Send these to ICT Exam.
6. (Optional) For the cleanest single grade column, install the native mod_ictexam plugin instead of a raw external-tool activity.
7. Add an External tool activity in a course pointing at the ICT Exam tool, then launch.

Step by step: Chamilo

1. Administration → Plugins → enable the LTI / External tool plugin (or Course → Tools → External tool (LTI) depending on version).
2. Add a new tool with:
   • Name: ICT Exam
   • Launch URL: https://app.ictlms.net/lti/launch
   • LTI version: 1.3
   • Login / Initiation URL: https://app.ictlms.net/lti/login
   • Redirect URL: https://app.ictlms.net/lti/launch
   • Public keyset (JWKS) URL: https://app.ictlms.net/.well-known/jwks.json
3. Enable AGS (grade services) and NRPS (membership) if your Chamilo version exposes them.
4. Save and open the registration details to read Chamilo’s issuer, client id, deployment id, and its OIDC auth, token and JWKS endpoints. Send these to ICT Exam.
5. Add the tool to a course and launch.

Step by step: any other LTI 1.3 LMS

For Open edX, Sakai, ILIAS, Canvas, OpenOLAT and the rest, the mechanism is identical and only the admin labels change:

1. In the LMS, register a new LTI 1.3 / LTI Advantage tool using the four ICT Exam tool endpoints (Login, Launch/Target, Redirect, JWKS) from the table above.
2. Enable the AGS and NRPS services and scopes.
3. Configure the tool to send the user’s name and email.
4. Copy the LMS’s issuer, client id, deployment id, OIDC auth endpoint, token endpoint and JWKS URL and send them to ICT Exam.
5. ICT Exam adds the registration and your tenant, restarts, and confirms.
6. Place the tool or activity in a course and launch.

For Open edX specifically, use the lti_consumer XBlock in “LTI 1.3” mode and enable LTI Advantage (AGS/NRPS). For Canvas, create an LTI 1.3 Developer Key with the same endpoints and scopes.

After connecting, what works

• Single sign-on launch: teachers land in the authoring workspace; students go straight into the exam, with no separate ICT Exam login.
• Grade passback (AGS): a student’s score is written back into the LMS gradebook on submit, and updated again after teacher recheck.
• Roster sync (NRPS): a teacher launched from a course can pull the course’s members into ICT Exam (creating users and enrolments) from the Sync roster from Moodle/LMS button.
• Tenant isolation: everything created under your issuer stays in your tenant.

Troubleshooting

When in doubt, the fastest check is the Tool configuration details screen in your LMS. It lists exactly the issuer, client, deployment and endpoints ICT Exam needs.