Naar YuJa
  1. YuJa Helpcentrum
  2. Platform voor examensurveillance Verity
  3. Integraties

Het platform voor examensurveillance YuJa Verity integreren in Canvas

Avatar
YuJa
  • Bijgewerkt

Dit document bevat instructies voor beheerders om het platform voor examensurveillance Verity met LTI 1.3 in Canvas te integreren. Controleer voordat u de onderstaande stappen uitvoert of u als beheerder volledige toegang hebt tot uw Canvas-instance. Neem bij vragen over het proces contact op met uw vaste Account Manager.

Opmerking: Het wordt sterk aanbevolen om voor de integratie een apart serviceaccount in Canvas aan te maken. Zo kunt u gemakkelijker zien welke acties door de integratie zijn uitgevoerd en welke door een menselijke beheerder, wat verwarring of onbedoelde wijzigingen helpt voorkomen.

 

Verity toevoegen aan Canvas

Als beheerder kunt u Verity met Canvas integreren door een JSON-URL toe te voegen aan de ontwikkelaarssleutels.

  1. Meld u als beheerder aan bij Canvas. Klik in de linkerzijbalk op Beheerder en selecteer het Canvas-account van uw instelling.
  2. Selecteer in de zijbalk Beheerder > Ontwikkelaarssleutels.
  3. Klik op + Ontwikkelaarssleutel > + LTI-sleutel.
  4. Voer op de pagina Sleutelinstellingen een naam voor uw sleutel in (bijvoorbeeld YuJa Verity).
  5. Selecteer in het vervolgkeuzemenu Methode Voer URL in.

  6. Voer in het veld JSON-URL een van de volgende URL's in, afhankelijk van uw locatie: 

    VS-zone: https://zone1.verity.yuja.com/api/verity/lti/config/canvas.json 

    AUS-zone: https://az.verity.yuja.com/api/verity/lti/config/canvas.json 

  7. Klik op Opslaan.
  8. Zoek op de pagina Ontwikkelaarssleutels de Verity-sleutel die u hebt toegevoegd.
  9. Zorg ervoor dat de schakelaar voor het veld Status op Aan staat. Als de pop-up Ontwikkelaarssleutel inschakelen verschijnt, klikt u op Overschakelen naar aan. 
  10. Klik op Weergeven in Canvas-apps. Er wordt een nieuw Canvas-venster geopend.
    toggle and view in canva app.png

  11. Klik op App ontgrendelen.

  12. Klik in de pop-up op Ontgrendelen.

  13. Klik vervolgens op het pictogram Beschikbaarheid wijzigen (potlood). 
  14. Wijzig de status in Beschikbaar, en klik vervolgens op Opslaan. Ga verder naar Het API-sleutelgeheim genereren om de integratie te voltooien.

Het API-sleutelgeheim genereren

  1. Klik op + Ontwikkelaarssleutel > API-sleutel.
    API key.png
  2. Voer de volgende gegevens in:
    • Sleutelnaam: Verity API Integration
    • Omleidings-URL's: https://<zoneURL>/api/verity/oauth/callback
      • VS-zone: https://zone1.verity.yuja.com/api/verity/oauth/callback
      • AUS-zone: https://az.verity.yuja.com/api/verity/oauth/callback

  3. (Optioneel) Schakel Bereiken afdwingen in.
    Opmerking: We raden af om bereiken af te dwingen. Hierdoor moet u Verity opnieuw met de Canvas API integreren telkens wanneer Verity nieuwe functionaliteit toevoegt die gebruikmaakt van de API. Bovendien wordt de mobiele Lockdown-app van Verity niet ondersteund als bereiken zijn ingeschakeld. Als uw instelling de mobiele Lockdown-app van Verity gebruikt, moeten bereiken zijn uitgeschakeld. 

    Als u dit niet wilt doen, zorg er dan voor dat Bereiken afdwingen is uitgeschakeld en ga vervolgens verder met stap 5. 

  4. Vink Include-parameters toestaan aan en vink vervolgens de volgende parameters aan:
    • Accounts: 
      • 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
    • Opdrachten: 
      • 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
    • Cursussen: 
      • 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
    • Externe tools: 
      • 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
    • Items van nieuwe quizzen: 
      • 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
    • Quizzen: 
      • 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
    • Quizvragen: 
      • 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
    • Gebruikers: 
      • url:GET|/api/v1/users/:id
      • url:GET|/api/v1/accounts/:account_id/users

  5. Klik op Opslaan rechtsonder.

  6. Kopieer het API-sleutelgeheim dat verschijnt in de pop-up Ontwikkelaarssleutel aangemaakt en klik vervolgens op Sluiten.

  7. Controleer of de schakelaar Status voor de nieuw toegevoegde API-sleutel is ingeschakeld.

  8. Neem contact op met uw Account Manager en geef uw API-sleutelgeheim door om de LMS-configuraties voor Verity af te ronden.

De API-toegang van YuJa Verity testen

Zodra uw Account Manager de integratie heeft voltooid, kunt u de REST API testen om te controleren of docenten Verity-quizzen kunnen verwijderen en Verity-oefenquizzen kunnen maken in Canvas.

  1. Klik in Canvas in de zijbalk op de link YuJa Verity om de Verity-portal te openen.
  2. Selecteer in Verity in de zijbalk Instellingen > Integratie-instellingen.
  3. Selecteer LMS API in het vervolgkeuzemenu Selecteer integratie.
  4. Klik in de sectie Toegangssleutels op Toegang tot instelling testen om te controleren of uw Canvas-account met de API is geïntegreerd.
    De velden Selecteer integratie en Toegangssleutels zijn gemarkeerd.
  5. Controleer of uw API-toegang is geslaagd voor zowel Accounts lezen als Cursussen lezen.
    Opmerking: Als uw API-toegang mislukt, neem dan contact op met uw Account Manager om de API-sleutel voor uw instelling bij te werken.
  6. Klik op Sluiten.
    Het pop-upvenster voor het testen van API-toegang.

De LMS Visualizer toevoegen aan Canvas

Als beheerder kunt u JavaScript-code toevoegen in de Thema-editor om de Verity-browserextensie te bewaken. Als de JavaScript-code is ingeschakeld, worden studenten die de toets maken eerst geleid naar het downloaden van de Verity-browserextensie voordat ze toegang krijgen tot de toets. Zij hebben geen toegang tot de toets zolang de browserextensie niet is geïnstalleerd.  

  1. Klik in Canvas in de zijbalk op de link YuJa Verity om de Verity-portal te openen.
  2. Selecteer in Verity in de zijbalk Instellingen > Integratie-instellingen.
  3. Selecteer LMS Visualizer in het vervolgkeuzemenu Selecteer integratie.
  4. Klik op Visualisatie bekijken.
    De LMS Visualizer is geselecteerd.
  5. Kopieer de JavaScript-code die in het nieuwe tabblad verschijnt. 
  6. Selecteer in Canvas Thema's in de zijbalk.
  7. Beweeg de muisaanwijzer over uw thema en klik op Openen in Thema-editor.
    Het onderdeel Thema's is geselecteerd in de zijbalk in Canvas.
  8. Klik in het linkerpaneel op het tabblad Uploaden .
  9. Zoek het veld JavaScript-bestand op, en klik vervolgens op Bestand weergeven om de pagina met de JavaScript-code te openen.
    De knop Bestand weergeven is gemarkeerd.
  10. Klik met de rechtermuisknop op de pagina met de JavaScript-code en selecteer Opslaan als om het bestand op uw apparaat op te slaan. 
    De JavaScript-code als nieuw bestand opslaan.
  11. Open uw bestand in een teksteditor (bijvoorbeeld Kladblok) en plak de JavaScript-code die u in stap 5 hebt gekopieerd aan het einde. 
    De gekopieerde JavaScript-code aan het bestand toevoegen.
  12. Sla uw bestand op in uw teksteditor. 
  13. Zoek in uw Thema-editor het veld JavaScript-bestand en klik op Selecteer om uw bestand te uploaden. 
    De knop Selecteer is gemarkeerd in het veld JavaScript-bestand.
  14. Zoek het veld JavaScript-bestand voor mobiele app op, en klik vervolgens op Bestand weergeven om de pagina met de JavaScript-code te openen.
    De knop Bestand weergeven is gemarkeerd in het veld JavaScript-bestand voor mobiele app.
  15. Klik met de rechtermuisknop op de pagina met de JavaScript-code en selecteer Opslaan als om het bestand op uw apparaat op te slaan. 
    De JavaScript-code als nieuw bestand opslaan.
  16. Open uw bestand in een teksteditor (bijvoorbeeld Kladblok) en plak de JavaScript-code die u in stap 5 hebt gekopieerd aan het einde. 
    De gekopieerde JavaScript-code aan het bestand toevoegen.
  17. Sla uw bestand op in uw teksteditor. 
  18. Zoek in uw Thema-editor het veld JavaScript-bestand voor mobiele app en klik op Selecteer om uw bestand te uploaden.
    De knop Selecteer is gemarkeerd in het veld JavaScript-bestand voor mobiele app.
  19. Klik op Voorbeeld van uw wijzigingen bekijken.
    De knop Voorbeeld van uw wijzigingen bekijken is gemarkeerd.
  20. Klik op Thema opslaan.
    De knop Thema opslaan is gemarkeerd.
  21. Klik op Thema toepassen om de nieuwe thema-instelling toe te voegen.

Verwante artikelen

Neem contact op met support