LTI 1.1 Consumer
Deze pagina beschrijft de details voor het afnemen van SkillsTown trainingen via LTI 1.1.
Launch URL
De standaard launch URL voor LTI 1.1 is:
https://account.onlineacademy.nl/LtiProvider/Provide
Als alternatief kunt u de LTI-identifier direct in de URL opnemen:
https://account.onlineacademy.nl/LtiProvider/Provide/XXXX
Waarbij XXXX de LTI-identifier is voor de specifieke training. Dit stelt u in staat om één Consumer Key en Secret te gebruiken voor alle trainingen, terwijl u elke training onderscheidt via zijn unieke identifier in de URL.
Credentials
Om te authenticeren heeft u een consumer_key en consumer_secret nodig. Deze worden aan u verstrekt door SkillsTown.
Voortgang van de training
Om voortgangsupdates van de training te ontvangen, moet het LTI launch verzoek de lis_outcome_service_url en lis_result_sourcedid parameters bevatten.
SkillsTown stuurt een cijfer (0.0 – 1.0), waarbij 0.0 staat voor 0% voortgang en 1.0 voor 100% voortgang, naar de lis_outcome_service_url wanneer de gebruiker de training voltooit.
Verplichte Velden
De volgende velden zijn vereist in het LTI launch verzoek:
lti_message_type(moetbasic-lti-launch-requestzijn)lti_version(moetLTI-1p0zijn)user_idlis_person_name_givenlis_person_name_familylis_person_name_fulllis_person_contact_email_primarycustom_course_identifier(Vereist als de LTI-identifier NIET in de Launch URL is opgenomen)oauth_consumer_keyoauth_signature_methodoauth_timestampoauth_nonceoauth_versionoauth_signaturelis_outcome_service_urllis_result_sourcedid
Voorbeeld Verzoek
De LTI 1.1 launch is een POST verzoek met het application/x-www-form-urlencoded content type. Hieronder staan de parameters van een voorbeeldverzoek:
| Parameter | Waarde | Beschrijving |
|---|---|---|
| LTI Standaard Parameters | ||
lti_message_type | basic-lti-launch-request | Moet basic-lti-launch-request zijn |
lti_version | LTI-1p0 | Moet LTI-1p0 zijn |
resource_link_id | 429785226 | Unieke ID voor de link |
resource_link_title | Phone home | Titel van de link |
resource_link_description | Will ET phone home... | Beschrijving van de link |
user_id | 29123 | Unieke ID voor de gebruiker |
roles | urn:lti:role:ims/lis/Instructor | Gebruikersrol |
lis_person_sourcedid | sis:942a8dd9 | SIS ID voor de persoon |
lis_person_name_given | John | Voornaam |
lis_person_name_family | Baird | Achternaam |
lis_person_name_full | John Logie Baird | Volledige naam |
lis_person_contact_email_primary | jbaird@uni.ac.uk | E-mailadres |
launch_presentation_locale | en-GB | Locale |
launch_presentation_return_url | https://saltire.lti.app/platform | Return URL |
| Parameters voor voortgang | ||
lis_outcome_service_url | https://saltire.lti.app/platform/tool/outcome | URL om cijfers naar te sturen |
lis_result_sourcedid | ondemand~8893h42 | Unieke ID voor het resultaat |
| Aangepaste Parameters | ||
custom_course_identifier | PEB50UTX | Verplicht (indien niet in URL). Identifier voor de training in SkillsTown |
| OAuth Parameters | ||
oauth_consumer_key | ****************** | Consumer Key |
oauth_signature_method | HMAC-SHA1 | Signature Method |
oauth_timestamp | 1763560682 | Tijdstempel |
oauth_nonce | e4600b4c937a89ead735edb13428f850 | Nonce |
oauth_version | 1.0 | OAuth Versie |
oauth_signature | ... | OAuth Handtekening |
Volledige Parameterlijst (Voorbeeld)
context_id=S3294476
context_label=ST101
context_title=Telecommunications 101
context_type=CourseSection
custom_caliper_endpoint_url=https://lti.tools/caliper/event
custom_course_identifier=PEB50UTX
...
lti_message_type=basic-lti-launch-request
lti_version=LTI-1p0
oauth_consumer_key=******************
resource_link_id=429785226
user_id=29123
roles=urn:lti:role:ims/lis/Instructor
...