Skip to main content

LTI’s instellen

Note

Deze documentatie is vertaald met behulp van AI-ondersteunde machinevertaling. Vertalingen worden geleverd 'zoals ze zijn', zonder garantie van de juistheid ervan. De Engelse versie van deze inhoud is de officiële en gezaghebbende bron.

Algemene eigenschappen instellen voor nieuwe domeinen

Hier kun je de standaard algemene instellingen voor LTI-tools configureren. Als je afzonderlijke instellingen wilt aanpassen, kun je dat doen wanneer je een nieuwe toolprovider toevoegt.

  1. Selecteer in het Configuratiescherm voor systeembeheer onder Integratie de optie LTI-toolproviders.

  2. Selecteer Algemene eigenschappen beheren.

  3. Selecteer onder Beschikbaarheid van functies je voorkeur voor Koppelingen naar toolproviders maken:

    • Met Koppelingen toestaan naar toolproviders die niet expliciet zijn uitgesloten kunnen cursusleiders LTI-koppelingen toevoegen naar elk domein dat de beheerder bij het beheren van LTI-toolproviders niet specifiek heeft geblokkeerd.

    • Met Koppelingen toestaan naar alle toolproviders, maar goedkeuring vereisen voor elke nieuwe provider kunnen cursusleiders LTI-koppelingen toevoegen, maar als het een nieuw domein is, moet dit worden goedgekeurd door de beheerder.

    • Met Alleen koppelingen toestaan naar goedgekeurde toolproviders kunnen cursusleiders alleen LTI-koppelingen toevoegen als de beheerder het domein al heeft goedgekeurd.

  4. Geef aan of toolproviders cijfers mogen publiceren in het Grade Center. Deze algemene instelling geldt alleen voor LTI 1.1. Voor LTI 1.3 wordt beoordelen per tool ingesteld.

    • Wanneer deze algemene instelling is ingeschakeld, accepteert Blackboard LMS cijfers die door LTI-toolproviders worden gepubliceerd, maar alleen in Grade Center-kolommen die zijn gemaakt door plaatsingen van toolproviders in cursussen.

    • Een toolprovider kan deze instelling alleen benutten als deze is geconfigureerd met een plaatsing die beoordelen toestaat.

  5. In het gedeelte Standaardconfiguratie kun je algemene opties instellen voor gebruikersgegevens en het bevestigingsbericht voor gebruikers.

    • Uit veiligheidsoverwegingen raden we de optie Gebruikersgegevens alleen via SSL verzenden sterk aan. Deze instelling geldt alleen voor LTI 1.1. Voor LTI 1.3 is een SSL-verbinding (TLS 2) vereist.

    • Als je Nooit selecteert, worden alle opties onder Te verzenden gebruikersvelden uitgevinkt.

    • Als je Gebruikersgegevens alleen via SSL verzenden of Gebruikersgegevens via elke verbinding verzenden selecteert, worden bij Te verzenden gebruikersvelden drie vooraf geselecteerde velden weergegeven die je kunt aanpassen op basis van het privacybeleid van je instelling: Rol in cursus, Naam en E-mailadres.

    • Als je Ja selecteert in het gedeelte Toegang tot lidmaatschapsservice toestaan, kan de tool alle gebruikers of een deel van de gebruikers in een cursus opvragen (cursusleiders en studenten). Als je Nee selecteert, heeft de tool geen toegang tot die informatie en wordt de optie Bevestigingsbericht voor gebruikers weergeven beschikbaar. Als je bij die optie Ja selecteert, kun je een aangepast bericht aan je gebruikers tonen, bijvoorbeeld: ‘Je staat op het punt een LTI-tool van derden te starten.’

    • Selecteer Verzenden om de algemene eigenschappen in te stellen.

LTI-versies

Er zijn twee versies van LTI: v1.1 en v1.3. Elke versie vereist verschillende configuratiestappen. Voordat je een LTI-tool toevoegt, moet je weten welke versie het is.

LTI v1.0 lijkt sterk op het eveneens verouderde LTI v1.1, maar zonder de mogelijkheid om cijfergegevens terug te sturen. Als je een LTI v1.0-bron toevoegt, registreer deze dan als LTI v1.1.

De huidige versie is LTI v1.3. Het grootste verschil met eerdere versies is het verbeterde beveiligingsmodel op basis van OAuth2, OpenID Connect en JSON Web Tokens. Er is ook LTI Advantage, een pakket nieuwe extensieservices dat op LTI v1.3 is gebaseerd en zich buiten de LTI-specificatie verder ontwikkelt.

Een LTI 1.1-toolprovider toevoegen

Uitfasering van LTI 1.1

Blackboard heeft officieel aangekondigd dat de ondersteuning voor LTI 1.1 in Blackboard LMS eindigt. Lees de mededeling. LTI-versies ouder dan 1.3 hebben bekende en gedocumenteerde beveiligingskwetsbaarheden. Deze oudere versies van de norm zijn door de verantwoordelijke normalisatie-instantie, 1EdTech, verouderd verklaard. Als je een nieuwe tool ontwikkelt, gebruik dan uitsluitend LTI 1.3/Advantage.

  • 1 januari 2027: Het registreren van nieuwe LTI 1.0- en LTI 1.1-tools in Blackboard LMS is niet langer toegestaan. De registratieknop wordt voor deze oudere versies verwijderd.

  • 30 september 2027: Alle LTI 1.0- en LTI 1.1-tools zijn uitgeschakeld in Blackboard LMS en kunnen niet opnieuw worden ingeschakeld.

Belangrijk

Blackboard raadt aan voor LTI-integraties LTI 1.3 of nieuwer te gebruiken. We raden beheerders aan contact op te nemen met leveranciers die oudere versies van LTI gebruiken om een update aan te vragen. We raden instellingen die hun eigen integraties hebben ontwikkeld met behulp van oudere versies van LTI ook aan om hun tools bij te werken.

  1. Selecteer in het Configuratiescherm voor systeembeheer onder Integraties de optie LTI-toolproviders.

  2. Selecteer LTI 1.1-provider registreren.

  3. Typ het Providerdomein, zoals www.example.com.

  4. Selecteer de Status providerdomein: Goedgekeurd of Uitgesloten. Goedgekeurd is de standaardinstelling. Als je Uitgesloten selecteert, kunnen gebruikers geen LTI-koppelingen van een toolprovider toevoegen.

  5. Geef eventueel secundaire hostnamen voor de provider op. De provider kan deze informatie verstrekken.

  6. Vraag bij de provider na of configuratie voor de hele site of per koppeling is toegestaan en selecteer de Standaardconfiguratie dienovereenkomstig. Typ voor Algemeen instellen de Sleutel van toolprovider en het Geheim van toolprovider. Als je de Standaardconfiguratie op Voor elke koppeling afzonderlijk instellen laat staan, moeten gebruikers bij het maken van elke koppeling de sleutel en het geheim invoeren. Keuzes die je voor een afzonderlijke provider maakt, hebben voorrang op de Algemene eigenschappen.

  7. Voeg eventuele aangepaste parameters die de toolprovider vereist toe in het tekstvak Aangepaste parameters van toolprovider.

    • Elke parameter moet op een eigen regel staan.

    • Ze moeten de opmaak "naam=waarde" hebben.

    • Het kunnen vervangingsvariabelen zijn. Bijvoorbeeld:

      userNameLTI=$User.username

      useridLTI=$User.id

      userEmailLTI=$Person.email.primary

    • Het kunnen ook sjabloonvariabelen zijn. Deze variabelen worden omgezet met gegevens uit Blackboard LMS in de parameterindeling @x@user.full_name@x@. Bijvoorbeeld:

      crsRoleLrn=@X@membership.role@X@

      course_pl=@X@course.pk_string@X@

  8. Het gedeelte Instellingsbeleid neemt de voorkeuren over uit de Algemene eigenschappen. Hier kun je afzonderlijke instellingen beheren.

    • Uit veiligheidsoverwegingen raden we de optie Gebruikersgegevens alleen via SSL verzenden sterk aan.

    • Als je Nooit selecteert, worden alle opties onder Te verzenden gebruikersvelden uitgevinkt.

    • Als je Gebruikersgegevens alleen via SSL verzenden of Gebruikersgegevens via elke verbinding verzenden selecteert, worden bij Te verzenden gebruikersvelden drie vooraf geselecteerde velden weergegeven die je kunt aanpassen op basis van het privacybeleid van je instelling:

      Rol in cursus, Naam en E-mailadres.

    • Als je Ja selecteert in het gedeelte Toegang tot lidmaatschapsservice toestaan, kan de tool alle gebruikers of een deel van de gebruikers in een cursus opvragen (cursusleiders en studenten). Als je Nee selecteert, heeft de tool geen toegang tot die informatie en wordt de optie Bevestigingsbericht voor gebruikers weergeven beschikbaar. Als je bij die optie Ja selecteert, kun je een aangepast bericht aan je gebruikers tonen, bijvoorbeeld: ‘Je staat op het punt een LTI-tool van derden te starten.’

  9. Selecteer Verzenden om de LTI 1.1-tool toe te voegen.

Een LTI 1.3-/Advantage-tool toevoegen

  1. Selecteer in het Configuratiescherm voor systeembeheer onder Integraties de optie LTI-toolproviders.

  2. Selecteer LTI 1.3-/Advantage-tool registreren.

  3. Voer de Client-ID of toepassings-ID in die door de leverancier van de tool is verstrekt. Als je zelf een toepassing ontwikkelt, kun je je registreren op het Developer Portal en je toepassing registreren om de client-ID te krijgen.

    • Sommige LTI-tools ondersteunen de service Dynamische registratie om het registratieproces te vereenvoudigen wanneer beheerders de tool zelf moeten registreren. Als een tool dynamische registratie gebruikt, selecteer je Dynamische registratie op de pagina Mijn toepassingen. Voer de registratie-URL in die je van de toolprovider hebt gekregen en volg de stappen die de toolprovider voorschrijft.

  4. Selecteer Verzenden. De configuratie-instellingen van de toepassing uit het Developer Portal worden op de pagina weergegeven.

  5. De velden zijn alleen-lezen, maar je kunt de status van de tool selecteren als Goedgekeurd of Uitgesloten.

  6. Het gedeelte Instellingsbeleid neemt de voorkeuren over uit de Algemene eigenschappen. Hier kun je de instellingen voor de afzonderlijke provider beheren door de selectievakjes onder Te verzenden gebruikersvelden in of uit te schakelen: Rol in cursus, Naam en E-mailadres. Je kunt ook per tool toegang tot de cijferservice toestaan of weigeren.

  7. Als je Ja selecteert in het gedeelte Toegang tot lidmaatschapsservice toestaan, kan de tool alle gebruikers of een deel van de gebruikers in een cursus opvragen (cursusleiders en studenten). Als je Nee selecteert, heeft de tool geen toegang tot die informatie en wordt de optie Bevestigingsbericht voor gebruikers weergeven beschikbaar. Als je bij die optie Ja selecteert, kun je een aangepast bericht aan je gebruikers tonen, bijvoorbeeld: ‘Je staat op het punt een LTI-tool van derden te starten.’

  8. Keuzes die je voor een afzonderlijke provider maakt, hebben voorrang op de Algemene eigenschappen.

  9. Selecteer Verzenden om de LTI 1.3-/Advantage-tool toe te voegen.

Plaatsingen configureren: waar LTI-tools verschijnen

Nadat je een LTI-toolprovider hebt toegevoegd, kun je een plaatsing instellen zodat gebruikers de tool gemakkelijker kunnen vinden en gebruiken in de gebruikersinterface van Blackboard LMS. Een leverancier kan alle plaatsingen voor LTI 1.3-tools definiëren.

Als er geen plaatsing is geconfigureerd, moeten studenten en cursusleiders de URL of geheime sleutel kennen om de tool in cursussen te gebruiken, zoals beschreven in Teaching Tools via LTI Connection.

Een plaatsing maken

  1. Ga in LTI-toolproviders onder Beheerdershulpmiddelen naar de toolprovider die je wilt configureren en selecteer de menuoptie naast het domein. Ga naar Plaatsingen beheren.

  2. Selecteer Plaatsing maken.

  3. Typ een Label. Dit is de naam die gebruikers in een cursus zien.

  4. Voeg een beschrijving toe als de tool voor studenten in hun menu Tools wordt weergegeven. Cursusleiders zien geen beschrijvingen.

  5. Typ een Handle. Deze moet uniek zijn en mag alleen alfanumerieke tekens, onderstrepingstekens of streepjes bevatten.

  6. Selecteer Ja of Nee om de plaatsing beschikbaar of niet beschikbaar te maken.

  7. Selecteer een Type:

    Opmerking

    Je kunt het plaatsingstype van een bestaande plaatsing niet wijzigen. Je moet een nieuwe plaatsing maken om het type te wijzigen.

    • Deep Linking-inhoudstool: hiermee kunnen cursusleiders en cursusontwikkelaars de LTI-tool starten en inhoud van de toolprovider toevoegen in plaats van via de interface van Blackboard LMS. Als de toolprovider zo is geconfigureerd dat de cursusleider meerdere inhoudsitems in één import kan selecteren, kan deze tool tijd besparen en de workflow vereenvoudigen.

      • Toegang voor studenten toestaan: geef studenten toestemming om ook inhoud van de toolprovider toe te voegen.

    • Cursusinhoudstool: hiermee kunnen cursusleiders de tool toevoegen vanaf de pagina Cursusinhoud. Na toevoegen via het gedeelte Content Market wordt de tool onderdeel van het cursusoverzicht.

      • Staat beoordelen toe: hiermee kunnen cursusleiders beoordelingsfuncties aan de tool toevoegen, zoals de einddatum en het maximale aantal punten.

    • Cursustool: de tool wordt voor cursusleiders en cursusontwikkelaars weergegeven in het gedeelte Cursusbeheer van een Original-cursus en in het menu Boeken en tools van een Ultra-cursus.

      • Toegang voor studenten toestaan: indien geselecteerd, hebben studenten toegang tot de tool via het menu Tools voor studenten. Voeg een beschrijving toe om studenten te laten weten wat de tool is en wat deze doet.

    • Een systeemtool kan worden geopend zonder een cursus te openen. In de Original-ervaring wordt de tool weergegeven in het menu Tools van het tabblad Mijn instelling. In de Ultra-ervaring wordt de tool weergegeven in het gedeelte Tools van de basisnavigatie. Je kunt een systeemtool ook in een module van de instellingspagina plaatsen.

    • Met een beheerderstool kunnen beheerders de tool toevoegen aan het menu Hulpprogramma’s en hulpmiddelen in het Configuratiescherm voor systeembeheer.

    • Ultra-extensieplaatsingen zijn bedoeld voor bepaalde integraties. Gebruik deze plaatsing alleen als je integratieprovider dat aangeeft. Gebruik deze plaatsing niet als je integratie dit niet vereist.

    • Proctoringtool, Basisnavigatietool en Cursusnavigatietool zijn typen die exclusief zijn voor LTI 1.3/Advantage en door de toolprovider worden ingesteld. Je kunt ze openen, maar niet wijzigen.

  8. Schakel het selectievakje in als je deze tool in een nieuw venster wilt starten in plaats van in een iframe.

  9. Voeg een pictogram voor de tool toe door Bladeren te selecteren en een afbeelding van 50 x 50 pixels te uploaden. Als deze LTI-plaatsing zich in een cursus met de Originele cursusweergave bevindt, wordt het pictogram met de koppeling weergegeven in de lijst Tools. In de Ultra-cursusweergave wordt het pictogram met de koppeling weergegeven in Content Market, maar niet bij de koppeling op de pagina Cursusinhoud.

  10. Voer de gegevens van de toolprovider in. Meestal zijn dit de gegevens die je ook hebt opgegeven bij het maken van de tool, tenzij je meerdere plaatsingen voor dezelfde geregistreerde provider maakt.

  11. Selecteer Verzenden.

Waarschuwing

Als je een LTI-domein of -plaatsing verwijdert, werken alle bestaande LTI-koppelingen niet meer. Als je het LTI-domein of de LTI-plaatsing opnieuw toevoegt, worden de verbroken koppelingen niet hersteld. Verwijder een LTI-plaatsing of -domein alleen als je zeker weet dat je deze nooit meer gebruikt.

Als je een LTI 1.1-tool naar LTI 1.3 wilt migreren, maak je de nieuwe LTI-tool met hetzelfde domein en accepteer je de prompt om naar LTI 1.3 te migreren. Bestaande koppelingen worden dan veilig verwerkt.

Toegang tot tools en zichtbaarheid beheren

In cursussen met de Originele cursusweergave kunnen cursusleiders de beschikbaarheid van tools nog steeds overschrijven, als dat is toegestaan. De beschikbaarheid van tools in cursussen met de Ultra-cursusweergave wordt altijd door de beheerder beheerd.

  1. Selecteer in het Configuratiescherm voor systeembeheer onder Hulpprogramma’s en hulpmiddelen de optie Tools.

  2. Zoek de tool die je wilt in- of uitschakelen. Je ziet een lijst met interne tools, Building Block-tools en LTI-tools die je op type kunt filteren.

  3. Bij Beschikbaarheid selecteer je AAN of UIT.

  4. Je kunt wijzigingen ook toepassen op Nieuwe Original-cursussen en alle Ultra-cursussen of Nieuwe en bestaande cursussen.

  5. Selecteer Verzenden.