
Taal 🇳🇱 Nederlands
TLDR
FastComments-configuratie
Registreer de tool
Toevoegen aan een cursus
Gebruik de tool
Beveiliging & naleving
Polls
Voeg opmerkingen toe aan uw LMS via LTI 1.3
FastComments integreert met elk LTI 1.3-compliant LMS - D2L Brightspace, Moodle, Blackboard Learn, Sakai, Schoology en anderen - via de IMS LTI Dynamic Registration standard. Eén URL, geplakt in het registratieformulier van uw LMS, zet de hele integratie in werking: SSO, cursuscontext, roltoewijzing en plaatsing van inhoud. Geen plug-in die u op uw server hoeft te installeren. (Canvas LMS heeft een eigen speciale handleiding omdat de registratieflow anders is.)
Na registratie verschijnt FastComments als een Learning Tool binnen uw cursussen. Studenten zien geneste reacties en samenwerkingschat naast cursusinhoud, en ze zijn automatisch ingelogd met hun LMS-account.
Prijzen 
De FastComments LTI 1.3-integratie is inbegrepen bij de Flex- en Pro-plannen zonder extra kosten. Het werkt met elk LMS dat de IMS LTI 1.3 Advantage-specificatie ondersteunt, inclusief Dynamic Registration.
Snelstart 
- Meld je aan bij FastComments en ga naar je LTI 1.3-configuratiepagina.
- (Optioneel) Kies het platform waarvandaan je verbinding maakt in het keuzemenu Platform - dit stelt het weergegeven label in, maar Automatisch detecteren werkt prima.
- Klik op Genereer URL. Er verschijnt een eenmalige Registratie-URL (geldig gedurende 30 minuten, voor eenmalig gebruik).
- Open in je LMS het LTI 1.3 Dynamic Registration-scherm en plak de URL in het veld Tool initiation registration endpoint (of gelijkwaardig). Verstuur.
- Je LMS maakt een callback naar FastComments, wisselt sleutels uit en maakt de integratie aan. De pop-up sluit zichzelf wanneer dat klaar is.
- Terug in FastComments verschijnt de nieuwe configuratie in de tabel Bestaande configuraties. De tool is nu beschikbaar binnen je LMS-cursussen.
Ondersteunde platforms 
FastComments LTI 1.3 is getest met:
- D2L Brightspace (elke versie met LTI Advantage)
- Moodle 4.0+ (External Tool-plug-in, LTI Advantage)
- Blackboard Learn (SaaS en Ultra)
- Sakai (versies met ondersteuning voor LTI Advantage)
- Schoology (Enterprise, Dynamic Registration waar beschikbaar)
Elke andere LMS die de IMS LTI 1.3 Advantage-specificatie met Dynamic Registration implementeert, zou ook moeten werken - selecteer Other LTI 1.3 platform in het platform-dropdown wanneer je je registratie-URL genereert (haal het hier op).
Canvas LMS gebruikt een andere installatieprocedure (per-developer-key configuration JSON in plaats van Dynamic Registration). Zie de toegewijde Canvas LMS-installatiegids.
Genereer registratie-URL 
Navigeer naar LTI 1.3-configuratie
Meld u aan bij FastComments en ga naar uw LTI 1.3-configuratiepagina.
Als uw account nog geen LTI-toegang heeft, ziet u "LTI not enabled for this account" - neem contact op met support om het op uw plan te activeren.
Kies een platform (optioneel)
Onder Dynamische registratie-URL genereren, gebruikt u de vervolgkeuzelijst Platform om FastComments te vertellen met welk LMS u verbinding maakt:
- D2L Brightspace
- Moodle
- Blackboard Learn
- Sakai
- Schoology
- Andere LTI 1.3-platform
U kunt het ook op Automatisch detecteren laten staan. Het platform wordt tijdens registratie uit de openid-configuration van uw LMS gelezen; de vervolgkeuzelijst vult alleen het weergavelabel voor de resulterende configuratie.
URL genereren
Klik op Genereer URL. FastComments maakt een eenmalige registratietoken aan en toont u een URL die er als volgt uitziet:
https://fastcomments.com/lti/v1p3/register/<long-token>
Kopieer deze. Deze URL:
- Is eenmalig - zodra uw LMS er met succes een oproep naar doet, wordt het registratietoken verbruikt.
- Vervalt na 30 minuten als het niet wordt gebruikt.
- Moet privé worden gehouden - iedereen met de URL kan binnen die 30 minuten een tool registreren voor uw tenant.
Bestaande configuraties
Zodra een registratie succesvol is voltooid, verschijnt de nieuwe configuratie in de tabel Bestaande configuraties op dezelfde pagina, met Platform, Issuer, Client ID en Status. U kunt configuraties uit deze tabel verwijderen als u ze ooit wilt de-registreren.
Registreren in D2L Brightspace 
D2L Brightspace stelt Dynamic Registration beschikbaar via de LTI Advantage admin-interface. Je hebt administrator-toegang nodig.
Open het Registratiescherm
- Log in op je Brightspace-instantie als admin.
- Navigeer naar Admin Tools > Manage Extensibility > LTI Advantage.
- Klik op Register Tool. (De directe URL is
https://<your-brightspace-host>/d2l/le/ltiadvantage/registrations/create.)
Plak de URL
Je ziet een registratieformulier. Het belangrijkste veld is Tool initiation registration endpoint (sommige Brightspace-versies noemen het "Tool Initiation Registration URL").
Plak de FastComments-registratie-URL (haal hem hier op) in dat veld. Laat de andere velden leeg - deze worden automatisch gevuld door FastComments tijdens de registratie-handshake.
Klik op Register.
Keur de Tool Goed
Brightspace opent een popup die met FastComments communiceert, sleutels uitwisselt en een bevestigingsscherm toont. De popup sluit zichzelf wanneer de registratie is voltooid.
De nieuwe tool verschijnt in je LTI Advantage-toollijst. Standaard markeert Brightspace nieuwe tools als disabled - zet de schakelaar op enabled zodat je cursussen deze kunnen gebruiken.
Voeg een Deployment Toe
In Brightspace hebben LTI-tools een deployment nodig voordat ze in cursussen kunnen worden gebruikt:
- Open de zojuist geregistreerde FastComments-tool.
- Klik op View Deployments > New Deployment.
- Geef de deployment een naam (bijv. "FastComments - All Courses"), kies de org-units waarin deze beschikbaar moet zijn en sla op.
Na de eerste lancering via deze deployment koppelt FastComments de deployment_id aan zijn configuratierecord - daaropvolgende lanceringen vanaf een andere deployment onder dezelfde client worden afgewezen, tenzij je opnieuw registreert.
Registreren in Moodle 
Gebruik je Moodle? We publiceren ook een speciale Moodle-plug-in voor FastComments met een nauwere integratie dan LTI 1.3 (hooks voor synchronisatie van cijfers, uitgebreidere activiteitrapportage, native Moodle-instellingen-UI). Zie de Moodle plug-in installatiehandleiding. De LTI 1.3 flow hieronder is de juiste keuze als je een enkele registratie wilt die ook andere LMSes dekt, of als je Moodle-beheerder geen plug-ins van derden wil installeren.
Moodle 4.0+ ondersteunt LTI 1.3 Dynamic Registration via de External Tool-plug-in.
Open het Toolbeheer-scherm
- Meld je aan bij Moodle als sitebeheerder.
- Navigeer naar Site administration > Plugins > Activity modules > External tool > Manage tools.
Plak de URL
Je ziet een kaart met het label Tool URL. Plak de FastComments-registratie-URL (get it here) in het tekstveld en klik op Add LTI Advantage.
Moodle opent een registratiescherm waarin de identiteit van de tool en de gevraagde machtigingen worden weergegeven. Controleer dit en klik op Activate (of Register, afhankelijk van de Moodle-versie).
De popup sluit zodra de registratie is voltooid; de nieuwe FastComments-tool verschijnt in de lijst Tools met de status Active.
Maak het beschikbaar
Standaard voegt Moodle nieuwe tools toe aan de lijst "Course tools", maar toont ze niet in de activiteitskiezer. Om FastComments cursusbreed zichtbaar te maken:
- Klik op het tandwielpictogram op de FastComments-tegel.
- Kies onder Tool configuration usage voor Show in activity chooser and as a preconfigured tool.
- Opslaan.
Docenten kunnen nu FastComments aan elke cursus toevoegen via Add an activity or resource > FastComments.
Registreren in Blackboard Learn 
Blackboard Learn SaaS en Ultra ondersteunen LTI 1.3 Dynamic Registration.
Open het Tool Provider-scherm
- Meld u aan bij Blackboard als systeembeheerder.
- Ga naar Administrator Panel > Integrations > LTI Tool Providers.
- Klik op Register LTI 1.3 / LTI Advantage Tool.
Als u alleen "Register LTI 1.1 Provider" ziet, ondersteunt uw Blackboard-versie LTI 1.3 nog niet - upgrade of neem contact op met Blackboard support.
Plak de URL
Plak de FastComments-registratie-URL (haal het hier op) in het veld Client ID / Registration URL (de benaming in Blackboard varieert per versie). Indienen.
Blackboard voert de registratie-handshake met FastComments uit en toont een bevestigingsscherm.
Goedkeuren en inschakelen
Blackboard markeert nieuw-geregistreerde tools standaard als Approved but excluded:
- Zoek de FastComments-vermelding in de tool provider-lijst.
- Open het menu en kies Edit.
- Stel Tool Status in op Approved.
- Controleer onder Institution Policies welke gebruikersgegevens worden verzonden (naam, e-mail, rol). Sla op.
De tool is nu beschikbaar voor docenten wanneer zij inhoud aan cursussen toevoegen.
Registreren in Sakai of Schoology 
Sakai
Sakai ondersteunt LTI 1.3 Dynamic Registration op releases met LTI Advantage. Vanuit de Administration Workspace:
- Log in als Sakai-beheerder en open de Administration Workspace.
- Kies External Tools > Install LTI 1.3 Tool.
- Plak de FastComments registratie-URL (verkrijg deze hier) en verstuur.
- Keur de tool goed zodra de handshake is voltooid.
De tool verschijnt vervolgens onder External Tools en kan door site-beheerders aan sites worden toegevoegd.
Schoology
Schoology Enterprise-instanties ondersteunen LTI 1.3, maar de beschikbaarheid van Dynamic Registration verschilt per implementatie. Neem contact op met je Schoology-accountmanager.
Als Dynamic Registration niet beschikbaar is op jouw Schoology-instantie, moet je de integratie handmatig configureren met behulp van deze endpoints:
- OIDC Login URL:
https://fastcomments.com/lti/v1p3/login - Target Link URL:
https://fastcomments.com/lti/v1p3/launch - Public Keyset URL (JWKS):
https://fastcomments.com/lti/v1p3/jwks - Redirect URLs:
https://fastcomments.com/lti/v1p3/launch
Nadat Schoology je een Client ID en Deployment ID heeft gegeven, neem je contact op met FastComments support om de configuratie op je tenant te registreren.
Andere LTI 1.3 Platforms
Elk LMS dat de IMS LTI 1.3 Advantage-specificatie volgt, zou moeten werken met dezelfde registratie-URL (verkrijg deze hier). Zoek naar een instelling met de naam "Dynamic Registration", "Tool Registration URL", "Tool initiation registration endpoint" of iets dergelijks.
Als je platform alleen handmatige LTI 1.3-configuratie ondersteunt, gebruik dan de vier endpoints die in de Schoology-sectie hierboven staan en neem contact op met support om af te ronden.
Toevoegen aan D2L-cursusinhoud 
Deze pagina behandelt het toevoegen van FastComments aan een Brightspace-cursus nadat een beheerder de tool heeft geregistreerd en een deployment heeft aangemaakt. Als de tool nog niet is geregistreerd, raadpleeg dan eerst de D2L-registratiegids.
Brightspace biedt twee content-authoring-ervaringen: Classic Content en de New Content Experience (ook wel Lessons genoemd). Beide bieden FastComments aan, maar de menupaden verschillen. Elke sectie hieronder behandelt beide waar ze uiteenlopen.
De FastComments-tool vinden
De FastComments-tool verschijnt op twee plaatsen binnen een cursuscontent-editor:
- De activiteitenkiezer, bereikbaar via de knop Add Existing van een module/eenheid (gelabeld Add Existing Activities in oudere Brightspace-versies). FastComments verschijnt direct in de kiezer in huidige Brightspace-builds; oudere versies nesten het onder een submenu External Learning Tools. Beide paden voegen FastComments toe als een zelfstandig onderwerp.
- Het dialoogvenster Insert Stuff binnen de HTML-editor, onder LTI Advantage. Dit embedt FastComments inline in een HTML-onderwerp via de LTI deep linking-flow.
Als FastComments in geen van beide kiezers verschijnt, is de deployment niet ingeschakeld voor de org-eenheid die de cursus bevat. Vraag uw Brightspace-beheerder om Admin Tools > Manage Extensibility > LTI Advantage > FastComments-tool > View Deployments te openen, de deployment te openen en de org-eenheid van de cursus (of een bovenliggende org-eenheid) toe te voegen onder Org Units.
FastComments toevoegen als onderwerp in een module
Classic Content:
- Open de cursus en klik op Content in de navigatiebalk.
- Selecteer de module die de discussie moet bevatten (of maak er een aan via Add a module).
- Klik op Add Existing (oudere Brightspace: Add Existing Activities > External Learning Tools).
- Klik in de kiezer op FastComments. Brightspace maakt een onderwerp aan in de module en brengt u terug naar de contentweergave.
- Klik op het nieuwe onderwerp. Hernoem het naar iets beschrijvends zoals
FastComments Discussionvia de inline titel-editor.
New Content Experience (Lessons):
- Open de cursus en klik op Content.
- Open de eenheid en les die de discussie moeten bevatten.
- Klik op Add > Existing Activity en selecteer FastComments (oudere Brightspace: genest onder External Learning Tools).
- De activiteit wordt toegevoegd aan de les.
- Klik op de activiteitstitel om deze te hernoemen.
De eerste keer dat een gebruiker (instructeur of student) het onderwerp opent, initialiseert FastComments de thread voor die resource link. De thread is gebonden aan de resource link-ID, dus het hernoemen of verplaatsen van het onderwerp verandert niet welke thread wordt geladen.
FastComments inline embedden in een HTML-onderwerp
Gebruik deze flow wanneer u reacties onder een leestekst, video of andere content binnen dezelfde onderwerppagina wilt laten verschijnen in plaats van als een apart onderwerp.
- Open of maak een HTML-onderwerp aan in de module/les.
- Klik op Edit HTML om de Brightspace HTML-editor te openen.
- Plaats de cursor waar de reactiethread moet verschijnen.
- Klik op de knop Insert Stuff (puzzelstukje-icoon in de werkbalk van de editor).
- Scroll in het Insert Stuff-dialoogvenster naar LTI Advantage en klik op FastComments.
- FastComments opent een deep linking-kiezer. Bevestig de plaatsing (de standaardopties werken voor contentdiscussies); klik op Insert of Continue.
- Brightspace keert terug naar de HTML-editor met een placeholder-blok dat de LTI-launch vertegenwoordigt. Klik op Save and Close bij het onderwerp.
Wanneer het onderwerp laadt, vervangt Brightspace de placeholder door een iframe dat FastComments automatisch via LTI lanceert. Studenten zien de discussiethread inline.
Eén HTML-onderwerp kan meerdere deep-linked FastComments-embeds bevatten. Elke embed krijgt zijn eigen thread, omdat elke deep link een unieke resource link-ID oplevert.
Module-onderwerp vs. inline quicklink
Kies de aanpak module-onderwerp wanneer:
- De discussie de primaire activiteit is voor die stap in de module.
- U wilt dat het onderwerp verschijnt in de inhoudsopgave van Brightspace, de voortgangsbijhouding en Class Progress.
Kies de aanpak inline embed wanneer:
- Reacties onder andere content op dezelfde pagina moeten verschijnen.
- U geen apart, op volledigheid bij te houden item in de inhoudsopgave wilt.
Zichtbaarheid, concept en releasevoorwaarden
Een nieuw FastComments-onderwerp is standaard zichtbaar voor studenten. Om het te verbergen tijdens het instellen:
- Klik in de content-editor op de onderwerptitel (Classic) of het drie-stippen-menu bij de activiteit (New Content Experience).
- Zet de status op Draft (Classic) of schakel Visibility uit (New Content Experience).
Conceptonderwerpen zijn onzichtbaar voor studenten. Instructeurs en TA's zien ze nog steeds met een "Draft"-badge.
Om het onderwerp te beperken tot een specifieke groep of sectie:
- Open het onderwerp.
- Klik op het menu van de onderwerptitel > Edit Properties In-place (Classic) of Edit > Restrictions (New Content Experience).
- Klik onder Release Conditions op Create.
- Kies Group enrollment of Section enrollment, selecteer de groep/sectie en sla op.
Releasevoorwaarden stapelen op met de eigen roltoewijzing van FastComments. Studenten die het onderwerp niet kunnen zien, krijgen geen LTI-launch.
Wat studenten zien bij de eerste launch
Wanneer een student op het onderwerp klikt (of een HTML-onderwerp met een embed laadt):
- Brightspace voert de LTI 1.3-launch op de achtergrond uit.
- FastComments ontvangt de naam, het e-mailadres, de avatar-URL en de LMS-rol van de student en meldt deze automatisch aan. Er is geen FastComments-inlogprompt.
- De reactiethread voor die resource link wordt weergegeven binnen het Brightspace-iframe.
Roltoewijzing bij launch:
- Brightspace
Administratorwordt een FastComments admin voor de thread (volledige moderatie-, verwijder-, ban- en configuratietoegang). - Brightspace
Instructorwordt een FastComments moderator (vastpinnen, verbergen, verwijderen, bannen). - Alle andere rollen (
Learner,TeachingAssistant, enz.) worden standaardreactieplacers.
Reacties worden toegeschreven aan het Brightspace-account van de student. Als de student zijn naam of avatar in Brightspace wijzigt, synchroniseert de volgende LTI-launch de wijziging.
Publieke toegang vergrendelen (aanbevolen)
Standaard zijn FastComments-reactiegegevens publiek leesbaar. Iedereen die de URL of het API-eindpunt van een thread kan raden, kan de reacties bekijken, zelfs buiten Brightspace. Voor cursusdiscussies wilt u vrijwel zeker het bekijken beperken tot alleen ingeschreven studenten.
Open uw widget-aanpassingspagina en maak een regel aan met Require SSO To View Comments ingeschakeld, en stel vervolgens het beveiligingsniveau in op Secure SSO, zodat threads alleen via de ondertekende LTI-launch kunnen worden geladen.
Zie Protecting Comment Threads With Single-Sign-On voor de volledige uitleg, inclusief hoe u de regel kunt beperken tot één domein of pagina.
Iframe-hoogte en formaatwijziging
FastComments zendt het org.imsglobal.lti.frameResize postMessage uit bij elke thread-render en bij contentwijzigingen (nieuwe reactie, reacties uitklappen). Brightspace luistert naar dit bericht en past de iframe-hoogte aan, zodat de thread niet wordt afgesneden en geen interne scrollbar toont.
Als het iframe op een vaste, korte hoogte blijft:
- Controleer of de cursus via HTTPS wordt geladen. De postMessage-listener van Brightspace wijst mixed-content-frames af.
- Controleer of geen enkele browserextensie het postMessage-kanaal blokkeert.
- Voor inline embeds in een HTML-onderwerp mag de omliggende HTML het iframe niet in een container met vaste hoogte wikkelen. Verwijder eventuele inline
style="height: ..."van het bovenliggende element.
Brightspace-specifieke valkuilen
Tool verschijnt niet in de Add Existing-kiezer. De deployment is niet ingeschakeld voor de org-eenheid van deze cursus. Een beheerder moet de org-eenheid (of een bovenliggende) toevoegen aan de lijst Org Units van de deployment. Alleen toolregistratie is niet voldoende; de deployment bepaalt welke cursussen de tool zien.
deployment_id-mismatch bij launch. FastComments pinnt de eerste deployment_id die het ziet voor een registratie (TOFU). Als een beheerder de oorspronkelijke deployment verwijdert en een nieuwe aanmaakt, worden launches vanaf de nieuwe deployment afgewezen met een deployment-mismatch-fout. De oplossing is om FastComments opnieuw te registreren (genereer een nieuwe registratie-URL (verkrijg die hier) en voer Dynamic Registration opnieuw uit); het oude configuratierecord wordt vervangen.
Tool lanceert maar toont "Invalid LTI launch". De cursus bevindt zich in een andere tenant/org-structuur dan de deployment dekt, of de deployment is na registratie uitgeschakeld. Controleer opnieuw de Enabled-schakelaar onder Admin Tools > Manage Extensibility > LTI Advantage > FastComments en de org-eenheidlijst van de deployment.
Namen en rollen ontbreken in FastComments. Brightspace stuurt LTI-launches met Names and Role Provisioning Services (NRPS)-claims. Als een cursus is opgewaardeerd vanaf een oudere LTI 1.1-link, ontbreken de name- en email-claims in de launch. Voeg het FastComments-onderwerp opnieuw toe via Add Existing (migreer de oude link niet) zodat de launch LTI 1.3 gebruikt.
Embed toont een inlogscherm in plaats van auto-SSO. Het HTML-onderwerp is ingevoegd als een plat <iframe> dat naar FastComments verwijst in plaats van via Insert Stuff > LTI Advantage. Platte iframes slaan de LTI-launch over en leiden gebruikers naar de publieke FastComments-pagina. Verwijder het iframe en voeg het opnieuw in via de Insert Stuff-flow.
Toevoegen aan Moodle-cursusinhoud 
Deze handleiding behandelt het toevoegen van FastComments aan een Moodle 4.x-cursus nadat een sitebeheerder de tool heeft geregistreerd en heeft ingesteld om te tonen in de activity chooser. Als FastComments nog niet geregistreerd is, raadpleeg eerst de Moodle-registratiehandleiding.
Open de cursus in de bewerkingsmodus
- Meld u aan bij Moodle als een Editing Teacher (of een hoger niveau) voor de cursus.
- Open de cursus.
- Schakel Edit mode in met de schakelaar in de rechterbovenhoek van de cursuskop.
Moodle 4.x heeft de verouderde dropdown "Add an activity or resource" uit 3.x vervangen door een full-screen activity chooser dialog. Moodle 4.5 behoudt dezelfde chooser maar voegt een starred/favorites-rij bovenaan toe, dus het vastpinnen van FastComments maakt het later sneller bereikbaar in andere secties.
Voeg de FastComments-activiteit toe
- Scroll naar de cursussectie (topic of week) waar de discussie hoort.
- Klik onderaan die sectie op Add an activity or resource.
- Selecteer in het chooser-venster FastComments. Als u het niet ziet, ga naar de gotchas-sectie hieronder.
Het instellingenformulier voor de activiteit wordt geopend. De velden die van belang zijn:
- Activity name (vereist). Wordt weergegeven op de cursuspagina en in het cijferschema. Voorbeeld:
Week 3 Discussion. - Activity description. Optionele inleidende tekst die boven de commentaardraad wordt weergegeven.
- Show description on course page. Vink dit aan als u de beschrijving zichtbaar wilt hebben zonder in de activiteit te hoeven klikken.
- Preconfigured tool. Ingesteld op
FastComments(automatisch geselecteerd wanneer gestart vanuit de chooser). Niet wijzigen. - Launch container. Instellen op New window. Zie de gotchas-sectie voor waarom "Same window" in sommige Moodle-implementaties breekt.
- Tool URL, Public key, Shared secret, Custom parameters. Laat leeg. Dynamic Registration heeft deze op siteniveau afgehandeld.
Scroll naar beneden en klik op Save and return to course (of Save and display om de activiteit direct te openen).
De activiteit verschijnt als een rij in de sectie met het FastComments-pictogram. Studenten klikken op de rij om de commentaardraad te openen.
FastComments inline insluiten met de editor
Voor een draad binnen een Page, Book-hoofdstuk, Lesson of een andere resource die de Atto- of TinyMCE-editor gebruikt:
- Open de resource in de bewerkingsmodus.
- Plaats de cursor waar de draad moet verschijnen.
- Klik in de editorwerkbalk op de LTI / External tool-knop. In Atto staat deze gelabeld als "Insert LTI Advantage content". In TinyMCE (standaard in Moodle 4.3+) staat het onder het More-menu als External tools.
- Kies FastComments uit de lijst met tools.
- FastComments opent een deep-linking picker. Bevestig de draadtitel en klik op Embed.
- De editor voegt een LTI-placeholderblok in. Sla de resource op.
Elke ingebedde instantie is een aparte draad die is gekoppeld aan de deep-link content item ID, dus een Page met drie FastComments-embeds krijgt drie onafhankelijke draden.
Beperk toegang en groepsinstellingen
De standaardinstellingen voor Moodle-activiteiten zijn van toepassing op FastComments-activiteiten:
- Common module settings > Group mode. Het instellen hiervan op Separate groups of Visible groups splitst FastComments niet automatisch in per-groep draden. Moodle's groepsmodus filtert alleen het cijferschema en de ledenlijst. Om een aparte draad per groep te draaien, voeg per groep één FastComments-activiteit toe en gebruik Restrict access om elke activiteit te beperken.
- Restrict access > Add restriction. Ondersteunt de standaard Moodle-condities: Date, Grade, Group, Grouping, User profile, en geneste restrictiesets. Gebruik Group om een FastComments-activiteit aan één groep te koppelen.
- Activity completion. Stel in op Students must view this activity to complete it als u voltooiingstracking wilt. FastComments rapporteert momenteel geen voltooiingsgebeurtenis terug naar Moodle behalve de launch.
Roltoewijzing
FastComments leest de LTI roles claim die Moodle bij elke launch verzendt en mapt deze als volgt:
- Moodle Manager of Site administrator -> FastComments admin
- Moodle Editing teacher of Non-editing teacher -> FastComments moderator
- Moodle Student -> FastComments commenter
- Moodle Guest -> read-only
Admins kunnen elke opmerking verwijderen, gebruikers verbannen en draadinstellingen bewerken. Moderators kunnen opmerkingen verwijderen en goedkeuren binnen de draad waarin ze geopend zijn. Aangepaste Moodle-rollen erven de mapping van het archetype waaruit ze gekloond zijn.
Wat studenten zien
Studenten klikken op de FastComments-activiteit (of scrollen naar het ingebedde blok binnen een Page of Book). Moodle stuurt hun identiteit naar FastComments via de LTI-launch:
- Geen inlogscherm. FastComments logt hen in met het Moodle-account.
- Hun weergavenaam, e-mail en avatar komen van Moodle.
- De draad is geschaald naar (Moodle site, course, resource link ID), dus dezelfde activiteit die naar een andere cursus wordt gekopieerd, krijgt een nieuwe draad.
- Gelaagde reacties, stemmen en notificaties werken hetzelfde als in een zelfstandige FastComments-draad.
Beperk publieke toegang (aanbevolen)
Standaard zijn FastComments-commentaargegevens publiekelijk leesbaar. Iedereen die de URL of API-endpoint van een draad kan raden, kan de opmerkingen bekijken, zelfs buiten Moodle. Voor cursusdiscussies wilt u vrijwel zeker het bekijken beperken tot alleen ingeschreven studenten.
Open uw widget customization page en maak een regel aan met Require SSO To View Comments ingeschakeld, en zet vervolgens het beveiligingsniveau op Secure SSO zodat draden alleen via de ondertekende LTI-launch kunnen worden geladen.
Zie Protecting Comment Threads With Single-Sign-On voor de volledige walkthrough, inclusief hoe u de regel kunt beperken tot een enkele domein of pagina.
Moodle gotchas
FastComments ontbreekt in de activity chooser. De sitebeheerder heeft de tool geregistreerd maar heeft Tool configuration usage niet ingesteld op Show in activity chooser and as a preconfigured tool. Los dit op via Site administration > Plugins > Activity modules > External tool > Manage tools > tandwielpictogram op de FastComments-tegel.
Launch faalt of toont een leeg frame wanneer ingesteld op "Same window". Moodle's sessiecookies gebruiken standaard SameSite=Lax, en sommige browsers verwijderen ze bij de cross-site POST die LTI 1.3 gebruikt om terug te keren van FastComments. Stel Launch container in op New window voor de activiteit. Dit is een harde eis voor ingebedde FastComments binnen een Page of Book, aangezien het in de editor ingebedde launch-pad altijd een nieuw venster opent.
De iss claim is de Moodle-site-URL, niet een tenant-ID. FastComments gebruikt de Moodle-site-URL (de wwwroot config value) als de LTI-issuer. Als uw Moodle-instance naar een nieuw domein verhuist of u wwwroot wijzigt, blijven bestaande FastComments-draden gekoppeld aan de oude issuer en komen ze niet overeen met nieuwe launches. Registreer de tool opnieuw tegen de nieuwe URL en migreer draden via de FastComments-admin indien nodig.
Activity backup en restore. Het back-uppen van een cursus en het herstellen in een nieuwe cursus maakt nieuwe resource link IDs aan, dus de herstelde FastComments-activiteiten starten met lege draden. De originele cursus behoudt de originele draden. Dit is het bedoelde gedrag, geen bug.
Moodle 4.5 TinyMCE-standaard. Moodle 4.5 wordt geleverd met TinyMCE als standaardeditor voor nieuwe installaties. De External tool-knop bevindt zich onder het More (...) menu in plaats van de hoofdwerkbalk. Oudere sites die zijn geüpgraded vanaf 4.1 behouden Atto tenzij een beheerder de standaard heeft gewijzigd.
Toevoegen aan Blackboard-cursusinhoud 
Zodra een beheerder FastComments als LTI 1.3 Advantage-tool heeft geregistreerd en het instellingsbeleid heeft goedgekeurd, voegen docenten het toe aan cursussen via de standaard Blackboard-plaatsingspunten. De exacte stappen verschillen tussen Ultra Course View en Original Course View, dus beide worden hieronder behandeld.
Ultra Course View
Ultra Course View is sinds 2026 de standaard in Blackboard Learn SaaS.
- Open de cursus en ga naar de pagina Course Content.
- Beweeg met de muis of tik op de plek waar je de commentaardraad in de structuur wilt plaatsen en klik op de paarse knop + (Add content).
- Kies Content Market. Het Content Market-paneel toont elke goedgekeurde LTI-tool en Building Block-plaatsing voor jouw instelling.
- Zoek de tegel FastComments en klik erop. Blackboard maakt een content-item aan op de positie waar je het menu + opende.
- Het item verschijnt standaard in de structuur als vermelding "Visible to students" voor docenten die Hide from students uit hebben staan als persoonlijke standaardinstelling. Als jouw standaardinstelling Hidden is, wordt het item verborgen aangemaakt en kun je de zichtbaarheidskeuze op de itemrij omschakelen wanneer je er klaar voor bent.
- Om het item te hernoemen, klik je op de titel in de structuur en typ je een nieuw label. De titel die studenten in de structuur zien is onafhankelijk van de FastComments-thread-identificatie, dus hernoemen is op elk moment veilig.
Als je Content Market niet als optie ziet, heeft jouw instelling de plaatsing verborgen. Je bereikt dezelfde kiezer ook via More tools in hetzelfde menu + onder de groep LTI Tools.
Original Course View
Original Course View wordt nog steeds ondersteund in Learn SaaS en blijft de primaire ervaring voor zelf-gehoste Learn 9.1-sites op de Q4 2024 CU-releaselijn.
- Open de cursus en ga naar een Content Area (bijvoorbeeld het standaard Information- of Content-gebied in het cursusmenu).
- Zet Edit Mode aan met de schakelaar rechtsboven op de pagina.
- Klik op Build Content in de actiebalk.
- Klik onder het submenu Learning Tools op FastComments. Het submenu Learning Tools wordt gevuld vanuit LTI 1.3-toolplaatsingen nadat een beheerder de tool heeft geregistreerd. Als je het niet ziet, raadpleeg dan de sectie met valkuilen hieronder.
- Stel in het formulier Create FastComments het volgende in:
- Name: het label dat studenten in het contentgebied zien.
- Description: optionele tekst die boven de ingesloten draad wordt getoond.
- Permit Users to View this Content: Ja/Nee-beschikbaarheidsschakelaar.
- Track Number of Views: schakel in als je de statistieken per item van Blackboard wilt. FastComments draait zijn eigen analytics onafhankelijk.
- Date and Time Restrictions: optionele vensters Display After / Display Until.
- Verzenden. De tool verschijnt als klikbaar item in het contentgebied.
Insluiten in een Item of Document
In beide cursusweergaven sluiten docenten FastComments inline in de body van een Item, Document of elk rich-text-veld in via de LTI Advantage-knop van de Content Editor.
Ultra Course View:
- Maak een Document aan of bewerk er een.
- Klik op Add content in de documentbody waar je de draad wilt laten verschijnen.
- Open in de werkbalk van de editor het menu Insert content en klik op Content Market (het LTI Advantage / Deep Linking-toegangspunt).
- Kies FastComments. FastComments retourneert een deep-link-payload en Blackboard voegt een ingesloten blok toe in de documentbody op de cursorpositie.
- Sla het document op. Studenten zien de draad inline weergegeven terwijl ze erlangs scrollen.
Original Course View:
- Bewerk elk item met een rich-text-body.
- Klik in de werkbalk van de Content Editor op het plus-icoon Add Content en kies Content Market (gelabeld Add Content from External Tool in oudere Q4 2024 CU's).
- Kies FastComments. De editor voegt een placeholder-blok in dat verwijst naar de deep-linked resource.
- Verzend het item.
Elke deep-link-embed produceert zijn eigen FastComments-thread, dus een Item met twee ingesloten FastComments-blokken heeft twee onafhankelijke commentaarstromen.
Zichtbaarheid, Release Conditions en Groepsbeperkingen
FastComments-content-items gedragen zich zoals elk ander Blackboard-content-item wat betreft de toegangscontrolleregels die erbovenop worden toegepast.
- Ultra: klik op de zichtbaarheidskeuze op de rij (Visible to students, Hidden from students, Conditional availability). Conditional availability ondersteunt datum/tijd-vensters, prestatieregels op gradebook-items en ledenregels op cursusgroepen.
- Original: open het contextmenu van het item en kies Adaptive Release of Adaptive Release: Advanced om de tool te beperken op datum, lidmaatschap, cijfer of beoordelingsstatus. Gebruik Set Group Availability op het item om te beperken tot specifieke cursusgroepen.
FastComments respecteert wat de gate van Blackboard beslist. Als Blackboard het item voor een student verbergt, vindt de LTI-launch nooit plaats voor die student en verschijnt hij niet in de moderatorweergave.
Gedrag van het Gradebook
FastComments rapporteert geen cijfers terug via LTI Advantage Assignment and Grade Services. Er wordt automatisch geen cijferkolom aangemaakt voor FastComments-content-items.
Als je Blackboard-tenant is geconfigureerd om automatisch een gradebook-kolom aan te maken voor elk nieuw content-item, ongeacht de beoordelingsmetadata, verschijnt er toch een lege kolom. Om die te verbergen:
- Ultra: open de Gradebook, klik op de kolomkop, kies Edit en zet Show to students en Include in calculations uit. Of gebruik Delete als jouw instelling het verwijderen van kolommen voor niet-beoordeelde items toestaat.
- Original: open de Grade Center, klik op het chevron-pictogram van de kolom, kies Hide from Users (on/off) en optioneel Hide from Instructor View onder Column Organization.
Wat Studenten Zien
Wanneer een student het FastComments-item opent of naar een ingesloten blok scrolt:
- Blackboard start het LTI 1.3-bericht naar FastComments. De student is aangemeld via SSO met zijn Blackboard-identiteit (naam, e-mail, avatar, rol) zonder een inlogformulier te zien.
- De commentaardraad wordt weergegeven in de iframe. Threading, reacties, vermeldingen en reacties zijn allemaal beschikbaar op basis van de widgetinstellingen die in FastComments zijn geconfigureerd.
- Hun opmerkingen worden toegeschreven aan hun Blackboard-account. Als de student later zijn naam of foto in Blackboard wijzigt, wordt het FastComments-profiel bij de volgende launch bijgewerkt.
Roltoewijzing van Blackboard naar FastComments:
- System Administrator en Course Builder worden gemapt naar FastComments admin.
- Instructor en Teaching Assistant worden gemapt naar FastComments moderator.
- Student, Guest en Observer worden gemapt naar FastComments commenter.
Moderators zien moderatieopties (pin, hide, ban, delete) inline bij elke opmerking in de draad.
Openbare Toegang Blokkeren (Aanbevolen)
Standaard zijn FastComments-commentaargegevens openbaar leesbaar. Iedereen die de URL van een draad of het API-eindpunt kan raden, kan de opmerkingen bekijken, zelfs buiten Blackboard. Voor cursusdiscussies wil je het bekijken vrijwel zeker beperken tot alleen ingeschreven studenten.
Open je widget-aanpassingspagina en maak een regel aan met Require SSO To View Comments ingeschakeld, stel vervolgens het beveiligingsniveau in op Secure SSO zodat draden alleen via de ondertekende LTI-launch kunnen worden geladen.
Zie Commentaardraden beveiligen met Single-Sign-On voor de volledige uitleg, inclusief hoe je de regel beperkt tot één domein of pagina.
Thread-Scoping
FastComments scope elke draad op (Blackboard-host, course ID, resource link ID). Twee FastComments-items in dezelfde cursus produceren twee draden. Hetzelfde item dat over twee cursusshells wordt gekopieerd (bijvoorbeeld via course copy) produceert twee draden, omdat Blackboard tijdens het kopiëren een nieuwe resource link ID uitgeeft. Om een gedeelde draad te behouden over cursuskopieën, gebruik je Deep Linking met een expliciete thread-URN die in FastComments is geconfigureerd vóór het starten van de kopie.
Blackboard-Specifieke Valkuilen
FastComments-tegel ontbreekt in het Build Content-menu (Original) of Content Market (Ultra). De beheerder heeft de tool goedgekeurd, maar er blokkeert een instellingsbeleid de betreffende plaatsing. Ga naar Administrator Panel > Integrations > LTI Tool Providers, bewerk de FastComments-vermelding en bevestig dat zowel Course Content Tool (Original) als Course Content Tool - allow students / Deep Linking content tool (Ultra) plaatsingen zijn ingeschakeld. Sla op en ververs de cursuspagina.
Foutmelding "Tool not configured for this context" of "Tool is not deployed" bij launch. Het tijdens dynamische registratie geregistreerde deployment-scope komt niet overeen met de instellingscontext waartoe de cursus behoort. Controleer in de tool provider-vermelding van Blackboard of de Deployment ID overeenkomt met wat FastComments toont op zijn LTI 1.3 Configuration-pagina voor deze tenant. Als ze verschillen, verwijder dan de plaatsing en voer de dynamische registratie opnieuw uit vanaf een verse registratie-URL (verkrijg die hier).
Iframe-hoogte lijkt vast te staan of content wordt afgesneden. Sommige Blackboard-tenants worden geleverd met een strikt Content Security Policy dat de standaard LTI iframe-resize postMessage blokkeert. FastComments zendt zowel het Canvas-stijl lti.frameResize-bericht als het IMS-spec-formaat org.imsglobal.lti.frameResize-bericht uit voor maximale compatibiliteit, maar een CSP-override op tenantniveau blokkeert de listener aan de ouderzijde. Vraag je beheerder te bevestigen dat *.fastcomments.com op de LTI-tool-allowlist staat en dat er geen aangepaste CSP-header postMessage-events verwijdert. Het formaat wijzigen werkt daarna zonder verdere configuratie.
Course copy dupliceert draden. Blackboard course copy geeft nieuwe resource link ID's uit voor LTI-plaatsingen, dus gekopieerde cursussen beginnen met lege draden. Dit is verwacht. Als je wilt dat de gekopieerde cursus de oorspronkelijke draad overneemt, stel dan Deep Linking in met een expliciete thread-URN vóór het kopiëren, of neem contact op met FastComments-ondersteuning om thread-ID's bulksgewijs te remappen.
Student ziet een generieke Blackboard-foutmelding bij launch. De oorzaak is een ontbrekende of verouderde email-claim. Bevestig dat het instellingsbeleid voor FastComments Role, Name en Email Address heeft ingeschakeld onder User Fields to Send. Sla op en start daarna opnieuw in een verse browsersessie.
Toevoegen aan Sakai- of Schoology-cursusinhoud 
Zodra FastComments met het platform is geregistreerd, voegen instructeurs het toe aan cursusinhoud met de standaard externe tool-workflows van het platform. Deze pagina behandelt Sakai 23.x en Schoology Enterprise.
Beperk openbare toegang (aanbevolen)
Standaard zijn FastComments-reactiegegevens op beide platforms openbaar leesbaar. Iedereen die de URL of API-endpoint van een thread kan raden, kan de reacties bekijken, zelfs buiten Sakai of Schoology. Voor cursusdiscussies wil je vrijwel zeker de weergave beperken tot ingeschreven studenten alleen.
Open je widget customization page en maak een regel aan met Require SSO To View Comments ingeschakeld, stel vervolgens het beveiligingsniveau in op Secure SSO zodat threads alleen via de gesigneerde LTI-launch kunnen worden geladen.
Zie Protecting Comment Threads With Single-Sign-On voor de volledige walkthrough, inclusief hoe je de regel kunt beperken tot één domein of pagina.
Sakai
1. Voeg FastComments toe aan een site
De sitebeheerder schakelt de tool per site in:
- Open de site en klik in de linker navigatie op Site Info.
- Klik op Manage Tools.
- Scroll naar de lijst External Tools en zet FastComments aan.
- Klik op Continue, controleer de lijst met tools en klik vervolgens op Finish.
FastComments verschijnt nu als een item in de linker navigatie van de site.
2. Hernoem of verplaats de linker-navigatievermelding
Ga naar Site Info > Tool Order. Sleep FastComments naar de gewenste positie en klik op Save. Je kunt het navigatielabel hier ook hernoemen en verbergen voor studenten.
3. Inline insluiten op een Lessons-pagina
Om FastComments direct in een Lessons-pagina te plaatsen in plaats van als een op zichzelf staande linker-navigatietool:
- Open de Lessons-tool in de site.
- Klik op Add Content > Add External Tool.
- Selecteer FastComments uit de lijst.
- Als FastComments tijdens registratie Deep Linking adverteerde, opent Sakai de contentselector van de tool zodat je de thread kunt kiezen of labelen. Als Deep Linking niet werd geadverteerd, plaatst Sakai een standaard launch-link.
- Sla het Lessons-item op.
Elke ingesloten instantie krijgt zijn eigen thread, gekoppeld aan die resource link.
4. Machtigingsaanpassingen voor studententoegang
Sakai regelt externe tool-launches via Realms. Om te bevestigen dat studenten FastComments kunnen starten:
- Meld je aan als Sakai-admin en open Administration Workspace > Realms.
- Open het relevante realm (bijvoorbeeld
!site.template.courseof het specifieke site-realm). - Bevestig dat de
access-rollti.launchheeft ingeschakeld en dat de rolpermissies in de groep external.tools zijn toegekend. - Sla het realm op.
Voor site-niveau overschrijvingen kan de beheerder per rol de zichtbaarheid van de tool aanpassen via Site Info > Tool Order door FastComments per rol te verbergen of weer te geven.
5. Wat studenten zien
Studenten klikken op het FastComments-item in de linker-navigatie (of scrollen naar het ingesloten Lessons-blok) en komen direct in de threaded comment-weergave. SSO gaat automatisch: Sakai stuurt de identiteit van de gebruiker in de LTI-launch en FastComments logt hen in onder hun Sakai-account.
Role mapping:
- Sakai
Instructor-> FastComments moderator - Sakai
Admin(admin in Administration Workspace) -> FastComments admin - Sakai
Student/access-> FastComments commenter
6. Sakai-valkuilen
- Tool niet zichtbaar in Manage Tools. Als FastComments niet verschijnt in de lijst External Tools, moet de Sakai-admin het toolregister openen (Administration Workspace > External Tools > FastComments) en Stealthed op
falsezetten. Stealthed tools zijn verborgen in de per-site Manage Tools-picker. - Launches breken in gedeelde-sessie browsers. De portal CSRF-token van Sakai is gebonden aan de browsersessie. Als een student in twee Sakai-sites in verschillende tabbladen is aangemeld of een verouderde sessie heeft, geeft de launch een 403 terug. Oplossing: sluit andere Sakai-tabbladen, log uit, log opnieuw in en start de launch opnieuw. Admins kunnen ook
sakai.csrf.token.cache.ttlverhogen als dit cluster-breed gebeurt. - Frame-embedding. Bevestig dat
lti.frameheightinsakai.propertiesgroot genoeg is (600 of meer) zodat de comment-thread niet wordt afgesneden binnen een Lessons-pagina.
Schoology
Schoology Enterprise kent twee installatiescenario's. Bevestig welk scenario van toepassing is voordat je de tool aan een cursus toevoegt.
1. Twee installatiescenario's
- (a) Enterprise-level installatie. De Schoology System Administrator heeft FastComments op organisatieniveau geïnstalleerd en toegewezen aan alle cursussen of aan specifieke cursus-sjablonen. Instructeurs slaan de installatie over en gaan direct naar "Add Materials".
- (b) Instructeur zelf-installatie. De instructeur installeert de tool in een enkele cursus via Course Options > External Tools > Install LTI Apps. Zelf-installatie vereist dat de System Administrator de FastComments-app op organisatieniveau heeft goedgekeurd.
2. Voeg FastComments toe als cursusmateriaal
Binnen de cursus:
- Open de cursus en ga naar Materials.
- Klik op Add Materials > Add File/Link/External Tool.
- Kies External Tool.
- Selecteer FastComments uit de lijst met geregistreerde tools.
- Stel een Name in (dit is wat studenten in de materialenlijst zien) en een optionele Description.
- Laat Enable Grading (grade passback) OFF. FastComments rapporteert geen cijfers terug aan Schoology, dus het inschakelen van grade passback maakt een lege kolom in het gradebook.
- Klik op Submit.
Het materiaal verschijnt nu in de cursusmaterialenlijst en opent de FastComments-thread wanneer erop geklikt wordt.
3. Inline insluiten via de Rich Text-editor
Als de System Administrator tijdens registratie Deep Linking-plaatsing voor FastComments heeft ingeschakeld, kunnen instructeurs de comment-thread insluiten in elk Rich Text-veld (opdrachtinstructies, pagina-inhoud, discussieprikkels):
- Open de Rich Text-editor op de doelpagina.
- Klik op het pictogram External Tool (puzzelstuk) in de werkbalk.
- Kies FastComments.
- Configureer de insluiting in het deep-linking dialoogvenster en klik op Insert.
- Sla de pagina op.
Als de knop External Tool niet verschijnt in de Rich Text-editor, is Deep Linking uitgeschakeld voor deze tool op deze tenant. Zie de onderstaande gotchas.
4. Zichtbaarheid en sectietoewijzingen
Schoology regelt de beschikbaarheid van tools per sectie via Course Options:
- Klik vanuit de cursus op Course Options > External Tools.
- Voor elke geïnstalleerde LTI-app bepaal je of deze beschikbaar is voor alle secties in de cursus of voor specifieke secties.
- Om FastComments te beperken tot bepaalde secties, haal je de vinkjes weg bij de secties die de tool niet mogen zien.
- Sectie-niveau toegang bepaalt ook welke secties de vermelding Add Materials > External Tool voor FastComments zien.
5. Wat studenten zien
Studenten klikken op het FastComments-materiaal (of scrollen naar de inline embed) en belanden in de threaded discussie. SSO gaat automatisch via de Schoology LTI-launch onder hun Schoology-account.
Role mapping:
- Schoology
Administrator-> FastComments admin - Schoology
Instructor-> FastComments moderator - Schoology
Student-> FastComments commenter
6. Schoology-valkuilen
- Alleen Enterprise. Persoonlijke en gratis Schoology-accounts kunnen geen LTI 1.3-tools installeren. Als jouw tenant op het gratis niveau zit, ontbreekt de optie External Tools in Course Options. Upgrade naar Schoology Enterprise om FastComments te gebruiken.
- Deep Linking standaard uitgeschakeld door tenant. Sommige Schoology-tenants beperken Deep Linking-plaatsing op organisatieniveau. In dat geval zien instructeurs alleen de flow Add Materials > External Tool en niet de knop External Tool in de Rich Text-editor. Om inline insluiting mogelijk te maken, gaat de System Administrator naar System Settings > Integration > LTI 1.3 > FastComments en schakelt de plaatsing Content Item / Deep Linking in, en slaat op.
- Sectie-override van toewijzing. Als FastComments op ondernemingsniveau is toegewezen maar de instructeur kan het niet zien in Add Materials, dan is de sectie van de cursus uitgesloten in de organisatiebrede toewijzing. Vraag de System Administrator de sectie toe te voegen aan de FastComments-app-toewijzing.
- Naam van materiaal versus identiteit van thread. Het hernoemen van het materiaal in Schoology verplaatst de comment-thread niet. Threads zijn gekoppeld aan de LTI resource link ID, dus een hernoeming houdt dezelfde thread; het verwijderen en opnieuw aanmaken van het materiaal creëert een nieuwe, lege thread.
Probleemoplossing 
"Registratietoken niet gevonden, verlopen of al gebruikt"
Het token in je registratie-URL (haal het hier op) is 30 minuten geldig en kan slechts één keer worden gebruikt. Als je LMS er langer over deed, of als de registratie opnieuw werd geprobeerd nadat deze al was geslaagd, wordt het token geweigerd. Genereer een nieuwe URL op de FastComments LTI 1.3 Configuratiepagina en begin opnieuw.
"Platform heeft registratie geweigerd"
Je LMS heeft de registratie-handshake geweigerd. De meest voorkomende oorzaken:
- Tool al geregistreerd met dezelfde clientnaam. Sommige platforms (met name D2L) weigeren een tweede registratie van "FastComments" totdat de vorige is verwijderd. Verwijder de oude tool in je LMS en probeer het opnieuw.
- Verkeerd veld in het LMS. Zorg ervoor dat je de URL hebt geplakt in het veld registration / tool initiation registration endpoint, niet in het veld voor de launch-URL of login-URL.
- Het LMS ondersteunt eigenlijk geen Dynamic Registration. Oudere Moodle- en Blackboard-versies adverteren met LTI 1.3 maar staan alleen handmatige configuratie toe. Raadpleeg de documentatie van je platform.
"Kan platformconfiguratie niet ophalen"
FastComments kon het openid-configuration-document van je LMS niet lezen. Dit is zeldzaam en betekent meestal dat het LMS een onjuist gevormde of onbereikbare discovery-URL heeft opgegeven. Neem contact op met de support van je LMS.
Launch toont "Configuration not found"
Ofwel is de configuratie in FastComments verwijderd, of de launch kwam van een iss/client_id-combinatie die we niet herkennen. Als je hebt verwijderd en opnieuw geregistreerd, geef je LMS dan de opdracht om de FastComments-tool te verwijderen en opnieuw toe te voegen, zodat deze de nieuwe client_id ontvangt.
Launch toont "Deployment not registered"
Je hebt FastComments gestart vanuit een Brightspace/Moodle/Blackboard-deployment die anders is dan degene waarin het voor het eerst werd gestart. FastComments pinnt de deployment_id bij de eerste launch als beveiligingscontrole. Om een nieuwe deployment onder dezelfde client toe te voegen, neem je contact op met support - wij voegen de deployment-ID toe aan de configuratie.
Launch toont "Unsupported message_type"
Het LMS heeft een LTI-bericht verzonden dat FastComments niet verwerkt (bijv. LtiSubmissionReviewRequest). FastComments ondersteunt alleen de standaard resource-link launch en deep-linking-flows. Neem contact op als je een specifiek berichttype toegevoegd nodig hebt.
Iframe past grootte niet aan
De meeste LMS'en passen de grootte van LTI-iframes automatisch aan. Als dat bij jou niet het geval is, controleer dan of de launch-instellingen van het LMS de tool toestaan postMessage-events naar het bovenliggende frame te sturen. FastComments stuurt zowel Canvas-stijl (lti.frameResize) als IMS-spec (org.imsglobal.lti.frameResize) resize-berichten.
Minimale rechten & gegevensminimalisatie 
De FastComments LTI 1.3-integratie volgt het principe van minimale privileges: het gebruikt alleen de launch-claims die nodig zijn om de gebruiker te identificeren, opmerkingen aan de juiste cursus en resource te koppelen, en rolgebaseerde rechten toe te passen.
De rest van deze pagina brengt elke claim die de integratie verbruikt, elke LTI Advantage-service die niet wordt aangevraagd, en elke categorie gegevens die niet wordt verzameld in kaart. Beveiligings- en inkoopreviewers kunnen antwoorden rechtstreeks uit de tabellen hieronder halen.
Gegevenselementen ontvangen van het LMS
Elke LTI 1.3-launch bevat een ondertekende JWT van het LMS. FastComments haalt de volgende claims uit die JWT en gebruikt niets anders:
| Veld | LTI-claim | Doel | Vereist | Opgeslagen |
|---|---|---|---|---|
| Gebruikersidentificatie | sub | Identificeert de gebruiker consistent over launches heen, zodat dezelfde persoon wordt gemapt naar dezelfde FastComments SSO-gebruiker | Ja | Ja, als onderdeel van een stabiel intern SSO-ID |
| Weergavenaam | name | Naamsvermelding naast de opmerkingen van de gebruiker | Ja (valt terug op "LMS User" indien afwezig) | Ja |
email | Accountkoppeling, notificaties, moderatie, supportcorrespondentie | Optioneel (de integratie werkt ook zonder) | Ja, indien verstrekt | |
| Avatar-URL | picture | Weergegeven bij de opmerkingen van de gebruiker | Optioneel | Alleen de URL; FastComments downloadt of herbergt de afbeelding niet |
| Rollen | https://purl.imsglobal.org/spec/lti/claim/roles | Bepaalt of de gebruiker administrator, instructor (moderator) of leerling is | Ja | Afgeleide isAdmin / isModerator-vlaggen op de SSO-sessie |
| Cursuscontext | https://purl.imsglobal.org/spec/lti/claim/context (id, title) | Koppelt de commentardraad aan de juiste LMS-cursus | Ja | Ja, als onderdeel van de opgeloste pagina-identificatie |
| Resource link | https://purl.imsglobal.org/spec/lti/claim/resource_link (id) | Koppelt opmerkingen aan de juiste activiteit of toolplaatsing binnen de cursus | Ja, indien aanwezig | Ja, als onderdeel van de opgeloste pagina-identificatie |
| Deployment ID | https://purl.imsglobal.org/spec/lti/claim/deployment_id | Routeert de launch naar de juiste FastComments tenant-configuratie | Ja | Ja, op het FastComments LTI-configuratierecord |
Claims en scopes gedeclareerd bij registratie
Tijdens LTI 1.3 Dynamic Registration registreert FastComments zichzelf met scope: "" (geen aanvullende OAuth-scopes) en declareert alleen deze OpenID Connect-claims:
iss, sub, name, email, picture
Het registreert twee berichttypen:
LtiResourceLinkRequest- de standaard cursuslaunch naar FastComments.LtiDeepLinkingRequest- stelt instructeurs in staat de FastComments-tool binnen een cursus te plaatsen.
Er worden geen aanvullende access tokens aangevraagd bij het LMS.
LTI Advantage-services die niet worden aangevraagd
| Service / scope | Aangevraagd? | Reden |
|---|---|---|
| Names and Role Provisioning Services (NRPS) | Nee | De integratie heeft geen cursusrooster nodig; de gebruikersidentiteit komt mee met elke launch |
| Assignment and Grade Services (AGS) - lineitem-, score- en result-scopes | Nee | De integratie is niet gradebook-bewust |
| Deep Linking voorbij de standaard plaatsing-terugkeer | Geen aanvullende gegevens | Deep linking wordt alleen gebruikt voor het plaatsen van de tool door instructeurs; er wordt geen cursusinhoud opgehaald |
Niet-verzamelde gegevens
Naast LTI zelf vraagt of ontvangt FastComments het volgende niet van het LMS of de gebruiker:
| Categorie | Verzameld? |
|---|---|
| Cijfers van studenten | Nee |
| Inzendingen van opdrachten | Nee |
| Aanwezigheidsregistraties | Nee |
| Volledige cursusroosters | Nee |
| Overheidsidentificatiegegevens | Nee |
| Geboortedatum | Nee |
| Postadres of telefoonnummer | Nee |
| Financiële informatie | Nee |
| LMS-administratorreferenties | Nee |
Toegangsgrenzen
- FastComments ontvangt alleen gegevens binnen een geautoriseerde LTI 1.3-launch die is ondertekend met de geregistreerde sleutels van het LMS. De integratie roept het LMS niet terug voor aanvullende informatie.
- Launch-tokens zijn eenmalig en kortlevend. Herhaalde of verlopen tokens worden geweigerd.
- LMS-administrators bepalen waar de tool binnen hun platform wordt ingezet. D2L Brightspace ondersteunt bijvoorbeeld per-deployment org-unit scoping en per-deployment beveiligingsinstellingen, waarmee administrators de tool kunnen beperken tot specifieke cursussen of org units in plaats van deze globaal beschikbaar te maken. Moodle, Blackboard, Sakai en Schoology bieden equivalente per-deployment controles in hun LTI 1.3-implementaties.
Opslag en retentie
FastComments bewaart LTI-afgeleide gegevens voor de duur van de actieve commentaardienst en volgens door de klant geconfigureerde retentie-instellingen. Commentaargegevens worden opgeslagen in versleutelde productieopslag (encrypted-at-rest). Bij beëindiging van het account of op schriftelijk verzoek tot verwijdering verwijdert of anonimiseert FastComments klantgegevens volgens de toepasselijke overeenkomst.
Voor volledige details over opslag en gegevensverwerking, zie het FastComments Privacybeleid.
Reviewfrequentie
Elke nieuwe LTI-functie die aanvullende claims, scopes of LTI Advantage-services vereist, wordt vóór release beoordeeld om te bevestigen dat de aangevraagde toegang noodzakelijk en evenredig is aan de functie die wordt uitgebracht.
Korte verklaring voor beveiligingsvragenlijsten
FastComments past minimale privileges en dataminimalisatie toe op zijn LTI 1.3-integratie. De integratie gebruikt alleen de LTI launch-claims die nodig zijn om de gebruiker te authenticeren (
sub,name,picture), de rol te bepalen, en de cursus en resource te identificeren waartoe de opmerkingen behoren. FastComments vraagt geen Names and Role Provisioning Services, Assignment and Grade Services, gradebook-gegevens, aanwezigheidsregistraties, volledige roosters of LMS-administratieve toegang aan. LMS-administrators behouden de controle over in welke org units, cursussen en deployments de tool beschikbaar is.
Voeg polls toe aan uw LMS-cursus 
Zodra FastComments op je LMS‑cursus staat, kun je ook live‑peilingen uitvoeren direct in de reacties. Schakel Enable Polls in je widget‑aanpassingsinstellingen in en er verschijnt een peilingknop in de werkbalk van de reactie. Peilingen kunnen 2 tot 10 opties bevatten, resultaten worden live bijgewerkt voor iedereen op de pagina, en je kiest wie peilingen kan maken en of stemmen een login vereist. Er is niets anders te installeren op LMS.
Probeer de Live Polls‑demo of lees de Polls‑documentatie om ze in te stellen.