Aller sur YuJa
  1. Centre d'aide YuJa
  2. Plateforme d'accessibilité LMS Panorama
  3. Intégration de Canvas
  4. Administrateurs

Intégration de Panorama à Canvas avec LTI 1.3

Avatar
YuJa
  • Mise à jour

Ce document fournit aux administrateurs les instructions pour intégrer la plateforme d'accessibilité LMS Panorama à Canvas à l'aide de LTI 1.3. Avant de poursuivre avec les étapes ci-dessous, veuillez vous assurer de disposer d'un accès complet à votre instance Canvas en tant qu'administrateur. Si vous avez des questions au sujet de la démarche, veuillez communiquer avec votre gestionnaire de compte dédié.
 

Remarque : Il est fortement recommandé de créer dans Canvas un compte de service distinct pour l'intégration. Cela permet de déterminer plus facilement quelles actions ont été effectuées par l'intégration et lesquelles l'ont été par un administrateur humain, ce qui aide à éviter les confusions ou les modifications involontaires.

 

Obtention de votre chaîne JSON Panorama

Avant d'ajouter Panorama à votre instance Canvas, vous devrez obtenir votre chaîne JSON. Pour y accéder, vous devez avoir reçu un courriel de votre gestionnaire de compte vous invitant à créer votre compte Panorama. Créez votre compte, puis passez aux étapes ci-dessous.

  1. Connectez-vous à votre compte Panorama.
  2. Cliquez sur Configurations dans le menu de gauche, puis sélectionnez Paramètres d'intégration.
  3. Sélectionnez LTI 1.3.
  4. Cliquez sur Télécharger le JSON LTI 1.3 pour obtenir votre chaîne JSON Panorama.

Ajout de Panorama à Canvas

Une fois votre chaîne JSON obtenue, vous pouvez ajouter Panorama à votre instance Canvas.

  1. Connectez-vous à Canvas en tant qu'administrateur. Dans la barre latérale de gauche, cliquez sur Admin, puis sélectionnez le compte Canvas de votre établissement.
  2. Dans la barre latérale, sélectionnez Admin > Clés de développeur.
  3. Cliquez sur + Clé de développeur > + Clé LTI.
  4. Dans le menu déroulant Méthode, sélectionnez Coller le JSON.
  5. Ouvrez le fichier JSON téléchargé à la section précédente dans n'importe quel éditeur de texte, comme le Bloc-notes, puis copiez son contenu. Les URL de redirection seront ajoutées automatiquement.
  6. Ensuite, dans le champ Configuration LTI 1.3, collez le contenu copié.

  7. Saisissez le Nom de la clé de votre choix, puis cliquez sur Enregistrer.

    Remarque : Si vous souhaitez que l'outil LTI soit désactivé par défaut dans la barre de navigation du cours, ajoutez le paramètre suivant dans la section de navigation du cours : "default": "disabled".

    Le paramètre permettant de définir le lien LTI de Panorama est inséré dans le code.

  8. Activez l'interrupteur État de la clé de développeur.
  9. Cliquez sur Afficher dans les applications Canvas. Une nouvelle fenêtre Canvas s'ouvrira.
  10. Cliquez sur l'icône en forme de crayon.
  11. Remplacez le statut par Disponible, puis cliquez sur Enregistrer.
  12. Copiez l'ID du client.
  13. Ensuite, sélectionnez Paramètres dans la barre de navigation.
      
  14. Sélectionnez Applications dans la rangée du haut, puis sélectionnez Afficher les configurations d'application.
  15. Sélectionnez +Application en haut à droite de l'écran.
  16. Sous Type de configuration, sélectionnez Par ID du client.
  17. Collez l'ID du client copié précédemment. Veuillez le noter, car vous en aurez encore besoin.
  18. Cliquez sur Soumettre pour créer l'application.
  19. Sélectionnez l'icône d'engrenage située à côté de l'application nouvellement créée.
  20. Dans le menu déroulant, sélectionnez ID de déploiement et copiez l'ID. Il sera nécessaire à l'étape 24 de cette section.
  21. Ensuite, connectez-vous à votre compte Panorama.
  22. Cliquez sur Configurations dans le menu de gauche, puis sélectionnez Paramètres d'intégration.
  23. Dans le menu déroulant Sélectionner l'intégration, sélectionnez LTI 1.3.
  24. Saisissez les informations requises selon votre environnement Panorama (type de compte) :
    1. Environnement de production : 
      1. ID du client : L'ID du client copié à l'étape 12.
      2. ID de déploiement : L'ID de déploiement copié à l'étape 20.
      3. ISS : https://canvas.instructure.com
      4. Point de terminaison OIDC : https://canvas.instructure.com/api/lti/authorize_redirect
      5. Point de terminaison JWKS : https://canvas.instructure.com/api/lti/security/jwks
         
    2. Environnement de test :
      1. ID du client : L'ID du client copié à l'étape 12.
      2. ID de déploiement : L'ID de déploiement copié à l'étape 20.
      3. ISS : https://canvas.test.instructure.com
      4. Point de terminaison OIDC : https://canvas.test.instructure.com/api/lti/authorize_redirect
      5. Point de terminaison JWKS : https://canvas.test.instructure.com/api/lti/security/jwks
         
    3. Environnement bêta :
      1. ID du client : L'ID du client copié à l'étape 12.
      2. ID de déploiement : L'ID de déploiement copié à l'étape 20.
      3. ISS : https://canvas.beta.instructure.com
      4. Point de terminaison OIDC : https://canvas.beta.instructure.com/api/lti/authorize_redirect
      5. Point de terminaison JWKS : https://canvas.beta.instructure.com/api/lti/security/jwks
  25. Cliquez sur Enregistrer les changements pour ajouter Panorama à votre instance Canvas, puis passez à la section suivante de ce guide.

     
     

Génération d'une clé et d'un secret client

  1. Cliquez sur + Clé de développeur > Clé API.
    1.png

  2. Saisissez les informations suivantes :

    • Nom de la clé : Panorama API Integration
    • URL de redirection : https://<zoneURL>/canvas-auth
      • Zone États-Unis : https://panorama-api.yuja.com/canvas-auth
      • Zone Canada : https://panorama-api-cz.yuja.com/canvas-auth
      • Zone UE : https://panorama-api-ez.yuja.com/canvas-auth
      • Zone Australie : https://panorama-api-az.yuja.com/canvas-auth

    2.png

  3. (Facultatif) Activez Imposer les portées.
    Remarque : Nous déconseillons d'imposer les portées. Vous devrez alors réintégrer Panorama avec l'API de Canvas chaque fois que Panorama ajoutera une fonctionnalité qui utilise l'API. Si vous ne souhaitez pas procéder ainsi, assurez-vous que Imposer les portées est désactivé, puis passez à l'étape 5.
  4. Cochez Autoriser les paramètres d'inclusion et cochez ensuite les paramètres suivants :
    3.png
    • Comptes
      • url:GET|/api/v1/accounts
      • url:GET|/api/v1/accounts/:id
      • url:GET|/api/v1/accounts/:account_id/courses
      • url:GET|/api/v1/accounts/:account_id/sub_accounts
    • Administrateurs
      • url:GET|/api/v1/accounts/:account_id/admins
    • Devoirs
      • url:GET|/api/v1/courses/:course_id/assignments
      • url:GET|/api/v1/courses/:course_id/assignments/:id
      • url:PUT|/api/v1/courses/:course_id/assignments/:id
    • Cours
      • url:GET|/api/v1/courses
      • url:GET|/api/v1/courses/:id
      • url:GET|/api/v1/courses/:course_id/users
      • url:GET|/api/v1/courses/:course_id/users/:id
      • url:PUT|/api/v1/courses/:id
      • url:POST|/api/v1/courses/:course_id/files
    • Sujets de discussion
      • url:GET|/api/v1/courses/:course_id/discussion_topics
      • url:GET|/api/v1/courses/:course_id/discussion_topics/:topic_id
      • url:PUT|/api/v1/courses/:course_id/discussion_topics/:topic_id
      • url:PUT|/api/v1/courses/:course_id/discussion_topics/:topic_id/entries/:id
    • Inscriptions
      • url:GET|/api/v1/users/:user_id/enrollments
      • url:GET|/api/v1/courses/:course_id/enrollments
    • Périodes d'inscription
      • url:GET|/api/v1/accounts/:account_id/terms
      • url:GET|/api/v1/accounts/:account_id/terms/:id
    • Fichiers
      • url:GET|/api/v1/courses/:course_id/files
      • url:GET|/api/v1/files/:id
      • url:POST|/api/v1/files/:id
      • url:PUT|/api/v1/files/:id
    • Pages
      • url:GET|/api/v1/courses/:course_id/pages
      • url:GET|/api/v1/courses/:course_id/pages/:url_or_id
      • url:PUT|/api/v1/courses/:course_id/pages/:url_or_id
      • url:POST|/api/v1/courses/:course_id/pages
    • Quiz
      • url:GET|/api/v1/courses/:course_id/quizzes
      • url:GET|/api/v1/courses/:course_id/quizzes/:id
      • url:GET|/api/quiz/v1/courses/:course_id/quizzes/:assignment_id
      • url:GET|/api/quiz/v1/courses/:course_id/quizzes
      • url:PUT|/api/v1/courses/:course_id/quizzes/:id
      • url:PATCH|/api/quiz/v1/courses/:course_id/quizzes/:assignment_id
    • Rôles
      • url:GET|/api/v1/accounts/:account_id/roles
      • url:GET|/api/v1/accounts/:account_id/roles/:id
    • Grilles d'évaluation
      • url:GET|/api/v1/courses/:course_id/rubrics
      • url:GET|/api/v1/courses/:course_id/rubrics/:id
    • Liens de ressources LTI
      • url:GET|/api/v1/courses/:course_id/lti_resource_links
      • url:GET|/api/v1/courses/:course_id/lti_resource_links/:id
  5. Cliquez sur Enregistrer.
    4.png
  6. Repérez la clé de développeur Panorama API Integration que vous venez de créer et copiez l'ID du client sous Détails.
  7. Cliquez sur Afficher la clé et copiez le Secret du client.
  8. Connectez-vous à Panorama, puis, dans le menu de gauche, cliquez sur Configuration > Paramètres d'intégration.
    7.png
  9. Dans le menu déroulant Sélectionner l'intégration, sélectionnez API LMS.
  10. Cliquez sur Ajouter une clé d'accès.
    9.png
  11. Pour la méthode d'authentification Canvas, choisissez ID du client.
  12. Dans le champ ID du client, saisissez l'ID de l'étape 8.
  13. Dans le champ Secret du client, saisissez le secret du client de l'étape 9.
  14. Si vous avez imposé les portées, activez Utiliser des portées imposées. Sinon, ignorez cette étape.
  15. Cliquez sur S'authentifier avec Canvas.
    Remarque : Veuillez vous assurer d'être connecté à Canvas en tant qu'administrateur disposant de tous les privilèges.
  16. Cliquez sur Autoriser.
    13.png
  17. Copiez la réponse d'authentification et retournez dans Panorama. Collez la réponse dans le champ Réponse d'authentification Canvas.
  18. Cliquez sur Ajouter une clé d'accès.
  19. Cliquez sur Enregistrer les changements pour terminer la configuration.
    15.png

Installation du LMS Visualizer

L'installation du LMS Visualizer permettra l'affichage des icônes de Panorama dans les cours. Cette étape exige que la fonctionnalité Remplacements CSS/JavaScript personnalisés soit activée dans votre instance Canvas. Si elle ne l'est pas, veuillez communiquer avec votre gestionnaire de compte Canvas.

  1. Connectez-vous à Panorama.
  2. Cliquez sur Configurations dans le menu de gauche, puis sélectionnez Paramètres d'intégration.
  3. Dans le menu déroulant Sélectionner l'intégration, choisissez LMS Visualizer et cliquez sur Télécharger le Visualizer.
  4. Ensuite, connectez-vous à Canvas en tant qu'administrateur. Dans la barre latérale de gauche, cliquez sur Admin et sélectionnez le compte auquel appliquer le YuJa Panorama - LMS Viewer.
  5. Sélectionnez Paramètres dans la barre de navigation de gauche et assurez-vous que l'onglet des paramètres est sélectionné dans la rangée du haut.  
  6. Ensuite, cliquez sur Thèmes dans la barre de navigation de gauche, puis cliquez sur le bouton + Thème. Sélectionnez n'importe quel modèle de thème dans le menu déroulant.

  7. Dans l'éditeur de thème, accédez à l'onglet Téléverser et sélectionnez le fichier Visualizer qui a été téléchargé.

    Remarque : L'onglet Téléverser n'est disponible qu'une fois que votre gestionnaire de compte Canvas l'a activé.

  8. Ensuite, cliquez sur Prévisualiser vos modifications, puis choisissez Appliquer le thème. Lorsqu'on vous demande de nommer votre thème, saisissez Panorama Theme.

Articles associés

Contacter le support