För att lärosätet ska kunna använda tjänsten för resultatrapportering Canvas-Ladok behöver vissa förutsättningar vara uppfyllda:

Ansluten till Ladok LIS-Adapter

Lärosätet kommer att behöva ansluta sig till Ladok-LIS adapter (se: Ladok LIS-adapter) men endast för resultatdelen. Det går bra för lärosätet att fortsätta använda sin egen integration mot Ladok parallellt. Sunet hjälper till att ansluta lärosätet till Ladok LIS-adapter.

Förutsättningar i Canvas

Följande förutsättningar behöver finnas i lärosätets Canvas:

Åtkomsttoken

En åtkomsttoken behöver genereras, under en dedikerad användare, i lärosätets Canvas. Detta för att LTI-appen ska kunna komma åt Canvas REST API.

Identifiering av kurstillfälle

Något av följande måste gälla:

• Kurstillfällets Ladok-uid satt på sektionens sis_section_id i Canvas kursrum (om Canvas-adaptern används är detta satt)
• Kurstillfällets Ladok-uid satt på sektionens integration_id i Canvas kursrum

Antingen anges kurstillfällets Ladok-uid ensamt, eller först i en sträng skiljt av _ (understreck). T.ex. b07dbcdc-a514-4c8e-bf5a-b2fe13d9a2f9_eventuell_ytterligare_lagrad_information

Identifiering av student

Något av följande måste gälla:

• Studentens Ladok-uid satt på användarens sis_user_id (om Canvas-adaptern används är detta satt)
• Studentens Ladok-uid satt på användarens integration_id
• Studentens personnummer satt på användarens sis_user_id

Identifiering av lärare

Något av följande måste gälla:

• Lärarens EduPersonPrincipalName (t.ex. abcd0123@umu.se) satt på användarens login_id.  Detta fungerar både med eller utan scope (abcd0123). I det senare fallet kan scopet (umu.se) anges i konfigurationen av appen.
• Lärarens Ladok-uid satt på användarens sis_user_id
• Lärarens Ladok-uid satt på användarens integration_id

Förutsättningar i Ladok

Följande förutsättningar behöver finnas lärosätets Ladok.

Certifikat/API-användare

Ett certifikat behöver utfärdas av lärosätets Ladok som LTI-appen sedan behöver för att komma åt Ladoks REST API. Följande rättigheter ska ges till användaren:

• Resultat: läsa information
• Kataloginformation: läsa information
• Kataloginformation: läsa användare och behörigheter
• Behörighetshantering: Agera ombud för användare

Lärare

Läraren ska ha rättighet att rapportera resultat på den student den valt att rapportera på inne i Canvas. Finns inte denna rättighet ges information om detta på studentens rad inne i appen och det går inte för läraren att välja studenten för rapportering.

Installation

Om ovanstående förutsättningar finns kan lärosätet använda resultatrapporteringen.

Lärosätet skickar till Sunet

• Åtkomsttoken för Canvas REST API.
• Information om hur identifieringen av de olika Ladok-entiteterna (kurstillfälle, student och lärare) är mappade i Canvas.
• Ladok-certifikat
• Om så önskas, en e-postadress till en funktionsbrevlåda som kan ta emot samma e-postmeddelande läraren får efter hen utfört en resultatrapportering.

Sunet skickar till lärosätet

• XML-data för installation av LTI-appen inne i Canvas.