PlayWithASL Help Center

Find documentation for LMS integration, LTI setup, and troubleshooting.

Moodle LMS Guide

Last Updated: Jan 22, 2026
{% extends "base.html" %} {% block content %}

Moodle LTI 1.3 Setup Guide

Follow these steps to configure your PlayWithASL LTI tool in Moodle:

Step 1: Add LTI External Tool

As a Moodle administrator, you need to configure the LTI external tool:

  1. Go to Site administrationPluginsExternal toolsManage tools
  2. Click Configure a tool manually
  3. Enter the following information:
    • Tool name: PlayWithASL
    • Tool URL: {{ launch_url }}
    • LTI version: LTI 1.3
    • Public key type: Keyset URL
    • Public keyset: {{ jwks_url }}
    • Initiate login URL: {{ login_url }}
    • Redirection URI(s): {{ launch_url }}
    • Tool configuration usage: Show as preconfigured tool when adding an external tool
  4. Under Services, enable the LTI services you need (Names and Roles, Assignment and Grade, etc.)
  5. Under Privacy, select which user data to share with the tool
  6. Click Save changes

Important: After saving, Moodle will provide you with the following information that you'll need for your platform configuration:

  • Platform ID/Issuer: Unique identifier for your Moodle instance
  • Client ID: Identifier for your tool in Moodle
  • Public keyset URL: Where Moodle publishes its public keys
  • Access token URL: For LTI service connections
  • Authentication request URL: For initiating LTI launches

Step 2: Configure Your Platform

After registering with Moodle, you need to create a platform record in PlayWithASL:

  1. Go to Platforms in your dashboard
  2. Click Add New Platform
  3. Fill out the form with these Moodle-specific settings:
    • Name: Moodle [Your Institution]
    • Platform Type: Moodle
    • Issuer: Platform ID provided by Moodle (typically your Moodle URL)
    • Client ID: Client ID provided by Moodle
    • OIDC Login URL: Authentication request URL from Moodle
    • JWKS URL: Public keyset URL from Moodle
    • Target Link URI: {{ launch_url }}
  4. Generate RSA keys for your platform using the key generation tool
  5. Save the platform

Step 3: Add Tool to Courses

After configuration, instructors can add the tool to their courses:

As an Activity:
  1. In a course, turn editing on
  2. Click Add an activity or resource
  3. Select External tool
  4. In the Preconfigured tool dropdown, select PlayWithASL
  5. Enter an Activity name
  6. Click Save and return to course or Save and display
As a Course Tool:
  1. In a course, turn editing on
  2. Click Add a blockExternal tool
  3. Configure the block to use PlayWithASL

Troubleshooting

Make sure the client ID and issuer in your platform record exactly match the values provided by Moodle. Moodle is very strict about matching these values.

Check that the deployment ID is being passed correctly. For Moodle, this is often the course ID, and your tool should handle various deployment IDs.

Check that your public key is correctly configured and accessible at your JWKS endpoint. Moodle requires the key to be in a specific format; you can use the Platform Test tool to verify your key configuration.

{% endblock %}