1. Oversikt

Learning Tools Interoperability® (LTI®) gjør det mulig for Canvas å koble seg til eksterne læringsverktøy, som Inspera, på en enkel og sikker måte. Tilkoblingen støtter Canvas ved å sende informasjon på en standardisert måte til Inspera. Dette inkluderer brukerens rolle (instruktør eller kandidat) og kurset verktøyet ble startet fra. Det kan også opprette brukerkontoer i verktøyet ved oppstart, noe som fungerer både som registrering og enkel pålogging (SSO) i én enkel arbeidsflyt. I tillegg støtter LTI Advantage/1.3 overføring av karakterer fra Inspera til Canvas sin karakterbok.

Det er tre trinn for å konfigurere Canvas:

1. Konfigurasjon av en LTI-utviklernøkkel (developer key).
2. Konfigurer en ekstern app ved hjelp av klient-ID (Client ID).
3. Registrere plattformen (refererer til applikasjonen som ønsker å bruke funksjonaliteten levert av verktøyet) i Canvas.

2. Registrering og konfigurasjon av eksternt verktøy

Sikkerhetsmodellen for LTI Advantage- og LTI 1.3-tjenester er basert på OAuth 2.0 og OpenID Connect. Dette skiller seg fra tidligere versjoner av LTI-standarden, som brukte OAuth 1.0. Dette betyr at verktøyet og plattformen må registrere seg hos hverandre på forhånd før aktiviteter og kurs kan nås fra plattformen. Registrering skjer bare én gang manuelt når man setter opp en kobling mellom verktøyet og en plattform, og er i hovedsak en sikkerhetskontrakt mellom disse to respektive systemene.

1. Administrator - Tilgang til LTI-utviklernøkkel i Canvas og konfigurasjon

   For å konfigurere integrasjonen mellom Inspera og Canvas må du fullføre følgende oppsett i Inspera og Canvas.

   Merk: Dette er tilgjengelig for administratorer i Canvas.

   1. Klikk på Admin.

   2. Klikk på navnet på kontoen, f.eks. Inspera Assessment. 

      

   3. Klikk på Developer Keys.
   4. Klikk på +Developer Key-knappen.

   5. Velg +LTI Key fra rullegardinmenyen. 

      

      2.1.1 Administrator - Konfigurere LTI-integrasjon med Canvas

      Det er tre URL-er som kreves fra Inspera første gang for å sette opp LTI-tilkoblingen i din Canvas-instans. De er: 

      1. key-url: Dette refererer vanligvis til et sett med offentlige nøkler som brukes til autentisering og sikkerhetsformål.
      2. login-init: Når en bruker starter en påloggingsprosess fra LMS til et eksternt verktøy ved bruk av LTI 1.3, er initiate login URL endepunktet der denne prosessen begynner.
      3. redirect-url(s): Redirect URLs spesifiserer URL-ene der LMS-et skal videresende brukeren etter å ha fullført OAuth 2.0-autorisasjonsflyten.

      key-url	https://{domain}/ICSXapi/metadata/PublicCertificates
      login-init	https://{domain}/ltiprovider/init
      redirect-url(s)	https://{domain}/ltiprovider/launch

      Bruk URL-malene i den forrige tabellen og erstatt {domain} med din Inspera-adresse (tenancy) som skal settes opp for integrasjon.

      For eksempel, hvis din Inspera-adresse er demo.inspera.com, vil URL-ene være:

      key-url	https://demo.inspera.com/ICSXapi/metadata/PublicCertificates
      login-init	https://demo.inspera.com/ltiprovider/init
      redirect-url(s)	https://demo.inspera.com/ltiprovider/launch

      1. Skriv inn navnet på nøkkelen i feltet Key name, f.eks. Inspera Assessment.
      2. Skriv inn e-posten til personen som eier det eksterne verktøyet i feltet Owner Email.

      3. Skriv inn redirect-URL-en i feltet Redirect URIs, f.eks. redirect-url med formatet https://{domain}/ltiprovider/launch. 

         

      4. Velg Manual Entry fra rullegardinmenyen Method.
      5. Skriv inn navnet på det eksterne verktøyet i feltet Title, f.eks. Inspera.
      6. Skriv inn en beskrivelse av verktøyet i feltet Description, f.eks. Tilkobling til Inspera.
      7. Skriv inn redirect-url i feltet Target Link URI, f.eks. https://{domain}/ltiprovider/launch.
      8. Skriv inn feltet for OIDC-initiering / login-init i feltet OpenID Connect Initiation Url, f.eks. https://{domain}/ltiprovider/init.
      9. Velg Public JWK URL fra rullegardinmenyen JWK Method.

      10. Skriv inn key-url i feltet Public JWK URL, f.eks. https://{domain}/ICSXapi/metadata/PublicCertificates.
          Viktig: Sørg for at du har erstattet {domain} med URL-en til din Inspera-adresse.

           

      11. Klikk på dragspelsmenyen LTI Advantage Services for å vise innstillingene.
      12. Aktiver eller deaktiver tilleggsfunksjoner verktøyet tilbyr basert på din institusjons behov. Valgene i bildet under er valgt for å gjenspeile karakterer, oppgaver, innleveringer og brukerdata i Canvas.
          • Can create and view assignment data in the gradebook associated with the tool: Brukeren kan opprette nye oppgaver, se data knyttet til oppgavene og tilhørende data koblet til et spesifikt verktøy.
          • Can view assignment data in the gradebook associated with the tool: Brukeren kan se detaljert informasjon knyttet til oppgaver.
          • Can create and update submission results for assignments associated with the tool: Brukeren kan registrere og endre innleveringsresultater for studenters oppgaver.
          • Can retrieve user data associated with the context the tool is installed in: Brukeren kan hente informasjon om brukere knyttet til konteksten.
          • Can update public jwk for LTI services: Brukeren kan oppdatere meldingen som brukes for å sikre kommunikasjon mellom Canvas og eksterne verktøy.
          • Can lookup Account information: Applikasjonen kan hente informasjon knyttet til en Canvas-konto.
          • Can view submission data for assignments associated with the tool: Gir tilgang til å se informasjon knyttet til studentinnleveringer i et spesifikt verktøy.

          • Can view Progress records associated with the context the tool is installed in: Indikerer at verktøyet kan se eller registrere data knyttet til studenten. 

            

      13. Klikk på dragspelsmenyen Additional Settings for å vise innstillingene.

      14. Sett Privacy Level til enten Public eller Private etter din institusjons behov.

          Merk: Som standard er Privacy Level satt til Private.

          Å sette denne til 'Private' kan hindre LTI-integrasjonen ved å blokkere brukerinformasjon fra LMS-et til applikasjonen.

      15. Valgfritt: skriv inn eventuelle egendefinerte parametere i feltet Custom Fields. For mer informasjon, se artikkelen om Egendefinerte parametere.
      16. Velg Link Selection og Assignment Selection fra rullegardinmenyen Placements.
          • Link Selection: Legg til hyperlenker i kursinnholdet.

          • Assignment Selection: Opprettelse eller valg av oppgaver i et Canvas-kurs.

            Merk: For mer informasjon, se Canvas hjelpedokument. 

            

      17. Klikk på dragspelsmenyen Link Selection for å vise innstillingene.
      18. Skriv inn redirect-url i feltet Target Link URI, f.eks. https://{domain}/ltiprovider/launch.
          Merk: Dette er den samme lenken som ble lagt inn i trinn 7.

      19. Klikk på Save-knappen. 

          

2. Administrator - Vis LTI-utviklernøkkel i Canvas

   Når du lagrer endringene, vil detaljene for utviklernøkkelen (Developer Key) vises.

   1. Kopier Client ID i Details-kolonnen, da denne vil kreves under konfigurasjonen.

   2. Klikk på State-knappen for å aktivere den (sette til "On"), slik at LTI-nøkkelen kan brukes til integrasjonen. 

      

3. Administrator - Konfigurer en ekstern app ved hjelp av Client ID

   Eksterne apper som støtter LTI 1.3 og LTI Advantage krever konfigurasjon ved hjelp av en Client ID. Denne finner du etter at det eksterne verktøyet har blitt konfigurert i 2.1 Administrator - Tilgang til LTI-utviklernøkkel i Canvas.

   1. Klikk på Admin.

   2. Klikk på navnet til kontoen, f.eks. Inspera Assessment. 

      

   3. Klikk på Settings (Innstillinger).
   4. Klikk på fanen Apps.

   5. Klikk på knappen View App Configurations. 

      

   6. Klikk på knappen +App.
   7. Velg By Client ID fra rullegardinmenyen Configuration Type.
   8. Skriv inn Client ID i tekstfeltet for Client ID. For mer informasjon, se seksjonen 2.2 Administrator - Vis LTI-utviklernøkkel i Canvas.

   9. Klikk på Submit-knappen.
      Merk: Hvis klient-ID-en ikke blir funnet i din kontos Developer Keys, vil Canvas vise en feilmelding om at LTI configuration for client ID <numre> ikke ble funnet. Hvis dette skjer, kontroller at informasjonen ble tastet inn riktig ved å se på seksjonen 2.2 Administrator - Vis LTI-utviklernøkkel i Canvas. 

      

   10. Klikk på Install-knappen. 

       

   11. Etter installasjon av appen må verdiene i neste seksjon deles med Inspera for å fullføre konfigurasjonen.

4. Administrator - Konfigurasjon av Inspera Assessment

   Inspera trenger følgende informasjon fra Canvas. Vennligst kontakt Inspera Support for å konfigurere disse oppdateringene for din spesifikke Inspera-instans.

   De spesifikke Canvas-verdiene skal konfigureres i Inspera for å fullføre oppsettet av eksternt verktøy på både Canvas og Inspera.

   Client ID	En unik Client ID for verktøyet opprettet som en del av den opprinnelige verktøyregistreringen i Canvas. Denne finner du i 2.2 Administrator - Vis LTI-utviklernøkkel i Canvas.
   Issuer/Platform	https://canvas.instructure.com (eller din spesifikke utsteder-URL)
   Canvas Keyset URL	https://<canvas-domene>/api/lti/security/jwks
   Canvas OAuth2 Access token URL	https://<canvas-domene>/login/oauth2/token
   OpenID Connect Authentication Endpoint Keyset URL	https://<canvas-domene>/api/lti/authorize_redirect
   Deployment ID	Unik ID

5. Lærer - Legge til en aktivitet der poeng overføres til Canvas sin karakterbok

   Inspera Assessment overfører totalpoeng etter at prøvestatusen er satt til Vurdert (Graded) i Inspera.

   Canvas-integrasjonen med Inspera Assessment kan settes opp slik at poeng fra Inspera overføres tilbake til Canvas sin karakterbok (Gradebook).

   1. Logg inn i Canvas som instruktør (Instructor).
   2. Åpne det aktuelle kurset.

   3. Naviger til en eksisterende modul og klikk på ikonet Legg til element i modul (Add item to module), og fortsett deretter til trinn 8. 

      Merk: Alternativt kan du klikke på + Module-knappen for å opprette en modul, klikke på Add item to module-ikonet og fortsette fra trinn 4.

   4. Velg Oppgave (Assignment) fra Add-rullegardinmenyen.
   5. Klikk på [ Create Assignment ].
   6. Skriv inn navnet på prøven som er opprettet/skal opprettes i feltet Assignment Name.

   7. Klikk på Add Item-knappen. 

      

   8. Klikk på Publiser (Publish)-ikonet på elementet.
      1. Dette bør først gjøres etter at prøven er aktivert i Inspera.
      2. Ikonet vil bli en grønn sirkel med en hake inni.

   9. Klikk på det opprettede elementet. 

      

   10. Klikk på Rediger (Edit)-knappen. 

       

   11. Skriv inn totalt antall poeng i feltet Points.

       Merk: Sørg for at totalpoengene er de samme i både Canvas og Inspera Assessment. Hvis for eksempel en prøve i Inspera har 40 poeng, men er satt til 10 poeng i Canvas, og en student får 27 av 40 poeng i Inspera, vil studenten se 27 poeng i Inspera, men 6,75 poeng i Canvas.

   12. I seksjonen Submission Type, velg External Tool fra rullegardinmenyen.
   13. Klikk på Find-knappen.
   14. Velg det aktuelle eksterne verktøyet (External Tool) fra listen.

   15. Klikk på Select-knappen. 

       

   16. Valgfritt: huk av for Load This Tool In A New Tab.
   17. Fyll ut de andre feltene etter behov.

   18. Klikk på Save-knappen. 

       

   19. Klikk på aktivitetsnavnet for å åpne siden for prøvelevering (Deliver) i Inspera.

6. Lærer - Legge til en aktivitet der poeng ikke skal overføres til Canvas sin karakterbok

   Noen ganger er det ikke et krav at poeng fra Inspera Assessment skal overføres til Canvas sin karakterbok. Følg disse trinnene for å sikre at poeng ikke blir overført.

   1. Logg inn i Canvas som instruktør (Instructor).
   2. Åpne det aktuelle kurset.

   3. Naviger til en eksisterende modul og klikk på ikonet Legg til element i modul (Add item to module). 

      Merk: Alternativt kan du klikke på + Module-knappen for å opprette en modul og deretter klikke på Add item to module-ikonet.

   4. Velg External Tool fra Add-rullegardinmenyen.
   5. Velg det aktuelle eksterne verktøyet (External Tool) fra listen.

   6. Klikk på Add Item-knappen. 

      

   7. For elementet, klikk på de tre vertikale prikkene.

   8. Klikk på Rediger (Edit). 

      

   9. Gi nytt navn til tittelen i feltet Title.
   10. Huk av for Load in a new tab.

   11. Klikk på Update-knappen. 

       

   12. Klikk på Publiser (Publish)-ikonet på elementet.
       • Dette bør først gjøres etter at prøven er aktivert i Inspera.
       • Ikonet vil bli en grønn sirkel med en hake inni.

   13. Klikk på aktivitetsnavnet for å åpne siden for prøvelevering (Deliver) i Inspera. 

       

7. Lærer - Utforme vurdering

   1. Logg inn i Canvas som instruktør (Instructor).
   2. Naviger til det aktuelle kurset.

   3. Klikk på den aktuelle aktiviteten. 

      

   4. Klikk på knappen Last inn [tittel] i et nytt vindu (Load [title] in a new window). 

      

   5. Siden for prøvelevering (Deliver) i Inspera vil vises, der du kan konfigurere innstillingene for prøven. For mer informasjon, se artikkelen Deliver overview.

8. Kandidat – Hvordan gjennomføre en prøve i Inspera Assessment via Canvas

   Kandidater kan gjennomføre prøver i Inspera Assessment direkte fra Canvas.

   1. Logg inn i Canvas som kandidat.
   2. Naviger til det aktuelle kurset.

   3. Klikk på den aktuelle aktiviteten. 

      

   4. Klikk på knappen Last inn [tittel] i et nytt vindu. 

      

   5. Gjennomfør prøven og lever svar som vanlig i Inspera Assessment.

   Når prøven er rettet og poengene er bekreftet av sensor, vil kandidaten kunne se resultatene sine på kandidat-dashbordet i Inspera Assessment og i Canvas sin karakterbok, hvis aktivert.

   Inspera: For å aktivere visning av poeng i Inspera Assessment, gå til Lever (Deliver) og huk av for Vis endelige poeng eller karakterer på kandidatens instrumentpanel i Innstillinger etter prøven.

   Canvas: Aktiver karakterbok-tjenestene under LTI Advantage services. 

   For mer informasjon, se seksjon 2.1.1 Administrator - Konfigurere en LTI-utviklernøkkel i Canvas.

3. FAQ

1. I et slikt tilfelle bør følgende trinn følges:

   1. For å sikre at karakterer reflekteres av verktøyet i Canvas sin karakterbok under LTI Advantage Services, er det avgjørende å velge alternativet "Can create and view assignment data in the gradebook associated with the tool."

      For mer informasjon, se seksjon 2.1.1 Administrator - Konfigurere en LTI-utviklernøkkel i Canvas.

   2. Vennligst sørg for at prøven er vurdert i Inspera Assessment. Vurderingen må være bekreftet for å muliggjøre overføring av poeng/karakterer.

2. Hvis du opplever at Save-knappen ikke fungerer, er den sannsynlige årsaken at siden beholder økten selv etter at feil er rettet. En løsning på dette er som følger:

   1. Åpne en ny fane eller side spesifikt for nøkkelinnstillingene relatert til LTI-utviklernøkkelen.
   2. Legg inn de riktige detaljene for LTI-utviklernøkkelen.
   3. Klikk på Save-knappen.

   Kontakt support hvis problemet vedvarer.