LTI-oppsett mellom Canvas og WISEflow

Her beskrives oppsett av LTI mellom WISEflow og Canvas som skal fungere for norsk sektor.

Dokumentasjon

UNIwises guide: https://help.wiseflow.net/service-centre/canvas-lti-configuration-guide

Guiden for standardoppsett kan følges, og det aller meste som er beskrevet på denne siden er likt. Spesifiserte detaljer som er annerledes er markert i blått i oversiktene under.

Webinar om LTI arrangert av UNIwise 07.11.2025: https://vimeo.com/1136109340?share=copy&fl=sv&fe=ci

Fremgangsmåte oppsummert

Det er 3 ulike konfigurasjoner som må settes opp. Det er en fordel å gjøre dette samtidig, fordi det må kopieres nøkler og lenker fra hverandre inn i de ulike konfigurasjonene.

Developer Key i Canvas
External App i Canvas
LTI connection i WISEflow

Det er mulig å benytte Canvas Prod, Beta eller Test og WISEflow Prod eller Stage, bare vær oppmerksom på at lenkene i oppsettet må peke til riktig miljø.

Start oppretting av en ny LTI connection i WISEflow (denne skal lagres til slutt)
Opprett en ny Developer Key i Canvas (fyll ut all informasjon i henhold til oversikten under og lagre)
Aktiver Developer Key
Opprett en ny External app
Fullfør oppsett av LTI connection i WISEflow

Developer Key i Canvas

I Canvas, gå til Admin > Developer Keys og opprett en ny developer key av typen “LTI Key”.

Developer key-felt	Verdi

Developer key-felt	Verdi
Method	Velg Manual entry
Key name, Title og Description	Gi den et valgfritt navn og beskrivelse slik at du som admin kan kjenne den igjen.
Redirect URIs	Kopier og lim inn Redirection URL fra WISEflow
Target Link URI	Kopier og lim inn Redirection URL fra WISEflow
OpenID Connect Initiation Url	Kopier og lim inn Login initiation URL fra WISEflow
JWK Method	Velg Public JWK URL
Public JWK URL	Kopier og lim inn Tool public keyset URL fra WISEflow
LTI Advantage Services	Aktiver toggle Can lookup Account information
Additional Settings > Custom Fields	Lim inn følgende: `custom_canvas_user_id=$Canvas.user.loginId`
Additional Settings > Privacy Level	Sett til PUBLIC
Placements	Velg Account Navigation, Link Selection, Assignment Selection og Assignment View
Link Selection > Target Link URI	Kopier og lim inn Deep Link URL fra WISEflow
Link Selection > Select Message Type	Velg LtiDeepLinkingRequest
Assignment Selection > Target Link URI	Kopier og lim inn Deep Link URL fra WISEflow
Assignment Selection > Select Message Type	Velg LtiDeepLinkingRequest
Assignment View > Target Link URI	Kopier og lim inn Deep Link URL fra WISEflow

External App i Canvas

I Canvas, gå til Admin > Settings > Apps > View App Configurations. Legg til en ny App.

External App-felt	Verdi

External App-felt

Verdi

Configuration Type

Velg By Client ID

Client ID

Kopier og lim inn verdien fra Details-kolonnen i Developer Keys-oversikten

(obs: ikke nøkkelen som vises når man trykker “Show Key”)

LTI connection i WISEflow

I WISEflow, gå til Licence Administration > Licence configuration > LTI setup. Velg Add new LTI setup.

Når denne er lagret er det ikke mulig å redigere eller se fullstendig oppsett. Ved behov må det da opprettes en ny LTI connection, men det er ikke nødvendig å endre oppsettet i Canvas.

LTI connection-felt

LTI connection-felt
Select platform	Velg Canvas
Select identification strategy	Velg institusjonsbrukernavn (ePPN). I listen vil den normalt ha samme navn som institusjonen (f.eks. “NMBU” eller “USN-id”. Systemene må kunne identifisere brukeren basert på en felles ID. Det er foreløpig kun brukernavn som har fungert.
Claim path	Feltet blir synlig når brukernavn er valgt som identification strategy. Lim inn følgende: `$["https://purl.imsglobal.org/spec/lti/claim/custom"].canvas_user_id` Dette skal harmonisere med det som legges inn i Customs Fields i Developer Key.
Client ID	Kopier og lim inn verdien fra Details-kolonnen i Developer Keys-oversikten i Canvas. (obs: ikke nøkkelen som vises når man trykker “Show Key”)
Access token URL	`https://{institution}.instructure.com/login/oauth2/token` *
Platform public key set URL	`https://{institution}.instructure.com/api/lti/security/jwks` *
OpenID connect login endpoint	`https://{institution}.instructure.com/api/lti/authorize_redirect` *
Issuer	`https://canvas.instructure.com`
Deployment ID	Trykk på tannhjulet til opprettet External App i Canvas og velg Deployment Id. Kopier nøkkelen og lim inn i WISEflow.

* Bytt ut {institution} slik at URL samstemmer med URL til din Canvas-lisens. Det betyr også at man f.eks. må legge til “nmbu.test” dersom man skal benytte Canvas' test-miljø.

Bruk

Når alt er konfigurert ferdig kan man opprette en ny Assignment i Canvas. Velg External Tool som Submission Type, så skal LTI-appen dukke opp i listen.