Integratie
      Terug naar start
      1. Helpcentrum
      2. Overig
      3. Integratie

      Single Sign On activeren voor BasicLTI of SCORM

      Als u uw bestaande LMS met TrainTool wil integreren, ondersteunen we de volgende integraties:

      Let op!

      • Zorg dat TrainTool in een nieuw window geopend wordt, anders kan TrainTool geen toegang krijgen tot de camera / microfoon in Google Chrome. 
      • SCORM-integratie werkt alleen met HTTPS-protocol en niet met HTTP.

      Hoe het voor deelnemers werkt

      1. Deelnemers klikken op hun TrainTool-leeractiviteit vanuit het bestaande LMS

      2. De deelnemer wordt automatisch ingelogd in de webversie van TrainTool

      3a. Als de deelnemer al in TrainTool bestaat, wordt hij/zij direct naar de betreffende training doorgestuurd en kan hij/zij verder gaan.

      3b. Als de deelnemer nog niet in TrainTool bestaat, wordt er automatisch een nieuwe gebruiker aangemaakt* en ingeschreven voor de training. De deelnemer krijgt de suggestie om de mobiele app te gebruiken (aangezien dit normaal gesproken de voorkeur heeft van onze deelnemers).

      Single Sign On activeren voor BasicLTI LTI 1.1 (Oud)

      LTI documentatie

      1. U heeft een accountname, consumer key en een shared secret nodig. 

      Wanneer ingelogd, kun je als account admin zelf de benodigde keys vinden. Deze staan onder 'API keys' bij de tab 'Account'. De keys moeten wel eerst voor een account aangemaakt worden, als dit nog niet gedaan is kun je contact opnemen met onze support afdeling. De account name is te vinden in de browserbalk, het deel van de url vóór ".traintool.com". 

      2. Voeg een  "LTI Tool Provider" toe in uw LMS met de volgende informatie:

      Eigenschap Waarde
      Tool base URL https://[accountname].traintool.com/api/lti
      Consumer key 16 character key you received in step 1
      Shared secret received in step 1
      Launch container New window
      Launch_presentation_return_url the URL to send users after they exit TrainTool
      program_id* ID of program
      start_date* YYYY-MM-DD

      De volgende formats worden ook ondersteund voor de start_date: DD.MM.YYYY en DD-MM-YYYY.

      *Als custom_ niet automatisch wordt ingevuld voor program_id, verander program_id dan handmatig in custom_program_id. Evenzo voor start_date.

      Meer info: http://www.imsglobal.org/specs/ltiv1p1/implementation-guide#toc-3


      3. Maak een nieuwe "LTI Activiteit"
      Maak activiteiten op elk punt in uw cursus waar u wilt linken naar een TrainTool-activiteit of een specifiek TrainTool-programma.

      Gebruik dezelfde eigenschappen als hierboven beschreven, maar voeg daarnaast ook een eigenschap program_id toe en gebruik als waarde hiervoor het "program ID" dat u kunt vinden in het trainingsoverzicht in de administrator-omgeving van TrainTool:

      Knipsel1.PNG

      Opmerking: om callbacks te implementeren voor het rapporteren van scores en voortgang, neem contact met ons op om te bespreken hoe we dit implementeren

       

      Eigen implementatie Single Sign On met BasicLTI

      Doe een POST request naar https://[accountname].traintool.com/api/lti met de volgende parameters.

       lti_message_type =basic-lti-launch-request
      oauth_consumer_key get this key from TrainTool (ask your account manager)
      oauth_signature_method http://www.imsglobal.org/specs/ltiv1p1/implementation-guide#toc-3
       oauth_timestamp http://www.imsglobal.org/specs/ltiv1p1/implementation-guide#toc-3
       oauth_nonce http://www.imsglobal.org/specs/ltiv1p1/implementation-guide#toc-3 
      oauth_version=1.0 http://www.imsglobal.org/specs/ltiv1p1/implementation-guide#toc-3
       

      oauth_signature=Xddn2A%2BjzwjgBIVYkvigaKxCdcc%3D

      		 Create this using shared secret (ask your TrainTool account manager) http://www.imsglobal.org/specs/ltiv1p1/implementation-guide#toc-3 

      oauth_callback

      		 =about:blank 
      lis_person_contact_email_primary* email adress
      lis_person_name_given first name
      lis_person_name_family last name
      launch_presentation_return_url the URL to send users after they exit TrainTool
      program_id * id of program (see screenshot above)
      start_date * YYYY-MM-DD

      *Als custom_ niet automatisch wordt ingevuld voor program_id, verander program_id dan handmatig in custom_program_id. Evenzo voor start_date.

      Meer info: http://www.imsglobal.org/specs/ltiv1p1/implementation-guide#toc-3

       

       

      Single Sign On activeren voor LTI 1.3 (Nieuw)

      LTI 1.3 is de geupdate versie van LTI 1.1. De stappen zijn grotendeels hetzelfde als de 1.1 versie.

      1. U heeft een accountname, consumer key en een shared secret nodig. 

        • Verkrijg uw accountnaam, consumentensleutel en privésleutel.
        • Als accountbeheerder vindt u deze sleutels onder 'API-keys' in het tabblad 'Account' na het inloggen. Als deze nog niet zijn gegenereerd, neem dan contact op met ons supportteam.
        • De accountnaam is het deel van de URL vóór ".traintool.com."

      2. Voeg LTI 1.3 Tool Provider toe aan uw LMS:

        • Toolconfiguratie:

          • Tool base-URL: https://[accountname].traintool.com/api/lti_tool
          • Initiate Login  URL: https://[accountname].traintool.com/api/lti_tool/initiation
          • (public) keyset: https://[accountname].traintool.com/api/lti_tool/keyset
          • Privésleutel: Gebruik de privésleutel ontvangen in stap 1.
          • Startcontainer: Nieuw venster
          • Redirection URI: https://[accountname].traintool.com/api/lti_tool/launch
          • program_id: ID van het programma
          • start_date: YYYY-MM-DD (ondersteunt DD.MM.YYYY en DD-MM-YYYY formaten)

        • Aanpassing:

          • Als custom_ niet automatisch wordt ingevuld voor program_id, wijzig het dan handmatig in custom_program_id.
          • Op dezelfde manier, als het niet is ingevuld, verander start_date in custom_start_date.

        • Meer informatie: IMSGlobal LTI 1.3 Implementatiehandleiding

      2. Maak LTI-activiteit aan:

        • Maak activiteiten in uw cursus waar links naar TrainTool-activiteiten of specifieke programma's gewenst zijn.

        • Gebruik dezelfde eigenschappen als hierboven beschreven.

        • Voeg een eigenschap program_id toe en gebruik als waarde hiervoor het "programma-ID" dat u kunt vinden in de TrainTool-beheerdersomgeving.

        • Opmerking:

          • Neem contact met ons op om callbacks te implementeren voor het rapporteren van scores en voortgang.

      3. Aangepaste Single Sign-On met BasicLTI:

        • Voer een POST-verzoek uit naar onze Redirection URI: https://[accountname].traintool.com/api/lti_tool/launch met de volgende parameters:

          • lti_message_type: basic-lti-launch-request

          • oauth_consumer_key: Verkrijg deze sleutel van TrainTool (vraag het aan uw accountmanager)

          • oauth_signature_method

          • oauth_timestamp

          • oauth_nonce

          • oauth_version: 1.0

          • oauth_signature: Maak dit met de gedeelde sleutel (vraag het aan uw TrainTool-accountmanager) Meer details


      1. Pas de instellingen van TrainTool aan

          • Vergelijkbaar met stap 2 Tool Configuration, voer je nu jullie informatie in in TrainTool, op de Account, scrol naar onder naar de OpenID Provider pagina, zie de volgende afbeelding ter referentie.

            Voor deze informatie kan je het beste bij je Account Manager zijn.

          • Extra Parameters:

            • oauth_callback: about:blank
            • lis_person_contact_email_primary: e-mailadres
            • lis_person_name_given: voornaam
            • lis_person_name_family: achternaam
            • launch_presentation_return_url: URL voor het doorsturen van gebruikers na het verlaten van TrainTool
            • program_id: ID van het programma (zie hierboven)
            • start_date: YYYY-MM-DD

          • Aanpassing:

            • Als custom_ niet automatisch wordt ingevuld voor program_id, wijzig het dan handmatig in custom_program_id.
            • Op dezelfde manier, als het niet is ingevuld, verander start_date in custom_start_date.

        • Meer informatie: IMSGlobal LTI 1.3 Implementatiehandleiding

       

      Single Sign On activeren via SCORM

      1. Vraag een SCORM-pakket aan voor elke training of elk programma

      Dit kan je downloaden via de link https://[accountnaam].traintool.com/admin_simple/programs/[program_id]/scorm.zip. Om dit pakket te downloaden via deze link moet er ingelogd worden met de login van een programma administrator.

      2. Maak een nieuwe activiteit in uw LMS en upload het SCORM-pakket
      Zorg ervoor dat het pakket opent in een nieuw venster.

      Do's and don'ts

      • Gebruik bij voorkeur LTI omdat het een eenvoudigere, technische betere standaard is.
      • Het is aan te raden om TrainTool in een nieuw venster te openen (niet in een iframe). 
      • Test de koppeling voordat u deze in gebruikt neemt.
      • In praktijk werkt het het beste als uw IT mensen direct met TrainTool schakelen.

      SURFconext of andere API

      Neem contact met ons op.