Step 1: Create a developer LTI key for WirisQuizzes

In the admin panel in your Canvas instance, select the option Developer Keys. Press the button for adding a new Developer Key and select “LTI key”.

Fill out the form with the following information:

Key name: WirisQuizzes

Owner email: support@wiris.com

Configure: Paste JSON

LTI 1.3 Configuration:

{
  "title": "WirisQuizzes",
  "description": "Math and science assessment platform. Include automated computer-based grading questions in your STEM courses. Student can handwrite their answer in mobile and tablet devices. Formative assessment at hand with unlimited versions of a question thanks to algorithmically generated questions.",
  "target_link_uri": "https://www.wiris.net/client/lti/quizzes/tool",
  "oidc_initiation_url": "https://www.wiris.net/client/lti/quizzes/login",
  "public_jwk_url": "https://www.wiris.net/client/lti/quizzes/jwks.json",
  "custom_fields": {
    "context_id_history": "$Context.id.history",
    "person_address_timezone": "$Person.address.timezone",
    "canvas_assignment_due_at_iso8601": "$Canvas.assignment.dueAt.iso8601",
    "canvas_assignment_lock_at_iso8601": "$Canvas.assignment.lockAt.iso8601",
    "canvas_assignment_points_possible": "$Canvas.assignment.pointsPossible",
    "canvas_assignment_allowed_attempts": "$Canvas.assignment.allowedAttempts",
    "canvas_assignment_unlock_at_iso8601": "$Canvas.assignment.unlockAt.iso8601"
  },
  "scopes": [
    "https://purl.imsglobal.org/spec/lti-ags/scope/lineitem",
    "https://purl.imsglobal.org/spec/lti-ags/scope/lineitem.readonly",
    "https://purl.imsglobal.org/spec/lti-ags/scope/result.readonly",
    "https://purl.imsglobal.org/spec/lti-ags/scope/score"
  ],
  "extensions": [
    {
      "domain": "wiris.net",
      "tool_id": "wiris-quizzes",
      "privacy_level": "anonymous",
      "platform": "canvas.instructure.com",
      "settings": {
        "platform": "canvas.instructure.com",
        "selection_width": 1200,
        "selection_height": 800,
        "placements": [
          {
            "placement": "assignment_selection",
            "message_type": "LtiDeepLinkingRequest",
            "target_link_uri": "https://www.wiris.net/client/lti/quizzes/tool"
          },
          {
            "placement": "post_grades",
            "message_type": "LtiResourceLinkRequest"
          }
        ]
      }
    }
  ]
}

The redirect URL should be filled out automatically. If it is not, set it to https://www.wiris.net/client/lti/quizzes/tool.

Save the developer key. After saving it, copy the number in the “Details” column. That will be your Client ID.

Step 2: Register the application

Go to the Settings tab of your admin panel. Select the Apps tab. Click View Apps Configuration and add a new app. Select Configuration Type: By Client ID, paste the Client ID you got in the previous step.

Step 3: Get your deployment ID

After adding the app using the Client ID, click the settings wheel icon corresponding to WirisQuizzes on that same page and select Deployment ID to get your deployment id.

Step 4: Send your details to WIRIS

Send your Deployment ID and Client ID to support@wiris.com

Migrating your application from LTI 1.1 to 1.3

Step 1: Install WirisQuizzes as an LTI 1.3 application

Follow the above instructions to install WirisQuizzes as an LTI 1.3 tool. To differentiate it from the LTI 1.1 installation, you can rename the application, for example, to "WirisQuizzes LTI 1.3".

Step 2: Notify WIRIS that you want to migrate your application

Ensure both the client ID and deployment ID are included, as detailed in the instructions above. We will then schedule a migration date that aligns with your needs.

Please note: Once the migration begins, LTI 1.1 links will be inaccessible until your LTI 1.3 application setup is complete. This process typically takes under a day, and we suggest undertaking it during periods of low academic activity to minimize inconveniences to your users.

Step 3: Verify that your 1.3 installation is working

Verify the successful installation process by creating a new assignment using your WirisQuizzes LTI 1.3 application. Additionally, confirm that the "domain" field in your WirisQuizzes 1.1 application configuration is set to "wiris.net". This domain matching enables Canvas to migrate your LTI 1.1 content to LTI 1.3 launches.

Step 4: Delete the WirisQuizzes 1.1 application

Canvas will automatically detect that all your WirisQuizzes content needs to be launched using version 1.3 with matching domains. You can then verify the migration's success by launching existing WirisQuizzes 1.1 content.