Sakai LTI 1.3 – Integration med Inspera Assessment

  • Uppdaterad

1. Översikt

Learning Tools Interoperability® (LTI®) gör det möjligt för Sakai att ansluta till externa lärverktyg, såsom Inspera, på ett enkelt och säkert sätt. Anslutningen stödjer Sakai genom att skicka information till Inspera på ett standardiserat sätt. Detta inkluderar användarens roll (instruktör eller kandidat) och den kurs från vilken de startade verktyget. 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. 

Det krävs ett steg för att konfigurera Sakai: 

  • Registrera Inspera-verktyget

2. Registrering och konfiguration av externt verktyg

Säkerhetsmodellen för LTI 1.3- och LTI Advantage-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. I praktiken innebär detta att verktyget (Tool) och plattformen (Platform) 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 - Konfigurera LTI-integration med Sakai

    För att konfigurera integrationen mellan Inspera och Sakai måste användaren följa dessa steg:

    1. Klicka på alternativet Worksite Setup i menyn till vänster i Sakai. 

    2. Klicka på Administration Workspace i listan över webbplatser (sites). 

      OBS: 

      Det finns tre (3) URL:er som användaren behöver från Inspera första gången för att ställa in LTI-anslutningen i sin Sakai-instans. Dessa är:

      1. key-url: En key-url avser vanligtvis en uppsättning publika 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 med LTI 1.3, är "login-init"-URL:en den slutpunkt där denna process börjar.
      3. redirect-url(s): Omdirigerings-URL:erna anger de URL:er dit LMS ska omdirigera användaren efter att OAuth 2.0- auktoriseringsflödet slutförts.
      key-url https://{domain}/ICSXapi/metadata/PublicCertificates
      login-init  https://{domain}/ltiprovider/init 
      redirect-url(s)  https://{domain}/ltiprovider/launch 

      Använd URL-mallarna ovan och ersätt {domain} med din Inspera-miljö som du ska konfigurera integrationen mot.

      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
    3. Scrolla ner i menyn till vänster och klicka på External Tools. Du kan välja ett av följande alternativ:
      • LTI Dynamic Registration: När du anger din URL kommer verktyget att registrera dina data automatiskt.

      • Install LTI 1. x Tool: Ange din registreringsinformation manuellt. 

    4. I fliken Installed Tools, klicka på Install LTI 1. x Tool. 

    5. För att registrera det externa verktyget, fyll i följande obligatoriska fält:
      1. Tool Title: Namnet på det externa verktyget.

      2. Button Text: Namnet på knappen för det externa verktyget. 

      3. Description: Kort beskrivning av verktyget.

      4. Launch URL: Anger var LMS ska omdirigera användaren när de klickar på innehållsvalet https://{domain}/ltiprovider/launch.

        Obs: Launch Key & Launch Secret är valfria eftersom dessa inte krävs i LTI 1.3.
      5. Privacy Settings: Under sekretessinställningar kan användaren välja:
        1. Send User Names to External Tool: Aktivera detta för att dela användarnamn med det externa verktyget. 
        2. Send Email Address to External Tool: Aktivera detta för att dela e-postadresser med det externa verktyget.

      6. Services: 

        Under tjänster kan användaren välja:

        1. Allow External Tool to return grades: Aktivera detta om användaren vill att externa verktyg ska kunna skicka och uppdatera betygsinformation.
        2. Allow External Tool to create grade column: Aktivera detta om användaren vill att externa verktyg ska kunna skapa nya betygskolumner dynamiskt.
        3. Provide Roster to External Tool: Aktivera detta för att ge externa verktyg tillgång till deltagarlistan.
        4. Allow External Tool to store settings data: Aktivera detta om användaren vill att externa verktyg ska kunna lagra specifika konfigurationsinställningar.

      7. Tools can generally accept…: 

        Under detta fält kan användaren välja:

        1. The tool URL can receive an LTI Resource Link launch: Aktivera detta för att helt enkelt kunna starta verktyget.

        2. The tool can receive a Content-Item or Deep-Link launch: Aktivera detta för att låta verktyget ta emot Content-Item eller Deep-Link-starter.

          Obs: Deep linking är för närvarande inte relevant för Inspera-integration. Att utföra en deep-link- start kommer inte att resultera i några fel. Svaret tillbaka till LMS är "giltigt", men det saknar användbara värden eftersom Inspera inte har funktioner som stämmer överens med ett flöde för djuplänkningsförfrågningar.

      8. Indicate where these tools are placed in Sakai: 

        Under detta fält kan användaren välja:

        1. Allow the tool to be selected from Lessons: Aktivera detta om användaren vill att verktyget ska vara tillgängligt direkt från Lessons.
        2. Allow the tool to be one of the assignment types: Aktivera detta om användaren vill inkludera verktyget som en av de tillgängliga uppgiftstyperna.
        3. Allow the tool to be used from the rich text editor: Aktivera detta för att integrera verktyget direkt i text- editorn, vilket förbättrar möjligheterna att skapa och redigera innehåll.
        4. Tool supports the privacy launch message (experimental): Aktivera detta för att låta verktyget stödja meddelandet för sekretesskyddad start.
        5. Allow the tool to provide a common cartridge (usually to be imported into a tool like Lessons): Aktivera detta för att importera "common cartridges" till verktyg som Lessons.
        6. Allow the tool to provide a file (usually as part of a file picker): Aktivera detta om verktyget kan tillhandahålla filer via filväljarfunktionen.

      9. Launch in Popup: 

        Under startalternativen kan användaren välja:

        1. Never launch in Popup: Välj detta för att säkerställa att verktyget aldrig öppnas i ett popup-fönster.
        2. Always Launch in Popup: Välj detta för att alltid starta verktyget i ett popup-fönster.

        3. Allow popup to be changed:  Välj detta om användaren vill ha flexibiliteten att ändra popup-inställningarna baserat på sina preferenser. 

      10. Custom Parameters: Lägg till nödvändiga anpassade parametrar.

      11. If the user selects LTI 1.3 support while .….the tool information: Välj Tool supports LTI 1.3.

      12. URLs:

        1. LTI 1.3 Tool Keyset URL: https://{domain}/ICSXapi/metadata/PublicCertificates
        2. LTI 1.3 Tool OpenID Connect/Initialization Endpoint: https://{domain}/ltiprovider/init
        3. LTI 1.3 Tool Redirect Endpoint(s): https://{domain}/ltiprovider/launch
        Viktigt: Se till att du har ersatt {domain} med URL:en till din Inspera-miljö.

      13. Klicka på Save. 

    6. Efter att ha slutfört registreringsprocessen kommer detaljerna för verktygskonfigurationen (Tool Configuration Details) att visas.

      Obs: Dessa värden måste delas med Inspera för att kunna slutföra konfigurationen.

      Klicka på knappen Done. 

    7. Det registrerade verktyget visas nu i listan. 

  2. Administratör - Konfiguration av Inspera Assessment

    Inspera behöver följande information (det vill säga konfigurationsdetaljer för verktyget) från Sakai. Användaren behöver kontakta Inspera Support för att få dem att göra dessa uppdateringar för den användarspecifika Inspera-miljön.

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

    LTI 1.3 Platform Issuer https://<sakai domän>
    LTI 1.3 Client ID Unikt för verktyget som skapas och återfinns som en del av den initiala verktygsregistreringen i Sakai.
    LTI 1.3 Platform OAuth2 Well-Known/KeySet URL https://<sakai domän>/imsblis/lti13/keyset
    LTI 1.3 Platform OAuth2 Bearer Token Retrieval URL https://<sakai domän>/imsblis/lti13/token
    LTI 1.3 Platform OIDC Authentication URL https://<sakai domän>/imsoidc/lti13/oidc_auth
    LTI 1.3 Deployment Id 1

  3. Lärare/Instruktör - Lägga till en uppgift

    När konfigurationen är klar i Sakai och Inspera kan läraren skapa en uppgift.

    Följ stegen nedan för att lägga till en uppgift:

    1. a. Logga in i Sakai med rollen Lärare/Instruktör (Teacher/Instructor). 

    2. b. Välj Worksite Setup i menyn till vänster och klicka på webbplatsens namn (se SMPL101 Spring 2023 i bilden nedan som referens). 

      Obs: Om arbetsytan inte är konfigurerad behöver användaren välja Create New Site.

    3. c. Välj Assignments (Uppgifter) i menyn till vänster. 

    4. d. Klicka på fliken Add (Lägg till). 

    5. e. Ange följande detaljer:
      1. Title: Ange uppgiftens titel.

      2. Assignment Instructions: De nödvändiga riktlinjerna för att göra uppgiften lätt att förstå och genomföra. 

      3. Availability: Open Date, Due Date, och Accept Until kommer att vara förifyllda som standard baserat på nuvarande tid och datum. Användaren kan också justera dessa efter önskemål. Instruktören bör tilldela ett framtida öppningsdatum för att förhindra att uppgiften visas för studenter innan provet är aktiverat i Inspera. Se dokumentet för anpassade parametrar för mer information. Instruktörer behöver skicka aktivitetens starttid i inspera_test_start_time och sluttiden i inspera_test_end_time. 

      4. Submission Type: Välj alternativet External Tool (LTI) för att använda det integrerade externa startverktyget. 

      5. Klicka på Select External Tool (LTI). 

      6. Välj det registrerade externa verktyget i popup-fönstret. 

        Ange följande detaljer i popup-fönstret:

        1. Tool Description: Kort beskrivning av verktyget (förifylls som standard från verktyget).
        2. Custom Parameter: Lägg till de nödvändiga anpassade parametrarna. En uppgiftsspecifik anpassad parameter behöver läggas till här.

        3. Klicka på Save. 

      7. External Tool to Launch: Namnet på det valda verktyget visas i rutan.
      8. Load this tool in a new tab: Markera denna kryssruta för att starta verktyget i en ny flik.
      9. Grade Scale: Välj Points för att aktivera betyg i form av poäng.

      10. Max Points: Ange antalet poäng, till exempel att denna uppgift ger maximalt 10 poäng.

        Obs: För konsekvent poängsättning måste instruktören fastställa identiska totalpoäng i både Inspera och Sakai. Om ett frågeset skapas med 40 poäng i Inspera, men i Sakai är uppgiften inställd på 10 poäng, och en student får 27 av 40 i Inspera, kommer studenten se poängen som 27 i Inspera. I Sakai kommer den dock visas som 6,75 poäng med en maxpoäng på 10. Vi kan betrakta det som att poängen konverteras enligt samma förhållande.
      11. Create new Gradebook item: Instruktörer kan välja detta alternativ om de vill skapa ett nytt objekt i betygskatalogen för en specifik uppgift.

      12. Klicka på Post. 

    6. f. Uppgiften kommer att visas i listan över uppgifter. 

  4. Lärare/Instruktör - Utforma bedömning

    1. Logga in i Sakai med rollen Lärare/Instruktör. 

    2. Välj Worksite Setup i menyn till vänster och klicka på webbplatsens namn (se SMPL101 Spring 2023 i bilden nedan som referens). 

    3. Välj Assignments (Uppgifter) i menyn till vänster. 

    4. Klicka på namnet för den tillagda uppgiften i listan. 

    5. Klicka på knappen Go to External Tool. 

    6. Klicka på knappen Launch External Tool in New Window. 

    7. Användaren skickas nu till sidan för provinställningar i Inspera Assessment.

    8. Om användaren behöver hjälp med att skapa prov i Inspera Assessment, besök våra hjälpguider på https://support.inspera.com/hc/en-us/articles/360022690051-Tutorials 

  5. Kandidat – Hur man genomför en Inspera-bedömning från Sakai

    Kandidater kan starta en Inspera-bedömning från Sakai och genomföra schemalagda prov som ställts in av en instruktör.

    1. Logga in i Sakai som kandidat. 

    2. Välj Worksite Setup i menyn till vänster och klicka på webbplatsens namn (se SMPL101 Spring 2023 i bilden nedan). 

    3. Välj Assignments (Uppgifter) i menyn till vänster. 

    4. Klicka på namnet för den tillagda uppgiften i listan. 

    5. Klicka på knappen Go to External Tool. 

    6. Klicka på knappen Launch External Tool in the New Window. 

    7. Kandidaten omdirigeras till Inspera-skärmen för att genomföra det schemalagda provet. 

3. FAQ

  • Kontrollera LTI-konfigurationerna på nytt för både Sakai och Inspera.

    I Sakai validerar du verktygskonfigurationen genom att redigera verktyget under sektionen ”External tools”.

    Kontrollera noggrannheten i följande fält på nytt: 

    • LTI 1.3 Platform Issuer,
    • LTI 1.3 Client Id,
    • LTI 1.3 Platform OAuth2 Well-Known/KeySet URL,
    • LTI 1.3 Platform OAuth2 Bearer Token Retrieval URL, 
    • LTI 1.3 Platform OIDC Authentication URL,
    • LTI 1.3 Deployment Id 

    Säkerställ att dessa uppgifter är korrekt konfigurerade för att garantera sömlös integration och funktionalitet.

    I Inspera behöver supportavdelningen säkerställa att nedanstående uppgifter är korrekt konfigurerade. 

  • Följande kan vara troliga orsaker:

    • Om en kandidat startar en uppgift som inte är konfigurerad i Inspera visas nedanstående felsida.

    För att undvika detta behöver instruktören konfigurera och aktivera uppgiften i Inspera.

Var denna artikel till hjälp?

0 av 0 tyckte detta var till hjälp