Docs home

LTI Integration: Connecting External Tools

Register an LTI 1.3 tool such as Moodle, add it to your courses as an External Tool material, and sync grades back to Edmingle.

LTI (Learning Tools Interoperability) lets you launch outside tools, such as coding labs, exam engines, sandboxes or Moodle activities, from inside your Edmingle courses. Learners are signed in to the tool automatically, and the tool can send scores back to Edmingle.

Edmingle supports LTI 1.3 / LTI Advantage. In Edmingle these are called External Tools.

What you can do

  • Register a tool once, then use it in any course.
  • Add tool activities to a course section as External Tool materials, either by pasting a launch link or by browsing the tool's catalogue.
  • Make a material Graded, so scores from the tool appear in Edmingle as marks.
  • Choose how much learner data the tool receives: anonymous, name only, or name and email.

LTI is available only on certain plans. If you don't see the option or can't turn it on, contact support@edmingle.com.

Before you start

You need:

  • Admin access to Edmingle (integrations write access).
  • Admin access to the external tool, so you can copy its LTI 1.3 details and paste in Edmingle's details.
  • These details from your tool vendor:
    • Login initiation URL (Edmingle calls it the Authentication request URL)
    • Public keyset (JWKS) URL
    • Launch redirect URL
    • Deep linking redirect URL

Step 1: Register the tool in Edmingle

Setup works in both directions. You paste the tool's URLs into Edmingle, then you paste Edmingle's details into the tool.

  1. Go to Settings → Integrations → Apps, open the Advanced tab, and find External tool integration.
  2. Click Connect New Tool.
  3. Fill in the form:
Field What to enter
Tool name A name instructors will see in the course builder, for example "Moodle Labs".
Authentication request URL The tool's login initiation URL (for Moodle, …/enrol/lti/login.php?id=…).
Public keyset URL The tool's JWKS URL. Edmingle checks that it can be reached when you save.
Launch redirect URL Where launches are sent (for Moodle, …/enrol/lti/launch.php).
Deep link redirect URL Where catalogue selections are sent (for Moodle, …/enrol/lti/launch_deeplink.php).
Additional redirect URL (optional) Any other return URLs the vendor gives you. Launches only go to an exact match on this list.
  1. Optionally open Advanced – permissions, privacy & identifiers (see Permissions and privacy).
  2. Click Save Configuration.

Step 2: Paste Edmingle's details into the tool

After you save, Edmingle generates signing keys and shows Config Saved! Paste into [tool name]. Copy each value into the tool's "register a platform" screen, or use Copy all:

Edmingle label Often called in the tool
Platform name Platform name
Platform ID (issuer) Issuer / Platform ID
Client ID Client ID
Authentication request URL Authentication request URL / OIDC auth URL
Public keyset URL Public keyset URL / JWKS URL
Access token URL Access token URL

To see these details again later, open the tool's actions menu in the tools list and choose View platform details.

Example: Moodle

In Moodle, the activity is published as an LTI tool and Edmingle is registered as the platform.

  1. In the Moodle course, go to Participants → Enrolment methods → Add method → Publish as LTI tool.
  2. Set LTI version to LTI Advantage, choose the course or a specific activity to publish, and save.
  3. Open Course → More → Published as LTI tools, then the LTI Advantage tab. Copy the tool URLs into Edmingle (Step 1).
  4. In Moodle's LTI Advantage platform registration, register a new platform and paste in Edmingle's details (Step 2).

Step 3: Turn on external tools

On the External tool integration page, switch on Enable external tools. When it's off, no tools can be launched from your courses. To pause one tool, use Mark as inactive in its actions menu. Inactive tools can't be chosen in the course builder.

Step 4: Add the tool to a course

  1. Open the course curriculum and the section where the activity should go.
  2. Add a material and choose External Tool.
  3. In Select External Tool, choose the tool you registered.
  4. Add the activity in one of two ways:
    • Browse from tool catalogue: sign in to the tool in the pop-up and pick one or more items. They're added to the section automatically. Allow pop-ups for your Edmingle site first.
    • Paste manually: enter the Activity ID. For Moodle, this is the id= value from the published activity's launch URL. Edmingle adds it to the tool's launch URL for you.
  5. To grade the activity, turn on Graded and enter the Maximum Marks.
  6. Save the material.

Each Moodle activity has its own ID. Register the Moodle tool once, then use a different Activity ID for each material.

What learners see

Learners open the material and click Open Tool. The tool opens in a new browser tab, already signed in. No second login is needed.

External tools can be opened only from the learner website. They can't be launched from the mobile apps or from the older version of the learner dashboard. The course also needs at least one batch.

How grades sync

If a material is Graded, the tool can send scores back to Edmingle:

  • Only final scores are recorded. Scores the tool marks as in progress or pending are ignored until it sends a final one.
  • Scores are converted to the material's Maximum Marks. For example, a learner who scores 8/10 in the tool gets 16 marks on a material out of 20.
  • A score above the tool's maximum is capped at full marks.
  • If the tool sends a new score later, the learner's marks update.

Marks then appear wherever Edmingle shows exercise results, such as Submissions and batch reports.

Permissions and privacy

Under Advanced – permissions, privacy & identifiers, you control what the tool can access:

  • What this tool may do
    • Submit scores: lets the tool send scores to Edmingle. This is needed for grade sync.
    • Read the batch roster: lets the tool see the list of learners in the batch it's launched from.
  • Learner data shared: Anonymous, Name only, or Name and email. This applies to launches and roster requests.

The tool gets only the permissions you grant. Anything else it asks for is refused. The signature algorithm is set by Edmingle and can't be changed.

Troubleshooting

Problem What to check
Save fails on the Public keyset URL The URL must be public and return the tool's keys. Copy it again from the vendor.
The tool doesn't appear in Select External Tool Make sure the tool is active and Enable external tools is on.
"Pop-up blocked" when browsing the catalogue Allow pop-ups for your Edmingle site, then try again.
"Deep linking failed" Check the Deep link redirect URL, or paste the Activity ID manually.
Learner sees "Add at least one batch to the course…" Create a batch for the course and enrol the learner in it.
The launch fails or the tool shows an error Make sure every value in Step 2 was pasted into the tool exactly, and that the redirect URLs in Edmingle match the vendor's.
Marks don't appear The material must be Graded with Maximum Marks above 0, Submit scores must be allowed, and the tool must send a final score.

For help, contact support@edmingle.com.

Updated yesterday

Ask AI