Ajouter des commentaires à Canvas LMS via LTI 1.3
FastComments s'intègre à Canvas LMS via la norme LTI 1.3. Cela ajoute des commentaires en direct et un chat collaboratif directement à vos cours Canvas - aucun plugiciel à installer sur votre serveur.
Les commentaires apparaissent automatiquement sous les devoirs, et les instructeurs peuvent intégrer FastComments dans Pages, Quizzes et Announcements via le Rich Content Editor. Le SSO est géré automatiquement via le lancement LTI - les étudiants commentent avec leurs comptes Canvas sans connexion séparée. L'intégration prend en charge les fils de discussion, le chat collaboratif en temps réel avec surlignage de texte, et le mappage automatique des rôles.
Tarification 
L'intégration FastComments LTI 1.3 est incluse dans les forfaits Flex et Pro sans frais supplémentaires.
Démarrage rapide
- Accédez à votre configuration LTI FastComments.
- Entrez un Nom de configuration et votre URL de la plateforme (p. ex.
https://yourschool.instructure.com). Choisissez les Emplacements à activer (Affichage de devoir et/ou Bouton de l'éditeur — les deux sont activés par défaut). Cliquez sur Créer la configuration. L'assistant passe à l'étape 2 et affiche votre URL de configuration. - Dans Canvas, allez à Administration > Clés de développeur > + Clé de développeur > Clé LTI. Définissez Méthode sur "Saisir l'URL" et collez l'URL de configuration. Enregistrez la clé, puis réglez son État sur Activé et cliquez sur Autoriser lorsqu'on vous le demande.
- Copiez le numéro Client ID depuis le tableau des Clés de développeur dans Canvas. De retour dans FastComments, collez-le dans le champ Client ID et cliquez sur Enregistrer et continuer.
- Vérifiez le résumé de la configuration et cliquez sur Activer l'intégration pour la mettre en ligne.
- Installez l'application externe dans Canvas (Administration > Paramètres > Applications > + Application > Par Client ID). Les commentaires apparaîtront automatiquement sous les devoirs, et les instructeurs peuvent intégrer FastComments dans les Pages, les Quiz et les Annonces via le bouton de la barre d'outils de l'éditeur de contenu enrichi.
Configuration du tableau de bord FastComments
Accéder à la configuration LTI
Accédez à votre configuration LTI FastComments.
La page de configuration utilise un assistant guidé qui vous accompagne à chaque étape. Vous commencerez à Étape 1 : Création.
Créer une nouvelle configuration LTI
Remplissez les champs suivants :
- Nom de la configuration - un libellé optionnel pour identifier cette configuration (utile si vous connectez plusieurs instances Canvas).
- URL de la plateforme - l'URL de votre instance Canvas (p. ex.
https://yourschool.instructure.com). Ce champ est requis.
Choisir les emplacements
Sous l'URL de la plateforme, vous pouvez choisir où FastComments apparaît dans vos cours Canvas. Les deux emplacements sont activés par défaut :
- Assignment View - les commentaires apparaissent automatiquement sous les devoirs.
- Rich Content Editor Button - les enseignants peuvent intégrer FastComments dans Pages, Quiz et Annonces en utilisant le bouton de la barre d'outils de l'éditeur de contenu enrichi.
Vous pouvez activer un ou les deux. Au moins un emplacement doit être activé.
Cliquez sur Créer la configuration.
Copier l'URL de configuration
Après avoir créé la configuration, l'assistant passe à Étape 2 : Connexion. Une Configuration URL bien en évidence est affichée en haut de la page avec un bouton Copier.
Copiez cette URL. Vous en aurez besoin à l'étape suivante pour créer une Developer Key dans Canvas.
La page affiche aussi des instructions numérotées pour ce qu'il faut faire dans Canvas, ainsi que des champs pour entrer le Client ID et le Deployment ID optionnel une fois que vous les aurez.
Clé de développeur Canvas
Ouvrir les clés de développeur dans Canvas
Connectez-vous à Canvas en tant qu'administrateur. Allez à Admin (dans la barre latérale gauche) > sélectionnez votre compte > Developer Keys.
Créer une clé de développeur LTI
Cliquez sur + Developer Key et sélectionnez LTI Key.
Dans le formulaire de configuration :
- Dans le champ Redirect URIs (côté gauche), collez l’Launch URL provenant de la page de configuration FastComments.
- À droite, définissez Method sur Enter URL.
- Collez l’Configuration URL que vous avez copiée depuis FastComments dans le champ JSON URL.
- Canvas chargera automatiquement la configuration LTI.
- Donnez un nom à la clé (p. ex. "FastComments").
- Cliquez sur Save.
Activer la clé de développeur
Après l’enregistrement, la nouvelle clé apparaîtra dans le tableau Developer Keys avec son State réglé sur OFF. Cliquez sur le commutateur pour le définir sur ON. Canvas peut vous demander de confirmer — cliquez sur Allow pour activer la clé.
Copier le Client ID
Le tableau Developer Keys affiche un Client ID numérique dans la colonne Détails (p. ex. 17000000000042). Copiez ce numéro — vous en aurez besoin à l’étape suivante.
Finaliser la connexion
Saisissez le Client ID dans FastComments
Retournez à votre configuration LTI FastComments. L'assistant devrait être à Étape 2 : Connexion.
Collez le Client ID que vous avez copié de Canvas dans le champ Client ID. Vous pouvez aussi saisir le Deployment ID si votre LMS en fournit un.
Cliquez sur Enregistrer et continuer.
Activer l'intégration
L'assistant passe à Étape 3 : Mise en service. Un résumé de votre configuration est affiché (nom, URL de la plateforme, Client ID et Deployment ID).
Vérifiez les détails, puis cliquez sur Activer l’intégration pour activer la connexion LTI.
Après l'activation, l'assistant affiche la Vue de gestion où vous pouvez modifier votre configuration, afficher toutes les URL LTI ou ajouter des déploiements supplémentaires.
Installer l'application externe dans Canvas
Dans Canvas, allez à Admin > sélectionnez votre compte > Settings > onglet Apps.
Cliquez sur + App et configurez :
- Réglez Configuration Type sur By Client ID.
- Collez le Client ID depuis la table Developer Keys.
- Cliquez sur Submit.
- Confirmez l'installation lorsqu'on vous le demande.
FastComments est maintenant installé au niveau du compte et disponible pour tous les cours.
Ajouter à un cours
Comment les commentaires apparaissent dans vos cours
Une fois l'intégration LTI activée et que l'application externe est installée, FastComments fonctionne automatiquement selon les emplacements que vous avez configurés :
Affichage du devoir
Si l'emplacement Affichage du devoir est activé, les commentaires apparaissent automatiquement sous chaque devoir du cours. Les étudiants et les enseignants voient une section de commentaires en fils lorsqu'ils consultent un devoir — aucune configuration supplémentaire n'est requise par devoir.
Chaque devoir a son propre fil de commentaires distinct.
Bouton de l'éditeur de contenu enrichi
Si l'emplacement Bouton de l'éditeur est activé, les enseignants peuvent intégrer FastComments dans tout contenu utilisant l'Éditeur de contenu enrichi :
- Modifiez une Page, un Quiz, ou une Annonce.
- Dans la barre d'outils de l'Éditeur de contenu enrichi, cliquez sur le bouton FastComments.
- FastComments est automatiquement intégré au contenu.
- Enregistrez la page.
Lorsque les étudiants consultent la page, le widget FastComments intégré se charge avec un fil de commentaires unique à cette page.
SSO automatique
Dans les deux emplacements, les étudiants sont automatiquement connectés via leur compte Canvas. Les noms, courriels et avatars sont synchronisés lors du lancement LTI, aucun autre identifiant n'est nécessaire.
Verrouiller l'accès public (recommandé)
Par défaut, les données de commentaires FastComments sont lisibles publiquement. Toute personne pouvant deviner l'URL d'un fil ou un endpoint API peut voir ses commentaires, même à l'extérieur de Canvas. 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ée, 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 l'authentification unique pour le guide complet, y compris comment limiter la règle à un seul domaine ou une seule page.
Styles de commentaires
FastComments ajoute des commentaires en fil de discussion à vos cours Canvas. Le widget FastComments standard apparaît sur la page. Les utilisateurs peuvent publier des commentaires en fil de discussion, répondre, voter et utiliser toutes les fonctionnalités standard.
Les commentaires sont attachés à chaque page de cours ou lien de ressource, ce qui permet de garder les discussions organisées par page, devoir ou module.
Mappage des rôles
Les rôles Canvas sont automatiquement associés aux rôles FastComments lors du lancement LTI. Aucune configuration manuelle n'est nécessaire.
Correspondance des rôles
| Canvas Role | FastComments Role | Permissions |
|---|---|---|
| Administrator | Admin | Accès complet au compte, gestion de tous les commentaires et des paramètres |
| Instructor | Moderator | Modifier et supprimer des commentaires, épingler des fils de discussion, gérer les discussions |
| Learner | Commenter | Publier des commentaires, répondre, voter et utiliser les mentions |
Comment cela fonctionne
Lorsqu'un utilisateur lance FastComments depuis Canvas, le protocole LTI 1.3 inclut son rôle Canvas. FastComments lit ce rôle et attribue automatiquement les autorisations appropriées.
Si un utilisateur a plusieurs rôles (p. ex. un Instructor qui est aussi un Admin), le rôle avec le niveau de privilège le plus élevé est utilisé.
Personnalisation
FastComments est conçu pour être personnalisé afin de correspondre à votre site.
Si vous souhaitez ajouter des styles personnalisés ou modifier la configuration, Consultez notre documentation de personnalisation pour savoir comment.
Erreurs de domaine
Vous pourriez obtenir une erreur d'autorisation, comme la suivante :
Ceci est dû au fait que FastComments ne sait pas qu'il doit autoriser l'utilisation de votre compte sur ce domaine.
Dans ce cas, la solution est simple. Vous devez simplement ajouter le domaine de votre instance Canvas à votre compte FastComments.
Allez ici pour ajouter votre site à votre compte.
Ajoutez le domaine de votre instance Canvas (p. ex. yourschool.instructure.com) et les commentaires devraient se charger correctement.