Intégration du système de gestion de l'apprentissage Discourse (authentification LTI 1.3)

[Discourse]

|||
-|-|-|
| Résumé | Discourse LTI permet à Discourse de s’intégrer à plusieurs systèmes de gestion de l’apprentissage via la norme LTI 1.3.
| Guide d’installation | Ce plugin est inclus dans le cœur de Discourse. Aucune installation séparée du plugin n’est nécessaire.

Comme il s’agit d’un plugin #officiel maintenu par l’équipe Discourse, les demandes de Support, de bug, d’expérience utilisateur (ux) et de #fonctionnalités peuvent être soumises dans les catégories respectives sur Meta, en utilisant le tag approprié pour le plugin. Cliquez sur un lien ci-dessous pour en créer un.

 Support  Bug  UX  Fonctionnalité

Ce plugin implémente la norme LTI 1.3 pour l’authentification, prise en charge par plusieurs systèmes de gestion de l’apprentissage. Discourse agit en tant qu’« Outil » au sein de la norme LTI. Une fois configuré, les utilisateurs pourront cliquer sur un bouton ou un lien dans leur système de gestion de l’apprentissage et se connecter instantanément à Discourse.

Les instructions précises de configuration varieront selon votre système de gestion de l’apprentissage. Mais en général :

1. Créez une nouvelle entrée « Outil » dans votre système de gestion de l’apprentissage

• Version LTI : 1.3
• URL de lancement : n’importe quelle URL de votre site. Les utilisateurs seront redirigés ici après la connexion
• URL de demande d’authentification : https://<votre-site-discourse>/auth/lti/initiate
• URL de redirection : https://<votre-site-discourse>/auth/lti/callback
• Clé publique de l’outil : laissez vide. Discourse n’envoie jamais de données vers le LMS

2. Dans votre LMS, trouvez le « point de terminaison d’autorisation », l’« ID client de l’outil », l’« ID émetteur de la plateforme » et la « clé publique de la plateforme », puis ajoutez-les aux paramètres du site pertinents dans Discourse. Dans Discourse, ces paramètres peuvent être trouvés en recherchant lti dans l’interface des paramètres du site.

3. Si votre système de gestion de l’apprentissage garantit que les e-mails des utilisateurs ont été validés, activez le paramètre du site lti email verified. Attention : si votre LMS ne vérifie pas les e-mails, activer lti email verified constitue un risque de sécurité.

4. Activez le paramètre du site lti enabled

Si ces instructions ne correspondent pas à votre LMS, veuillez poster dans le sujet ci-dessous et nous ferons de notre mieux pour mettre à jour les instructions en conséquence.

Que faire si mon site nécessite une invitation (invite_required) ?

Si vous souhaitez que vos utilisateurs passent par le processus de rachat d’invitation de Discourse lors de leur première connexion, vous pouvez utiliser les « Propriétés personnalisées » LTI pour spécifier un lien d’invitation Discourse. Les nouveaux utilisateurs seront redirigés vers l’invitation, tandis que les utilisateurs existants seront envoyés à l’URL de lancement habituelle. Par exemple :

Nom de la propriété	Valeur de la propriété
discourse_invite_link	https://discourse.example.com/invites/abcdefg

FAQ

Le plugin prend-il en charge l’intégration avec plusieurs systèmes LMS simultanément ?

• Le plugin ne prend actuellement en charge qu’un seul LMS connecté à un site. Le paramètre du site LTI client IDs accepte plusieurs valeurs, mais cela s’explique par le fait que certains systèmes LMS attribuent un ID client par cours.

[robertguss]

Avez-vous des instructions spécifiques pour intégrer l’intégration LTI avec Canvas LMS ?

[pfaffman (Jay Pfaffman)]

Vous aurez besoin que vos administrateurs effectuent l’intégration.

[robertguss]

Je suis l’un de nos administrateurs et aussi un ingénieur logiciel. Je pense que le problème que j’ai a à voir avec les cookies et que « l’état » entre Discourse et Canvas ne correspond pas.

Voici l’erreur que j’obtiens dans les journaux de Discourse :

(lti) Échec d’authentification ! state_mismatch : StandardError, Le paramètre d’état ne correspondait pas à la session

Je pense que cette erreur est générée à partir d’ici : discourse-lti/lib/discourse_lti/lti_omniauth_strategy.rb at main · discourse/discourse-lti · GitHub

Avez-vous des idées ou des pistes à explorer pour m’aider à déboguer cela ? Sur cette page de la documentation Canvas : Overview of an LTI Launch <a name="launch-overview"></a> - Canvas LMS REST API Documentation

Il y a une section « Lancement sans cookies » qui, je pense, est pertinente ici. Mais je ne suis pas sûr à 100 %. Toute aide ou idée serait grandement appréciée.

[kevincolten]

J’ai réussi à faire fonctionner LTI dans Canvas avec une seule réserve. Voici les étapes que j’ai suivies :

1. Créez une clé de développeur dans Canvas. Peu importe ce que vous mettez dans la méthode JWK et JWK public
   

   

2. Dans les paramètres LTI de Discourse, remplissez vos paramètres
   

   

3. Pour la clé publique, vous pouvez naviguer vers https://\u003cvotre_url_canvas\u003e/api/lti/security/jwks et copier la deuxième clé. Ensuite, vous pouvez aller sur https://8gwifi.org/jwkconvertfunctions.jsp et la coller là-bas et convertir. Ensuite, copiez le texte entre -----BEGIN/END PUBLIC KEY----- et collez-le dans la Clé publique de la plateforme Lti dans les paramètres LTI de Discourse. Ensuite, enregistrez.

Voici la réserve. Ces JWK que Canvas génère sont mis à jour, apparemment mensuellement. Une fois que cette deuxième clé change, LTI cessera de fonctionner et vous devrez la remplacer par la nouvelle en suivant l’étape 3.

Le plugin LTI de Discourse devra prendre en charge une URL JWK publique pour rester à jour.

[HandSpy_v3]

Puis-je avoir plusieurs LMS intégrés à un seul Discourse ?

[tobiaseigen]

Ce plugin est maintenant inclus dans le cœur de Discourse dans le cadre de Bundling more popular plugins with Discourse core. Si vous auto-hébergez et utilisez le plugin, vous devez le supprimer de votre app.yml avant votre prochaine mise à niveau.