Generer et tilgangstoken for Ally

Ally må kunne synkronisere data som emner og filer fra Canvas REST API for å kunne generere rapporter og komme med undervisertilbakemelding. For at dette skal gjøres på en sikker måte, må det genereres et tilgangstoken.

Dette er bare tilgjengelig for administratorer i Instructure Canvas LMS.


Trinn 1: Opprett en ny kontorolle

Når du har en ny kontorolle, kan du definere tillatelsene Ally-tjenesten skal ha. Du kan se hvilke spesifikke tillatelser Ally-tjenesten har fått, i administreringsgrensesnittet for Canvas, og på overordnet nivå gjør disse tillatelsene det mulig for Ally å laste ned informasjon om semestre, emner og filer for generering av tilbakemelding om tilgjengelighet og alternative versjoner. De gjør det også mulig for Ally å slette og erstatte filinnhold, noe som er viktige handlinger for å hjelpe undervisere med å utbedre emneinnhold.

  1. Logg på Canvas-installasjonen din som administrator.
  2. Velg Administrator-ikonet i navigasjonen på venstre side, og velg kontoen din i vinduet som åpnes.
  3. Velg Tillatelser og deretter Kontoroller.
  4. Velg Legg til rolle.
  5. Lagre en rolle du kaller Ally. Deretter bør tabellen inneholde en ny kolonne som heter Ally.
  6. I Ally-kolonnen kan du aktivere disse tillatelsene.
    • Emner – se listen
    • Brukere – handle som
    • Kunngjøringer – se
    • Oppgaver og quizer – legge til / redigere / slette
    • Emneinnhold – legge til / redigere / slette
    • Emneinnhold – se
    • Emnefiler – legge til / redigere / slette
    • Diskusjoner – moderere
    • Diskusjoner – se
    • Sider – legge til / redigere / slette

Trinn 2: Opprett en ny bruker

Det anbefales å opprette en ny bruker for hver integrering med Canvas. Hvis brukere på institusjonen din opprettes direkte i Canvas, kan du følge disse instruksjonene for å gjøre det. Men hvis brukerne administreres i et eksternt system, for eksempel SIS eller LDAP, bør du følge prosessen for å opprette brukere for bruk i Canvas for institusjonen din. Deretter kan du gi den nye brukeren Ally-rollen.

Hvis brukere opprettes direkte i Canvas for institusjonen din, bør du følge disse trinnene.

  1. Gå til Users-siden (brukere) under kontoadministreringen.
  2. Velg New User (ny bruker), og legg til en bruker du kaller Ally.
  3. Sørg for at det er merket av for Email the user about this account creation (send brukeren en e-post om at kontoen er opprettet).
  4. Klikk på lenken du fikk på e-post, for å bekrefte kontoen.

Trinn 3: Gi den nye brukeren Ally-rollen

  1. Gå til Settings-siden (Innstillinger) under kontoadministreringen.
  2. Velg Admins (administratorer).
  3. Velg + Account Admins-knappen (flere kontoadministratorer) for å legge til brukeren.
  4. Sørg for at Ally-rollen er valgt i menyen i skjemaet som åpnes.
  5. Hvis brukere på institusjonen din opprettes direkte i Canvas, blir du bedt om å legge inn e-postadressen til brukeren du opprettet i den forrige delen. Hvis brukeren ble opprettet i et eksternt system, for eksempel SIS eller LDAP, må du legge inn identifikatoren for brukeren Canvas ber om, i feltet.
  6. Velg Continue... (fortsett).
  7. Hvis brukeren blir funnet, velger du OK Looks Good (Ok, det ser bra ut).
  8. Bekreft at Ally-brukeren er lagt til i listen.

Trinn 4: Generer et tilgangstoken

I dette siste trinnet genererer vi et tilgangstoken som Ally-tjenesten kan brukes for å samhandle med REST API på en trygg og sikker måte.

  1. Logg på som Ally-brukeren.

    Du må faktisk logge på som Ally-brukeren i disse trinnene, fordi Canvas forbyr at administratorer konfigurerer tilgangstokener på andres vegne.

  2. Naviger til brukerinnstillingene ved å velge Account (konto) i navigasjonen til venstre og deretter Settings-lenken (innstillinger) i det nye vinduet.
  3. Velg New Access Token (nytt tilgangstoken).
  4. Skriv inn Ally.ac integration (integrering med Ally.ac) som formål for tokenet. Feltet for tidsstempelet for utløp kan stå tomt.
  5. Velg Generate Token (generer tokenet).
  6. Nå skal det åpnes et nytt vindu som inneholder tilgangstokenet. Kopier dette tokenet nå – du ikke får tilgang til det igjen når du lukker denne siden.