Ajouter des commentaires à votre LMS via LTI 1.3

1. Connectez-vous à FastComments et allez à votre page de configuration LTI 1.3.
2. (Facultatif) Choisissez la plateforme depuis le menu déroulant Plateforme - cela définit l'étiquette d'affichage, mais Auto-détection fonctionne bien.
3. Cliquez sur Générer l’URL. Une URL d'enregistrement à usage unique apparaît (valide pendant 30 minutes).
4. Dans votre LMS, ouvrez l'écran d'enregistrement dynamique LTI 1.3 et collez l'URL dans le champ Point de terminaison d'initiation d'enregistrement de l'outil (ou équivalent). Soumettez.
5. Votre LMS appelle FastComments, échange les clés et crée l'intégration. La fenêtre contextuelle se ferme automatiquement une fois l'opération terminée.
6. De retour dans FastComments, la nouvelle configuration apparaît dans le tableau Configurations existantes. L'outil est maintenant disponible dans vos cours LMS.

FastComments LTI 1.3 a été testé avec :

• D2L Brightspace (toute version avec LTI Advantage)
• Moodle 4.0+ (External Tool plugin, LTI Advantage)
• Blackboard Learn (SaaS et Ultra)
• Sakai (versions prenant en charge LTI Advantage)
• Schoology (Enterprise, Dynamic Registration là où disponible)

Tout autre LMS qui implémente la spécification IMS LTI 1.3 Advantage avec Dynamic Registration devrait également fonctionner - sélectionnez Other LTI 1.3 platform dans le menu déroulant de la plateforme lors de la génération de votre URL d'enregistrement (obtenez-le ici).

Canvas LMS utilise un flux d'installation différent (JSON de configuration per-developer-key au lieu de Dynamic Registration). Consultez le guide d'installation dédié à Canvas LMS.

Navigate to LTI 1.3 Configuration

Connectez-vous à FastComments et allez à votre page de configuration LTI 1.3.

Si votre compte n'a pas encore accès à LTI, vous verrez "LTI not enabled for this account" - contactez l'assistance pour l'activer sur votre forfait.

Pick a Platform (Optional)

Sous Generate a Dynamic Registration URL, utilisez le menu déroulant Platform pour indiquer à FastComments à quel LMS vous vous connectez :

• D2L Brightspace
• Moodle
• Blackboard Learn
• Sakai
• Schoology
• Other LTI 1.3 platform

Vous pouvez aussi laisser sur Auto-detect. La plateforme est lue depuis l'openid-configuration de votre LMS lors de l'enregistrement ; le menu déroulant ne sert qu'à définir l'étiquette affichée pour la configuration résultante.

Generate the URL

Cliquez sur Generate URL. FastComments crée un jeton d'enregistrement à usage unique et vous affiche une URL ressemblant à :

https://fastcomments.com/lti/v1p3/register/<long-token>

Copiez-la. Cette URL :

• Est single-use - once your LMS calls it successfully, the token is consumed.
• Expire après 30 minutes si elle n'est pas utilisée.
• Doit rester privée - toute personne disposant de l'URL peut enregistrer un outil sur votre tenant pendant ces 30 minutes.

Existing Configurations

Une fois l'enregistrement terminé avec succès, la nouvelle configuration apparaît dans le tableau Existing Configurations sur la même page, avec sa Platform, son Issuer, son Client ID, et son Status. Vous pouvez supprimer des configurations depuis ce tableau si vous devez les désenregistrer.

D2L Brightspace offre l’enregistrement dynamique via l’interface d’administration LTI Advantage. Vous aurez besoin d’un accès administrateur.

Ouvrir l'écran d'enregistrement

1. Connectez-vous à votre instance Brightspace en tant qu'administrateur.
2. Accédez à Admin Tools > Manage Extensibility > LTI Advantage.
3. Cliquez sur Register Tool. (L'URL directe est https://<your-brightspace-host>/d2l/le/ltiadvantage/registrations/create.)

Collez l'URL

Vous verrez un formulaire d'enregistrement. Le champ clé est Tool initiation registration endpoint (certaines versions de Brightspace l'appellent "Tool Initiation Registration URL").

Collez l'URL d'enregistrement FastComments (obtenez-la ici) dans ce champ. Laissez les autres champs vides — ils sont remplis automatiquement par FastComments pendant la négociation d'enregistrement.

Cliquez sur Register.

Approuver l'outil

Brightspace ouvre une fenêtre contextuelle qui communique avec FastComments, échange des clés et affiche un écran de confirmation. La fenêtre contextuelle se ferme automatiquement lorsque l'enregistrement est terminé.

Le nouvel outil apparaît dans la liste des outils LTI Advantage. Par défaut, Brightspace marque les nouveaux outils comme disabled — basculez le commutateur sur enabled pour que vos cours puissent l'utiliser.

Ajouter un déploiement

Dans Brightspace, les outils LTI requièrent un deployment avant de pouvoir être utilisés dans les cours :

1. Ouvrez l'outil FastComments nouvellement enregistré.
2. Cliquez sur View Deployments > New Deployment.
3. Donnez un nom au déploiement (p. ex. "FastComments - All Courses"), choisissez les unités organisationnelles où il devrait être disponible, puis enregistrez.

Après le premier lancement via ce déploiement, FastComments attache le deployment_id à son enregistrement de configuration — les lancements ultérieurs depuis un autre déploiement sous le même client seront refusés, sauf si vous le réenregistrez.

Vous utilisez Moodle ? Nous publions également un plugin Moodle dédié pour FastComments offrant une intégration plus poussée que LTI 1.3 (hooks de synchronisation des notes, rapports d'activité approfondis, interface de configuration native Moodle). Voir le guide d'installation du plugin Moodle. Le flux LTI 1.3 ci‑dessous est le bon choix si vous voulez une inscription unique qui couvre également d'autres LMS, ou si votre administrateur Moodle n'installera pas de plugins tiers.

Moodle 4.0+ prend en charge l'enregistrement dynamique LTI 1.3 via le plugin External Tool.

Ouvrez l'écran de gestion des outils

1. Connectez-vous à Moodle en tant qu'administrateur du site.
2. Naviguez vers Site administration > Plugins > Activity modules > External tool > Manage tools.

Collez l'URL

Vous verrez une carte intitulée Tool URL. Collez l'URL d'enregistrement FastComments (obtenez-la ici) dans le champ de texte et cliquez sur Add LTI Advantage.

Moodle ouvre un écran d'enregistrement affichant l'identité de l'outil et les autorisations demandées. Vérifiez et cliquez sur Activate (ou Register, selon la version de Moodle).

La fenêtre contextuelle se ferme une fois l'enregistrement terminé ; le nouvel outil FastComments apparaît dans la liste Tools avec le statut Active.

Rendez-le disponible

Par défaut, Moodle ajoute les nouveaux outils à la liste « Course tools » mais ne les affiche pas dans le sélecteur d'activités. Pour rendre FastComments disponible dans tout le cours :

1. Cliquez sur l'icône d'engrenage de la vignette FastComments.
2. Sous Tool configuration usage, choisissez Show in activity chooser and as a preconfigured tool.
3. Enregistrez.

Les enseignants peuvent maintenant ajouter FastComments à n'importe quel cours via Add an activity or resource > FastComments.

Blackboard Learn SaaS and Ultra prennent en charge LTI 1.3 Dynamic Registration.

Open the Tool Provider Screen

1. Connectez-vous à Blackboard en tant qu'administrateur système.
2. Accédez à Administrator Panel > Integrations > LTI Tool Providers.
3. Cliquez sur Register LTI 1.3 / LTI Advantage Tool.

Si vous ne voyez que "Register LTI 1.1 Provider", votre version de Blackboard ne prend pas encore en charge LTI 1.3 - effectuez une mise à niveau ou contactez le support de Blackboard.

Paste the URL

Collez l'URL d'enregistrement FastComments (obtenez-la ici) dans le champ Client ID / Registration URL (le libellé varie selon la version de Blackboard). Soumettez.

Blackboard effectue la poignée de main d'enregistrement avec FastComments et vous affiche un écran de confirmation.

Approve and Enable

Blackboard marque par défaut les outils nouvellement enregistrés comme Approved but excluded :

1. Trouvez l'entrée FastComments dans la liste des fournisseurs d'outils.
2. Ouvrez le menu et choisissez Edit.
3. Réglez Tool Status sur Approved.
4. Sous Institution Policies, vérifiez quelles données utilisateur sont envoyées (nom, courriel, rôle). Enregistrez.

L'outil est maintenant disponible pour les enseignants lorsqu'ils ajoutent du contenu aux cours.

Sakai

Sakai prend en charge l'enregistrement dynamique LTI 1.3 sur les versions avec LTI Advantage. Depuis l'espace d'administration :

1. Connectez-vous en tant qu'administrateur Sakai et ouvrez l'Administration Workspace.
2. Choisissez External Tools > Install LTI 1.3 Tool.
3. Collez l'URL d'enregistrement FastComments (obtenez-le ici) et soumettez.
4. Approuvez l'outil lorsque l'échange est terminé.

L'outil apparaît alors sous External Tools et peut être ajouté aux sites par leurs responsables.

Schoology

Les instances Schoology Enterprise prennent en charge LTI 1.3, mais la disponibilité de l'enregistrement dynamique varie selon le déploiement. Vérifiez auprès de votre responsable de compte Schoology.

Si l'enregistrement dynamique n'est pas disponible sur votre instance Schoology, vous devrez configurer l'intégration manuellement en utilisant ces points de terminaison :

• 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

Après que Schoology vous a fourni un Client ID et un Deployment ID, contactez le support FastComments pour enregistrer la configuration sur votre tenant.

Autres plateformes LTI 1.3

Tout LMS qui respecte la spécification IMS LTI 1.3 Advantage devrait fonctionner avec la même URL d'enregistrement (obtenez-le ici). Recherchez un paramètre libellé "Dynamic Registration", "Tool Registration URL", "Tool initiation registration endpoint", ou similaire.

Si votre plateforme ne prend en charge que la configuration manuelle de LTI 1.3, utilisez les quatre points de terminaison énumérés dans la section Schoology ci‑dessus et contactez le support pour finaliser.

Cette page explique comment ajouter FastComments à un cours Brightspace après qu’un administrateur ait enregistré l’outil et créé un déploiement. Si l’outil n’est pas encore enregistré, consultez d’abord le guide d’enregistrement D2L.

FastComments embedded as a unit topic in Brightspace

Brightspace propose deux expériences de création de contenu : Classic Content et la New Content Experience (appelée aussi Lessons). Les deux exposent FastComments, mais les chemins de menu diffèrent. Chaque section ci‑dessous couvre les deux lorsqu’ils divergent.

Localiser l’outil FastComments

L’outil FastComments apparaît à deux endroits dans l’éditeur de contenu d’un cours :

1. Le sélecteur d’activité, accessible depuis le bouton Add Existing d’un module/unité (dans les anciennes versions de Brightspace : Add Existing Activities). FastComments apparaît directement dans le sélecteur dans les versions récentes de Brightspace ; dans les versions plus anciennes il est imbriqué sous un sous‑menu External Learning Tools. Dans les deux cas, ce chemin ajoute FastComments comme sujet autonome.
2. La boîte de dialogue Insert Stuff à l’intérieur de l’éditeur HTML, sous LTI Advantage. Cela intègre FastComments en ligne dans un sujet HTML via le flux de deep linking LTI.

Si FastComments n’apparaît dans aucun des deux sélecteurs, le déploiement n’est pas activé pour l’unité organisationnelle qui contient le cours. Demandez à votre administrateur Brightspace d’ouvrir Admin Tools > Manage Extensibility > LTI Advantage > outil FastComments > View Deployments, d’ouvrir le déploiement et d’ajouter l’unité organisationnelle du cours (ou une unité parent) sous Org Units.

Ajouter FastComments comme sujet dans un module

Classic Content :

1. Ouvrez le cours et cliquez sur Content dans la barre de navigation.
2. Sélectionnez le module qui doit contenir la discussion (ou créez‑en un via Add a module).
3. Cliquez sur Add Existing (Brightspace ancien : Add Existing Activities > External Learning Tools).
4. Dans le sélecteur, cliquez sur FastComments. Brightspace crée un sujet dans le module et vous ramène à la vue de contenu.
5. Cliquez sur le nouveau sujet. Renommez‑le avec un titre descriptif comme FastComments Discussion en utilisant l’éditeur de titre en ligne.

New Content Experience (Lessons) :

1. Ouvrez le cours et cliquez sur Content.
2. Ouvrez l’unité et la leçon qui doivent contenir la discussion.
3. Cliquez sur Add > Existing Activity et sélectionnez FastComments (Brightspace ancien : imbriqué sous External Learning Tools).
4. L’activité est ajoutée à la leçon.
5. Cliquez sur le titre de l’activité pour le renommer.

La première fois qu’un utilisateur (enseignant ou étudiant) ouvre le sujet, FastComments initialise le fil pour ce resource link. Le fil est lié à l’ID du resource link, donc renommer ou déplacer le sujet ne change pas le fil chargé.

Intégrer FastComments en ligne dans un sujet HTML

Utilisez ce flux lorsque vous voulez que les commentaires apparaissent sous une lecture, une vidéo ou un autre contenu à l’intérieur de la même page de sujet plutôt que comme un sujet séparé.

1. Ouvrez ou créez un sujet HTML dans le module/la leçon.
2. Cliquez sur Edit HTML pour ouvrir l’éditeur HTML de Brightspace.
3. Placez le curseur à l’endroit où le fil de commentaires doit apparaître.
4. Cliquez sur le bouton Insert Stuff (icône en forme de pièce de puzzle dans la barre d’outils de l’éditeur).
5. Dans la boîte de dialogue Insert Stuff, faites défiler jusqu’à LTI Advantage et cliquez sur FastComments.
6. FastComments ouvre un sélecteur de deep linking. Confirmez l’emplacement (les options par défaut conviennent pour des discussions de contenu) ; cliquez sur Insert ou Continue.
7. Brightspace revient à l’éditeur HTML avec un bloc de remplacement représentant le lancement LTI. Cliquez sur Save and Close sur le sujet.

Quand le sujet se charge, Brightspace remplace le bloc de remplacement par une iframe qui lance automatiquement FastComments via LTI. Les étudiants voient le fil de discussion en ligne.

Un seul sujet HTML peut contenir plusieurs intégrations FastComments créées par deep linking. Chaque intégration obtient son propre fil car chaque deep link produit un resource link ID distinct.

Sujet de module vs lien rapide en ligne

Choisissez l’approche module topic lorsque :

• La discussion est l’activité principale pour cette étape du module.
• Vous voulez que le sujet apparaisse dans la table des matières de Brightspace, le suivi d’achèvement et Class Progress.

Choisissez l’approche inline embed lorsque :

• Les commentaires doivent se trouver sous d’autres contenus sur la même page.
• Vous ne souhaitez pas d’élément séparé traçable pour l’achèvement dans la table des matières.

Visibilité, brouillon et conditions de publication

Un nouveau sujet FastComments est visible par les étudiants par défaut. Pour le masquer pendant que vous le configurez :

1. Dans l’éditeur de contenu, cliquez sur le titre du sujet (Classic) ou sur le menu à trois points de l’activité (New Content Experience).
2. Réglez le statut sur Draft (Classic) ou désactivez le réglage Visibility (New Content Experience).

Les sujets en mode brouillon sont invisibles pour les étudiants. Les instructeurs et les TA les voient toujours avec un badge « Draft ».

Pour restreindre le sujet à un groupe ou à une section spécifique :

1. Ouvrez le sujet.
2. Cliquez sur le menu du titre du sujet > Edit Properties In-place (Classic) ou Edit > Restrictions (New Content Experience).
3. Sous Release Conditions, cliquez sur Create.
4. Choisissez Group enrollment ou Section enrollment, sélectionnez le groupe/la section, puis enregistrez.

Les conditions de publication s’empilent avec la cartographie des rôles propre à FastComments. Les étudiants qui ne peuvent pas voir le sujet ne reçoivent pas un lancement LTI.

Ce que voient les étudiants au premier lancement

Quand un étudiant clique sur le sujet (ou charge un sujet HTML avec une intégration) :

1. Brightspace effectue le lancement LTI 1.3 en arrière‑plan.
2. FastComments reçoit le nom, l’e‑mail, l’URL d’avatar et le rôle LMS de l’étudiant, et le connecte automatiquement. Il n’y a pas d’invite de connexion FastComments.
3. Le fil de commentaires pour ce resource link se rend à l’intérieur de l’iframe Brightspace.

Cartographie des rôles au lancement :

• Brightspace Administrator devient un administrateur FastComments (admin) pour le fil (modération complète, suppression, bannissement et accès à la configuration).
• Brightspace Instructor devient un modérateur FastComments (moderator) (épingler, cacher, supprimer, bannir).
• Tous les autres rôles (Learner, TeachingAssistant, etc.) deviennent des commentateurs standards.

Les commentaires sont attribués au compte Brightspace de l’étudiant. Si l’étudiant modifie son nom ou son avatar dans Brightspace, le prochain lancement LTI synchronise le changement.

Verrouiller l’accès public (recommandé)

Par défaut, les données de commentaires FastComments sont lisibles publiquement. Toute personne capable de deviner l’URL du fil ou le point de terminaison API peut voir les commentaires, même en dehors de Brightspace. Pour les discussions de cours, vous voulez presque certainement restreindre la lecture aux apprenants inscrits seulement.

Ouvrez votre page de personnalisation du widget et créez une règle avec Require SSO To View Comments activé, puis définissez le niveau de sécurité sur Secure SSO afin que les fils ne puissent être chargés que via le lancement LTI signé.

Voir Protéger les fils de commentaires avec Single‑Sign‑On pour le walkthrough complet, incluant comment limiter la règle à un seul domaine ou une seule page.

Hauteur de l’iframe et redimensionnement

FastComments émet le postMessage org.imsglobal.lti.frameResize à chaque rendu de fil et lors des changements de contenu (nouveau commentaire, développement des réponses). Brightspace écoute ce message et ajuste la hauteur de l’iframe afin que le fil ne soit pas tronqué et qu’aucune barre de défilement interne n’apparaisse.

Si l’iframe reste à une petite hauteur fixe :

• Confirmez que le cours est chargé via HTTPS. Le listener postMessage de Brightspace rejette les frames en contenu mixte.
• Confirmez qu’aucune extension de navigateur ne bloque le canal postMessage.
• Pour les intégrations en ligne dans un sujet HTML, le HTML environnant ne doit pas envelopper l’iframe dans un conteneur à hauteur fixe. Supprimez tout style="height: ..." en ligne de l’élément parent.

Particularités spécifiques à Brightspace

L’outil n’apparaît pas dans le sélecteur Add Existing. Le déploiement n’est pas activé pour l’unité organisationnelle de ce cours. Un administrateur doit ajouter l’unité organisationnelle (ou une unité parent) à la liste Org Units du déploiement. L’enregistrement de l’outil seul n’est pas suffisant ; le déploiement définit les cours qui voient l’outil.

Incompatibilité de deployment_id au lancement. FastComments enregistre de façon TOFU le premier deployment_id qu’il voit pour une registration. Si un administrateur supprime le déploiement initial et en crée un nouveau, les lancements depuis le nouveau déploiement sont rejetés avec une erreur de mismatch de déploiement. La solution est de réenregistrer FastComments (générez une nouvelle URL d’enregistrement (récupérez‑la ici) et relancez l’enregistrement dynamique) ; l’ancien enregistrement de configuration est remplacé.

L’outil se lance mais affiche « Invalid LTI launch ». Le cours se trouve dans une structure de locataire/organisation différente de celle couverte par le déploiement, ou le déploiement a été désactivé après l’enregistrement. Revérifiez Admin Tools > Manage Extensibility > LTI Advantage > FastComments > bascule Enabled et la liste des unités organisationnelles du déploiement.

Noms et rôles manquants dans FastComments. Brightspace envoie les lancements LTI avec les claims NRPS (Names and Role Provisioning Services). Si un cours a été mis à niveau depuis un ancien lien LTI 1.1, le lancement peut ne pas inclure les claims name et email. Réajoutez le sujet FastComments via Add Existing (ne migrez pas l’ancien lien) afin que le lancement utilise LTI 1.3.

L’intégration affiche un écran de connexion au lieu de l’auto‑SSO. Le sujet HTML a été inséré comme une simple balise <iframe> pointant vers FastComments plutôt que via Insert Stuff > LTI Advantage. Les iframes simples contournent le lancement LTI et amènent les utilisateurs sur la page publique de FastComments. Supprimez l’iframe et réinsérez‑la via le flux Insert Stuff.

Ce guide couvre l’ajout de FastComments à un cours Moodle 4.x après qu’un administrateur du site ait enregistré l’outil et l’ait configuré pour qu’il apparaisse dans le sélecteur d’activités. Si FastComments n’est pas encore enregistré, consultez d’abord le guide d’enregistrement Moodle.

Open the Course in Edit Mode

1. Connectez-vous à Moodle en tant qu’enseignant avec droit d’édition (ou rôle supérieur) pour le cours.
2. Ouvrez le cours.
3. Activez le mode édition en utilisant l’interrupteur dans le coin supérieur droit de l’en-tête du cours.

Moodle 4.x a remplacé le menu déroulant hérité « Add an activity or resource » utilisé en 3.x par une boîte de sélection d’activités en plein écran. Moodle 4.5 conserve le même sélecteur mais ajoute une rangée d’étoiles/favoris en haut, donc épingler FastComments une fois permet d’y accéder plus rapidement dans les sections suivantes.

Add the FastComments Activity

1. Faites défiler jusqu’à la section du cours (thème ou semaine) où la discussion doit se trouver.
2. Cliquez sur Add an activity or resource au bas de cette section.
3. Dans la boîte de sélection, choisissez FastComments. Si vous ne le voyez pas, passez à la section des points d’attention ci-dessous.

Le formulaire de paramètres de l’activité s’ouvre. Les champs importants :

• Activity name (obligatoire). Affiché sur la page du cours et dans le carnet de notes. Exemple : Week 3 Discussion.
• Activity description. Texte d’introduction optionnel affiché au-dessus du fil de commentaires.
• Show description on course page. Cochez ceci si vous voulez que la description soit visible sans ouvrir l’activité.
• Preconfigured tool. Réglé sur FastComments (sélection automatique lors du lancement depuis le sélecteur). Ne pas modifier.
• Launch container. Réglez sur New window. Voir la section des points d’attention pour comprendre pourquoi « Same window » ne fonctionne pas dans certaines installations Moodle.
• Tool URL, Public key, Shared secret, Custom parameters. Laissez vides. L’enregistrement dynamique s’occupe de ces éléments au niveau du site.

Descendez en bas et cliquez sur Save and return to course (ou Save and display pour ouvrir l’activité immédiatement).

L’activité apparaît comme une ligne dans la section avec l’icône FastComments. Les étudiants cliquent sur la ligne pour ouvrir le fil de commentaires.

Embed FastComments Inline with the Editor

Pour insérer un fil à l’intérieur d’une Page, d’un chapitre de Book, d’une Lesson ou de toute autre ressource qui utilise l’éditeur Atto ou TinyMCE :

1. Ouvrez la ressource en mode édition.
2. Placez le curseur à l’endroit où le fil doit apparaître.
3. Dans la barre d’outils de l’éditeur, cliquez sur le bouton LTI / External tool. Dans Atto, il est intitulé « Insert LTI Advantage content ». Dans TinyMCE (par défaut dans Moodle 4.3+), il se trouve sous le menu More en tant que External tools.
4. Choisissez FastComments dans la liste des outils.
5. FastComments ouvre un sélecteur de deep-linking. Confirmez le titre du fil et cliquez sur Embed.
6. L’éditeur insère un bloc d’espace réservé LTI. Enregistrez la ressource.

Chaque instance intégrée est un fil distinct identifié par l’ID de l’élément de contenu deep-link, donc une Page contenant trois intégrations FastComments aura trois fils indépendants.

Restrict Access and Group Settings

Les paramètres d’activité standard de Moodle s’appliquent aux activités FastComments :

• Common module settings > Group mode. Le fait de régler ceci sur Separate groups ou Visible groups ne divise pas automatiquement FastComments en fils par groupe. Le mode de groupe de Moodle ne fait que filtrer le carnet de notes et la liste des membres. Pour exécuter un fil distinct par groupe, ajoutez une activité FastComments par groupe et utilisez Restrict access pour limiter chacune.
• Restrict access > Add restriction. Prend en charge les conditions standard de Moodle : Date, Grade, Group, Grouping, User profile, et des ensembles de restrictions imbriqués. Utilisez Group pour verrouiller une activité FastComments à un seul groupe.
• Activity completion. Réglez sur Students must view this activity to complete it si vous voulez le suivi d’achèvement. FastComments ne rapporte pas actuellement d’événement d’achèvement à Moodle au-delà du lancement.

Role Mapping

FastComments lit la réclamation LTI roles que Moodle envoie à chaque lancement et la mappe comme suit :

• Moodle Manager ou Site administrator -> FastComments admin
• Moodle Editing teacher ou Non-editing teacher -> FastComments moderator
• Moodle Student -> FastComments commenter
• Moodle Guest -> lecture seule

Les administrateurs peuvent supprimer n’importe quel commentaire, bannir des utilisateurs et modifier les paramètres du fil. Les modérateurs peuvent supprimer et approuver des commentaires dans le fil dans lequel ils ont lancé l’activité. Les rôles Moodle personnalisés héritent du mapping de l’archétype à partir duquel ils ont été clonés.

What Students See

Les étudiants cliquent sur l’activité FastComments (ou font défiler jusqu’au bloc intégré dans une Page ou un Book). Moodle envoie leur identité à FastComments via le lancement LTI :

• Aucun écran de connexion. FastComments les connecte en utilisant le compte Moodle.
• Leur nom d’affichage, courriel et avatar proviennent de Moodle.
• Le fil est limité à « (site Moodle, cours, resource link ID) », donc la même activité dupliquée dans un autre cours reçoit un fil neuf.
• Les réponses en arbre, le vote et les notifications fonctionnent de la même façon qu’un fil FastComments autonome.

Lock Down Public Access (Recommended)

Par défaut, les données de commentaires FastComments sont lisibles publiquement. Toute personne capable de deviner l’URL du fil ou le point de terminaison API peut voir ses commentaires, même en dehors de Moodle. Pour les discussions de cours, vous voudrez très probablement restreindre la consultation aux seuls étudiants inscrits.

Ouvrez votre page de personnalisation du widget et créez une règle avec Require SSO To View Comments activé, puis définissez le niveau de sécurité sur Secure SSO afin que les fils ne puissent être chargés que via le lancement LTI signé.

Voir Protecting Comment Threads With Single-Sign-On pour le guide complet, y compris comment limiter la règle à un domaine ou une page spécifique.

Moodle Gotchas

FastComments missing from the activity chooser. L’administrateur du site a enregistré l’outil mais n’a pas réglé Tool configuration usage sur Show in activity chooser and as a preconfigured tool. Corrigez cela sous Site administration > Plugins > Activity modules > External tool > Manage tools > icône d’engrenage sur la vignette FastComments.

Launch fails or shows a blank frame when set to "Same window". Les cookies de session de Moodle utilisent SameSite=Lax par défaut, et certains navigateurs les suppriment lors du POST intersite que LTI 1.3 utilise pour revenir depuis FastComments. Réglez Launch container sur New window pour l’activité. Il s’agit d’une exigence stricte pour les intégrations FastComments dans une Page ou un Book, car le chemin de lancement intégré depuis l’éditeur ouvre toujours une nouvelle fenêtre.

The iss claim is the Moodle site URL, not a tenant ID. FastComments utilise l’URL du site Moodle (la valeur de configuration wwwroot) comme émetteur LTI. Si votre instance Moodle déménage vers un nouveau domaine ou si vous changez wwwroot, les fils FastComments existants restent liés à l’ancien émetteur et ne correspondront pas aux nouveaux lancements. Réenregistrez l’outil pour la nouvelle URL et migrez les fils via l’administration FastComments si nécessaire.

Activity backup and restore. Sauvegarder un cours et le restaurer dans un nouveau cours crée de nouveaux resource link IDs, donc les activités FastComments restaurées commencent avec des fils vides. Le cours original conserve les fils d’origine. C’est le comportement attendu, pas un bogue.

Moodle 4.5 TinyMCE default. Moodle 4.5 est livré avec TinyMCE comme éditeur par défaut pour les nouvelles installations. Le bouton External tool se trouve sous le menu More (...) plutôt que dans la barre d’outils principale. Les anciens sites mis à niveau depuis 4.1 conservent Atto à moins qu’un administrateur n’ait changé le défaut.

Une fois qu’un administrateur a enregistré FastComments comme outil LTI 1.3 Advantage et approuvé les politiques de l’établissement, les instructeurs l’ajoutent aux cours via les points de placement standard de Blackboard. Les étapes exactes diffèrent entre Ultra Course View et Original Course View, donc les deux sont décrites ci‑dessous.

Ultra Course View

Ultra Course View est le réglage par défaut dans Blackboard Learn SaaS depuis 2026.

1. Ouvrez le cours et allez à la page Course Content.
2. Survolez ou appuyez à l’endroit où vous voulez que le fil de commentaires apparaisse dans le plan et cliquez sur le bouton violet + (Add content).
3. Choisissez Content Market. Le panneau Content Market liste tous les outils LTI approuvés et les placements Building Block pour votre établissement.
4. Trouvez la tuile FastComments et cliquez dessus. Blackboard crée un élément de contenu à la position où vous aviez ouvert le menu +.
5. L’élément apparaît dans le plan comme une entrée « Visible to students » par défaut pour les instructeurs dont le paramètre personnel Hide from students est désactivé. Si votre paramètre par défaut est Hidden, l’élément est créé en mode masqué et vous basculez le sélecteur de visibilité sur la ligne de l’élément quand vous êtes prêt.
6. Pour renommer l’élément, cliquez sur le titre dans le plan et tapez un nouveau libellé. Le titre que voient les étudiants dans le plan est indépendant de l’identifiant du fil FastComments, donc renommer est sans risque à tout moment.

Si vous ne voyez pas Content Market comme option, votre établissement a caché ce placement. Vous pouvez aussi accéder au même sélecteur via More tools dans le même menu + sous le groupe LTI Tools.

Original Course View

Original Course View est toujours pris en charge dans Learn SaaS et reste l’expérience principale pour les sites Learn 9.1 auto‑hébergés sur la ligne de correctifs Q4 2024 CU.

1. Ouvrez le cours et entrez dans une Content Area (par exemple, la Information ou la zone Content par défaut dans le menu du cours).
2. Activez Edit Mode avec le commutateur en haut à droite de la page.
3. Cliquez sur Build Content dans la barre d’actions.
4. Sous le sous‑menu Learning Tools, cliquez FastComments. Le sous‑menu Learning Tools est alimenté par les placements d’outils LTI 1.3 après qu’un administrateur a enregistré l’outil. Si vous ne le voyez pas, consultez la section des problèmes courants ci‑dessous.
5. Sur le formulaire Create FastComments, configurez :
   • Name : le libellé que verront les étudiants dans la zone de contenu.
   • Description : texte optionnel affiché au‑dessus du fil intégré.
   • Permit Users to View this Content : bascule de disponibilité Oui/Non.
   • Track Number of Views : activez si vous voulez les statistiques de consultation par élément de Blackboard. FastComments exécute ses propres analyses de façon indépendante.
   • Date and Time Restrictions : fenêtres optionnelles Display After / Display Until.
6. Soumettez. L’outil apparaît comme un élément cliquable dans la zone de contenu.

Intégration dans un élément ou un document

Dans les deux vues de cours, les instructeurs intègrent FastComments en ligne dans le corps d’un Item, d’un Document ou de tout champ riche via le bouton LTI Advantage de l’éditeur de contenu.

Ultra Course View :

1. Créez ou modifiez un Document.
2. Cliquez sur Add content à l’intérieur du corps du document à l’endroit où vous souhaitez que le fil apparaisse.
3. Dans la barre d’outils de l’éditeur, ouvrez le menu Insert content et cliquez sur Content Market (le point d’entrée LTI Advantage / Deep Linking).
4. Choisissez FastComments. FastComments renvoie une charge utile deep-link et Blackboard insère un bloc intégré dans le corps du document à la position du curseur.
5. Enregistrez le document. Les étudiants voient le fil rendu en ligne lorsqu’ils font défiler la page.

Original Course View :

1. Modifiez n’importe quel élément avec un corps en texte enrichi.
2. Dans la barre d’outils de l’éditeur de contenu, cliquez sur l’icône plus Add Content et choisissez Content Market (étiqueté Add Content from External Tool dans les anciennes CU Q4 2024).
3. Choisissez FastComments. L’éditeur insère un bloc de remplacement référant la ressource deep‑linked.
4. Soumettez l’élément.

Chaque intégration deep‑link crée son propre fil FastComments, donc un Item avec deux blocs FastComments intégrés aura deux flux de commentaires indépendants.

Visibilité, conditions de publication et restrictions de groupe

Les éléments de contenu FastComments se comportent comme tout autre élément de contenu Blackboard pour les règles de contrôle d’accès qui leur sont appliquées.

• Ultra : cliquez sur le sélecteur de visibilité sur la ligne (Visible to students, Hidden from students, Conditional availability). La disponibilité conditionnelle prend en charge les fenêtres de date/heure, les règles de performance basées sur les éléments du carnet de notes, et les règles de membre basées sur les groupes de cours.
• Original : ouvrez le menu contextuel de l’élément et choisissez Adaptive Release ou Adaptive Release: Advanced pour restreindre l’outil par date, appartenance, note ou statut de révision. Utilisez Set Group Availability sur l’élément pour le restreindre à des groupes de cours spécifiques.

FastComments respecte la décision du contrôle d’accès de Blackboard. Si Blackboard masque l’élément pour un étudiant, le lancement LTI n’a jamais lieu pour cet étudiant et il n’apparaît pas dans la vue modérateur.

Comportement dans le carnet de notes

FastComments ne renvoie pas de notes via LTI Advantage Assignment and Grade Services. Aucune colonne de notes n’est créée automatiquement pour les éléments FastComments.

Si votre locataire Blackboard est configuré pour créer automatiquement une colonne du carnet de notes pour chaque nouvel élément de contenu indépendamment des métadonnées de notation, une colonne vide apparaîtra quand même. Pour la masquer :

• Ultra : ouvrez le Gradebook, cliquez sur l’en‑tête de colonne, choisissez Edit, et désactivez Show to students ainsi que Include in calculations. Ou utilisez Delete si votre établissement autorise la suppression de colonne pour les éléments non notés.
• Original : ouvrez le Grade Center, cliquez sur le chevron de la colonne, choisissez Hide from Users (on/off), et éventuellement Hide from Instructor View sous Column Organization.

Ce que voient les étudiants

Lorsque l’étudiant ouvre l’élément FastComments ou fait défiler jusqu’à un bloc intégré :

1. Blackboard lance le message LTI 1.3 vers FastComments. L’étudiant est connecté via SSO en utilisant son identité Blackboard (nom, courriel, avatar, rôle) sans voir de formulaire de connexion.
2. Le fil de commentaires s’affiche dans l’iframe. Le threaded view, les réponses, les mentions et les réactions sont tous disponibles selon les paramètres du widget de commentaires configurés dans FastComments.
3. Leurs commentaires sont attribués à leur compte Blackboard. Si l’étudiant modifie ensuite son nom ou sa photo dans Blackboard, le lancement suivant mettra à jour le profil FastComments.

Correspondance des rôles de Blackboard vers FastComments :

• System Administrator et Course Builder correspondent au rôle FastComments admin.
• Instructor et Teaching Assistant correspondent au rôle FastComments moderator.
• Student, Guest et Observer correspondent au rôle FastComments commenter.

Les modérateurs voient les contrôles de modération (pin, hide, ban, delete) en ligne sur chaque commentaire du fil.

Verrouiller l’accès public (recommandé)

Par défaut, les données de commentaires FastComments sont lisibles publiquement. Toute personne capable de deviner l’URL d’un fil ou un endpoint API peut voir ses commentaires, même en dehors de Blackboard. Pour les discussions de cours, vous voudrez presque certainement restreindre la consultation aux étudiants inscrits seulement.

Ouvrez votre page de personnalisation du widget et créez une règle avec Require SSO To View Comments activé, puis réglez le niveau de sécurité sur Secure SSO afin que les fils ne puissent être chargés que via le lancement LTI signé.

Voir Protéger les fils de commentaires avec l'authentification unique pour le guide complet, y compris comment limiter la règle à un seul domaine ou une seule page.

Périmètre des fils

FastComments découpe chaque fil selon (Blackboard host, course ID, resource link ID). Deux éléments FastComments dans le même cours produisent deux fils. Le même élément copié dans deux cours différents (par exemple via la copie de cours) produit deux fils, parce que Blackboard attribue un nouvel resource link ID lors de la copie. Pour conserver un fil partagé entre des copies de cours, utilisez Deep Linking avec un URN de fil explicite configuré dans FastComments avant de lancer la copie.

Problèmes spécifiques à Blackboard

Tuile FastComments manquante dans le menu Build Content (Original) ou Content Market (Ultra). L’administrateur a approuvé l’outil mais a laissé une politique d’établissement bloquant le placement pertinent. Allez dans Administrator Panel > Integrations > LTI Tool Providers, modifiez l’entrée FastComments et confirmez que les placements Course Content Tool (Original) et Course Content Tool - allow students / Deep Linking content tool (Ultra) sont activés. Enregistrez et actualisez la page du cours.

Erreur « Tool not configured for this context » ou « Tool is not deployed » au lancement. Le scope de déploiement enregistré lors de l’enregistrement dynamique ne correspond pas au contexte de l’établissement auquel appartient le cours. Dans l’entrée fournisseur d’outil de Blackboard, vérifiez que le Deployment ID correspond à ce que FastComments affiche sur sa page de configuration LTI 1.3 pour ce locataire. S’ils diffèrent, supprimez le placement et relancez l’enregistrement dynamique depuis une URL d’enregistrement fraîche (récupérez‑la ici).

La hauteur de l’iframe semble fixe ou le contenu est tronqué. Certains locataires Blackboard imposent une Content Security Policy stricte qui bloque le postMessage de redimensionnement d’iframe LTI par défaut. FastComments émet à la fois le message de style Canvas lti.frameResize et le message conforme à la spécification IMS org.imsglobal.lti.frameResize pour maximiser la compatibilité, mais une surcharge CSP au niveau du locataire bloque l’écouteur parent. Demandez à votre administrateur de confirmer que *.fastcomments.com est sur la liste blanche des outils LTI et qu’aucun en‑tête CSP personnalisé ne supprime les événements postMessage. Le redimensionnement fonctionnera alors sans configuration supplémentaire.

La copie de cours duplique les fils. La copie de cours de Blackboard génère de nouveaux resource link ID pour les placements LTI, donc les cours copiés démarrent avec des fils vides. C’est attendu. Si vous avez besoin que le cours copié hérite du fil original, configurez Deep Linking avec un URN de fil explicite avant la copie, ou contactez le support FastComments pour remapper les IDs de fil en masse.

L’étudiant voit une erreur générique Blackboard au lancement. La cause est une revendication email manquante ou périmée. Confirmez que la politique d’établissement pour FastComments a activé Role, Name, et Email Address sous User Fields to Send. Enregistrez, puis relancez dans une nouvelle session de navigateur.

Une fois que FastComments est enregistré sur la plateforme, les instructeurs l'ajoutent au contenu du cours en utilisant les flux standard d'outils externes de la plateforme. Cette page couvre Sakai 23.x et Schoology Enterprise.

Verrouiller l'accès public (Recommandé)

Par défaut, les données de commentaires FastComments sont lisibles publiquement sur chaque plateforme. Toute personne capable de deviner l'URL d'un fil ou le point de terminaison API peut voir ses commentaires, même en dehors de Sakai ou Schoology. Pour les discussions de cours, vous voudrez presque certainement restreindre l'affichage aux étudiants inscrits seulement.

Ouvrez votre page de personnalisation du widget et créez une règle avec Require SSO To View Comments activé, puis définissez le niveau de sécurité sur Secure SSO afin que les fils puissent être chargés uniquement via le lancement LTI signé.

Voir Protecting Comment Threads With Single-Sign-On pour le guide complet, y compris comment limiter la règle à un seul domaine ou une seule page.

Sakai

1. Ajouter FastComments à un site

Le gestionnaire du site active l'outil au niveau de chaque site :

1. Ouvrez le site et cliquez sur Site Info dans la navigation de gauche.
2. Cliquez sur Manage Tools.
3. Faites défiler jusqu'à la liste External Tools et activez FastComments.
4. Cliquez sur Continue, vérifiez la liste des outils, puis cliquez sur Finish.

FastComments apparaît maintenant comme un élément de la navigation de gauche dans le site.

2. Réordonner l'entrée de navigation de gauche

Allez dans Site Info > Tool Order. Faites glisser FastComments à la position souhaitée et cliquez sur Save. Vous pouvez aussi renommer le libellé de navigation et le masquer aux étudiants depuis cet écran.

3. Intégrer en ligne dans une page Lessons

Pour placer FastComments directement dans une page Lessons plutôt que comme un outil autonome dans la navigation de gauche :

1. Ouvrez l'outil Lessons dans le site.
2. Cliquez sur Add Content > Add External Tool.
3. Sélectionnez FastComments dans la liste.
4. Si FastComments a annoncé Deep Linking lors de l'enregistrement, Sakai ouvre le sélecteur de contenu de l'outil pour que vous puissiez choisir ou étiqueter le fil. Si Deep Linking n'a pas été annoncé, Sakai insère un lien de lancement par défaut.
5. Enregistrez l'élément Lessons.

Chaque instance intégrée obtient son propre fil, limité à ce lien de ressource.

4. Ajustements de permission pour l'accès des étudiants

Sakai contrôle les lancements d'outils externes via les Realms. Pour confirmer que les étudiants peuvent lancer FastComments :

1. Connectez-vous en tant qu'administrateur Sakai et ouvrez Administration Workspace > Realms.
2. Ouvrez le realm concerné (par exemple, !site.template.course ou le realm du site spécifique).
3. Confirmez que le rôle access a lti.launch activé et que les permissions de rôle dans le groupe external.tools sont accordées.
4. Enregistrez le realm.

Pour les substitutions au niveau du site, le gestionnaire peut ajuster la visibilité de l'outil par rôle depuis Site Info > Tool Order en masquant ou en affichant FastComments par rôle.

5. Ce que voient les étudiants

Les étudiants cliquent sur l'élément FastComments de la navigation de gauche (ou font défiler jusqu'au bloc Lessons intégré) et arrivent directement dans la vue des fils de discussion. Le SSO est automatique : Sakai envoie l'identité de l'utilisateur dans le lancement LTI et FastComments les connecte sous leur compte Sakai.

Mappage des rôles :

• Sakai Instructor -> modérateur FastComments
• Sakai Admin (admin in Administration Workspace) -> administrateur FastComments
• Sakai Student / access -> commentateur FastComments

6. Pièges Sakai

• Outil non visible dans Manage Tools. Si FastComments n'apparaît pas dans la liste External Tools, l'administrateur Sakai doit ouvrir le registre d'outils (Administration Workspace > External Tools > FastComments) et définir Stealthed sur false. Les outils stealthed sont cachés du sélecteur Manage Tools au niveau du site.
• Lancements qui échouent dans des navigateurs en session partagée. Le jeton CSRF du portail Sakai est lié à la session du navigateur. Si un étudiant est connecté à deux sites Sakai dans différents onglets ou possède une session périmée, le lancement retourne un 403. Solution : fermez les autres onglets Sakai, déconnectez-vous, reconnectez-vous et relancez. Les administrateurs peuvent aussi augmenter sakai.csrf.token.cache.ttl si cela se produit à l'échelle du cluster.
• Intégration en iframe. Confirmez que lti.frameheight dans sakai.properties est suffisamment grand (600 ou plus) afin que le fil de commentaires ne soit pas coupé dans une page Lessons.

Schoology

Schoology Enterprise a deux scénarios d'installation. Confirmez lequel s'applique avant d'ajouter l'outil à un cours.

1. Deux scénarios d'installation

• (a) Installation au niveau de l'entreprise. L'administrateur système Schoology a installé FastComments au niveau de l'organisation et l'a attribué à tous les cours ou à des modèles de cours spécifiques. Les instructeurs sautent l'installation et passent directement à « Add Materials ».
• (b) Installation par l'instructeur. L'instructeur installe l'outil dans un seul cours via Course Options > External Tools > Install LTI Apps. L'auto-installation nécessite que l'administrateur système ait approuvé l'application FastComments au niveau de l'organisation au préalable.

2. Ajouter FastComments en tant que matériel de cours

À l'intérieur du cours :

1. Ouvrez le cours et allez dans Materials.
2. Cliquez sur Add Materials > Add File/Link/External Tool.
3. Choisissez External Tool.
4. Sélectionnez FastComments dans la liste des outils enregistrés.
5. Définissez un Name (c'est ce que les étudiants voient dans la liste des matériels) et une Description facultative.
6. Laissez Enable Grading (grade passback) OFF. FastComments ne renvoie pas de notes à Schoology, donc activer le grade passback crée une colonne vide dans le carnet de notes.
7. Cliquez sur Submit.

Le matériel apparaît maintenant dans la liste des matériels du cours et ouvre le fil FastComments lorsqu'on clique dessus.

3. Intégration en ligne via l'éditeur Rich Text

Si l'administrateur système a activé le placement Deep Linking pour FastComments lors de l'enregistrement, les instructeurs peuvent intégrer le fil de commentaires dans n'importe quel champ Rich Text (instructions de devoir, corps de page, consignes de discussion) :

1. Ouvrez l'éditeur Rich Text sur la page cible.
2. Cliquez sur l'icône External Tool (pièce de puzzle) dans la barre d'outils.
3. Choisissez FastComments.
4. Configurez l'intégration dans la boîte de dialogue de deep-linking et cliquez sur Insert.
5. Enregistrez la page.

Si le bouton External Tool n'apparaît pas dans l'éditeur Rich Text, Deep Linking est désactivé pour cet outil sur ce tenant. Voir les pièges ci-dessous.

4. Visibilité et affectations par section

Schoology limite la disponibilité des outils par section via Course Options :

1. Depuis le cours, cliquez sur Course Options > External Tools.
2. Pour chaque application LTI installée, vous contrôlez si elle est disponible pour toutes les sections du cours ou pour des sections spécifiques.
3. Pour restreindre FastComments à certaines sections, décochez les sections qui ne doivent pas voir l'outil.
4. L'accès au niveau de la section conditionne également quelles sections voient l'entrée Add Materials > External Tool pour FastComments.

5. Ce que voient les étudiants

Les étudiants cliquent sur le matériel FastComments (ou font défiler jusqu'à l'intégration en ligne) et arrivent dans la discussion filée. Le SSO est automatique via le lancement LTI Schoology sous leur compte Schoology.

Mappage des rôles :

• Schoology Administrator -> administrateur FastComments
• Schoology Instructor -> modérateur FastComments
• Schoology Student -> commentateur FastComments

6. Pièges Schoology

• Uniquement Enterprise. Les comptes Schoology personnels et gratuits ne peuvent pas installer d'outils LTI 1.3. Si votre tenant est sur le forfait gratuit, l'option External Tools est absente de Course Options. Passez à Schoology Enterprise pour utiliser FastComments.
• Deep Linking désactivé par défaut au niveau du tenant. Certains tenants Schoology restreignent le placement Deep Linking au niveau de l'organisation. Quand c'est le cas, les instructeurs ne voient que le flux Add Materials > External Tool et pas le bouton External Tool dans l'éditeur Rich Text. Pour permettre l'intégration en ligne, l'administrateur système doit aller dans System Settings > Integration > LTI 1.3 > FastComments et activer le placement Content Item / Deep Linking, puis enregistrer.
• Substitution d'affectation par section. Si FastComments est assigné au niveau de l'entreprise mais que l'instructeur ne le voit pas dans Add Materials, la section du cours est exclue de l'affectation au niveau organisationnel. Demandez à l'administrateur système d'ajouter la section à l'affectation de l'application FastComments.
• Nom du matériel vs identité du fil. Renommer le matériel dans Schoology ne déplace pas le fil de commentaires. Les fils sont identifiés par l'ID du lien de ressource LTI, donc un renommage conserve le même fil ; supprimer et recréer le matériel crée un nouveau fil vide.

"Jeton d'enregistrement introuvable, expiré ou déjà utilisé"

Le token dans votre URL d'enregistrement (obtenez-le ici) est valide pendant 30 minutes et ne peut être utilisé qu'une seule fois. Si votre LMS a mis plus de temps, ou si l'enregistrement a été réessayé après avoir réussi, le token sera rejeté. Générez une nouvelle URL sur la page de configuration FastComments LTI 1.3 et recommencez.

"La plateforme a refusé l'enregistrement"

Votre LMS a refusé la négociation d'enregistrement. Les causes les plus courantes :

• Outil déjà enregistré avec le même nom de client. Certaines plateformes (notamment D2L) refusent une seconde inscription de "FastComments" tant que la précédente n'est pas supprimée. Supprimez l'ancien outil dans votre LMS, puis réessayez.
• Mauvais champ dans le LMS. Assurez-vous d'avoir collé l'URL dans le champ registration / tool initiation registration endpoint, et non dans le champ launch URL ou login URL.
• Le LMS ne prend pas réellement en charge l'enregistrement dynamique. Les anciennes versions de Moodle et Blackboard annoncent LTI 1.3 mais n'autorisent que la configuration manuelle. Consultez la documentation de votre plateforme.

"Échec de la récupération de la configuration de la plateforme"

FastComments n'a pas pu lire le document openid-configuration de votre LMS. C'est rare et signifie généralement que le LMS a fourni une URL de découverte mal formée ou inaccessible. Contactez le support de votre LMS.

Le lancement affiche "Configuration introuvable"

Soit la configuration dans FastComments a été supprimée, soit le lancement provenait d'une paire iss/client_id que nous ne reconnaissons pas. Si vous avez supprimé puis réenregistré, demandez à votre LMS de supprimer puis de réajouter l'outil FastComments afin qu'il obtienne le nouveau client_id.

Le lancement affiche "Déploiement non enregistré"

Vous avez lancé FastComments depuis un déploiement Brightspace/Moodle/Blackboard différent de celui dans lequel il a été lancé initialement. FastComments verrouille le deployment_id lors du premier lancement comme mesure de sécurité. Pour ajouter un nouveau déploiement sous le même client, contactez le support — nous ajouterons l'ID de déploiement à la configuration.

Le lancement affiche "Type de message non pris en charge"

Le LMS a envoyé un message LTI que FastComments ne gère pas (p. ex. LtiSubmissionReviewRequest). FastComments ne prend en charge que le lancement resource-link standard et les flux de deep-linking. Contactez-nous si vous avez besoin qu'un type de message spécifique soit ajouté.

L'iframe ne se redimensionne pas

La plupart des LMS redimensionnent automatiquement les iframes LTI. Si le vôtre ne le fait pas, vérifiez que les paramètres de lancement du LMS permettent à l'outil d'envoyer des événements postMessage à la fenêtre parente. FastComments émet des messages de redimensionnement de type Canvas (lti.frameResize) et selon la spécification IMS (org.imsglobal.lti.frameResize).

La intégration FastComments LTI 1.3 suit le principe du moindre privilège : elle n'utilise que les revendications de lancement requises pour identifier l'utilisateur, attacher les commentaires au bon cours et à la bonne ressource, et appliquer des autorisations basées sur les rôles.

Le reste de cette page cartographie chaque revendication que l'intégration consomme, chaque service LTI Advantage qu'elle ne demande pas, et chaque catégorie de données qu'elle ne collecte pas. Les évaluateurs de la sécurité et des achats peuvent extraire des réponses directement des tableaux ci-dessous.

Éléments de données reçus du LMS

Chaque lancement LTI 1.3 contient un JWT signé provenant du LMS. FastComments extrait les revendications suivantes de ce JWT et n'utilise rien d'autre :

Revendications et étendues déclarées lors de l'enregistrement

Lors de l'enregistrement dynamique LTI 1.3, FastComments s'enregistre avec scope: "" (aucune étendue OAuth additionnelle) et déclare uniquement ces revendications OpenID Connect :

iss, sub, name, email, picture

Il enregistre deux types de messages :

• LtiResourceLinkRequest - le lancement de cours standard vers FastComments.
• LtiDeepLinkingRequest - permet aux instructeurs de placer l'outil FastComments à l'intérieur d'un cours.

Aucun jeton d'accès supplémentaire n'est demandé au LMS.

Services LTI Advantage non demandés

Données non collectées

Outre LTI lui‑même, FastComments ne demande ni ne reçoit les éléments suivants du LMS ou de l'utilisateur :

Limites d'accès

• FastComments ne reçoit des données que dans le cadre d'un lancement LTI 1.3 autorisé signé par les clés enregistrées du LMS. L'intégration n'interroge pas le LMS pour obtenir des informations supplémentaires.
• Les jetons de lancement sont à usage unique et de courte durée. Les jetons rejoués ou expirés sont rejetés.
• Les administrateurs LMS contrôlent où l'outil est déployé dans leur plateforme. D2L Brightspace, par exemple, prend en charge le ciblage par unité organisationnelle et les paramètres de sécurité par déploiement, ce qui permet aux administrateurs de restreindre l'outil à des cours ou unités organisationnelles spécifiques plutôt que de le rendre disponible globalement. Moodle, Blackboard, Sakai et Schoology offrent des contrôles équivalents par déploiement dans leurs implémentations LTI 1.3.

Stockage et conservation

FastComments conserve les données dérivées de LTI pendant la durée du service de commentaires actif et conformément aux paramètres de conservation configurés par le client. Les données de commentaires sont stockées dans un stockage de production chiffré au repos. Lors de la résiliation du compte ou sur demande écrite de suppression, FastComments supprime ou anonymise les données client conformément à l'accord applicable.

Pour les détails complets sur le stockage et le traitement des données, voir la Politique de confidentialité de FastComments.

Fréquence de révision

Toute nouvelle fonctionnalité LTI nécessitant des revendications, des étendues ou des services LTI Advantage supplémentaires est examinée avant la publication afin de confirmer que l'accès demandé est nécessaire et proportionnel à la fonctionnalité livrée.

Brève déclaration pour les questionnaires de sécurité

FastComments applique le principe du moindre privilège et la minimisation des données à son intégration LTI 1.3. L'intégration n'utilise que les revendications de lancement LTI nécessaires pour authentifier l'utilisateur (sub, name, email, picture), déterminer son rôle et identifier le cours et la ressource auxquels les commentaires appartiennent. FastComments ne demande pas les services de provision des noms et des rôles (NRPS), les services d'affectation et de notation (AGS), les données du carnet de notes, la présence, les listes complètes de participants, ni l'accès administratif au LMS. Les administrateurs LMS conservent le contrôle sur les unités organisationnelles, les cours et les déploiements dans lesquels l'outil est disponible.