1. Översikt
Learning Tools Interoperability® (LTI®) gör det möjligt för Brightspace att ansluta till externa lärverktyg som Inspera på ett enkelt och säkert sätt. Anslutningen stödjer Brightspace genom att skicka information till Inspera på ett standardiserat sätt. Detta inkluderar användarens roll (instruktör eller provtagare) och den kurs som de startade verktyget ifrån. Det kan även skapa användarkonton i verktyget vid start, vilket fungerar som både registrering och enkel inloggning (single sign-on) i ett smidigt arbetsflöde. Dessutom stödjer LTI Advantage återrapportering av resultat från Inspera till Brightspaces betygsbok. LTI Advantage-standarden är omfattande och täcker många områden. D2L uppfyller ännu inte alla delar av standarden.
Det krävs tre steg för att konfigurera D2L Brightspace:
- Registrera Inspera-verktyget
- Skapa en driftsättning (deployment) av verktyget
- Skapa LTI-länkar
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, som använde OAuth 1.0. I praktiken innebär detta att verktyget (Tool) och plattformen (Platform) måste registrera 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 avbryta LTI-inställningen.
-
Administratör - Konfigurera LTI-integration med D2L Brightspace
För att konfigurera integrationen mellan Inspera och D2L Brightspace, följ dessa steg:
-
Klicka på menyn Admin Tools i Brightspace och välj Manage Extensibility.
OBS:
Det finns tre (3) URL:er som användaren behöver från Inspera för att ställa in LTI-anslutningen i din D2L Brightspace-instans för första gången. Dessa är följande:
- key-url: en key-url syftar vanligtvis på en uppsättning publika nycklar som används för autentisering och säkerhet.
- login-init: När en användare initierar en inloggningsprocess från LMS till ett externt verktyg via LTI 1.3, är "login-init"-URL:en slutpunkten där denna process börjar.
- redirect-url(s): Omdirigerings-URL:erna anger de URL:er som LMS ska skicka användaren till 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 URL-mall
Använd URL-mallarna ovan och ersätt {domain} med den Inspera-instans som användaren ska integrera med.
Till exempel, om Inspera-miljön är 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 - Klicka på fliken LTI Advantage och välj sedan Register Tool. Du kan välja ett av följande alternativ:
- Dynamic Registration (Dynamisk registrering): När du anger din URL kommer verktyget att registrera dina data automatiskt.
-
Standard Registration (Standardregistrering): Ange din registreringsinformation manuellt.
Fliken LTI Advantage Registrera verktyg Dynamisk registrering
-
Välj alternativet Standard för manuell inmatning av registreringsuppgifter mellan Brightspace och verktyget.
Ange först verktygsinformationen. När verktyget har registrerats blir "Brightspace Registration Details" tillgängliga för att delas med verktyget.
- För standardregistrering, fyll i följande fält:
-
Name: Namnet på det externa verktyget.
- Description: Kort beskrivning av verktyget.
- Domain: https://{domain} (Obs: Domäner kan endast användas i en aktiverad registrering åt gången. Om användaren försöker registrera ett verktyg med en domän som redan används kommer användaren att uppmanas att inaktivera den befintliga registreringen.)
- Redirect URLs: https://{domain}/ltiprovider/launch
- OpenID Connect Login URL: https://{domain}/ltiprovider/init
- Target Link URI: https://{domain}/ltiprovider/launch
-
Keyset URL: https://{domain}/ICSXapi/metadata/PublicCertificates
-
Extensions: Välj -
- Assignment and Grade Services: När en användare väljer detta alternativ innebär det vanligtvis att de vill koppla uppgiftsrelaterade aktiviteter och överföra betygsdata mellan det externa verktyget och LMS.
- Deep Linking: 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 ligger i linje med ett deep-link-begärandeflöde.
- Names & Roles: Genom att aktivera Names and Roles via LTI kan LMS synkronisera användardata, inklusive namn och roller, med det externa verktyget.
-
Roles: Att välja roller är onödigt eftersom Inspera inte använder institutionsroller. Istället använder vi uteslutande kontextroller för att tilldela behörigheter för specifika Inspera-prov.
-
Kontextroller avser de roller som tilldelas användare inom en specifik inlärningskontext, till exempel en kurs eller en organisation. Dessa roller definierar behörigheter och åtkomstnivåer som användarna har. D2L tillhandahåller en uppsättning fördefinierade roller, var och en med sin egen uppsättning behörigheter, och administratörer kan tilldela dessa roller till användare baserat på deras ansvarsområden och den nivå av åtkomst som krävs.
Kontextroller - Instructors (har den högsta åtkomstnivån inom en kurs), Teaching Assistant, Student, Guest, Administrator, Course Builder och Librarian.
-
- Custom Parameters: Registrering av verktyget krävs inte i detta steg, eftersom det kan utföras under driftsättningen eller länkningsprocessen. Även om användaren har möjlighet att göra det i detta skede, observera att även om användaren väljer att inte inkludera några anpassade parametrar under driftsättningen eller länkningsprocessen, kommer de fortfarande att vara tillgängliga i de stadierna. Se anpassade parametrar (custom parameters).
-
Klicka på Register.
-
När registreringsprocessen är klar visas "Tool Configuration Details". Dessa värden måste delas med Inspera för att slutföra konfigurationen. Klicka på knappen Done.
-
Det registrerade verktyget visas i listan.
-
-
-
Administratör - Konfiguration av Inspera Assessment
Inspera behöver följande information (d.v.s. Tool Configuration Details) tillbaka från D2L Brightspace. Du behöver kontakta Inspera Support för att de ska kunna göra dessa uppdateringar för din specifika Inspera-miljö.
De specifika värdena från D2L Brightspace ska konfigureras i Inspera för att slutföra konfigurationen av det externa verktyget i både D2L Brightspace & Inspera.
Issuer/Platform ID https://<d2l domain>/ Client ID Unikt för verktyget som skapas och kan hittas som en del av den initiala verktygsregistreringen som görs i D2L Brightspace. Deployment ID Unikt 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 -
Administratör - Driftsättning av verktyg (Tool Deployment)
Driftsättningar (Deployments) gör det möjligt att dela registrerade verktyg som Inspera i Brightspace.
För att driftsätta ett verktyg, följ dessa steg:
-
Klicka på External Learning Tools i menyn Admin Tools.
-
Klicka på New Deployment under fliken LTI Advantage.
-
Välj verktyget du registrerade i flödet ovan från rullgardinslistan Tool.
-
Ange ett Name och en Description för driftsättningen.
-
Välj Extension (Välj Assignment and Grade Services och Names & Roles. Lämna Deep Linking tom).
-
Välj Deployment Security Settings (Välj ALLA utom Anonymous) för att göra det möjligt för LMS att dela de valda uppgifterna vid start av aktiviteten.
- Substitution Parameters: sourcedld kopplat till $Person.sourcedld. Du hittar andra D2L-stödda ersättningsparametrar här. Dessa fält kommer att inkluderas i listan över anpassade parametrar i LTI-startbegäran.
- Custom Parameters: Lägg till de nödvändiga anpassade parametrarna.
-
Välj Add Access Groups för att göra ett verktyg tillgängligt som ett externt lärverktyg för att auktorisera en ny aktivitet.
-
Vid klick öppnas ett popup-fönster där användaren måste välja befintliga organisationsenheter/kurser.
Obs: Administratörer kan se befintliga kurser genom att navigera till ”Course Management”. Om ingen kurs är tillgänglig kan de använda länken nedan för att skapa en ny kurs i D2L: https://community.d2l.com/brightspace/kb/articles/5071-design-your-course
-
När du har valt organisationer, klicka på Add (som visas i bilden ovan). Efter tillägg visas en lista över Access Groups nedan.
-
Klicka på Create Deployment.
-
När driftsättningsprocessen är klar visas popup-skärmen nedan. Klicka på knappen Done.
-
Det registrerade verktyget kommer att visas i listan.
Obs: När en driftsättning har skapats för det verktyget kan den inte längre ändras.
-
-
Lärare/Instruktör - Lägga till en aktivitet/prov
När konfigurationen är klar i D2L Brightspace och Inspera kan läraren skapa en aktivitet. En lärare kan lägga till verktygslänken till Inspera Assessment genom att lägga till ett externt verktyg i en modul och ett ämne i Brightspace.
Följ stegen nedan för att lägga till länken till Inspera-provet/aktiviteten:
-
Logga in i D2L Brightspace med rollen Lärare/Instruktör (Teacher/Instructor).
-
Välj den kurs som användaren vill lägga till länken i (t.ex. "inspera Course 1" i bilden nedan). Administratörer kan se länken nedan för att skapa en ny kurs i D2L:
https://community.d2l.com/brightspace/kb/articles/5071-design-your-course
-
Välj ikonen Innehåll (Content) (t.ex. "Inspera Demo LTI 1.3 Launch Tool" i bilden nedan).
-
Klicka på knappen Befintliga aktiviteter (Existing Activities) och välj Externa lärverktyg (External Learning Tools).
Användaren kan lägga till aktiviteter genom två olika flöden:
- Flöde 1 – Genom att skapa en ny LTI-länk (aktivitet).
- Flöde 2 – Genom att välja en befintlig LTI-länk (aktivitet).
-
Flöde 1: Lägg till en ny aktivitet genom att skapa en ny LTI-länk (aktivitet).
-
Istället för att välja en befintlig aktivitet, klicka på ”Skapa ny LTI-länk” (Create New LTI link) för att lägga till en ny aktivitet.
-
Ange följande uppgifter:
- i. Rubrik (Title): Den önskade titeln för din Inspera-prov/aktivitetslänk.
- ii. LTI-URL: Startpunktens URL (d.v.s. den URL som användaren angav vid verktygsregistreringen som omdirigerings-URL: https://{domain}/ltiprovider/launch) som användaren navigerar till när de klickar på Inspera-provlänken (LTI).
-
iii. Verktyg (Tool): Eftersom verktyget är registrerat som LTI Advantage, blir alternativet LTI Advantage tillgängligt i rullgardinsmenyn när LTI-URL:en anges.
Obs: Vid en misslyckad registrering (t.ex. om användaren angav en annan URL än den omdirigerings-URL som angavs vid registreringen), kommer användaren endast att se "Legacy LTI Tool" i rullgardinsmenyn.
-
När uppgifterna har angetts, klicka på knappen ”Skapa och infoga” (Create and Insert).
-
Verktygslänken visas på enhetssidan.
-
-
Flöde 2: Lägga till en kopia av en befintlig aktivitet genom att välja en befintlig LTI-länk (aktivitet).
-
Välj den tidigare skapade LTI-länken (aktivitet) som är kopplad till en annan aktivitet.
-
Inspera-provlänken visas på enhetssidan.
Obs: Instruktören bör inaktivera synlighetsreglaget i redigeringsinställningarna för den specifika aktivitetslänken för att förhindra att den visas för studenter innan provet har aktiverats i Inspera.
-
-
-
-
Lärare/Instruktör - Skapa bedömning
- Logga in i D2L Brightspace som instruktör (Instructor).
-
Länken till Inspera kan nu öppnas genom att klicka på aktivitetsnamnet.
Inspera Assessment öppnas inledningsvis i den aktuella fliken som standard. Användare har möjlighet att ändra denna inställning till att öppnas i en ny flik genom att redigera aktiviteten. Användare kan utforska tillgängliga alternativ genom att klicka på ikonen med en pil nedåt. Därefter bör de välja alternativet ”Redigera egenskaper på plats” (Edit Properties in Place), som visas i den inkluderade referensen. Efter detta steg måste användaren markera kryssrutan Öppna som extern resurs (Open as External Resource).
Användaren skickas till sidan för provinställningar i Inspera Assessment.
Om användaren behöver hjälp med att skapa prov i Inspera Assessment, vänligen besök våra hjälpsidor på https://support.inspera.com/hc/en-us/articles/360022690051-Tutorials
-
Kandidat – Hur man genomför en Inspera-bedömning från D2L Brightspace
Kandidater kan starta Inspera Assessment från D2L Brightspace och genomföra schemalagda prov som skapats av en instruktör.
Logga in i D2L Brightspace som kandidat.
-
Klicka på den kurs som innehåller länken till din bedömning, klicka sedan på bedömningens namn.
-
Kandidaten kommer att omdirigeras till Inspera-skärmen för att genomföra det schemalagda provet.
-
3. FAQ
-
Omvalidera LTI-konfigurationerna för både D2L Brightspace och Inspera.
I D2L Brightspace, validera verktygskonfigurationen genom att redigera verktyget från sektionen ”Manage Extensibility”.
Kontrollera noggrannheten i följande fält på nytt:
- Client ID,
- Brightspace Keyset URL,
- Brightspace OAuth2 Access token URL,
- OpenID Connect Authentication Endpoint,
- Brightscpace OAuth2 Audience &
- Issuer
Säkerställ att dessa uppgifter är korrekt konfigurerade för att garantera sömlös integration och funktionalitet.
I Inspera behöver Service Desk säkerställa att detaljerna nedan är korrekt konfigurerade:
-
Följande kan vara några troliga orsaker:
- Kontrollera och bekräfta om din LTI-version 1.3 har automatisk provisjonering aktiverad och är bakåtkompatibel.
- Säkerställ att inställningen för ”LTI Names and Role provisioning” är satt till alternativet:
”Use this service to retrieve member's information per privacy settings”.
Följ stegen nedan för att verifiera denna inställning med administratörsuppgifter:
- Logga in som Admin.
-
Klicka på Admin tools, välj sedan Manage Extensibility & växla till LTI Advantage. Klicka på namnet på det registrerade verktyget i listan.
-
Verifiera inställningen för LTI Names and Roles Provisioning.
- Skicka ”enroll_candidates=true” om medlemskapstjänsten (membership service) är tillgänglig.
-
Varför kan en kandidat inte starta en aktivitet?
Följande kan vara den troliga orsaken:
Om en kandidat startar en aktivitet som inte är konfigurerad i Inspera kommer detta att ge ett 404-fel.
För att undvika detta måste instruktören konfigurera en aktivitet i Inspera, alternativt kan instruktören inaktivera synlighetsreglaget i redigeringsinställningarna för den specifika länken så att den inte visas för studenten.