Skip to main content

Ally für D2L Brightspace-Integration

Um Ally in Ihre D2L Brightspace-Instanz zu integrieren, müssen Sie die folgenden Schritte durchführen:

  1. Erstellen von Benutzern und Rollen. Dies muss vor einem Anruf beim Kontakt für Anthology Ally erledigt werden.

  2. Hauptkonfiguration

  3. LTI konfigurieren

    • Client-Konfiguration

    • Institutionsbericht

    • Bericht zur Kursbarrierefreiheit

Erstellen von Benutzern und Rollen

  1. Erstellen einer neuen Rolle 

    1. Navigieren Sie im Menü "Einstellungen" (Zahnradsymbol) zu Rollen und Berechtigungen 

    2. Starten Sie den Vorgang zum Erstellen einer Rolle, indem Sie auf die Schaltfläche Erstellen/Kopieren 

    3. Erstellen Sie eine neue leere Rolle, indem Sie auf die Schaltfläche Neu starten klicken 

    4. Rolleneinstellungen: 

      • Name: Ally-REST-Rolle 

      • Beschreibung: Der Satz von Berechtigungen, die es Ally ermöglichen, sicher mit den Brightspace-REST-APIs zu kommunizieren 

      • Aktivieren Sie die Kaskadierende Rolle 

        Lassen Sie die Option Primary Facilitator deaktiviert, da sie möglicherweise nicht mehr benötigt wird

      • Rollenalias: ally 

      • Unter Tool-Verhaltensoptionen müssen keine Änderungen vorgenommen werden, alles kann deaktiviert bleiben 

      • Unter Anzeigeoptionen für Klassenlisten müssen keine Änderungen vorgenommen werden, alles kann deaktiviert bleiben 

      • Gehen Sie in den Kurszugriffsoptionen wie folgt vor: 

        • Aktivieren Sie alle Zugriffsoptionen: 

          • Auf inaktive Kurse zugreifen 

          • Greifen Sie auf vergangene Kurse zu 

          • Zugang zu zukünftigen Kursen 

        • Abschnitte und Gruppen können auf Keine der oben genannten Optionen gesetzt bleiben 

    5. Rolleninteraktionen: 

      1. Aktivieren Sie unter „ Enroll Ally REST Role“ (Ally REST-Rolle anmelden) das Kontrollkästchen am Schnittpunkt von Administratorzeile und Organisationsspalte. Dies ermöglicht es, später einen Benutzer mit dieser Rolle anzulegen. 

      2. Aktivieren Sie unter „Search Ally REST-Rolle“ (Ally Rest Rolle suchen) das Kontrollkästchen am Schnittpunkt von Administratorzeile und Organisationsspalte. Dies ermöglicht es, später nach einem Benutzer mit dieser Rolle zu suchen. 

      3. Es sind keine weiteren Änderungen erforderlich.

  2. Konfigurieren der Berechtigungen der Rolle 

    Nach dem Speichern wird die neue Ally-REST-Rolle am Ende der Rollenliste angezeigt. Öffnen Sie das Dropdown-Menü und wählen Sie Edit Permissions (Berechtigungen bearbeiten) aus. Auf diesem Bildschirm müssen die folgenden Berechtigungen erteilt werden: 

    1. Filtern Sie nach dem Content-Tool und erteilen Sie in der Spalte Kursangebot die folgenden Berechtigungen: 

      • Kursinhalte anzeigen 

      • Kompilieren und Herunterladen von Inhalten 

      • Themen zum Herunterladen von Inhalten 

      • Nicht freigegebene Inhalte anzeigen 

      • Verwalten von Inhalten 

      • Erstellen und Bearbeiten von Modulen und Themen 

      • Module und Themen löschen (notwendig, um potenziell anfallsauslösende Bilder zu löschen)

    2. Kursmanagementkonsole

      • Siehe Kursinfo (Kursangebot). Diese Berechtigung ist für das Abrufen der Organisationseinheiten der Abteilung durch Ally erforderlich.

    3. Kursliste

      • Hat Zugriff auf die Kursliste

    4. Diskussionen 

      • Diskussionen anzeigen (Kursangebot)

        Dies ist notwendig, um Links zu Diskussionsthemen in einem Kurs und dessen Inhaltsverzeichnis aufzulisten. 

    5. Quiz 

      • Quiz anzeigen (Kursangebot)

        Dies ist notwendig, um Links zu Quizfragen im Inhaltsverzeichnis eines Kurses aufzulisten. 

    6. Editor für Organisationseinheiten 

      • Organisationseinheiten-Editor anzeigen (Organisation)  

      • Kann Organisationseinheitentypen (Organisation) hinzufügen und bearbeiten.

        Wir benötigen diese Rolle, um die Semester aufzulisten. Leider ist keine „Schreibschutz“-Berechtigung verfügbar. Ally erstellt oder bearbeitet niemals Informationen vom Typ Organisationseinheit.

    7. Sicherheit 

      • Siehe „Rollen und Berechtigungen (Organisation)“

    8. Datenschutz für Benutzerinformationen

      1. Siehe Benutzernamen (Kursangebot)

        Mit dieser Berechtigung kann Ally die Kennung des Benutzers sehen, aber sonst nichts. Diese Informationen werden nie gespeichert. Aus technischen Gründen muss jedoch festgelegt werden, wie viele Teilnehmer für einen Kurs angemeldet sind.

      2. Siehe Vornamen (Organisation)

        Notwendig, um den Namen und die E-Mail-Adresse des Benutzers abzurufen, wenn er Hilfe anfordert. Diese Daten werden nie in Ally gespeichert und werden nur in der Hilfe-E-Mail weitergegeben.

      3. Siehe Nachnamen (Organisation)

        Notwendig, um den Namen und die E-Mail-Adresse des Benutzers abzurufen, wenn er Hilfe anfordert. Diese Daten werden nie in Ally gespeichert und werden nur in der Hilfe-E-Mail weitergegeben.

      4. Siehe E-Mail-Adressen (Organisation)

        Notwendig, um den Namen und die E-Mail-Adresse des Benutzers abzurufen, wenn er Hilfe anfordert. Diese Daten werden nie in Ally gespeichert und werden nur in der Hilfe-E-Mail weitergegeben.

    9. Benutzer

      1. Benutzeranmeldungen anzeigen (Kursangebot)

      2. Suche nach 'Teilnehmer' (Kursangebot)

        Teilnehmer ist der Standardname für die Teilnehmerrolle. Wenn Ihre Einrichtung einen anderen Namen für diesen Benutzertyp verwendet, aktivieren Sie stattdessen Nach „...“ suchen. Dies ist erforderlich, um die Teilnehmerzahl für ein Kursangebot abzurufen. Die gesendeten Daten werden anonymisiert.

      3. Anzeigen der E-Mail-Adresse der Benutzer (Organisation)

        Es ist notwendig, die E-Mail des Benutzers abzurufen, wenn er Hilfe anfordert. Diese Daten werden nie in Ally gespeichert und werden nur in der Hilfe-E-Mail weitergegeben.

      4. Weitere Informationen finden Sie unter dem Benutzerverwaltungstool (Organisation)

        Es ist notwendig, den Namen und die E-Mail-Adresse des Benutzers abzurufen, wenn er Hilfe anfordert. Diese Daten werden nie in Ally gespeichert und werden nur in der Hilfe-E-Mail weitergegeben.

  3. Benutzererstellung

    Sobald die Rolle konfiguriert wurde, kann ein neuer Benutzer mit diesen eingeschränkten Berechtigungen erstellt werden. 

    1. Navigieren Sie im Menü „Einstellungen‟ (Zahnradsymbol) zu „Benutzer‟ 

    2. Starten Sie den Prozess zum Erstellen einer Rolle, indem Sie auf die Schaltfläche Neuer Benutzer klicken 

    3. Einstellungen: 

      • Vorname: Ally 

      • Nachname: Benutzer 

      • Rolle: Ally REST-Rolle 

      • Benutzername: allyuser 

      • Wählen Sie Manually set password (Kennwort manuell festlegen) aus und geben Sie ein entsprechend sicheres Kennwort in das Kennwortfeld ein. Es ist wichtig, dass dieses Kennwort ausreichend sicher ist, da eine spätere Änderung eine weitere Einrichtung erforderlich macht.

      • Speichern Sie den Benutzer, indem Sie auf die Schaltfläche Speichern  

Hauptkonfiguration

Wichtig

Vergewissern Sie sich, dass die Konfiguration von Benutzern und Rollen zuerst erfolgt. Die folgende Konfiguration erfolgt während eines Anrufs mit einem Anthology Ally-Kontakt. Stellen Sie sicher, dass zuerst ein Termin für den Konfigurationsanruf geplant wurde.

  1. Navigieren Sie im Einstellungenmenü (Zahnradsymbol) zu Manage extensibility (Erweiterbarkeit verwalten).

  2. Stellen Sie sicher, dass Sie sich auf der Registerkarte „OAuth 2.0“ befinden

  3. Wählen Sie die Schaltfläche App registrieren

  4. Füllen Sie das Formular wie folgt aus:

    • Name: Verbündeter

    • Weiterleitungs-URI: <Weiterleitungs-URI vom Anthology-Kontakt bereitgestellt>

      z.B. https://[Ally env]/api/v1/d2l/callback?clientId=[Ally Client ID]

    • Bereich: content:*:read content:file:write core:*:* custom:contentaccess:read Anmeldung:orgunit:read

    • Aufforderung zur Einwilligung des Benutzers: Nein

    • Aktualisierungstoken aktivieren: Ja

    • Ich akzeptiere die Vereinbarung für nichtkommerzielle Entwickler: Ja

  5. Wählen Sie die Schaltfläche Registrieren

  6. Ihnen werden nun die Details der neu erstellten Anwendung präsentiert. Kopieren Sie die Client-ID und den geheimen Schlüssel und geben Sie sie an Ihren Anthology Ally-Kontakt weiter.

  7. Nachdem die Bestätigung von Anthology Ally erhalten haben, wählen Sie Update (Aktualisieren) aus

  8. Als „allyuser“ bei Brightspace anmelden

  9. Gehen Sie zu der URL, die Ihr Anthology Ally-Kontakt (in den Client-Integrationsdetails für den Ally-Administrator) bereitgestellt hat. Obwohl es sich um eine URL handelt, deren Hostname mit „.ally.ac“ endet, werden Sie automatisch zu Ihrer Brightspace-Instanz umgeleitet. Brightspace zeigt einen Bildschirm an, in dem Sie um Erlaubnis geben werden, dass Ally mit der REST-API interagieren darf. Wählen Sie Akzeptierenaus.

  10. Wenn alles gut gegangen ist, sollte folgende Erfolgsmeldung angezeigt werden: Die REST-Integration wurde erfolgreich eingerichtet!

  11. Navigieren Sie im Einstellungenmenü (Zahnradsymbol) zu „Variable Config Browser“ (Variabler Konfigurationsbrowser)

  12. Suchen Sie die Ally-Konfigurationen über das Strukturmenü auf der linken Seite: 3rdParty > Ally

    Die Ally-Integration befindet sich in d2l.3rdParty.Ally.*

  13. Fügen Sie die Konfigurationswerte mit den Werten hinzu, die Sie von Ihrem Blackboard-Kontakt erhalten haben

    • ClientId

    • ClientSecret – Brightspace zeigt zwei Eingaben an. Verwenden Sie dem geheimen LTI-Schlüssel für beide Eingaben.

    • ScriptUrl

  14. Navigieren Sie im Einstellungenmenü (Zahnradsymbol) zu Organizational Tools (Organisations-Tools)

  15. Suchen Sie die Zeile für die Ally-Integration und aktivieren Sie das Kontrollkästchen

LTI konfigurieren

Befolgen Sie diesen Schritt, um die LTI zu konfigurieren und Ally registrieren.