Aller sur YuJa
  1. Centre d'aide YuJa
  2. Plateforme de surveillance d'examens Verity
  3. Intégrations

Intégration de la plateforme de surveillance d'examens YuJa Verity dans Canvas

Avatar
YuJa
  • Mise à jour

Ce document fournit aux administrateurs les instructions pour intégrer la plateforme de surveillance d'examens Verity à Canvas à l'aide de LTI 1.3. Avant de passer aux étapes ci-dessous, assurez-vous de disposer d'un accès complet à votre instance Canvas en tant qu'administrateur. Si vous avez des questions sur le processus, veuillez communiquer avec votre gestionnaire de compte attitré.

Remarque : Il est fortement recommandé de créer un compte de service distinct dans Canvas 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 la confusion ou les modifications involontaires.

Ajout de Verity à Canvas

En tant qu'administrateur, vous pouvez intégrer Verity à Canvas en ajoutant une URL JSON aux clés de développeur.

  1. Connectez-vous à Canvas en tant qu'administrateur. Dans la barre latérale gauche, cliquez sur Administrateur, puis sélectionnez le compte Canvas de votre établissement.
  2. Dans la barre latérale, sélectionnez Administrateur > Clés de développeur.
  3. Cliquez sur + Clé de développeur > + Clé LTI.
  4. Sur la page Paramètres de clé, saisissez un nom pour votre clé (p. ex. YuJa Verity).
  5. Dans le menu déroulant Méthode, sélectionnez Entrer l'URL.

  6. Dans le champ URL JSON, saisissez l'une des URL suivantes selon votre emplacement :

    Zone États-Unis : https://zone1.verity.yuja.com/api/verity/lti/config/canvas.json

    Zone Australie : https://az.verity.yuja.com/api/verity/lti/config/canvas.json

  7. Cliquez sur Enregistrer.
  8. Sur la page Clés de développeur, repérez la clé Verity que vous avez ajoutée.
  9. Assurez-vous que le commutateur du champ État est réglé sur Activé. Si la fenêtre contextuelle Activer la clé de développeur s'affiche, cliquez sur Passer à Activé.
  10. Cliquez sur Afficher dans les applications Canvas. Une nouvelle fenêtre Canvas s'ouvrira.
    toggle and view in canva app.png

  11. Cliquez sur Déverrouiller l'application.

  12. Dans la fenêtre contextuelle, cliquez sur Déverrouiller.

  13. Ensuite, cliquez sur l'icône Modifier la disponibilité (crayon).
  14. Remplacez le statut par Disponible, puis cliquez sur Enregistrer. Passez à la section Génération d'un secret de clé API pour terminer l'intégration.

Génération d'un secret de clé API

  1. Cliquez sur + Clé de développeur > Clé API.
    API key.png
  2. Saisissez les informations suivantes :
    • Nom de la clé : Verity API Integration
    • URL de redirection : https://<zoneURL>/api/verity/oauth/callback
      • Zone États-Unis : https://zone1.verity.yuja.com/api/verity/oauth/callback
      • Zone Australie : https://az.verity.yuja.com/api/verity/oauth/callback

  3. (Facultatif) Activez Appliquer les portées.
    Remarque : Nous ne recommandons pas d'appliquer les portées. Vous devrez réintégrer Verity à l'API de Canvas chaque fois que Verity ajoutera une nouvelle fonctionnalité qui utilise l'API. De plus, si les portées sont activées, l'application mobile Verity Lockdown ne sera pas prise en charge. Si votre établissement utilise l'application mobile Verity Lockdown, les portées doivent obligatoirement être désactivées.

    Si vous ne souhaitez pas procéder ainsi, assurez-vous que l'option Appliquer les portées est désactivée, puis passez à l'étape 5.

  4. Cochez Autoriser les paramètres d'inclusion, puis cochez les paramètres suivants :
    • Comptes :
      • url:GET|/api/v1/accounts
      • url:GET|/api/v1/accounts/:id
      • url:GET|/api/v1/manageable_accounts
      • url:GET|/api/v1/course_creation_accounts
      • url:GET|/api/v1/course_accounts
      • url:GET|/api/v1/accounts/:account_id/sub_accounts
      • url:GET|/api/v1/accounts/:account_id/permissions
      • url:GET|/api/v1/accounts/:account_id/courses
    • Travaux :
      • url:GET|/api/v1/courses/:course_id/assignments
      • url:GET|/api/v1/courses/:course_id/assignments/:id
      • url:POST|/api/v1/courses/:course_id/assignments
      • 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/accounts/:account_id/courses/:id
      • url:GET|/api/v1/users/:user_id/courses
      • url:GET|/api/v1/courses/:course_id/users
      • url:GET|/api/v1/courses/:course_id/users/:id
    • Outils externes :
      • url:GET|/api/v1/courses/:course_id/external_tools/:external_tool_id
      • url:GET|/api/v1/courses/:course_id/external_tools
      • url:GET|/api/v1/courses/:course_id/external_tools/sessionless_launch
      • url:GET|/api/v1/accounts/:account_id/external_tools/sessionless_launch
    • Éléments de nouveaux quiz :
      • url:GET|/api/quiz/v1/courses/:course_id/quizzes/:assignment_id/items/:item_id
      • url:GET|/api/quiz/v1/courses/:course_id/quizzes/:assignment_id/items
      • url:POST|/api/quiz/v1/courses/:course_id/quizzes/:assignment_id/items
      • url:PATCH|/api/quiz/v1/courses/:course_id/quizzes/:assignment_id/items/:item_id
    • Quiz :
      • url:GET|/api/v1/courses/:course_id/quizzes
      • url:GET|/api/v1/courses/:course_id/quizzes/:id
      • url:POST|/api/v1/courses/:course_id/quizzes
      • url:PUT|/api/v1/courses/:course_id/quizzes/:id
      • url:GET|/api/v1/courses/:course_id/quizzes/:quiz_id/questions
      • url:GET|/api/v1/courses/:course_id/quizzes/:quiz_id/questions/:id
      • url:POST|/api/v1/courses/:course_id/quizzes/:quiz_id/questions
      • url:PUT|/api/v1/courses/:course_id/quizzes/:quiz_id/questions/:id
      • url:POST|/api/v1/courses/:course_id/quizzes/:id/validate_access_code
      • url:GET|/api/quiz/v1/courses/:course_id/quizzes/:assignment_id
      • url:GET|/api/quiz/v1/courses/:course_id/quizzes
      • url:POST|/api/quiz/v1/courses/:course_id/quizzes
      • url:PATCH|/api/quiz/v1/courses/:course_id/quizzes/:assignment_id
    • Questions de quiz :
      • url:GET|/api/v1/courses/:course_id/quizzes/:quiz_id/questions
      • url:GET|/api/v1/courses/:course_id/quizzes/:quiz_id/questions/:id
      • url:POST|/api/v1/courses/:course_id/quizzes/:quiz_id/questions
      • url:PUT|/api/v1/courses/:course_id/quizzes/:quiz_id/questions/:id
    • Utilisateurs :
      • url:GET|/api/v1/users/:id
      • url:GET|/api/v1/accounts/:account_id/users

  5. Cliquez sur Enregistrer dans le coin inférieur droit.

  6. Copiez le secret de la clé API qui s'affiche dans la fenêtre contextuelle Clé de développeur créée, puis cliquez sur Fermer.

  7. Assurez-vous que le commutateur État de la clé API nouvellement ajoutée est activé.

  8. Communiquez votre secret de clé API à votre gestionnaire de compte afin de finaliser les configurations LMS pour Verity.

Test de l'accès à l'API de YuJa Verity

Une fois que votre gestionnaire de compte a terminé l'intégration, vous pouvez tester l'API REST pour vous assurer que les enseignants peuvent supprimer des quiz Verity et créer des quiz d'entraînement Verity dans Canvas.

  1. Dans Canvas, cliquez sur le lien YuJa Verity dans la barre latérale pour ouvrir le portail Verity.
  2. Dans Verity, sélectionnez Paramètres > Paramètres d'intégration dans la barre de navigation latérale.
  3. Sélectionnez API LMS dans le menu déroulant Sélectionner l'intégration.
  4. Dans la section Clés d'accès, cliquez sur Tester l'accès de l'établissement pour vérifier que votre compte Canvas est intégré à l'API.
    Les champs Sélectionner l'intégration et Clés d'accès sont mis en évidence.
  5. Confirmez que l'accès à l'API est réussi à la fois pour Lire les comptes et pour Lire les cours.
    Remarque : Si l'accès à l'API échoue, veuillez communiquer avec votre gestionnaire de compte afin de mettre à jour la clé API de votre établissement.
  6. Cliquez sur Fermer.
    La fenêtre contextuelle Tester l'accès à l'API.

Ajout de LMS Visualizer à Canvas

En tant qu'administrateur, vous pouvez ajouter du code JavaScript dans l'éditeur de thèmes pour surveiller l'extension de navigateur Verity. Lorsque le code JavaScript est activé, les candidats sont invités à télécharger l'extension de navigateur Verity avant d'accéder à l'évaluation. Ils ne pourront pas accéder à l'évaluation tant que l'extension de navigateur n'est pas installée.

  1. Dans Canvas, cliquez sur le lien YuJa Verity dans la barre latérale pour ouvrir le portail Verity.
  2. Dans Verity, sélectionnez Paramètres > Paramètres d'intégration dans la barre de navigation latérale.
  3. Sélectionnez LMS Visualizer dans le menu déroulant Sélectionner l'intégration.
  4. Cliquez sur Afficher le visualiseur.
    L'option LMS Visualizer est sélectionnée.
  5. Copiez le code JavaScript qui s'affiche dans le nouvel onglet.
  6. Dans Canvas, sélectionnez Thèmes dans la barre de navigation latérale.
  7. Passez le curseur sur votre thème, puis cliquez sur Ouvrir dans l'éditeur de thèmes.
    La section Thèmes est sélectionnée dans la barre de navigation latérale de Canvas.
  8. Dans le panneau de gauche, cliquez sur l'onglet Téléverser.
  9. Repérez le champ Fichier JavaScript, puis cliquez sur Afficher le fichier pour ouvrir la page du code JavaScript.
    Le bouton Afficher le fichier est mis en évidence.
  10. Faites un clic droit sur la page du code JavaScript et sélectionnez Enregistrer sous pour enregistrer le fichier sur votre appareil.
    Enregistrement du code JavaScript dans un nouveau fichier.
  11. Ouvrez votre fichier dans un éditeur de texte (p. ex. le Bloc-notes) et collez à la fin le code JavaScript copié à l'étape 5.
    Ajout du code JavaScript copié au fichier.
  12. Enregistrez votre fichier dans votre éditeur de texte.
  13. Dans l'éditeur de thèmes, repérez le champ Fichier JavaScript et cliquez sur Sélectionner pour téléverser votre fichier.
    Le bouton Sélectionner est mis en évidence dans le champ Fichier JavaScript.
  14. Repérez le champ Fichier JavaScript de l'application mobile, puis cliquez sur Afficher le fichier pour ouvrir la page du code JavaScript.
    Le bouton Afficher le fichier est mis en évidence dans le champ Fichier JavaScript de l'application mobile.
  15. Faites un clic droit sur la page du code JavaScript et sélectionnez Enregistrer sous pour enregistrer le fichier sur votre appareil.
    Enregistrement du code JavaScript dans un nouveau fichier.
  16. Ouvrez votre fichier dans un éditeur de texte (p. ex. le Bloc-notes) et collez à la fin le code JavaScript copié à l'étape 5.
    Ajout du code JavaScript copié au fichier.
  17. Enregistrez votre fichier dans votre éditeur de texte.
  18. Dans l'éditeur de thèmes, repérez le champ Fichier JavaScript de l'application mobile et cliquez sur Sélectionner pour téléverser votre fichier.
    Le bouton Sélectionner est mis en évidence dans le champ Fichier JavaScript de l'application mobile.
  19. Cliquez sur Prévisualiser vos modifications.
    Le bouton Prévisualiser vos modifications est mis en évidence.
  20. Cliquez sur Enregistrer le thème.
    Le bouton Enregistrer le thème est mis en évidence.
  21. Cliquez sur Appliquer le thème pour ajouter le nouveau paramètre de thème.

Articles associés

Contacter le support