Skip to main content

Ally for D2L Brightspace-integrering

For å integrere Ally med D2L Brightspace-forekomsten din må du følge disse trinnene:

  1. Bruker- og rolleopprettelse. Dette må gjøres før eventuelle anrop med Anthology Ally-kontakten.

  2. Hovedkonfigurasjon

  3. Konfigurer LTI

    • Klientkonfigurasjon

    • Institusjonsrapport

    • Emnetilgjengelighetsrapport

Bruker- og rolleopprettelse

  1. Opprett en ny rolle 

    1. Fra innstillingsmenyen (tannhjulsikon) navigerer du til Roller og tillatelser 

    2. Start prosessen med å opprette en rolle ved å velge knappen Lag/Kopier 

    3. Opprett en ny tom rolle ved å velge knappen Start på nytt 

    4. Rolleinnstillinger: 

      • Navn:  Ally REST-rolle 

      • Beskrivelse: Settet med tillatelser som gjør det mulig for Ally å kommunisere sikkert med Brightspace REST-API-ene 

      • Aktiver kaskaderende rolle 

        La Primærfasilitator alternativet være deaktivert siden det kanskje ikke lenger trengs

      • Rollealias:  ally 

      • Det er ikke nødvendig å gjøre endringer under Tool Behavior Options, alt kan forbli deaktivert 

      • Det er ikke nødvendig å gjøre endringer under Classlist Display Options, alt kan forbli deaktivert 

      • Under Alternativer for emnetilgang: 

        • Aktiver alle tilgangsalternativer: 

          • Få tilgang til inaktive kurs 

          • Få tilgang til tidligere kurs 

          • Få tilgang til fremtidige kurs 

        • Seksjoner og grupper kan forbli satt til Ingen av de ovennevnte 

    5. Rolleinteraksjoner: 

      1. Under Registrer Ally REST-rolle merker du av i skjæringspunktet mellom administratorraden og organisasjonskolonnen. Dette gjør det mulig å opprette en bruker med denne rollen senere. 

      2. Under Søk Ally REST-rolle merker du av i avmerkingsboksen i skjæringspunktet mellom administratorraden og organisasjonskolonnen. Dette gjør det mulig å søke etter en bruker med denne rollen senere. 

      3. Ingen ytterligere endringer er nødvendig .

  2. Konfigurer rollens tillatelser 

    Når den er lagret, vil den nye Ally REST-rollen vises nederst i rollelisten. Åpne rullegardinlisten og velg Rediger tillatelser. I dette skjermbildet må følgende tillatelser gis: 

    1. Filtrer etter Innholdsverktøyet og gi følgende tillatelser i kolonnen Kurstilbud: 

      • Se kursinnhold 

      • Kompil og last ned innhold 

      • Last ned innholdstemaer 

      • Se innhold som ikke er utgitt 

      • Administrer innhold 

      • Opprett og rediger moduler og temaer 

      • Slett moduler og temaer (nødvendig for å slette potensielt anfallsfremkallende bilder)

    2. Emneadministreringskonsoll

      •  Se Emneinformasjon (emnetilbud). Denne tillatelsen er nødvendig for Ally for å hente avdelingens organisasjonsenheter.

    3. Klasseliste

      • Har tilgang til klasselisten

    4. Diskusjoner 

      • Se diskusjoner (kurstilbud)

        Dette er nødvendig for å liste opp lenker til diskusjonstemaer i et kurs og dets innholdsfortegnelse. 

    5. Spørrekonkurranser 

      • Se quizer (kurstilbud)

        Dette er nødvendig for å liste lenker til quizer i kursets innholdsfortegnelse. 

    6. Redigeringsprogram for organisasjonsenhet 

      • Vis redigeringsprogram for organisasjonsenhet (organisasjon)   

      • Kan legge til og redigere organisasjonsenhetstyper (organisasjon).

        Vi trenger denne rollen for å liste opp semestre. Det er dessverre ingen "skrivebeskyttet" tillatelse som er tilgjengelig. Ally vil aldri opprette eller redigere informasjon om organisasjonsenhetstype.

    7. Sikkerhet 

      • Se Roller og tillatelser (organisasjon)

    8. Personvern for brukerinformasjon

      1. Se brukernavn (kurstilbud)

        Denne tillatelsen lar Ally se brukerens identifikator, men ingenting annet. Denne informasjonen blir aldri lagret, men av tekniske årsaker er det nødvendig å avgjøre hvor mange studenter som er påmeldt et emne.

      2. Se Fornavn (Organisering)

        Nødvendig for å hente brukerens Navn og E-post når de ber om hjelp. Dette lagres aldri fra Allys side og sendes bare gjennom i e-posten for hjelp.

      3. Se etternavn (Organisering)

        Nødvendig for å hente brukerens Navn og E-post når de ber om hjelp. Dette lagres aldri fra Allys side og sendes bare gjennom i e-posten for hjelp.

      4. Se E-postadresser (Organisering)

        Nødvendig for å hente brukerens Navn og E-post når de ber om hjelp. Dette lagres aldri fra Allys side og sendes bare gjennom i e-posten for hjelp.

    9. Brukere

      1. Se brukerpåmeldinger (emnetilbud)

      2. Søk etter 'Student' (kurstilbud)

        Student er standardnavnet for studentrollen. Hvis institusjonen din bruker et annet navn for denne brukertypen, aktiverer du Søk etter '...' i stedet. Dette er nødvendig for å hente studentantallet i et emnetilbud. Dataene som sendes, anonymiseres.

      3. Se brukernes e-postadresse (organisering)

        Det er nødvendig å hente brukerens E-post når de ber om hjelp. Dette lagres aldri fra Allys side og sendes bare gjennom i e-posten for hjelp.

      4. Se Brukeradministrasjonsverktøyet (Organisering)

        Det er nødvendig å hente brukerens Navn og E-post når de ber om hjelp. Dette lagres aldri fra Allys side og sendes bare gjennom i e-posten for hjelp.)

  3. Brukeropprettelse

    Når rollen er konfigurert, kan en ny bruker opprettes med dette begrensede settet av tillatelser. 

    1. Fra Innstillinger-menyen (tannhjulsikon), gå til Brukere 

    2. Start prosessen med å opprette rolle ved å velge Ny bruker-knappen. 

    3. Innstillinger: 

      • Fornavn: Ally 

      • Etternavn: Bruker 

      • Rolle:  Ally REST-rolle 

      • Brukernavn: allyuser 

      • Velg Angi passord manuelt, og skriv inn et passende sikkert passord i Passord-feltet. Det er avgjørende at dette passordet er tilstrekkelig sikkert, fordi hvis du endrer det senere, må du konfigurere alt på nytt.

      • Lagre brukeren ved å velge Save -knappen 

Hovedkonfigurasjon

Viktig

Sørg for at bruker- og rollekonfigurasjonen gjøres først. Følgende konfigurasjon gjøres i en samtale med en Anthology Ally-kontakt. Sørg for at konfigurasjonsanropet er planlagt først.

  1. Fra Innstillinger-menyen (tannhjulsikon) navigerer du til Administrer utvidbarhet'

  2. Sørg for at du er i OAuth 2.0-fanen

  3. Velg knappen Registrer en app

  4. Fyll ut skjemaet slik:

    • Navn: Ally

    • Omdiriger URI: <Omdiriger URI levert av Anthology-kontakt>

      f.eks. https://[Ally env]/api/v1/d2l/callback?clientId=[Ally client ID]

    • Omfang: innhold:*:les innhold:fil:skriv kjerne:*:* tilpasset:innholdtilgang:les påmelding:orgunit:les

    • Forespørsel om brukersamtykke: Nei

    • Aktiver oppdateringstokens: Ja

    • Jeg aksepterer avtalen om ikke-kommersielle utviklere: Ja

  5. Velg Registrer -knappen

  6. Nå får du se detaljene for den nyopprettede applikasjonen. Kopier ned klient-ID-enog den hemmelige nøkkelen, og del dem med din Anthology Ally-kontakt.

  7. Når du har mottatt bekreftelse av Anthology Ally, velger du Oppdater

  8. Logg på Brightspace som allyuser

  9. Gå til URL du har fått av din Anthology Ally-kontakt (under Ally detaljer om integrering av administratorklienten). Selv om dette er en URL hvis vertsnavn slutter på .ally.ac, blir du automatisk viderekoblet til Brightspace-forekomsten din. Brightspace viser en skjerm hvor du blir spurt om tillatelse for at Ally kan samhandle med REST-API. Velg Godta.

  10. Hvis alt gikk bra, skal følgende suksessmelding vises: REST-integrasjonen er vellykket satt opp!

  11. I Innstillinger-menyen (tannhjulikon) går du til Konfigurer variabel nettleser

  12. Finn Ally-konfigurasjonene ved å bruke tremenyen til venstre: 3rdParty > Ally

    Ally ally-integrasjonen lever i d2l.3rdParty.Ally.*

  13. Legg til konfigurasjonsverdiene med de du har fått av din Blackboard-kontakt

    • ClientId

    • ClientSecret – Brightspace presenterer to inndata. Bruk LTI-hemmeligheten for begge inndataene.

    • ScriptUrl

  14. Fra Innstillinger-menyen (tannhjulikon) navigerer du til Organisasjonsverktøy

  15. Finn raden for Ally-integrasjonen, og merk av i boksen, slik at den er slått på

Konfigurer LTI

Følg dette trinnet for å konfigurere LTI og registrere Ally-verktøyene.