lectoraIntegrer Lectora

HURTIGSTART · ENKELT-LÆRER

Hvordan prøver jeg Lectora på mine egne Canvas-emner?

Vil du evaluere Lectora på dine egne emner uten å involvere Canvas-IT? Denne veiledningen tar deg fra null til vurderte innleveringer på rundt ti minutter ved hjelp av et personlig Canvas-tilgangstoken. Veien er ment for solo-piloter — én underviser som prøver Lectora på sine egne emner, eller en demo for interessenter før et institusjonsbredt valg tas. Den er ikke egnet for utrullinger med flere undervisere: Canvas' API-policy begrenser personlige tilgangstokener til personlig, individuell bruk, og en tredjepartsapp som ber hver underviser overlevere et token er ikke en kompatibel integrasjon. Når du har validert Lectora på dine egne emner, er LTI 1.3 admin-installasjonsveiledningen den kompatible, skalerbare veien til å rulle det ut på hele institusjonen.

Er denne veiledningen riktig for deg?

Denne PAT-veien passer fire tilfeller: en solo-pilot der én underviser prøver Lectora på sine egne emner; en demo eller evaluering der du viser produktet til interessenter før et institusjonsbredt valg; testing og QA der du raskt kobler Lectora til en staging-Canvas-instans; og selv-hostede enkeltbruker-utrullinger der du kjører din egen Lectora-instans for din egen undervisning. Hvis målet er at hver underviser ved institusjonen din skal bruke Lectora, bør Canvas-administratoren installere det via LTI 1.3 i stedet — det er den kompatible, skalerbare veien. Det samme gjelder enhver utrulling der tokenet måtte forlate den opprinnelige token-eierens konto.

Canvas' API-policy begrenser eksplisitt manuelt genererte personlige tilgangstokener til personlig, individuell bruk. En tredjepartsapp som ber hver underviser i en flerbruker-utrulling om å generere og levere et token er ikke kompatibel; Canvas forventer at den veien går via LTI 1.3 eller institusjonsnivå OAuth i stedet. I praksis betyr det at PAT-veien beskrevet her er greit for én person som evaluerer Lectora på sin egen Canvas-konto, eller en selv-hostet Lectora-utrulling der du er den eneste brukeren. Noe bredere krever LTI-installasjonen.

Hvordan PAT-veien fungerer

Flyten er, i rekkefølge: du registrerer deg i Lectora med e-post og passord; du genererer et personlig tilgangstoken i Canvas; du limer inn tokenet (sammen med Canvas-URL-en din) i Lectora; Lectora krypterer tokenet med AES-256-GCM og lagrer det; fra da av leser Lectora emnene dine og skriver karakterer tilbake til Canvas som deg, ved å bruke det tokenet. Tokenet blir aldri logget i klartekst og behandles som ekvivalenten av et passord.

Hva du trenger før du starter: en Canvas-konto med underviser-tilgang til minst ett emne (enhver Canvas fungerer — institusjonens din, eller en gratis Canvas-konto på canvas.instructure.com), en e-postadresse for å registrere Lectora-kontoen, og rundt ti minutter. Du trenger ikke Canvas-administrator-tilgang.

Steg 1 — Opprett Lectora-kontoen din

Åpne Lectora i nettleseren. For de fleste brukere er dette den hostede produksjonsappen på https://lectora.app; hvis institusjonen din selv-hoster Lectora på sitt eget domene (det er åpen kildekode), bruk den URL-en i stedet.

  1. Klikk Sign up.
  2. Oppgi e-posten din og velg et passord.
  3. Bekreft e-posten hvis du blir bedt om det.

Du er nå logget inn. Lectora vil be deg om å koble til en Canvas-instans deretter — hold denne fanen åpen mens du går for å generere tokenet.

Steg 2 — Generer et personlig Canvas-tilgangstoken

Et personlig tilgangstoken er Canvas' måte å la eksterne apper handle på dine vegne på. Du genererer det én gang i Canvas, limer det inn i Lectora, og Lectora lagrer det kryptert.

  1. I Canvas, klikk på kontoavataren din øverst til venstre i den globale navigasjonen, deretter klikk Settings.
  2. Bla nedover til Approved Integrations-seksjonen.
  3. Klikk + New Access Token.
  4. Fyll inn dialogen:
    • PurposeLectora Pilot — <dagens dato> (noe du kjenner igjen senere når du skal kalle den tilbake)
    • Expires — 30 eller 60 dager. Unngå å la den stå tom — et token som aldri utløper er en sikkerhetsrisiko du ikke vil ha på en evalueringskonto.
  5. Klikk Generate Token.
  6. Klikk kopier-ikonet, eller velg og kopier hele den lange strengen (Canvas-tokener er rundt 70 tegn).

Behandle tokenet som et passord — enhver som har det kan lese og endre Canvas-dataene dine som om de var deg. Lectora krypterer det i ro med AES-256-GCM, men du bør likevel kalle det tilbake i samme øyeblikk du slutter å bruke Lectora, aldri lime det inn i en chat eller e-post, og foretrekke den korte utløpstiden du satte over.

Steg 2a — Canvas' kontoavatar → Settings

Steg 2b — Approved Integrations → + New Access Token

Steg 2c — New Access Token-skjema, Purpose og Expires fylt ut

Steg 2d — Token vist. Canvas viser det kun én gang; kopier det nå.

Steg 3 — Koble Canvas til Lectora

Tilbake i Lectora, enten følg onboarding-prompten som dukket opp etter registreringen, eller åpne Settings → Canvas Connection.

  1. Oppgi din Canvas URL i det første feltet. Eksempler:
    • Gratis Canvas: https://canvas.instructure.com
    • Institusjon: https://canvas.din-skole.no
  2. Lim inn Personal Access Token fra Steg 2 i det andre feltet.
  3. Klikk Save.

Steg 3 — Lectoras Canvas Connection-skjema, begge felt fylt ut

Steg 4 — Bekreft at du ser emnene dine

  1. Åpne Lectora-startsiden (eller Courses-visningen).
  2. Innen noen få sekunder vises de aktive Canvas-emnene dine i listen.
  3. Åpne et hvilket som helst emne og velg en oppgave.

Du er klar til å vurdere. Herfra leder Lectoras innebygde onboarding deg gjennom din første vurderingsrunde og publisering av tilbakemelding tilbake til Canvas.

Steg 4 — Lectora-emnevisning etter første synkronisering

Etter piloten

Når evalueringen din er ferdig, har du tre alternativer. Hvis du vil fortsette å bruke Lectora selv, kreves ingenting videre — når tokenet ditt utløper, generer et nytt og oppdater det i Settings → Canvas Connection. Hvis du vil rulle ut til hele skolen, gi LTI 1.3 admin-installasjonsveiledningen til Canvas-administratoren din; etter at hen har installert den institusjonsbredt, starter hver underviser Lectora fra emnesidemenyen uten PAT-oppsett per underviser. Hvis du vil slutte å bruke Lectora, kall tilbake tokenet i Canvas (Settings → Approved Integrations → søppelbøtteikon ved siden av Lectora-tokenet ditt), og slett deretter Lectora-kontoen din eller bare slutt å logge inn.

Du må strengt tatt ikke — men LTI 1.3 krever at en Canvas-administrator installerer Lectora på institusjonsnivå (admin-installasjonsveiledningen går gjennom det, omtrent 15 minutter for hen). PAT-veien lar én underviser evaluere Lectora uten å involvere IT. Når du har bestemt deg for å rulle ut bredere, er LTI-installasjonen den kompatible veien; PAT er det lettere startpunktet.