Sakai LTI 1.3 – Integrasjon med Inspera Assessment

  • Oppdatert

1. Oversikt

Learning Tools Interoperability® (LTI®) gjør det mulig for Sakai å koble seg til eksterne læringsverktøy, som Inspera, på en enkel og sikker måte. Tilkoblingen støtter Sakai 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 i én enkel arbeidsflyt. 

Det er ett trinn for å konfigurere Sakai: 

  • Registrere Inspera-verktøyet

2. Registrering og konfigurasjon av eksternt verktøy

Sikkerhetsmodellen for LTI 1.3- og LTI Advantage-tjenester er basert på OAuth 2.0 og OpenID Connect. Dette skiller seg fra tidligere versjoner av LTI-standarden, som brukte OAuth 1.0. I praksis betyr dette at verktøyet (Tool) og plattformen (Platform) 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.

Viktig informasjon ved kopiering og liming av URL-er

Når du kopierer og limer inn URL-er, må du kontrollere at det ikke er mellomrom før eller etter; ekstra mellomrom kan føre til ødelagte lenker, tilgangsfeil og kan ødelegge LTI-oppsettet.

  1. Administrator - Konfigurere LTI-integrasjon med Sakai

    For å konfigurere integrasjonen mellom Inspera og Sakai, må brukeren følge disse trinnene:

    1. Klikk på valget Worksite Setup fra menyen i venstre marg i Sakai. 

    2. Klikk på Administration Workspace fra listen over nettsteder (sites). 

      MERK: 

      Det er tre (3) URL-er som brukeren trenger fra Inspera for første gang for å sette opp LTI-tilkoblingen i sin Sakai-instans. Disse er:

      1. key-url: En "key-url" refererer vanligvis til et sett med offentlige nøkler brukt for 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 "login-init" URL-en endepunktet der denne prosessen begynner.
      3. redirect-url(s): Redirect-URL-ene spesifiserer URL-ene der LMS skal omdirigere 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 ovenfor og erstatt {domain} med din Inspera-adresse som integrasjonen skal settes opp mot.

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

      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. Rull ned i venstremenyen og klikk på External Tools. Du kan velge ett av følgende alternativer:
      • LTI Dynamic Registration: Når du skriver inn din URL, vil verktøyet registrere dine data automatisk.

      • Install LTI 1. x Tool: Legg inn registreringsinformasjon manuelt. 

    4. I fanen Installed Tools, klikk på Install LTI 1. x Tool. 

    5. For å registrere det eksterne verktøyet, fyll ut følgende påkrevde felt:
      1. Tool Title: Navnet på det eksterne verktøyet.

      2. Button Text: Navnet på knappen for det eksterne verktøyet. 

      3. Description: Kort beskrivelse av verktøyet.

      4. Launch URL: Spesifiserer hvor LMS skal omdirigere brukeren når de klikker på innholdsvelgeren https://{domain}/ltiprovider/launch.

        Merk: Launch Key & Launch Secret er valgfrie da disse ikke er påkrevd i LTI 1.3
      5. Privacy Settings: Under personverninnstillinger kan brukeren velge:
        1. Send User Names to External Tool: Aktiver dette for å dele brukernavn med det eksterne verktøyet. 
        2. Send Email Address to External Tool: Aktiver dette for å dele e-postadresser med det eksterne verktøyet.

      6. Services: 

        Under tjenester kan brukeren velge:

        1. Allow External Tool to return grades: Aktiver dette hvis du ønsker at eksterne verktøy skal kunne sende og oppdatere karakterinformasjon.
        2. Allow External Tool to create grade column: Aktiver dette hvis du ønsker at eksterne verktøy skal kunne opprette nye karakterkolonner dynamisk.
        3. Provide Roster to External Tool: Aktiver dette for å gi eksterne verktøy tilgang til deltakerlisten.
        4. Allow External Tool to store settings data: Aktiver dette hvis du ønsker at eksterne verktøy skal kunne lagre spesifikke konfigurasjonsinnstillinger.

      7. Tools can generally accept…: 

        Under dette feltet kan brukeren velge:

        1. The tool URL can receive an LTI Resource Link launch: Aktiver dette for å enkelt kunne starte verktøyet.

        2. The tool can receive a Content-Item or Deep-Link launch: Aktiver dette for å la verktøyet motta Content-Item- eller Deep-Link-oppstarter.

          Merk: Deep linking (djuplenking) er for øyeblikket ikke relevant for Inspera-integrasjonen. Å utføre en deep-link-oppstart vil ikke føre til feil, og svaret tilbake til LMS er "gyldig", men det mangler brukbare verdier siden Inspera ikke har funksjoner som samsvarer med denne flyten.

      8. Indicate where these tools are placed in Sakai: 

        Under dette feltet kan brukeren velge:

        1. Allow the tool to be selected from Lessons: Aktiver dette hvis du ønsker at verktøyet skal være tilgjengelig direkte fra Lessons-modulen.
        2. Allow the tool to be one of the assignment types: Aktiver dette hvis du ønsker å inkludere verktøyet som en av de tilgjengelige oppgavetypene.
        3. Allow the tool to be used from the rich text editor: Aktiver dette for å integrere verktøyet direkte i teksteditoren (RTE).
        4. Tool supports the privacy launch message (experimental): Aktiver dette for å la verktøyet støtte meldingen for privat oppstart.
        5. Allow the tool to provide a common cartridge (usually to be imported into a tool like Lessons): Aktiver dette for å importere innholdspakker (cartridges) til moduler som Lessons.
        6. Allow the tool to provide a file (usually as part of a file picker): Aktiver dette hvis verktøyet kan levere filer via filvelger-funksjonalitet.

      9. Launch in Popup: 

        Under oppstartsvalg kan brukeren velge:

        1. Never launch in Popup: Velg dette for å sikre at verktøyet aldri åpnes i et popup-vindu.
        2. Always Launch in Popup: Velg dette for å alltid starte verktøyet i et popup-vindu.

        3. Allow popup to be changed:  Velg dette hvis du ønsker fleksibilitet til å endre popup-innstillingene basert på egne preferanser. 

      10. Custom Parameters: Legg til nødvendige egendefinerte parametere 

      11. If the user selects LTI 1.3 support while .….the tool information: Velg 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
        Viktig: Sørg for at du har erstattet {domain} med URL-en til din Inspera-instans.

      13. Klikk Save. 

    6. Etter å ha fullført registreringsprosessen, vil detaljer for verktøykonfigurasjonen vises.

      Merk: Disse verdiene må deles med Inspera for å fullføre konfigurasjonen.

      Klikk på Done-knappen. 

    7. Det registrerte verktøyet vil nå vises i listen. 

  2. Administrator - Konfigurasjon av Inspera Assessment

    Inspera vil trenge følgende informasjon (detaljer for verktøykonfigurasjon) tilbake fra Sakai. Brukeren må kontakte Inspera Support for å få dem til å gjøre disse oppdateringene for den spesifikke Inspera-instansen.

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

    LTI 1.3 Platform Issuer https://<sakai domene>
    LTI 1.3 Client ID Unik for verktøyet som er opprettet og finnes som en del av den opprinnelige verktøyregistreringen i Sakai
    LTI 1.3 Platform OAuth2 Well-Known/KeySet URL https://<sakai domene>/imsblis/lti13/keyset
    LTI 1.3 Platform OAuth2 Bearer Token Retrieval URL https://<sakai domene>/imsblis/lti13/token
    LTI 1.3 Platform OIDC Authentication URL https://<sakai domene>/imsoidc/lti13/oidc_auth
    LTI 1.3 Deployment Id 1

  3. Lærer/Instruktør - Legge til en oppgave

    Når konfigurasjonen er fullført i Sakai og Inspera, kan læreren opprette en oppgave.

    Følg trinnene nedenfor for å legge til en oppgave:

    1. a. Logg inn i Sakai med rollen Lærer/Instruktør. 

    2. b. Velg Worksite Setup fra venstremenyen og klikk på navnet på nettstedet (se referansen SMPL101 Spring 2023 i bildet under). 

      Merk: Hvis arbeidsområdet (worksite) ikke er konfigurert, må brukeren velge Create New Site.

    3. c. Velg Assignments fra venstremenyen. 

    4. d. Klikk på fanen Add. 

    5. e. Skriv inn følgende detaljer:
      1. Title: Skriv inn oppgavens tittel.

      2. Assignment Instructions: Nødvendige retningslinjer for å gjøre oppgaven enkel å forstå og gjennomføre. 

      3. Availability: Open Date, Due Date, og Accept Until vil være forhåndsutfylt basert på nåværende tid og dato. Brukeren kan justere disse etter preferanse. Instruktøren bør sette en fremtidig åpningsdato for å forhindre at oppgaven vises for studenter før prøven er aktivert i Inspera. Se dokumentet for egendefinerte parametere for flere detaljer. Instruktører må sende starttid for aktiviteten i inspera_test_start_time og sluttid i inspera_test_end_time. 

      4. Submission Type: Velg alternativet External Tool (LTI) for å bruke det integrerte eksterne verktøyet. 

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

      6. Velg det registrerte eksterne verktøyet fra popup-vinduet. 

        Fyll ut følgende detaljer i popup-vinduet:

        1. Tool Description: Kort beskrivelse av verktøyet (forhåndsutfylles vanligvis fra verktøyet).
        2. Custom Parameter: Legg til nødvendige egendefinerte parametere. Her må det legges til en oppgavespesifikk parameter.

        3. Klikk på Save. 

      7. External Tool to Launch: Navnet på det valgte verktøyet vises i boksen.
      8. Load this tool in a new tab: Huk av for å starte verktøyet i en ny fane.
      9. Grade Scale: Velg Points for å aktivere karakterer i form av poeng.

      10. Max Points: Oppgi antall poeng, f.eks. at denne oppgaven skal gi maksimalt 10 poeng.

        Merk: For samsvarende poengsummer må instruktøren opprette identiske totalpoeng i både Inspera og Sakai. Hvis et oppgavesett i Inspera har 40 poeng, men oppgaven i Sakai er satt til 10 poeng, og en student får 27 av 40 i Inspera, vil studenten se 27 poeng i Inspera. I Sakai vil det derimot vises som 6,75 poeng (omregnet etter samme forhold).
      11. Create new Gradebook item: Instruktører kan velge dette hvis de ønsker å opprette et nytt element i karakterboken for en spesifikk oppgave.

      12. Klikk på Post. 

    6. f. Oppgaven vil nå vises i oppgavelisten. 

  4. Lærer/Instruktør - Utforme vurdering

    1. Logg inn i Sakai med rollen Lærer/Instruktør. 

    2. Velg Worksite Setup fra venstremenyen og klikk på navnet på nettstedet (se referansen SMPL101 Spring 2023 i bildet under). 

    3. Velg Assignments fra venstremenyen. 

    4. Klikk på navnet til den nylig lagt til oppgaven i listen. 

    5. Klikk på knappen Go to External Tool. 

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

    7. Brukeren blir nå ført til siden for prøveoppsett i Inspera Assessment.

    8. Hvis brukeren trenger hjelp til å opprette prøver i Inspera Assessment, vennligst se våre veiledninger på https://support.inspera.com/hc/en-us/articles/360022690051-Tutorials 

  5. Kandidat – Hvordan gjennomføre en Inspera-vurdering fra Sakai

    Kandidater kan åpne en Inspera-vurdering fra Sakai og gjennomføre planlagte prøver satt opp av en instruktør.

    1. Logg inn i Sakai som kandidat. 

    2. Velg Worksite Setup fra venstremenyen og klikk på navnet på nettstedet (se referansen SMPL101 Spring 2023 i bildet under). 

    3. Velg Assignments fra venstremenyen. 

    4. Klikk på navnet til den aktuelle oppgaven i listen. 

    5. Klikk på knappen Go to External Tool. 

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

    7. Kandidaten vil bli omdirigert til Inspera-skjermen for å gjennomføre den planlagte prøven. 

3. FAQ

  • Kontroller LTI-konfigurasjonene på nytt for både Sakai og Inspera.

    I Sakai validerer du verktøykonfigurasjonen ved å redigere verktøyet fra seksjonen "External tools".

    Sjekk nøyaktigheten i følgende felt 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 

    Forsikre deg om at disse detaljene er korrekt konfigurert for å sikre sømløs integrasjon og funksjonalitet.

    I Inspera må Service Desk sørge for at detaljene nedenfor er riktig konfigurert. 

  • Dette kan skyldes følgende årsaker:

    • Hvis en kandidat starter en oppgave som ikke er konfigurert i Inspera, vil de få feilmeldingen vist i bildet under.

    For å unngå dette må instruktøren konfigurere og aktivere oppgaven i Inspera.

Var denne artikkelen nyttig?

0 av 0 syntes dette var nyttig