Ally muss Daten, wie Kurse und Dateien, von der Canvas REST-API synchronisieren, um Berichte zu generieren und Dozenten-Feedback bereitzustellen. Um dies sicher durchzuführen, muss ein Zugriffstoken generiert werden.

Dies steht nur Administratoren im Instructure Canvas-LMS zur Verfügung.


Schritt 1: Eine neue Kontorolle erstellen

Mit einer neuen Kontorolle können Sie die Berechtigungen für den Ally-Service definieren. In der Canvas-Verwaltungsoberfläche können Sie genau sehen, welche Berechtigungen dem Ally-Service erteilt wurden. Allgemein ermöglichen diese Berechtigungen Ally Informationen zu Kursabschnitten Kursen und Dateien herunterzuladen, um Feedback zur Barrierefreiheit und alternative Versionen zu generieren. Zudem kann Ally so Dateiinhalte löschen und ersetzen. Diese Vorgänge sind zur Unterstützung von Dozenten beim Korrigieren ihres Kursinhalts wichtig.

  1. Melden Sie sich bei Ihrer Canvas-Installation als Administrator an.
  2. Klicken Sie im linken Navigationsbereich auf das Symbol Admin und wählen Sie in dem angezeigten Fenster Ihr Konto aus.
  3. Wählen Sie Berechtigungen und dann Kontorollen aus.
  4. Wählen Sie Rolle hinzufügen aus.
  5. Speichern Sie eine Rolle mit dem Namen Ally. Nachdem Speichern sollte in der Tabelle eine neue Spalte mit dem Namen Ally enthalten sein.
  6. Aktiveren Sie in der Spalte Ally diese Berechtigungen.
    • Kurse – Liste anzeigen
    • Benutzer – fungieren als
    • Ankündigungen – anzeigen
    • Aufgaben und Quiz – hinzufügen/bearbeiten/löschen
    • Kursinhalt – hinzufügen/bearbeiten/löschen
    • Kursinhalt – anzeigen
    • Kursdateien – hinzufügen/bearbeiten/löschen
    • Diskussionen – moderieren
    • Diskussionen – anzeigen
    • Seiten – hinzufügen/bearbeiten/löschen

Schritt 2: Einen neuen Benutzer erstellen

Als Best Practice gilt für jede Integration in Canvas einen neuen Benutzer zu erstellen. Wenn Benutzer für Ihre Institution direkt in Canvas erstellt werden, befolgen Sie dafür diese Anweisungen. Wenn Benutzer allerdings in einem externen System, wie SIS oder LDAP, verwaltet werden, befolgen Sie das Verfahren zum Erstellen von Benutzern für die Verwendung in Canvas für Ihre Institution und fahren Sie dann mit dem Erteilen der Ally-Rollen für den neuen Benutzer fort.

Führen Sie diese Schritte aus, wenn Benutzer für Ihre Institution direkt in Canvas erstellt werden.

  1. Navigieren Sie in Ihrer Kontoverwaltung zur Seite Benutzer.
  2. Wählen Sie Neuer Benutzer aus und fügen Sie einen neuen Benutzer mit dem Namen Ally hinzu.
  3. Vergessen Sie nicht, das Kontrollkästchen Benutzer über diese Kontoerstellung per E-Mail informieren zu aktivieren.
  4. Klicken Sie auf den Link, den Sie in Ihrem E-Mail-Postfach erhalten haben, um das Konto zu bestätigen.

Schritt 3: Dem neuen Benutzer die Ally-Rolle zuteilen

  1. Navigieren Sie in Ihrer Kontoverwaltung zur Seite Benutzer.
  2. Wählen Sie Admins aus.
  3. Klicken Sie auf die Schaltfläche + Konto-Admins, um den Benutzer hinzuzufügen.
  4. Überprüfen Sie, ob im daraufhin geöffneten Formular im Menü die Rolle Ally ausgewählt ist.
  5. Wenn in Ihrer Institution Benutzer direkt in Canvas erstellt werden, werden Sie aufgefordert, die E-Mail-Adresse des Benutzers, den Sie im vorherigen Schritt erstellt haben, einzugeben. Wenn Ihr Benutzer in einem externen System, wie SIS oder LDAP, erstellt wurde, geben Sie den von Canvas angeforderten Bezeichner des Benutzers in das Feld ein.
  6. Wählen Sie Fortsetzen... aus.
  7. Wenn der Benutzer gefunden wurde, wählen Sie OK, bestätigen aus.
  8. Überprüfen Sie, ob der Benutzer Ally der Liste hinzugefügt wurde.

Schritt 4: Ein Zugriffstoken generieren

In diesem letzten Schritt generieren Sie ein Zugriffstoken, mit dem der Ally-Service sicher mit der REST-API interagieren kann.

  1. Melden Sie sich als Benutzer Ally an.

    Das Maskieren als Ally-Benutzer funktioniert bei diesen Schritten nicht, da Canvas es Administratoren verbietet, ein Zugriffstoken für einen anderen Benutzer einzurichten.

  2. Navigieren Sie zu den Benutzereinstellungen, indem Sie im linken Navigationsbereich Konto auswählen und dann im neuen Fenster auf den Link Einstellungen klicken.
  3. Wählen Sie Neues Zugriffstoken aus.
  4. Geben Sie Ally.ac integration als Zweck des Token ein. Das Feld für das Ablaufdatum können Sie leer lassen.
  5. Wählen Sie Token generieren aus.
  6. Nun sollte ein neues Fenster angezeigt werden, das das Token enthält. Kopieren Sie dieses Token jetzt, da Sie nicht mehr darauf zugreifen können, wenn Sie das Fenster verlassen haben.