This page will provide Administrators with the list of common LTI 1.3 issues and how to resolve them.
Standard Checks
- The LTI 1.3 is a two-way configuration between your Learning Management System (LMS) and the Video Platform. For that reason, the parameters have to match between the two instances.
- Contact your YuJa Customer Success Manager to ensure that your institution has LTI 1.3 enabled.
- Navigate to your Admin Panel in the Video Platform and ensure that all the parameters on the Integrations page match with the information generated by your LMS.
Common Errors
Below is the list of all the common errors with the LTI 1.3 integration and all the steps needed to resolve them.
- Your LMS YuJa Integration for LTI 1.3 did not provide a valid ISS: Ensure the ISS and Client ID are correct. You can check this through the Video Platform's Admin Panel > Integrations > LMS via LTI 1.3.
- Your LMS YuJa Integration for LTI 1.3 did not Initiate Login with all the Information. Error is - A signing key must be specified if the specified JWT is digitally signed: Ensure the Deployment ID and JWKS Endpoint are correct. You can check this through the Video Platform's Admin Panel > Integrations > LMS via LTI 1.3.
- Authentication scheme not configured for your Organization for LTI 1.3: Please contact your YuJa Customer Success Manager to enable LTI 1.3 integration for your Organization.
- Your LMS YuJa Integration for LTI 1.3 did not initiate Login with all the information: This happens when some mandatory tags for LTI 1.3 are missing during Launch request. Please check for compatibility between the current version of your LMS and LTI 1.3.
- LTI Version claim missing in the Launch request: This happens when Version Claim is missing. Please check with your LMS's support on how to resolve this issue.
- Incorrect LTI Version passed to LTI 1.3 Launch request: This happens when the Version Claim is incorrect. Please check with your LMS's support on how to resolve this issue.
- Invalid JWT. Critical claims of LTI 1.3 missing in request: This happens when Sub claim is missing. Please check with your LMS's support on how to resolve this issue.
- One or more of the Required Claims are missing in the LTI 1.3 Launch request: Mandatory claims of LTI 1.3 are as follows.
- Message type.
- LTI.
- Deployment ID.
- Target link URI.
- Resource link ID.
- LTI user ID.
- LTI roles.
- Invalid IAT and/or EXP values passed in the LTI 1.3 request /Invalid IAT and/or exp fields in the LTI 1.3 Launch request: This happens when the request carries an expired timestamp.
- KID not set in the header: This happens when the signing key is missing during the Launch request. Please check with your LMS's support on how to resolve this issue.
- Incorrect KID provided: KID is used to retrieve the matching key to decrypt messages sent by LMS to the Video Platform. Incorrect KID could be due to incorrect Deployment ID within the LMS. Some LMS has decoupled Deployment ID and KID. If this is the case, it will require further investigation from both LMS and YuJa.
- Incorrect Signature - Unable to Validate JWT: This happens when the JWT key URL is incorrectly configured. Make sure all other parameters including ISS, Deployment ID and Client ID are also correct.
- RSA Public key not found for the given ISS: This happens when the JWT key URL is incorrectly configured. Make sure all other parameters including ISS, Deployment ID and Client ID are also correct.
- Incorrect Signature unable to validate state JWT: This happens when the JWT key URL is incorrectly configured. Make sure all other parameters including ISS, Deployment ID and Client ID are also correct.
- YuJa URL refused to connect: This happens when the integration cannot identify a user account to connect. There are two common reasons for this.
- If this is a new user, the log into the Admin Panel > Integrations > LMS via LTI 1.3 page to check if automatic provisioning of a new user account is enabled.
- If this is to link an existing user by using the user's email, check if there are multiple users that share the same email address. Please reach out to your YuJa Customer Success Manager to get this resolved.