Skip to main content

Ally för D2L BrightSpace-integrering

Följ dessa steg för att integrera Ally med din D2L BrightSpace-instans:

  1. Skapa användare och roller. Detta måste göras innan något samtal med din Anthology Ally-kontakt.

  2. Huvudkonfiguration

  3. Konfigurera LTI

    • Klientkonfiguration

    • Lärosätesrapport

    • Kurstillgänglighetsrapport

Skapa användare och roller.

  1. Skapa en ny roll 

    1. Från inställningsmenyn (kugghjulsikon) navigerar du till Roller och behörigheter 

    2. Starta processen för att skapa roll genom att välja knappen Skapa/Kopiera 

    3. Skapa en ny tom roll genom att välja knappen Börja om 

    4. Rollinställningar: 

      • Namn: Allierad REST Roll 

      • Beskrivning: Uppsättningen av behörigheter som tillåter Ally att säkert kommunicera med Brightspace REST-API:erna 

      • Aktivera kaskadroll 

        Låt alternativet Primär Facilitator vara avstängt eftersom det kanske inte längre behövs

      • Rollalias: allierad 

      • Inga ändringar behöver göras under Verktyg för beteendealternativ, allt kan förbli inaktiverat 

      • Inga ändringar behöver göras under Classlist Display Options, allt kan förbli inaktiverat 

      • Under Kursåtkomstalternativ: 

        • Aktivera alla åtkomstalternativ: 

          • Få tillgång till inaktiva kurser 

          • Tillgång till tidigare kurser 

          • Få tillgång till framtida kurser 

        • Sektioner och grupper kan förbli inställda på Ingen av ovanstående 

    5. Rollinteraktioner: 

      1. Under Inskrivning av Ally REST-roll markerar du kryssrutan mellan raden Administratör och kolumnen Organisation. Detta möjliggör att en användare med denna roll kan skapas senare. 

      2. Under Sök efter Ally REST-roll markerar du kryssrutan mellan raden Administratör och kolumnen Organisation. Detta möjliggör sökning efter en användare med denna roll senare. 

      3. Inga ytterligare ändringar krävs.

  2. Konfigurera rollens behörigheter 

    När den är sparad kommer den nya allierade REST-rollen att visas längst ner i rolllistan. Öppna rullgardinsmenyn och välj Redigera behörigheter. I det här fönstret måste följande behörigheter beviljas: 

    1. Filtrera efter Innehållsverktyget och ge följande behörigheter i kolumnen Kursutbud: 

      • Visa kursinnehåll 

      • Kompilera och ladda ner innehåll 

      • Ladda ner innehållsämnen 

      • Visa innehåll som inte släpps 

      • Hantera innehåll 

      • Skapa och redigera moduler och ämnen 

      • Ta bort moduler och ämnen (nödvändigt för att radera bilder som potentiellt kan framkalla anfall)

    2. Kurshanteringskonsol

      • Se kursinformation (kursutbud). Denna behörighet krävs för att Ally ska kunna hämta avdelningens organisatoriska enheter.

    3. Klasslista

      • Har åtkomst till klasslistan

    4. Diskussioner 

      • Visa diskussioner (Kursutbud)

        Detta är nödvändigt för att lista länkar till diskussionsämnen i en kurs och dess innehållsförteckning. 

    5. Quiz 

      • Visa Quiz (kursutbud)

        Detta är nödvändigt för att lista länkar till Quiz innehållsförteckningen för en kurs. 

    6. Org enhetsredigerare 

      • Visa Org Unit Redigerare (Organisation)  

      • Kan lägga till och redigera organisationsenhetstyper (organisation).

        Vi behöver den här rollen för att lista terminerna. Tyvärr går det inte att välja skrivskyddad behörighet. Ally kommer aldrig att skapa eller redigera information om organisationsenheter.

    7. Säkerhet 

      • Se Roller och behörigheter (organisation)

    8. Integritet för användarinformation

      1. Se användarnamn (kursutbud)

        Denna behörighet tillåter Ally att se användarens identifierare, men inget annat. Den här informationen lagras aldrig, men av tekniska skäl är det nödvändigt att fastställa hur många deltagare som är inskrivna i en kurs.

      2. Se Förnamn (Organisation)

        Nödvändigt för att hämta användarens namn och e-postadress när de begär hjälp. Detta lagras aldrig av Ally och används endast tillfälligt i samband med hjälpmeddelandet.

      3. Se efternamn (organisation)

        Nödvändigt för att hämta användarens namn och e-postadress när de begär hjälp. Detta lagras aldrig av Ally och används endast tillfälligt i samband med hjälpmeddelandet.

      4. Se e-postadresser (organisation)

        Nödvändigt för att hämta användarens namn och e-postadress när de begär hjälp. Detta lagras aldrig av Ally och används endast tillfälligt i samband med hjälpmeddelandet.

    9. Användare

      1. Visa användarinskrivningar (kurserbjudande)

      2. Sök efter 'deltagare' (kursutbud)

        Deltagare är standardnamnet för deltagarrollen. Om ditt lärosäte använder ett annat namn för den här användartypen aktiverar du Sök efter ”...” istället. Detta är nödvändigt för att hämta antalet deltagare i ett kurserbjudande. De data som skickas är anonyma.

      3. Visa användarnas e-postadress (organisation)

        Det är nödvändigt att hämta användarens e-post när de begär hjälp. Detta lagras aldrig av Ally och används endast tillfälligt i samband med hjälpmeddelandet.

      4. Se Användarhanteringsverktyget (Organisation)

        Det är nödvändigt att hämta användarens namn och e-postadress när de begär hjälp. Detta lagras aldrig av Ally och används endast tillfälligt i samband med hjälpmeddelandet.

  3. Användarskapande

    När rollen har konfigurerats kan en ny användare skapas med denna begränsade uppsättning behörigheter. 

    1. Från menyn Inställningar (kugghjulsikon), gå till Användare 

    2. Starta processen för att skapa roll genom att välja knappen Ny användare 

    3. Inställningar: 

      • Förnamn: Ally 

      • Efternamn: Användare 

      • Roll: Allierad REST Roll 

      • Användarnamn: allyuser 

      • Välj Ställ in lösenord manuellt och ange ett lämpligt säkert lösenord i fältet Lösenord. Det är viktigt att lösenordet är säkert eftersom allt måste konfigureras igen om lösenordet ska ändras vid ett senare tillfälle.

      • Spara användaren genom att välja knappen Spara  

Huvudkonfiguration

Viktigt

Se till att konfigurationen av användare och roll görs först. Följande konfiguration ska göras under ett samtal med en Anthology Ally-kontakt. Se till att konfigurationssamtalet schemaläggs först.

  1. I menyn Inställningar (kugghjulsikonen) ska du välja Hantera utökningsbarhet

  2. Se till att du befinner dig på fliken OAuth 2.0

  3. Välj knappen Registrera en app

  4. Fyll i formuläret på följande sätt:

    • Namn: Ally

    • Omdirigerad URI: <Omdirigerad URI tillhandahållen av Anthology-kontakten>

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

    • Omfattning: innehåll:*:läs innehåll:fil:skriv kärna:*:* anpassad:innehållåtkomst:läs inskrivning:orgunit:läs

    • Prompt för användarens samtycke: Nej

    • Aktivera uppdateringstoken: Ja

    • Jag accepterar avtalet för icke-kommersiell utvecklare: Ja

  5. Välj knappen Registrera

  6. Du kommer nu att få information om det nyskapade programmet. Skriv ner klient-id och hemlig nyckel och dela dem med din Anthology Ally-kontakt.

  7. När du har fått bekräftelsen från Anthology Ally klickar du på Uppdatera

  8. Logga in på Brightspace som allyuser

  9. Gå till den webbadress som du fått av din Anthology Ally-kontakt (under klientintegreringsinformation för Ally-administratör). Även om det är ett URL vars värdnamn slutar på .ally.ac omdirigeras du automatiskt till din BrightSpace-instans. Brightspace visar ett fönster där du ska ge tillstånd till Ally att interagera med REST API. Klicka på Acceptera.

  10. Om allt gick bra bör följande framgångsmeddelande visas: REST-integrationen har upprättats framgångsrikt!

  11. I menyn Inställningar (kugghjulsikonen) ska du välja Config Variable Browser

  12. Hitta Ally-konfigurationerna genom att använda trädmenyn till vänster: 3rdParty > Ally

    Allierades integration finns i d2l.3rdParty.Ally.*

  13. Lägg till konfigurationsvärdena med de som din Blackboard-kontakt har tillhandahållit dig

    • Klient-id

    • Klienthemlighet – Brightspace presenterar två inmatningar. Använd LTI-hemligheten för båda inmatningar.

    • ScriptUrl

  14. I menyn Inställningar (kugghjulsikonen) ska du välja Organisationsverktyg

  15. Leta upp raden för Ally-integreringen och klicka på kryssrutan så att den är ikryssad

Konfigurera LTI

Följ det här steget för att konfigurera LTI och registrera Ally-verktyg.