1. Oversikt

Learning Tools Interoperability® (LTI®) gjør det mulig for Brightspace å koble seg til eksterne læringsverktøy som Inspera på en enkel og sikker måte. Tilkoblingen støtter Brightspace 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. Den kan også opprette brukerkontoer i verktøyet ved oppstart, noe som fungerer som både registrering og enkel pålogging (single sign-on) i én enkel arbeidsflyt. I tillegg støtter LTI Advantage overføring av karakterer fra Inspera til karakterboken i Brightspace. LTI Advantage-standarden er omfattende og dekker mange områder. D2L samsvarer ennå ikke med alle aspekter av standarden.

Det er tre trinn for å konfigurere D2L Brightspace: 

• Registrere Inspera-verktøyet 
• Opprette en distribusjon (deployment) av verktøyet 
• Opprette LTI-lenker

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 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 - Konfigurere LTI-integrasjon med D2L Brightspace

   For å konfigurere integrasjonen mellom Inspera og D2L Brightspace, følg disse trinnene:

   1. Klikk på Admin Tools-menyen i Brightspace, og klikk på Manage Extensibility. 

      

      MERK: 

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

      1. key-url: En key-url 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 "login-init" URL-en endepunktet der denne prosessen begynner.
      3. redirect-url(s): Redirect-URL-ene spesifiserer URL-ene der LMS skal videresende brukeren etter at OAuth 2.0-autorisasjonsflyten er fullført.

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

      URL-mal

      Bruk URL-malene ovenfor og erstatt {domain} med Inspera-instansen brukeren skal integrere med. 

      For eksempel, hvis Inspera-domenet 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

   2. Klikk på LTI Advantage-fanen, og deretter på Register Tool. Du kan velge ett av følgende alternativer:
      • Dynamic Registration (Dynamisk registrering): Når du skriver inn din URL, vil verktøyet registrere dine data automatisk.

      • Standard Registration (Standard registrering): Skriv inn registreringsinformasjonen din manuelt. 

        

        

        

   3. Velg alternativet Standard registrering for manuell inntasting av registreringsdetaljer mellom Brightspace og verktøyet. 

      Først skriver du inn detaljene for verktøyet. Etter at verktøyet er registrert, vil registreringsdetaljene fra Brightspace bli tilgjengelige for å gis videre til verktøyet. 

      

   4. For standard registrering, fyll ut følgende felt:

      1. Name: Navnet på det eksterne verktøyet.

         

      2. Description: Kort beskrivelse av verktøyet.
      3. Domain: https://{domain} (Merk: Domener kan bare brukes i én aktivert registrering om gangen. Hvis brukeren prøver å registrere et verktøy med et domene som allerede er i bruk, vil brukeren få beskjed om å deaktivere den eksisterende registreringen.)
      4. Redirect URLs: https://{domain}/ltiprovider/launch
      5. OpenID Connect Login URL: https://{domain}/ltiprovider/init
      6. Target Link URI: https://{domain}/ltiprovider/launch

      7. Keyset URL: https://{domain}/ICSXapi/metadata/PublicCertificates 

         

      8. Extensions: Velg - 
         • Assignment and Grade Services: Når en bruker velger dette alternativet, betyr det vanligvis at de ønsker å koble sammen oppgaverelaterte aktiviteter og overføre karakterinformasjon mellom det eksterne verktøyet og LMS-et.
         • Deep Linking: Deep linking er for øyeblikket ikke relevant for Inspera-integrasjon. Å 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 en deep-link-forespørsel.
         • Names & Roles: Aktivering av Names and Roles via LTI lar LMS-et synkronisere brukerdata, inkludert navn og roller, med det eksterne verktøyet.
      9. Roles: Det er unødvendig å velge roller siden Inspera ikke bruker institusjonsroller. I stedet bruker vi utelukkende kontekstroller for å tildele rettigheter for spesifikke Inspera-prøver.

         • Kontekstroller refererer til rollene som er tildelt brukere innenfor en spesifikk læringskontekst, som et emne eller en organisasjon. Disse rollene definerer tillatelsene og tilgangsnivåene brukerne har. D2L tilbyr et sett med forhåndsdefinerte roller, hver med sine egne tillatelser, og administratorer kan tildele disse rollene til brukere basert på deres ansvarsområder og nivået på tilgang som kreves.
           Kontekstroller - Instruktører (har det høyeste tilgangsnivået i et emne), Teaching Assistant, Student, Guest, Administrator, Course Builder og Librarian. 

           

      10. Custom Parameters: Registrering av verktøyet er ikke påkrevd i dette trinnet, da det kan gjøres under distribusjon (deployment) eller lenking av verktøyet. Selv om brukeren har muligheten til å gjøre det her, vær oppmerksom på at selv om man velger å ikke inkludere egendefinerte parametere nå, vil de fortsatt være tilgjengelige i de senere stadiene. Vennligst se custom parameters.

      11. Klikk Register. 

          

      12. Etter å ha fullført registreringsprosessen, vil Tool Configuration Details bli vist. Disse verdiene må deles med Inspera for å fullføre konfigurasjonen. Klikk på Done-knappen. 

          

      13. Det registrerte verktøyet vil vises i listen. 

          

2. Administrator - Konfigurasjon av Inspera Assessment

   Inspera trenger følgende informasjon (dvs. Tool Configuration Details) i retur fra D2L Brightspace. Du må kontakte Inspera Support for å få dem til å legge inn disse oppdateringene for din spesifikke Inspera-instans.

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

   Issuer/Platform ID	https://<d2l domain>/
   Client ID	Unik for verktøyet som er opprettet, og finnes som en del av den opprinnelige verktøyregistreringen som gjøres i D2L Brightspace
   Deployment ID	Unik ID
   Brightspace keyset URL	https://<d2l domain>/d2l/.well-known/jwks
   Brightspace OAuth2 Access Token URL	https://<d2l domain>/core/connect/token
   OpenID Connect Authentication Endpoint	https://<d2l domain>/d2l/lti/authenticate

3. Administrator - Distribusjon av verktøy (Tool Deployment)

   Distribusjoner (deployments) gjør det mulig å dele registrerte verktøy som Inspera i Brightspace.

   Følg disse trinnene for å distribuere et verktøy:

   1. Fra Admin Tools-menyen, klikk på External Learning Tools. 

      

      

   2. I LTI Advantage-fanen, klikk på New Deployment. 

      

   3. Velg verktøyet du registrerte i forrige trinn fra Tool-rullegardinlisten. 

      

   4. Angi et Name og en Description for distribusjonen. 

      

   5. Velg en Extension (Velg Assignment and Grade Services, og Names & Roles. La Deep Linking stå tomt). 

      

   6. Velg Deployment Security Settings (Velg ALLE unntatt Anonymous) for å la LMS dele valgte detaljer ved oppstart av aktiviteten. 

      

   7. Substitution Parameters: sourcedld koblet til $Person.sourcedld. Du finner andre D2L-støttede substitusjonsparametere her. Disse feltene vil bli inkludert i listen over egendefinerte parametere i LTI-oppstartforespørselen (launch request).
   8. Custom Parameters: Legg til de nødvendige egendefinerte parametrene.

   9. Velg Add Access Groups for å gjøre verktøyet tilgjengelig som et eksternt læringsverktøy for å autorisere ny aktivitet. 

      

   10. Når du klikker her, vil et popup-vindu vises der brukeren må velge eksisterende organisasjonsenheter/kurs. 

       

       Merk: Administrator kan se eksisterende kurs ved å navigere til "Course Management". Hvis ingen kurs er tilgjengelige, kan de følge lenken under for å opprette et nytt kurs i D2L: https://community.d2l.com/brightspace/kb/articles/5071-design-your-course 

       

   11. Etter å ha valgt organisasjonene, klikk på Add (som vist i bildet over). Etter at du har lagt dem til, vil en liste over tilgangsgrupper (Access Groups) vises nedenfor. 

       

   12. Klikk på Create Deployment. 

       

   13. Etter at distribusjonsprosessen er fullført, vil popup-skjermen under vises. Klikk på Done-knappen. 

       

   14. Det distribuerte verktøyet vil vises i listen. 

       

       Merk: Etter at en distribusjon er opprettet for det verktøyet, kan den ikke lenger endres.

4. Lærer/Instruktør - Legge til en aktivitet/prøve

   Når konfigurasjonen er fullført i D2L Brightspace og Inspera, kan læreren opprette en aktivitet. En lærer kan legge til verktøykoblingen til Inspera Assessment ved å legge til et eksternt verktøy i en modul og et emne i Brightspace.

   Følg trinnene nedenfor for å legge til Inspera-test/aktivitetskoblingen:

   1. Logg inn i D2L Brightspace med rollen Teacher/Instructor (Lærer/Instruktør). 

      

   2. Velg kurset brukeren ønsker å legge til lenken i (f.eks. "inspera Course 1" i bildet nedenfor). Administrator kan se lenken under for å opprette et nytt kurs i D2L:

      https://community.d2l.com/brightspace/kb/articles/5071-design-your-course 

      

   3. Velg Content-ikonet (for referanse i bildet nedenfor: "Inspera Demo LTI 1.3 Launch Tool"). 

      

   4. Klikk på Existing Activities-knappen, og velg External Learning Tools. 

      

      

      Brukeren kan legge til aktiviteter gjennom to ulike metoder:

      • Metode 1 - Ved å opprette en ny LTI-lenke (aktivitet).
      • Metode 2 - Ved å velge en eksisterende LTI-lenke (aktivitet).

        1. Metode 1: Legg til en ny aktivitet ved å opprette en ny LTI-lenke (aktivitet).

           1. I stedet for å velge en eksisterende aktivitet, klikk på "Create New LTI link" for å legge til en ny aktivitet. 

              

           2. Fyll ut følgende detaljer:

              • i. Title: Ønsket tittel for din Inspera-prøve/aktivitetskobling. 
              • ii.  LTI URL: Startpunkt-URL-en (dvs. URL-en brukeren oppga i verktøyregistreringen som omdirigerings-URL (redirect URL): https://{domain}/ltiprovider/launch ) som brukeren navigerer til når de klikker på Inspera-prøven (LTI-lenken).

              • iii. Tool: Siden verktøyet er registrert som LTI Advantage, vil LTI Advantage-alternativet være tilgjengelig i Tool-rullegardinmenyen når LTI-URL-en legges inn. 

                

              Merk: Ved en mislykket registrering (f.eks. hvis brukeren la inn en annen URL enn omdirigerings-URL-en som ble oppgitt ved registrering), vil brukeren bare se "Legacy LTI Tool" i rullegardinmenyen.

              

           3. Etter å ha lagt inn detaljene, klikk på "Create and Insert"-knappen. 

              

           4. Verktøykoblingen vil vises på enhetssiden. 

              

        2. Metode 2: Legg til en kopi av en eksisterende aktivitet ved å velge en eksisterende LTI-lenke (aktivitet).

           1. Velg den tidligere opprettede LTI-lenken (aktivitet) som er knyttet til en annen aktivitet. 

              

           2. Inspera-testlenken vil vises på enhetssiden. 

              

              Merk: Instruktøren bør deaktivere synlighetsbryteren i egenskapsredigeringen for den spesifikke aktivitetslenken for å forhindre at den vises for studenter før prøven er aktivert i Inspera. 

              

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

   1. Logg inn i D2L Brightspace som instruktør (Instructor).

   2. Lenken til Inspera kan nå åpnes ved å klikke på aktivitetsnavnet. 

      

      Inspera Assessment vil som standard åpnes i den gjeldende fanen. Brukere har mulighet til å endre denne innstillingen for å åpne den i en ny fane ved å redigere aktiviteten. Brukere kan utforske de tilgjengelige valgene ved å klikke på ikonet med en pil ned. Deretter bør de velge alternativet "Edit Properties in Place", som vist i den inkluderte referansen. Etter dette må brukerne krysse av i boksen Open as External Resource.

      

      

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

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

      

6. Kandidat – Hvordan gjennomføre en Inspera-vurdering fra D2L Brightspace

   Kandidater kan starte en Inspera-vurdering fra D2L Brightspace og ta planlagte prøver satt opp av en instruktør.

   Logg inn i D2L Brightspace som kandidat. 

   1. Klikk på kurset som inneholder lenken til din vurdering, og klikk deretter på navnet på vurderingen. 

      

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

      

3. FAQ

1. Revalider LTI-konfigurasjonene for både D2L Brightspace og Inspera.

   I D2L Brightspace validerer du verktøykonfigurasjonen ved å redigere verktøyet fra seksjonen "Manage Extensibility".

   Kontroller på nytt at følgende felt er korrekte: 

   1. Client ID, 
   2. Brightspace Keyset URL, 
   3. Brightspace OAuth2 Access token URL, 
   4. OpenID Connect Authentication Endpoint, 
   5. Brightspace OAuth2 Audience  &
   6. Issuer

   Sørg for at disse detaljene er riktig konfigurert for å sikre sømløs integrasjon og funksjonalitet.

   ---

   Hos Inspera må Service Desk sørge for at detaljene nedenfor er riktig konfigurert: 

   

2. Dette kan skyldes noen av følgende årsaker:

   1. Sjekk og bekreft om din LTI-versjon 1.3 har automatisk provisjonering aktivert og er bakoverkompatibel.
   2. Sørg for at "LTI Names and Role provisioning" er satt til alternativet:

   “Use this service to retrieve member's information per privacy settings”. 

   Følg trinnene nedenfor for å bekrefte denne innstillingen med administratortilgang:

   1. Logg inn som Admin.

   2. Klikk på Admin tools, velg deretter Manage Extensibility og bytt til LTI Advantage. Klikk på navnet til det registrerte verktøyet i listen. 

      

      

   3. Bekreft innstillingen for LTI Names and Roles Provisioning. 

      

      

   4. Send “enroll_candidates=true” hvis medlemskapstjenesten (membership service) er tilgjengelig.

3. Hvorfor kan ikke en kandidat starte en aktivitet?

   Dette kan være den sannsynlige årsaken:

   Hvis en kandidat starter en aktivitet som ikke er konfigurert i Inspera, vil dette gi en 404-feil. 

   

   For å unngå dette må instruktøren konfigurere en aktivitet i Inspera, eller instruktøren kan deaktivere synlighetsbryteren fra redigeringsegenskapene for den aktuelle lenken, slik at den ikke vises for studenten.