Oppset av LTI 1.3 applikasjonen
For å sette opp LTI 1.3-protokollen og kjøre applikasjonen, følg trinnene under.
(1) Sette opp LTI nøkkel
1.1 Navigate to the Administrator Tab:
Click on the "Administrator" tab located on the left-hand side of the page.
1.2 Select the Account:
Choose the account where you wish to create the application.
1.3 Access the Developer Key Section:
A second column on the left-hand side will appear. Scroll down and select "Utviklernøkkel" (Developer Key).
1.4 Switch to Account Tab:
Click on the "Account" tab.
1.5 Add a New Developer Key:
On the right-hand side of the page, click on "+Utviklernøkkel". This will display a drop-down menu.
1.6 Choose LTI Key:
From the drop-down menu, select "LTI nøkkel".
1.7 Name Your LTI Key:
A new page will appear. Provide a descriptive name for your LTI nøkkel.
1.8 Select Manual Entry for Configuration:
Under the "Metode" tab, click on "Manuell innlegging" and select "Lim inn JSON" (Paste JSON).
1.9 Configure JSON Object:
Modify the JSON object below (as described in the following) and paste into the “LTI 1,3 Konfigurasjon”.
"title": "Write the title of your application"
Give an arbitrary title to your lti-application. This title appears in the Canvas menu later as a clickable name for running your application."description": "Write a short description of your application here"
Write an arbitrary short description for your applicationcustom_custom_app_url:"https://lti-arbeidslister.de-c1.eu1.cloudhub.io"
ORcustom_custom_app_url:"https://lti-clear-users.de-c1.eu1.cloudhub.io/"
This is the URL to the actuall application. Currently these two applications are availablecustom_custom_permissions: (ONLY forArbeidslisterapplication)
If this is left empty, the application will require the user to be added to the course. Add for instance “manage_grades" to allow all users with the given permission (within the current course) to access this LTI app.
JSON Object:
{
"title": "FS overføring (lti1.3)",
"scopes": [],
"extensions": [
{
"platform": "canvas.instructure.com",
"settings": {
"platform": "canvas.instructure.com",
"placements": [
{
"placement": "account_navigation",
"message_type": "LtiResourceLinkRequest"
},
{
"placement": "link_selection",
"message_type": "LtiResourceLinkRequest"
},
{
"placement": "course_navigation",
"message_type": "LtiResourceLinkRequest"
}
]
},
"privacy_level": "public"
}
],
"public_jwk": {},
"description": "For overføring av resultater til FS",
"custom_fields": {
"custom_context_title": "$Context.title",
"custom_custom_app_url": "https://lti-arbeidslister.de-c1.eu1.cloudhub.io",
"custom_custom_oauth_or_token": "token",,
"custom_custom_permissions": "manage_grades",
"custom_lis_person_name_full": "$Person.name.full",
"custom_custom_canvas_user_id": "$Canvas.user.id",
"custom_custom_canvas_course_id": "$Canvas.course.id",
"custom_custom_canvas_api_domain": "$Canvas.api.domain",
"custom_custom_canvas_course_sissourceid": "$Canvas.course.sisSourceId",
"custom_lis_person_contact_email_primary": "$Person.email.primary",
"custom_custom_canvas_course_integrationid": "$com.instructure.Course.integrationId"
},
"public_jwk_url": "https://lti1.de-c1.eu1.cloudhub.io/public-jwks-to-the-lti13-app",
"target_link_uri": "https://lti1.de-c1.eu1.cloudhub.io/final-call-to-the-launch-lti13-app",
"oidc_initiation_url": "https://lti1.de-c1.eu1.cloudhub.io/start-the-launch-lti13-app"
}
1.10 Enter Redirect URI:
Paste the following URI into the box “URIer for videresendelse"
https://lti1.de-c1.eu1.cloudhub.io/redirect-to-the-launch-lti13-app
1.11 Save the LTI Key:
Click on “Lagre" to store the LTInøkkel. You should be redirected to "Administrator > Utviklernøkkel > Konto".
1.12 Activate the LTI Key:
On the far right side, next to your LTI nøkkel under "Tilstand" (Status), click on the grey checkbox to turn it green. Confirm any prompts that appear.
Under “Detaljer", in front of your LTI nøkkel, there exists “LTI Client ID". Copy and keep this ID securely as it will be required when configuring the LTI Key.
(2) Konfigurasjon av LTI nøkkel
2.1 Navigate to the Administrator Tab:
Click on the "Administrator" tab located on the left-hand side of the page.
2.2 Select the Account:
Choose the account where you previously created the LTInøkkel.
2.3 Access the Settings Section:
A second column on the left-hand side will appear. Scroll down and select "Innstillinger" (Settings).
2.4 Switch to the Apps Tab:
Click on the "Apper" (Apps) tab.
2.5 View Application Configurations:
On the right-hand side of the page, click on "Vis applikasjonskonfigurasjoner" (Show application configurations).
2.6 Add a New App:
Click on "+App".
2.7 Select Manual Entry:
A new page will appear. Click on the drop-down menu labeled "Manuell innlegging" (Manual entry).
2.8 Set up with Client ID:
Click on “Av klient-ID”
2.9 Enter LTI Client ID:
Paste the "LTI Client ID" that you copied in step 1.12 into the “Klient-ID" box.
2.10 Submit the Form:
Click on “Send inn“ (Submit).
2.11 Confirmation Dialog:
A dialog box will appear. Click on “Installere” (Install).
2.12 Final Installation Confirmation:
A dialog box appears. Click on "Ja, installer verktøy".
(3) Sette opp API nøkkel
3.1 Navigate to the Administrator Tab:
Click on the "Administrator" tab located on the left-hand side of the page.
3.2 Select the Account:
Choose the account where you previously created the LTInøkkel.
3.3 Access the Developer Key Section:
A second column on the left-hand side will appear. Scroll down and select "Utviklernøkkel" (Developer Key).
3.4 Switch to Account Tab:
Click on the Account tab.
3.5 Add a New Developer Key:
On the right-hand side of the page, click on "+Utviklernøkkel". This will display a drop-down menu.
3.6 Choose API Key:
From the drop-down menu, select “API nøkkel” (API key).
3.7 Name Your API Key:
A new page will appear. Provide a descriptive name for your API nøkkel (API key).
3.8 Enter Redirect URI:
Paste the following URI into the box “Omdirigere URIer"
https://lti1.de-c1.eu1.cloudhub.io/redirect-to-the-oauth2-lti13-app
3.9 Save the API Key:
Click on “Lagre" bottom.
3.10 Activate the API Key:
On the far right side, next to your LTI nøkkel under "Tilstand" (Status), click on the grey checkbox to turn it green. Confirm any prompts that appear.
Under “Detaljer", you will find the “API Client ID" and “API Key". Copy and securely store both, as they will be required when running the LTInøkkel for the first time. (Click on “Vis nøkkel" to reveal the “API Key").
(4) Konfigurasjon/kjøring av applikasjonen (første gang)
4.1 Navigate to the Administrator Tab:
Click on the "Administrator" tab located on the left-hand side of the page.
4.2 Select the Account:
Choose the account where you previously created the LTInøkkel.
4.3 Locate the LTI Key:
Scroll down the second column on the left-hand side of the page to find the name of the LTI nøkkel you created earlier. Click on it.
Note: If this is your first time accessing this LTI nøkkel, proceed to steps 4.4 and 4.5. Otherwise, skip to step 4.6.
4.4 Enter API Client ID:
A dialog box appears. Paste the "API Client ID" that you copied in step 3.10 into the available box.
4.5 Enter API Key:
Paste the “API Key" that you copied in step 3.10 into the available box.
4.6 Authorize the API Key:
Another dialog box will appear for authentication of the API nøkkel. Click on "Autoriser" (Authorize) to proceed.