Ylläpitäjänä voit käyttää tätä opasta yleisten LTI 1.3 -integraatio-ongelmien tunnistamiseen ja ratkaisemiseen.
Vakiotarkistusten suorittaminen Luminassa
Ylläpitäjänä voit suorittaa vakiotarkistuksia varmistaaksesi, että määritysparametrit täsmäävät Luminan ja oppimisympäristösi (LMS) välillä, koska LTI 1.3 edellyttää kaksisuuntaista määritystä.
- Ota yhteyttä asiakasvastaavaasi varmistaaksesi, että organisaatiossasi on LTI 1.3 otettu käyttöön.
- Kirjaudu Luminaan ylläpitäjänä.
- Napsauta Päävalikko-painiketta > Hallintapaneeli.
- Valitse sivupalkista Integraatiot.
- Varmista, että kaikki parametrit täsmäävät LMS:n tuottamien tietojen kanssa.
Yleisten virheiden ratkaiseminen
Ylläpitäjänä voit etsiä tästä yleisiä LTI 1.3 -integraatiovirheitä ja niiden ratkaisuvaiheet.
- LMS:n YuJa-integraatio LTI 1.3:a varten ei antanut kelvollista ISS-arvoa: Varmista, että ISS ja Client ID ovat oikein. Voit tarkistaa tämän siirtymällä kohtaan Hallintapaneeli > Integraatiot > LMS LTI 1.3:n kautta.
- LMS:n YuJa-integraatio LTI 1.3:a varten ei aloittanut kirjautumista kaikilla tiedoilla. Virhe on: allekirjoitusavain on määritettävä, jos määritetty JWT on allekirjoitettu digitaalisesti: Varmista, että Deployment ID ja JWKS Endpoint ovat oikein. Voit tarkistaa tämän siirtymällä kohtaan Hallintapaneeli > Integraatiot > LMS LTI 1.3:n kautta.
- Todennusmenetelmää ei ole määritetty organisaatiollesi LTI 1.3:a varten: Ota yhteyttä YuJa-asiakasvastaavaasi ottaaksesi LTI 1.3 -integraation käyttöön organisaatiossasi.
- LMS:n YuJa-integraatio LTI 1.3:a varten ei aloittanut kirjautumista kaikilla tiedoilla: Tämä tapahtuu, kun joitakin LTI 1.3:n pakollisia tunnisteita puuttuu käynnistyspyynnön aikana. Tarkista LMS:n nykyisen version ja LTI 1.3:n yhteensopivuus.
- LTI Version claim puuttuu käynnistyspyynnöstä: Tämä tapahtuu, kun Version Claim puuttuu. Ota yhteyttä LMS:n tukitiimiin ongelman ratkaisemiseksi.
- LTI 1.3 -käynnistyspyynnölle välitettiin virheellinen LTI-versio: Tämä tapahtuu, kun Version Claim on virheellinen. Ota yhteyttä LMS:n tukitiimiin ongelman ratkaisemiseksi.
- Virheellinen JWT. LTI 1.3:n kriittisiä claimeja puuttuu pyynnöstä: Tämä tapahtuu, kun Sub claim puuttuu. Ota yhteyttä LMS:n tukitiimiin ongelman ratkaisemiseksi.
-
Yksi tai useampi vaadituista claimeista puuttuu LTI 1.3 -käynnistyspyynnöstä:
- Message type
- LTI
- Deployment ID
- Target link URI
- Resource link ID
- LTI user ID
- LTI roles
- Virheelliset IAT- ja/tai EXP-arvot LTI 1.3 -pyynnössä / Virheelliset IAT- ja/tai exp-kentät LTI 1.3 -käynnistyspyynnössä: Tämä tapahtuu, kun pyynnön aikaleima on vanhentunut.
- KID-arvoa ei ole asetettu otsikossa: Tämä tapahtuu, kun allekirjoitusavain puuttuu käynnistyspyynnön aikana. Ota yhteyttä LMS:n tukitiimiin ongelman ratkaisemiseksi.
- Virheellinen KID annettu: KID-arvon avulla haetaan vastaava avain, jolla puretaan LMS:n Luminalle lähettämien viestien salaus. Virheellinen KID voi johtua virheellisestä Deployment ID:stä LMS:ssä. Joissakin LMS-järjestelmissä Deployment ID ja KID on erotettu toisistaan. Tällöin asia vaatii lisäselvitystä sekä LMS:n että YuJan puolelta.
- Virheellinen allekirjoitus - JWT:n vahvistaminen ei onnistu: Tämä tapahtuu, kun JWT-avaimen URL on määritetty virheellisesti. Varmista, että kaikki muut parametrit, mukaan lukien ISS, Deployment ID ja Client ID, ovat oikein.
- RSA-julkista avainta ei löytynyt annetulle ISS-arvolle: Tämä tapahtuu, kun JWT-avaimen URL on määritetty virheellisesti. Varmista, että kaikki muut parametrit, mukaan lukien ISS, Deployment ID ja Client ID, ovat oikein.
- Virheellinen allekirjoitus, state-JWT:n vahvistaminen ei onnistu: Tämä tapahtuu, kun JWT-avaimen URL on määritetty virheellisesti. Varmista, että kaikki muut parametrit, mukaan lukien ISS, Deployment ID ja Client ID, ovat oikein.
-
YuJa-URL kieltäytyi muodostamasta yhteyttä: Tämä tapahtuu, kun integraatio ei pysty tunnistamaan yhdistettävää käyttäjätiliä. Tähän on kaksi yleistä syytä.
- Jos kyseessä on uusi käyttäjä, siirry sivulle Hallintapaneeli > Integraatiot > LMS LTI 1.3:n kautta ja tarkista, onko uuden käyttäjätilin automaattinen luominen otettu käyttöön.
- Jos tarkoituksena on yhdistää olemassa oleva käyttäjä käyttäjän sähköpostiosoitteen avulla, tarkista, onko useilla käyttäjillä sama sähköpostiosoite. Ota yhteyttä YuJa-asiakasvastaavaasi ongelman ratkaisemiseksi.