Naar YuJa
  1. YuJa Helpcentrum
  2. LMS-toegankelijkheidsplatform Panorama
  3. Canvas-integratie
  4. Beheerders

Panorama integreren in Canvas met LTI 1.3

Avatar
YuJa
  • Bijgewerkt

Dit document biedt beheerders instructies voor het integreren van het LMS-toegankelijkheidsplatform Panorama in Canvas met LTI 1.3. Controleer voordat u verdergaat met de onderstaande stappen of u als beheerder volledige toegang hebt tot uw Canvas-instantie. Neem bij vragen over het proces contact op met uw eigen accountmanager.
 

Opmerking: Het wordt sterk aanbevolen om in Canvas een apart serviceaccount voor de integratie 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.

 

Uw JSON-string voor Panorama ophalen

Voordat u Panorama aan uw Canvas-instantie toevoegt, moet u uw JSON-string ophalen. Om toegang te krijgen tot uw JSON-string moet u een e-mail van uw accountmanager hebben ontvangen met het verzoek om u aan te melden voor uw Panorama-account. Meld u aan voor uw account en ga daarna verder met de onderstaande stappen. 

  1. Log in bij uw Panorama-account.
  2. Klik in het linkermenu op Configuraties en selecteer daarna Integratie-instellingen.
  3. Selecteer LTI 1.3.
  4. Klik op LTI 1.3-JSON downloaden om uw JSON-string voor Panorama op te halen. 

Panorama toevoegen aan Canvas

Zodra u uw JSON-string hebt opgehaald, kunt u Panorama toevoegen aan uw Canvas-instantie. 

  1. Log in bij Canvas als beheerder. 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. Selecteer in het vervolgkeuzemenu Methode de optie JSON plakken.
  5. Open het JSON-bestand dat u in de vorige sectie hebt gedownload in een willekeurige teksteditor, zoals Kladblok, en kopieer de inhoud. De Omleidings-URL's worden automatisch toegevoegd.
  6. Plak vervolgens de gekopieerde inhoud in het veld LTI 1.3-configuratie.

  7. Geef een Sleutelnaam naar keuze op en klik op Opslaan.

    Opmerking: Als u wilt dat de LTI-tool standaard is uitgeschakeld in de cursusnavigatiebalk, voegt u de volgende parameter toe in het gedeelte voor de cursusnavigatie - "default": "disabled".

    De parameter om de LTI-link van Panorama in te stellen is in de code ingevoegd.

  8. Schakel de schakelaar Status van de ontwikkelaarssleutel in.
  9. Klik op Weergeven in Canvas-apps. Er wordt een nieuw Canvas-venster geopend.
  10. Klik op het potloodpictogram.
  11. Wijzig de status in Beschikbaar en klik daarna op Opslaan.
  12. Kopieer de Client-ID.
  13. Selecteer vervolgens Instellingen in de navigatiebalk.
      
  14. Selecteer Apps in de bovenste rij en selecteer daarna App-configuraties bekijken.
  15. Selecteer +App rechtsboven in het scherm.
  16. Selecteer onder Configuratietype, de optie Op client-ID.
  17. Plak de Client-ID die u eerder hebt gekopieerd. Bewaar de ID goed, want u hebt die later nog nodig.
  18. Klik op Indienen om de app te maken.
  19. Selecteer het pictogram Tandwiel naast de nieuw gemaakte app.
  20. Selecteer in het vervolgkeuzemenu Implementatie-ID en kopieer de ID. Deze hebt u nodig in stap 24 van deze sectie.
  21. Log vervolgens in bij uw Panorama-account.
  22. Klik in het linkermenu op Configuraties en selecteer daarna Integratie-instellingen.
  23. Selecteer in het vervolgkeuzemenu Selecteer integratie de optie LTI 1.3.
  24. Voer de vereiste gegevens in op basis van uw Panorama-omgeving (accounttype): 
    1. Productieomgeving: 
      1. Client-ID: De Client-ID die in stap 12 is gekopieerd. 
      2. Implementatie-ID: De implementatie-ID die in stap 20 is gekopieerd. 
      3. ISS: https://canvas.instructure.com
      4. OIDC-eindpunt: https://canvas.instructure.com/api/lti/authorize_redirect
      5. JWKS-eindpunt: https://canvas.instructure.com/api/lti/security/jwks
         
    2. Testomgeving:
      1. Client-ID: De Client-ID die in stap 12 is gekopieerd. 
      2. Implementatie-ID: De implementatie-ID die in stap 20 is gekopieerd. 
      3. ISS: https://canvas.test.instructure.com
      4. OIDC-eindpunt: https://canvas.test.instructure.com/api/lti/authorize_redirect
      5. JWKS-eindpunt: https://canvas.test.instructure.com/api/lti/security/jwks
         
    3. Bèta-omgeving:
      1. Client-ID: De Client-ID die in stap 12 is gekopieerd. 
      2. Implementatie-ID: De implementatie-ID die in stap 20 is gekopieerd. 
      3. ISS: https://canvas.beta.instructure.com
      4. OIDC-eindpunt: https://canvas.beta.instructure.com/api/lti/authorize_redirect
      5. JWKS-eindpunt: https://canvas.beta.instructure.com/api/lti/security/jwks
  25. Klik op Wijzigingen opslaan om Panorama toe te voegen aan uw Canvas-instantie en ga daarna verder met de volgende sectie van deze handleiding.

     
     

Een clientsleutel en client secret genereren

  1. Klik op + Ontwikkelaarssleutel > API-sleutel.
    1.png

  2. Voer de volgende gegevens in:

    • Sleutelnaam: Panorama API Integration
    • Omleidings-URL's: https://<zoneURL>/canvas-auth
      • VS-zone: https://panorama-api.yuja.com/canvas-auth
      • Canadese zone: https://panorama-api-cz.yuja.com/canvas-auth
      • EU-zone: https://panorama-api-ez.yuja.com/canvas-auth
      • Australische zone: https://panorama-api-az.yuja.com/canvas-auth

    2.png

  3. (Optioneel) Schakel Scopes afdwingen in.
    Opmerking: Wij raden af om scopes af te dwingen. U moet Panorama dan opnieuw integreren met de Canvas-API telkens wanneer Panorama nieuwe functionaliteit toevoegt die gebruikmaakt van de API. Als u dit niet wilt, zorg er dan voor dat Scopes afdwingen is uitgeschakeld en ga daarna verder met stap 5. 
  4. Vink Include-parameters toestaan aan en vink daarna de volgende parameters aan:
    3.png
    • Accounts
      • 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
    • Admins
      • url:GET|/api/v1/accounts/:account_id/admins
    • Assignments
      • 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
    • Courses
      • 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
    • Discussion Topics
      • 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
    • Enrollments
      • url:GET|/api/v1/users/:user_id/enrollments
      • url:GET|/api/v1/courses/:course_id/enrollments 
    • Enrollment Terms
      • url:GET|/api/v1/accounts/:account_id/terms
      • url:GET|/api/v1/accounts/:account_id/terms/:id
    • Files
      • 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
    • Quizzes
      • 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
    •  Roles
      • url:GET|/api/v1/accounts/:account_id/roles
      • url:GET|/api/v1/accounts/:account_id/roles/:id
    • Rubrics
      • url:GET|/api/v1/courses/:course_id/rubrics
      • url:GET|/api/v1/courses/:course_id/rubrics/:id
    • LTI Resource Links
      • url:GET|/api/v1/courses/:course_id/lti_resource_links
      • url:GET|/api/v1/courses/:course_id/lti_resource_links/:id
  5. Klik op Opslaan.
    4.png
  6. Zoek de zojuist gemaakte ontwikkelaarssleutel Panorama API Integration en kopieer de Client-ID onder Details.
  7. Klik op Sleutel weergeven en kopieer het Client secret.
  8. Log in bij Panorama en klik daarna in het linkermenu op Configuratie > Integratie-instellingen.
    7.png
  9. Selecteer in het vervolgkeuzemenu Selecteer integratie de optie LMS API.
  10. Klik op Toegangssleutel toevoegen.
    9.png
  11. Kies bij de Canvas-authenticatiemethode Client-ID.
  12. Voer in het veld Client-ID de ID uit stap 8 in.
  13. Voer in het veld Client secret het client secret uit stap 9 in.
  14. Als u afgedwongen scopes hebt gebruikt, schakelt u Gebruik afgedwongen toegangsrechten in. Sla deze stap anders over.
  15. Klik op Authenticeer met Canvas.
    Opmerking: Zorg ervoor dat u bent ingelogd bij Canvas als beheerder met volledige rechten.
  16. Klik op Autoriseren.
    13.png
  17. Kopieer de authenticatierespons en ga terug naar Panorama. Plak de respons in het veld Canvas authenticatie respons.
  18. Klik op Toegangssleutel toevoegen.
  19. Klik op Wijzigingen opslaan om de installatie te voltooien.
    15.png

De LMS Visualizer installeren 

Als u de LMS Visualizer installeert, verschijnen de pictogrammen van Panorama in cursussen. Voor deze stap moet in uw Canvas-instantie de functie voor aangepaste CSS/JavaScript-overschrijvingen zijn ingeschakeld. Als deze niet is ingeschakeld, neemt u contact op met uw Canvas-accountmanager.

  1. Log in bij Panorama.
  2. Klik in het linkermenu op Configuraties en selecteer daarna Integratie-instellingen.
  3. Kies in het vervolgkeuzemenu Selecteer integratie de optie LMS Visualizer en klik op Visualizer downloaden.
  4. Log vervolgens in bij Canvas als beheerder. Klik in de linkerzijbalk op Beheerder en selecteer het Account waarop u de YuJa Panorama - LMS Viewer wilt toepassen.
  5. Selecteer Instellingen in de navigatiebalk aan de linkerkant en controleer of het tabblad Instellingen is geselecteerd in de bovenste rij. 
  6. Klik vervolgens in de navigatiebalk aan de linkerkant op Thema's en klik daarna op de knop + Thema. Selecteer een willekeurige themasjabloon in de vervolgkeuzelijst.

  7. Ga in de thema-editor naar het tabblad Uploaden en selecteer het gedownloade bestand Visualizer. 

    Opmerking: Het tabblad Uploaden is pas beschikbaar nadat uw Canvas-accountmanager het heeft ingeschakeld.

  8. Klik vervolgens op Voorbeeld van wijzigingen bekijken, en kies daarna Thema toepassen. Wanneer u wordt gevraagd uw thema een naam te geven, typt u Panorama Theme.

Verwante artikelen

Neem contact op met support