Canvas LTI 1.3 – Integration med Inspera Assessment

  • Uppdaterad

1. Översikt

Learning Tools Interoperability® (LTI®) gör det möjligt för Canvas att ansluta till externa lärverktyg såsom Inspera på ett enkelt och säkert sätt. Anslutningen stödjer Canvas genom att skicka information till Inspera på ett standardiserat sätt. Detta inkluderar användarens roll (instruktör eller kandidat) och den kurs som de startade verktyget ifrån. Det kan även skapa användarkonton i verktyget vid start, vilket fungerar som både en registrering och en "single sign-on" (SSO) i ett smidigt arbetsflöde. Dessutom stödjer LTI Advantage/1.3 återrapportering av resultat från Inspera till Canvas betygsbok.

Det krävs tre steg för att konfigurera Canvas:

  1. Konfiguration av en LTI-utvecklarnyckel (developer key).
  2. Konfigurera en extern app med hjälp av klient-ID (Client ID).
  3. Registrera plattformen (syftar på applikationen som vill använda funktionaliteten som verktyget tillhandahåller) i Canvas.

2. Registrering och konfiguration av externt verktyg

Säkerhetsmodellen för LTI Advantage- och LTI 1.3-tjänster är baserad på OAuth 2.0 och OpenID Connect. Detta skiljer sig från tidigare versioner av LTI-standarden, vilka använde OAuth 1.0. Detta innebär att verktyget och plattformen måste registrera sig hos varandra i förväg innan aktiviteter och kurser kan kommas åt från plattformen. Registrering sker endast en gång manuellt när man sätter upp en länk mellan verktyget och en plattform, och är i huvudsak ett säkerhetsavtal mellan dessa två respektive system.

Viktig information vid kopiering och inklistring av URL:er

När du kopierar och klistrar in URL:er, se till att det inte finns några mellanslag före eller efter; extra mellanslag kan orsaka brutna länkar, åtkomstfel och förstöra LTI-konfigurationen.

  1. Administratör - Tillgång till LTI-utvecklarnyckel i Canvas och konfiguration

    För att konfigurera integrationen mellan Inspera och Canvas, slutför följande inställningar i Inspera och Canvas.

    Obs: Detta är tillgängligt för administratörer i Canvas.

    1. Klicka på Admin.

    2. Klicka på namnet för kontot, t.ex. Inspera Assessment. 

    3. Klicka på Developer Keys.
    4. Klicka på knappen +Developer Key.

    5. Välj +LTI Key från rullgardinsmenyn. 

      2.1.1 Administratör - Konfigurera LTI-integration med Canvas

      Det krävs tre URL:er från Inspera första gången för att ställa in LTI-anslutningen i din Canvas-instans. Dessa är: 

      1. key-url: Detta syftar vanligtvis på en uppsättning offentliga nycklar som används för autentisering och säkerhetsändamål.
      2. login-init: När en användare initierar en inloggningsprocess från LMS till ett externt verktyg via LTI 1.3, är initiate login URL slutpunkten där denna process börjar.
      3. redirect-url(s): Omdirigerings-URL:er anger de URL:er dit LMS ska omdirigera användaren efter att ha slutfört OAuth 2.0-auktoriseringsflödet.
      key-url https://{domain}/ICSXapi/metadata/PublicCertificates
      login-init  https://{domain}/ltiprovider/init 
      redirect-url(s)  https://{domain}/ltiprovider/launch 

      Använd URL-mallarna i föregående tabell och ersätt {domain} med den Inspera-miljö (tenancy) som ska integreras. 

      Till exempel, om din Inspera-miljö har URL:en demo.inspera.com, skulle URL:erna vara:

      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. Ange nyckelns namn i textfältet Key name t.ex. Inspera Assessment.
      2. Ange e-postadressen till ägaren av det externa verktyget i fältet Owner Email.

      3. Ange omdirigerings-URL i fältet Redirect URIs t.ex. omdirigerings-URL:en med formateringen https://{domain}/ltiprovider/launch. 

      4. Välj Manual Entry i rullgardinsmenyn Method.
      5. Ange namnet på det externa verktyget i fältet Title t.ex. Inspera.
      6. Ange en beskrivning av verktyget i fältet Description t.ex. Anslutning till Inspera.
      7. Ange omdirigerings-URL i fältet Target Link URI t.ex. https://{domain}/ltiprovider/launch.
      8. Ange fältet för OIDC-initiering / login-init i fältet OpenID Connect Initiation Url t.ex. https://{domain}/ltiprovider/init.
      9. Välj Public JWK URL i rullgardinsmenyn JWK Method.

      10. Ange key-url i fältet Public JWK URL t.ex. https://{domain}/ICSXapi/metadata/PublicCertificates.
        Viktigt: Se till att du har ersatt {domain} med URL:en till din Inspera-miljö.

         

      11. Klicka på dragspelsmenyn LTI Advantage Services för att visa inställningarna.
      12. Aktivera eller inaktivera ytterligare funktioner som verktyget tillhandahåller baserat på din institutions krav. Alternativen i bilden nedan har valts för att återspegla poäng, uppgifter, inlämningar och användardata i Canvas.
        • Can create and view assignment data in the gradebook associated with the tool: Användaren kan skapa nya uppgifter, se data kopplade till uppgifterna samt tillhörande data länkad till ett specifikt verktyg.
        • Can view assignment data in the gradebook associated with the tool: Användaren kan se detaljerad information kopplad till uppgifter.
        • Can create and update submission results for assignments associated with the tool: Användaren kan registrera och ändra inlämningsresultat för studenters uppgifter.
        • Can retrieve user data associated with the context the tool is installed in: Användaren kan hämta information om användare kopplade till kontexten.
        • Can update public jwk for LTI services: Användaren kan uppdatera meddelandet som används för att säkra kommunikationen mellan Canvas och externa verktyg.
        • Can lookup Account information: Applikationen kan hämta information relaterad till ett Canvas-konto.
        • Can view submission data for assignments associated with the tool: Indikerar åtkomst till att granska information relaterad till studentinlämningar inom ett specifikt verktyg i Canvas.

        • Can view Progress records associated with the context the tool is installed in: Indikerar att verktyget kan se eller registrera data relaterad till studenten. 

      13. Klicka på dragspelsmenyn Additional Settings för att visa inställningarna.

      14. Ställ in Privacy Level till antingen Public eller Private baserat på din institutions krav.

        Obs: Som standard är Privacy Level inställd på Private.

        Att ställa in detta till 'Private' kan hindra LTI-integrationen genom att blockera användarinformation från LMS till applikationen.

      15. Valfritt: ange valfria anpassade parametrar i fältet Custom Fields. För mer information, se artikeln om anpassade parametrar.
      16. Välj Link Selection och Assignment Selection i rullgardinsmenyn Placements.
        • Link Selection: Lägg till hyperlänkar i kursinnehållet.

        • Assignment Selection: Skapande eller val av uppgifter inom en Canvas-kurs.

          Obs: För mer information, se Canvas hjälpdokument. 

      17. Klicka på dragspelsmenyn Link Selection för att visa inställningarna.
      18. Ange omdirigerings-URL i fältet Target Link URI t.ex. https://{domain}/ltiprovider/launch.
        Obs: Detta är samma länk som angavs i steg 7.

      19. Klicka på knappen Save. 

  2. Administratör - Visa LTI-utvecklarnyckel i Canvas

    När ändringarna sparats visas detaljerna för Developer Key (utvecklarnyckeln).

    1. Kopiera Client ID i kolumnen Details eftersom det kommer att krävas vid konfigurationen.

    2. Klicka på knappen State för att aktivera den (sätt till ON) så att LTI-nyckeln kan användas för integrationen. 

  3. Administratör - Konfigurera en extern app med hjälp av klient-ID

    Externa appar som stöder LTI 1.3 och LTI Advantage kräver konfiguration med ett klient-ID (Client ID). Detta ID kan hittas efter att det externa verktyget har konfigurerats i avsnitt 2.1 Administratör - Tillgång till LTI-utvecklarnyckel i Canvas.

    1. Klicka på Admin.

    2. Klicka på namnet för kontot, t.ex. Inspera Assessment. 

    3. Klicka på Inställningar (Settings).
    4. Klicka på fliken Appar (Apps).

    5. Klicka på knappen Visa appkonfigurationer (View App Configurations). 

    6. Klicka på knappen +App.
    7. Välj Efter klient-ID (By Client ID) i rullgardinsmenyn Konfigurationstyp (Configuration Type).
    8. Ange klient-ID (Client ID) i textfältet. För mer information, se avsnitt 2.2 Administratör - Visa LTI-utvecklarnyckel i Canvas.

    9. Klicka på knappen Skicka (Submit).
      Obs: Om det inskickade klient-ID:t inte hittas i ditt kontos utvecklarnycklar (Developer Keys), kommer Canvas visa ett felmeddelande om att LTI-konfiguration för klient-ID <nummer> inte hittades. Om detta inträffar, kontrollera att informationen angavs korrekt genom att referera till avsnitt 2.2 Administratör - Visa LTI-utvecklarnyckel i Canvas. 

    10. Klicka på knappen Installera (Install). 

    11. Efter att appen har installerats måste värdena i nästa avsnitt delas med Inspera för att slutföra konfigurationen.

  4. Administratör - Konfiguration av Inspera Assessment

    Inspera behöver följande information från Canvas. Vänligen kontakta Inspera Support för att konfigurera dessa uppdateringar för din specifika Inspera-miljö.

    De specifika Canvas-värdena ska konfigureras i Inspera för att slutföra konfigurationen av det externa verktyget i både Canvas och Inspera.

    Client ID Ett unikt klient-ID (Client ID) för verktyget skapat som en del av den initiala verktygsregistreringen i Canvas. Detta hittas i avsnitt 2.2 Administratör - Visa LTI-utvecklarnyckel i Canvas.
    Issuer/Platform https://canvas.instructure.com
    Canvas Keyset URL https://<canvas-domän>/api/lti/security/jwks
    Canvas OAuth2 Access token URL https://<canvas-domän>/login/oauth2/token
    OpenID Connect Authentication Endpoint Keyset URL https://<canvas-domän>/api/lti/authorize_redirect
    Deployment ID Unikt ID

  5. Lärare - Lägga till en aktivitet där resultat återrapporteras till Canvas betygskatalog

    Inspera Assessment överför det totala antalet poäng efter att provstatusen har satts till Bedömd (Graded) i Inspera.

    Canvas-integrationen med Inspera Assessment kan ställas in så att poäng från Inspera Assessment återrapporteras till Canvas betygskatalog (Gradebook).

    1. Logga in i Canvas som Instruktör (Instructor).
    2. Öppna önskad kurs.

    3. Navigera till en befintlig modul och klicka på ikonen Lägg till innehåll i modul (Add item to module) och fortsätt till steg 8. 

      Obs: Alternativt kan du klicka på knappen + Modul för att skapa en modul, klicka sedan på ikonen Lägg till innehåll i modul och fortsätt från steg 4.

    4. Välj Uppgift (Assignment) i rullgardinsmenyn Lägg till (Add).
    5. Klicka på [ Skapa uppgift / Create Assignment ].
    6. Ange namnet på provet som har skapats/ska skapas i textfältet Uppgiftsnamn (Assignment Name).

    7. Klicka på knappen Lägg till (Add Item). 

    8. Klicka på ikonen Publicera (Publish) på objektet.
      1. Denna åtgärd bör endast utföras efter att provet har aktiverats i Inspera.
      2. Ikonen ändras till en grön cirkel med en bock inuti.

    9. Klicka på det skapade objektet. 

    10. Klicka på knappen Redigera (Edit). 

    11. Ange det totala antalet poäng i textfältet Poäng (Points).

      Obs: Se till att det totala antalet poäng är konsekvent i både Canvas-objektet och Inspera Assessment. Om till exempel ett prov i Inspera Assessment skapas med 40 poäng, men i Canvas är uppgiften inställd på 10 poäng, och en student får 27 av 40 i Inspera, kommer studenten att se 27 poäng i Inspera Assessment men 6,75 poäng i Canvas.

    12. I avsnittet Inlämningstyp (Submission Type), välj Externt verktyg (External Tool) i rullgardinsmenyn.
    13. Klicka på knappen Hitta (Find).
    14. Välj önskat Externt verktyg i listan.

    15. Klicka på knappen Välj (Select). 

    16. Valfritt: markera kryssrutan Läs in det här verktyget i en ny flik (Load This Tool In A New Tab).
    17. Fyll i övriga fält vid behov.

    18. Klicka på knappen Spara (Save). 

    19. Klicka på aktivitetsnamnet för att starta Inspera Assessments leveranssida (Deliver).

  6. Lärare - Lägga till en aktivitet där poäng inte ska återrapporteras till Canvas betygskatalog

    Ibland finns det inget krav på att poäng från Inspera Assessment ska återrapporteras till Canvas betygskatalog. Utför följande steg för att säkerställa att poäng inte skickas tillbaka.

    1. Logga in i Canvas som Instruktör (Instructor).
    2. Åpna önskad kurs.

    3. Navigera till en befintlig modul och klicka på ikonen Lägg till innehåll i modul (Add item to module). 

      Obs: Alternativt kan du klicka på knappen + Modul för att skapa en modul och sedan klicka på ikonen Lägg till innehåll i modul.

    4. Välj Externt verktyg (External Tool) i rullgardinsmenyn Lägg till (Add).
    5. Välj önskat Externt verktyg i listan.

    6. Klicka på knappen Lägg till (Add Item). 

    7. För objektet, klicka på de tre vertikala punkterna.

    8. Klicka på Redigera (Edit). 

    9. Byt namn på titeln i textfältet Titel (Title).
    10. Markera rutan Läs in i en ny flik (Load in a new tab).

    11. Klicka på knappen Uppdatera (Update). 

    12. Klicka på ikonen Publicera (Publish) på objektet.
      • Denna åtgärd bör endast utföras efter att provet har aktiverats i Inspera.
      • Ikonen ändras till en grön cirkel med en bock inuti.

    13. Klicka på aktivitetsnamnet för att starta Inspera Assessments leveranssida (Deliver). 

  7. Lärare - Skapa bedömning

    1. Logga in i Canvas som Instruktör (Instructor).
    2. Navigera till önskad kurs.

    3. Klicka på lämplig aktivitet. 

    4. Klicka på knappen Öppna [titel] i ett nytt fönster (Load [title] in a new window). 

    5. Inspera Assessments leveranssida (Deliver) visas nu, där du kan konfigurera inställningarna för provet. För mer information, se artikeln Översikt av Leverera (Deliver overview).

  8. Kandidat – Hur man genomför ett prov i Inspera Assessment via Canvas

    Kandidater kan genomföra prov i Inspera Assessment direkt via Canvas.

    1. Logga in i Canvas som Kandidat (Candidate).
    2. Navigera till önskad kurs.

    3. Klicka på lämplig aktivitet. 

    4. Klicka på knappen Öppna [titel] i ett nytt fönster. 

    5. Genomför provet och lämna in svaren som vanligt i Inspera Assessment.

    När provet har rättats och poängen har bekräftats av bedömaren, kommer kandidaten att kunna se sina resultat på kandidatens instrumentpanel i Inspera Assessment och i Canvas betygskatalog, om detta är aktiverat.

    Inspera: För att aktivera visning av poäng i Inspera Assessment, gå till Leverera (Deliver) och markera Visa slutliga poäng eller betyg på studentens instrumentpanel i alternativen för Efter provet.

    Canvas: Aktivera betygskatalogstjänsterna under LTI Advantage-tjänster. 

    För mer information, se avsnitt 2.1.1 Administratör - Konfigurera en LTI-utviklarnyckel i Canvas.

3. FAQ

  1. I ett sådant fall bör följande steg följas:

    1. För att säkerställa att betyg återspeglas av verktyget i Canvas betygskatalog under LTI Advantage-tjänster, är det viktigt att välja alternativet "Can create and view assignment data in the gradebook associated with the tool."

      För mer information, se avsnitt 2.1.1 Administratör - Konfigurera en LTI-utvecklarnyckel i Canvas.

    2. Se till att provet är bedömt i Inspera Assessment. Bedömningen måste vara bekräftad för att möjliggöra överföring av poäng.

  2. Om du har problem med att Save-knappen inte fungerar, är den troliga orsaken att sidan behåller sessionen även efter att fel har rättats. En lösning på detta är följande:

    1. Öppna en ny flik eller sida specifikt för nyckelinställningarna relaterade till LTI-utvecklarnyckeln.
    2. Ange de korrekta uppgifterna för LTI-utvecklarnyckeln.
    3. Klicka på Save-knappen.

    Kontakta supporten om problemet kvarstår.

Var denna artikel till hjälp?

0 av 0 tyckte detta var till hjälp