Algemene LTI 1.3 documentatie: gebruikersbeheer

Learning Tool Interoperability (LTI) is een standaard die de workflow van je toets administratie efficiënter maakt. Eén van de doelen van LTI is om gebruikers automatisch te voorzien in Ans. Met andere woorden: accounts hoeven niet handmatig aangemaakt te worden, omdat de integratie dit automatisch regelt.

Wanneer je een LTI-integratie gebruikt wordt er een link gemaakt tussen het Learning Management System (LMS) en Ans. Wanneer een gebruiker op een LTI-link klikt, wordt er een verzoek naar Ans gestuurd. In dit verzoek ontvangt Ans de volgende attributen in de backend. Sommige attributen zijn zichtbaar in de interface, maar sommige niet. Deze worden opgeslagen in Ans en worden gebruikt in de backend.

• LTI Integratie ID (niet zichtbaar in Ans)
• LTI Gebruiker ID (niet zichtbaar in Ans)
• Voornaam van de gebruiker (zichtbaar als voornaam in Ans)
• Achternaam (zichtbaar als achternaam in Ans)
• E-mail (zichtbaar als e-mailadres in Ans)
• Rol (zichtbaar als rol in Ans, kan student of medewerker zijn)
• Person Sourcedid (zichtbaar als studentnummer in Ans)
• Optioneel aangepast attribuut: "student_number" (zichtbaar als studentnummer in Ans)

Als een gebruiker probeert in te loggen op Ans door op een LTI-link te klikken, gebruikt Ans verschillende stappen om te controleren of de gebruiker al bestaat. Als de gebruiker niet bestaat zal Ans de gebruiker aanmaken. Als de gebruiker wel bestaat, worden de gebruikersgegevens bijgewerkt. In de volgende lijst met stappen zijn er meerdere momenten waarop Ans probeert een nieuw account aan te maken of informatie te matchen met een bestaand account. De volgende twee richtlijnen kunnen hierbij in acht worden genomen:

• Als de gebruikersrol in het LMS geen student is, maar bijvoorbeeld docent, beheerder of een andere niet-student rol, zal Ans de rol 'Medewerker' aan deze gebruiker geven. Het attribuut 'Person Sourcedid' en het optionele aangepaste attribuut "student_number" worden genegeerd.
• Als er niet-numerieke waarden aanwezig zijn in het aangepaste attribuut "student_number", worden deze waarden uit de waarde verwijderd, zodat alleen numerieke waarden overblijven.

Een gebruiker aanmaken

Zodra een gebruiker op de LTI-link klikt, worden de volgende stappen gestart:

1. Wanneer een LTI-verzoek van het LMS naar Ans wordt gestuurd, wordt er een versleuteld bericht verzonden met daarin de vak-, toets- en gebruikersinformatie. Als Ans dit versleutelde bericht niet ontvangt, wordt er een foutmelding weergegeven met de tekst "Missing platforms' identifier token".
2. Op basis van de LTI Integratie-ID probeert Ans de juiste school te vinden. Als de juiste school wordt gevonden, zal Ans de gebruiker in die school matchen of aanmaken. Als de school niet wordt gevonden, wordt er een foutmelding weergegeven met de tekst "Forbidden".
3. Ans probeert de attributen die vanuit het LMS zijn verzonden en de vak-, toets- en gebruikersinformatie te ontsleutelen. Als Ans de attributen niet kan ontsleutelen, wordt er een foutmelding weergegeven met de tekst "Unable to decrypt message". Dit gebeurt wanneer de integratie verkeerd is geconfigureerd.
4. Ans probeert de gebruiker te matchen met de LTI Gebruikers-ID. De matching is succesvol als de gebruiker eerder een LTI-link heeft gebruikt, omdat dit de enige manier is waarop het attribuut wordt ingevuld in Ans. Als er een bestaande gebruiker wordt gevonden, worden de voornaam, achternaam en het e-mailadres ingevuld of overschreven.
5. Als de LTI Gebruikers-ID niet kan worden gevonden, betekent dit dat de gebruiker nog geen LTI-link heeft gebruikt. In dat geval probeert Ans de gebruiker te vinden op basis van het studentnummer. Ans controleert eerst het optionele aangepaste attribuut "student_number". Als dat veld niet is ingevuld, controleert Ans het attribuut 'Person Sourcedid'. Als dit attribuut wordt gevonden, vult of overschrijft Ans de voornaam, achternaam en het e-mailadres. Bovendien vult Ans het veld LTI Gebruikers-ID in.
6. Als er geen gebruiker wordt gevonden op basis van een van de attributen van het studentnummer, probeert Ans een gebruiker te vinden op basis van het e-mailadres. Als er een gebruiker wordt gevonden, worden de voornaam en achternaam overschreven. Bovendien vult Ans het veld LTI Gebruikers-ID in.
7. Als Ans de gebruiker niet kan vinden op basis van de LTI Gebruikers-ID, het studentnummer of het e-mailadres, maakt Ans een nieuwe gebruiker aan.

Nadat er een account is gematcht of aangemaakt, wordt de gebruiker doorgestuurd naar Ans. Studenten worden doorgestuurd naar de pagina waar ze de toets kunnen starten. Medewerkers worden doorgestuurd naar de pagina waar ze de digitale toets kunnen bewerken.

Hieronder vind je een visuele weergave van het proces, inclusief fouten die zich tijdens het proces kunnen voordoen.

Geef vak rollen aan gebruikers

Zoals beschreven in het artikel over rollen in Ans, zijn er school rollen, vak rollen en itembank rollen. Hierboven hebben we beschreven dat een gebruiker de school rol 'Student' of 'Medewerker' krijgt als de gebruiker nog niet bestaat. Ans gebruikt de LTI 1.3 Names and Role Provisioning Services om ook vak rollen te verstrekken. Afhankelijk van de rol die de gebruiker heeft in het LMS, zal Ans de vak rol voor die gebruiker verstrekken. Momenteel zijn er twee opties voor gebruikers. Op dit moment controleren we of de gebruiker een van de volgende rollen heeft in het LMS: Docent, Beheerder, Contentontwikkelaar, Personeel, Faculteit of Mentor. Als dit het geval is krijgt de gebruiker de rol Docent in het vak. Als de gebruiker een andere rol heeft, krijgt de gebruiker de vak rol Student.

error_outlineOp dit moment houdt Ans geen rekening met instellingen met betrekking tot de rechten van medewerkers, studenten of aangepaste rollen. De hierboven genoemde regels zijn altijd van toepassing.  

error_outlineProvisioning via LTI kan worden gebruikt om gebruikers toe te voegen aan een vak en een toets. Het kan niet worden gebruikt om groepen binnen een vak aan te maken.