Als beheerder kunt u deze handleiding gebruiken om veelvoorkomende problemen met de LTI 1.3-integratie te identificeren en op te lossen.
Standaardcontroles uitvoeren in Lumina
Als beheerder kunt u standaardcontroles uitvoeren om te controleren of de configuratieparameters in Lumina en uw leermanagementsysteem (LMS) overeenkomen, aangezien LTI 1.3 een tweezijdige configuratie vereist.
- Neem contact op met uw Account Manager om ervoor te zorgen dat LTI 1.3 is ingeschakeld voor uw instelling.
- Meld u als beheerder aan bij Lumina.
- Klik op de knop Hoofdmenu > Admin Paneel.
- Selecteer in de zijbalk Integraties.
- Zorg ervoor dat alle parameters overeenkomen met de informatie die door uw LMS is gegenereerd.
Veelvoorkomende fouten oplossen
Als beheerder kunt u dit gebruiken om veelvoorkomende LTI 1.3-integratiefouten en de stappen om ze op te lossen te vinden.
- Uw YuJa-integratie met het LMS voor LTI 1.3 heeft geen geldige ISS opgegeven: Controleer of de ISS en de Client ID juist zijn. Ga hiervoor naar Admin Paneel > Integraties > LMS via LTI 1.3.
- Uw YuJa-integratie met het LMS voor LTI 1.3 heeft de aanmelding niet met alle informatie gestart. De fout is: er moet een ondertekeningssleutel worden opgegeven als de opgegeven JWT digitaal is ondertekend: Controleer of de Deployment ID en het JWKS-endpoint juist zijn. Ga hiervoor naar Admin Paneel > Integraties > LMS via LTI 1.3.
- Authenticatieschema niet geconfigureerd voor uw organisatie voor LTI 1.3: Neem contact op met uw YuJa Account Manager om de LTI 1.3-integratie voor uw organisatie in te schakelen.
- Uw YuJa-integratie met het LMS voor LTI 1.3 heeft de aanmelding niet met alle informatie gestart: Dit gebeurt wanneer tijdens het startverzoek enkele verplichte tags voor LTI 1.3 ontbreken. Controleer of de huidige versie van uw LMS compatibel is met LTI 1.3.
- LTI-versieclaim ontbreekt in het startverzoek: Dit gebeurt wanneer de versieclaim ontbreekt. Neem contact op met het ondersteuningsteam van uw LMS om dit probleem op te lossen.
- Onjuiste LTI-versie doorgegeven aan het LTI 1.3-startverzoek: Dit gebeurt wanneer de versieclaim onjuist is. Neem contact op met het ondersteuningsteam van uw LMS om dit probleem op te lossen.
- Ongeldige JWT. Kritieke claims van LTI 1.3 ontbreken in het verzoek: Dit gebeurt wanneer de Sub-claim ontbreekt. Neem contact op met het ondersteuningsteam van uw LMS om dit probleem op te lossen.
-
Een of meer van de vereiste claims ontbreken in het LTI 1.3-startverzoek:
- Berichttype
- LTI
- Deployment ID
- Target link URI
- Resource link ID
- LTI-gebruikers-ID
- LTI-rollen
- Ongeldige IAT- en/of EXP-waarden doorgegeven in het LTI 1.3-verzoek / Ongeldige IAT- en/of exp-velden in het LTI 1.3-startverzoek: Dit gebeurt wanneer het verzoek een verlopen tijdstempel bevat.
- KID niet ingesteld in de header: Dit gebeurt wanneer de ondertekeningssleutel ontbreekt tijdens het startverzoek. Neem contact op met het ondersteuningsteam van uw LMS om dit probleem op te lossen.
- Onjuiste KID opgegeven: De KID wordt gebruikt om de bijbehorende sleutel op te halen waarmee berichten van het LMS naar Lumina worden ontsleuteld. Een onjuiste KID kan komen door een onjuiste Deployment ID in het LMS. Bij sommige LMS-systemen zijn Deployment ID en KID losgekoppeld. In dat geval is nader onderzoek door zowel het LMS als YuJa nodig.
- Onjuiste handtekening - JWT kan niet worden gevalideerd: Dit gebeurt wanneer de JWT-sleutel-URL onjuist is geconfigureerd. Controleer of alle andere parameters, waaronder ISS, Deployment ID en Client ID, juist zijn.
- Openbare RSA-sleutel niet gevonden voor de opgegeven ISS: Dit gebeurt wanneer de JWT-sleutel-URL onjuist is geconfigureerd. Controleer of alle andere parameters, waaronder ISS, Deployment ID en Client ID, juist zijn.
- Onjuiste handtekening, state-JWT kan niet worden gevalideerd: Dit gebeurt wanneer de JWT-sleutel-URL onjuist is geconfigureerd. Controleer of alle andere parameters, waaronder ISS, Deployment ID en Client ID, juist zijn.
-
YuJa-URL weigerde verbinding te maken: Dit gebeurt wanneer de integratie geen gebruikersaccount kan identificeren om mee te verbinden. Hiervoor zijn twee veelvoorkomende redenen.
- Als het om een nieuwe gebruiker gaat, ga dan naar de pagina Admin Paneel > Integraties > LMS via LTI 1.3 om te controleren of het automatisch aanmaken van een nieuw gebruikersaccount is ingeschakeld.
- Als een bestaande gebruiker moet worden gekoppeld via het e-mailadres van de gebruiker, controleer dan of meerdere gebruikers hetzelfde e-mailadres delen. Neem contact op met uw YuJa Account Manager om dit probleem op te lossen.