Skip to main content

Ally voor integratie met D2L Brightspace

Als je Ally wilt integreren met je D2L Brightspace-instantie, moet je deze stappen volgen:

  1. Aanmaken van gebruikers en rollen. Dit moet gebeuren voordat er contact wordt opgenomen met de contactpersoon van Anthology Ally.

  2. Hoofdconfiguratie

  3. Configureer LTI

    • Clientconfiguratie

    • Instellingsrapport

    • Cursustoegankelijkheidsrapport

Aanmaken van gebruikers en rollen 

  1. Creëer een nieuwe functie 

    1. Vanuit het instellingenmenu (tandwielpictogram) navigeer je naar Rollen en permissies 

    2. Start het proces van rol aanmaken door op de knop Maken/Kopiëren te kiezen 

    3. Maak een nieuwe lege rol aan door op de knop Start Fresh te kiezen 

    4. Rolinstellingen: 

      • Naam:  Ally REST Rol 

      • Beschrijving: De set machtigingen waarmee Ally veilig kan communiceren met de Brightspace REST API's 

      • Schakel Cascaderende Rol in 

        Laat de optie Primaire Facilitator uitgeschakeld omdat deze mogelijk niet meer nodig is

      • Rolalias:  Ally 

      • Er hoeven geen wijzigingen te worden gedaan onder Tool Behavior Options, alles kan uitgeschakeld blijven 

      • Er hoeven geen wijzigingen te worden gedaan onder Classlist Display Options, alles kan uitgeschakeld blijven 

      • Onder Cursustoegangsopties: 

        • Alle toegangsopties inschakelen: 

          • Toegang tot inactieve cursussen 

          • Toegang tot eerdere cursussen 

          • Toegang tot toekomstige cursussen 

        • Secties en Groepen kunnen blijven ingesteld op Geen van bovenstaande 

    5. Rolinteracties: 

      1. Vink onder Inschrijving Ally REST-rol het selectievakje aan op het snijpunt van de rij Beheerder en de kolom Organisatie. Dit maakt het mogelijk om later een gebruiker met deze rol aan te maken. 

      2. Vink onder Zoeken Ally REST-rol het selectievakje aan op het snijpunt van de rij Beheerder en de kolom Organisatie. Dit maakt het mogelijk om later naar een gebruiker met deze rol te zoeken. 

      3. Verdere wijzigingen zijn niet nodig.

  2. Configureer de rechten van de rol 

    Eenmaal opgeslagen verschijnt de nieuwe  Ally REST-rol onderaan de rollijst. Open het vervolgkeuzemenu en selecteer Machtigingen bewerken. In dit scherm moeten de volgende machtigingen worden toegekend: 

    1. Filter op de Content-tool en verleen de volgende rechten in de kolom Cursusaanbod: 

      • Bekijk cursusinhoud 

      • Inhoud compileren en downloaden 

      • Download Inhoudsonderwerpen 

      • Bekijk inhoud die niet is vrijgegeven 

      • Beheer Inhoud 

      • Maak en bewerk modules en onderwerpen 

      • Verwijder modules en onderwerpen (noodzakelijk om mogelijk epileptische afbeeldingen te verwijderen)

    2. Cursusbeheerconsole

      • Zie cursusinformatie (cursusaanbod). Deze machtiging is vereist voor Ally om de organisatie-eenheden van de afdeling op te halen.

    3. Cursusdeelnemers

      • Heeft toegang tot de Cursusdeelnemers 

    4. Discussies 

      • Bekijk discussies (Cursusaanbod)

        Dit is noodzakelijk om links naar discussieonderwerpen in een cursus en de inhoudsopgave te vermelden. 

    5. Quizzen 

      • Bekijk quizzen (Cursusaanbod)

        Dit is noodzakelijk om links naar quizzen in de inhoudsopgave van een cursus te vermelden. 

    6. Org Unit Editor 

      • Bekijk Org Unit Editor (Organisatie)  

      • Kan organisatie-eenheidstypen toevoegen en bewerken (organisatie).

        We hebben deze functie nodig om de semesters te vermelden. Helaas is er geen machtiging ‘Alleen-lezen’ beschikbaar. Ally zal nooit informatie over organisatie-eenheid maken of bewerken.

    7. Beveiliging 

      • Zie Rollen en machtigingen (organisatie)

    8. Privacy van gebruikersinformatie

      1. Zie Gebruikersnamen (Cursusaanbod)

        Deze toestemming stelt Ally in staat om de identificatie van de gebruiker te zien, maar verder niets. Deze informatie wordt nooit opgeslagen, maar om technische redenen moet je wel vaststellen hoeveel studenten er zijn ingeschreven voor een cursus.

      2. Zie voornamen (organisatie)

        Noodzakelijk om de naam en e-mail van de gebruiker te achterhalen wanneer ze om hulp vragen. Deze informatie wordt nooit opgeslagen bij Ally en wordt alleen doorgegeven in de Help-e-mail.

      3. Zie Achternamen (Organisatie)

        Noodzakelijk om de naam en e-mail van de gebruiker te achterhalen wanneer ze om hulp vragen. Deze informatie wordt nooit opgeslagen bij Ally en wordt alleen doorgegeven in de Help-e-mail.

      4. Zie e-mailadressen (organisatie)

        Noodzakelijk om de naam en e-mail van de gebruiker te achterhalen wanneer ze om hulp vragen. Deze informatie wordt nooit opgeslagen bij Ally en wordt alleen doorgegeven in de Help-e-mail.

    9. Gebruikers

      1. Inschrijvingen van gebruikers weergeven (cursusaanbod)

      2. Zoek op 'Student' (cursusaanbod)

        Student is de standaardnaam voor de studentenrol. Als je instelling een andere naam gebruikt voor dit type gebruiker, kun je in plaats daarvan Zoeken naar ‘...’ inschakelen. Dit is nodig om het aantal studenten in een cursusaanbod op te halen. De gegevens die worden verstuurd, worden anoniem gemaakt.

      3. Bekijk het e-mailadres van de gebruiker (organisatie)

        Het is noodzakelijk om het e-mailadres van de gebruiker op te halen wanneer hij om hulp vraagt. Deze informatie wordt nooit opgeslagen bij Ally en wordt alleen doorgegeven in de Help-e-mail.

      4. Zie de User Management Tool (Organisatie)

        Het is noodzakelijk om de naam en het e-mailadres van de gebruiker op te vragen wanneer hij om hulp vraagt. Deze informatie wordt nooit opgeslagen bij Ally en wordt alleen doorgegegeven in de Help-e-mail.)

  3. Gebruikerscreatie

    Zodra de rol is geconfigureerd, kan er met deze beperkte set rechten een nieuwe gebruiker worden aangemaakt. 

    1. Vanuit het instellingenmenu (tandwielpictogram) navigeer naar Gebruikers 

    2. Start het proces om een rol aan te maken door op de knop Nieuwe Gebruiker te kiezen 

    3. Instellingen: 

      • Voornaam: Ally 

      • Achternaam: Gebruiker 

      • Rol:  Ally REST Rol 

      • Gebruikersnaam: allyuser 

      • Selecteer Wachtwoord handmatig instellen en voer een veilig wachtwoord in het veld Wachtwoord in. Het is van essentieel belang dat dit wachtwoord veilig genoeg is. Als je het wachtwoord later gaat wijzigen, moet alles opnieuw worden ingesteld.

      • Sla de gebruiker op door op de Save knop te kiezen 

Hoofdconfiguratie

Belangrijk

Zorg ervoor dat eerst de Gebruiker en de Rol eerst worden geconfigureerd. De volgende configuratie wordt uitgevoerd tijdens een gesprek met een contactpersoon van Anthology Ally. Zorg ervoor dat het configuratiegesprek eerst wordt gepland.

  1. Ga vanuit het menu Instellingen (tandwielpictogram) naar Uitbreidbaarheid beheren

  2. Zorg ervoor dat je in het tabblad OAuth 2.0 bent

  3. Selecteer de knop Registreer een app

  4. Vul het formulier als volgt in:

    • Naam: Ally

    • Redirect URI: <Redirect URI geleverd door Anthology contact>

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

    • Scope: content:*:lees content:file:write core:*:* custom:contentaccess:read inschrijving:orgunit:read

    • Prompt voor gebruikerstoestemming: Nee

    • Schakel verversingstokens in: Ja

    • Ik accepteer de Non-Commercial Developer-overeenkomst: Ja

  5. Selecteer de Registreren knop

  6. Je krijgt nu de details te zien van de nieuwe toepassing. Kopieer de client-ID en geheime sleutel en deel deze met je contactpersoon van Anthology Ally.

  7. Nadat je bevestiging van Anthology Ally hebt ontvangen, selecteer je Bijwerken

  8. Meld je als de allyuser aan bij Brightspace

  9. Ga naar de URL die aan je is verstrekt door je contactpersoon van Anthology Ally (onder Clientintegratiedetails Ally-beheerder). Hoewel de URL eindigt op .ally.ac, word je automatisch omgeleid naar je Brightspace-instantie. Brightspace geeft een scherm weer waarin je wordt gevraagd Ally toestemming te geven om met de REST-API te communiceren. Selecteer Accepteren.

  10. Als alles goed ging, zou het volgende succesbericht moeten verschijnen: De REST-integratie is succesvol opgezet!

  11. Ga vanuit het menu Instellingen (tandwielpictogram) naar Variabele browser configureren

  12. Zoek de Ally-configuraties via het boommenu aan de linkerkant: 3rdParty > Ally

    De integratie van bondgenoten bevindt zich in d2l.3rdParty.Ally.*

  13. Voeg de configuratiewaarden toe aan die welke je door je Blackboard-contactpersoon wordt verstrekt

    • ClientId

    • ClientSecret – Brightspace geeft twee inputs weer. Gebruik het LTI-geheim voor beide inputs.

    • ScriptUrl

  14. Ga vanuit het menu Instellingen (tandwielpictogram) naar Organisatietools

  15. Zoek de rij voor de Ally-integratie en vink het selectievakje aan, zodat deze optie is ingeschakeld

Configureer LTI

Volg deze stap om de LTI te configureren en Ally-tools te registeren.