Een toegangstoken voor Ally genereren

Ally moet gegevens zoals cursussen en bestanden uit de Canvas REST API kunnen synchroniseren om rapporten te genereren en feedback voor de cursusleider te geven. Om dit op een veilige wijze te doen, moet er een toegangstoken worden gegenereerd.

Dit is alleen mogelijk voor beheerders in het LMS Instructure Canvas.


Stap 1: Een nieuwe accountrol maken

Met een nieuwe accountrol kun je de machtigingen definiëren die de Ally-service krijgt. In de Canvas-beheerinterface kun je zien welke specifieke machtigingen worden verleend aan de Ally-service. Deze machtigingen geven Ally op een hoog niveau de mogelijkheid om semester-, cursus- en bestandsgegevens te downloaden voor het genereren van toegankelijkheidsfeedback en alternatieve versies. Ally kan hiermee ook bestandsinhoud verwijderen en vervangen, wat belangrijke bewerkingen zijn die cursusleiders helpen hun cursusinhoud te verbeteren.

  1. Meld je aan als beheerder bij je Canvas-installatie.
  2. Selecteer het pictogram Beheerder in de navigatie aan de linkerkant en selecteer je account in het venster dat openschuift.
  3. Selecteer Machtigingen en selecteer Accountrollen.
  4. Selecteer Rol toevoegen.
  5. Sla een rol op met de naam Ally. Na het opslaan staat er een nieuwe kolom genaamd Ally in de tabel.
  6. In de kolom Ally schakel je deze machtigingen in.
    • Cursussen - lijst weergeven
    • Gebruikers - handelen als
    • Mededelingen - weergeven
    • Opdrachten en vragenlijsten - toevoegen/bewerken/verwijderen
    • Cursusinhoud - toevoegen/bewerken/verwijderen
    • Cursusinhoud - weergeven
    • Cursusbestanden - toevoegen/bewerken/verwijderen
    • Discussies - modereren
    • Discussies - weergeven
    • Pagina's - toevoegen/bewerken/verwijderen

Stap 2: Een nieuwe gebruiker maken

Het is een best practice om een nieuwe gebruiker te maken voor elke integratie met Canvas. Als gebruikers voor jouw instelling rechtstreeks in Canvas worden gemaakt, kun je deze instructies gebruiken om dit te doen. Als gebruikers echter worden beheerd in een extern systeem zoals SIS of LDAP, moet je de procedure volgen voor het maken van gebruikers voor gebruik in Canvas voor jouw instelling. Daarna ga je verder om de nieuwe gebruiker de rol Ally te geven.

Als gebruikers rechtstreeks in Canvas worden gemaakt voor jouw instelling, volg je deze stappen.

  1. Navigeer naar de pagina Gebruikers onder je accountbeheer.
  2. Selecteer Nieuwe gebruiker en voeg een nieuwe gebruiker toe met de naam Ally.
  3. Zorg ervoor dat het selectievakje Gebruiker e-mailen over het aanmaken van dit account is ingeschakeld.
  4. Selecteer de koppeling in je mailbox om het account te verifiëren.

Stap 3: De nieuwe gebruiker de Ally-rol geven

  1. Navigeer naar de pagina Instellingen onder je accountbeheer.
  2. Selecteer Beheerders.
  3. Selecteer de knop + Accountbeheerders om de gebruiker toe te voegen.
  4. Controleer in het formulier dat je nu ziet of de rol Ally is geselecteerd in het menu.
  5. Als gebruikers rechtstreeks in Canvas worden gemaakt bij jouw instelling, word je gevraagd om het e-mailadres van de gebruiker te in voeren die je hebt gemaakt in de vorige sectie. Als je gebruiker is gemaakt in een extern systeem zoals SIS of LDAP, voer je de ID van de gebruiker waar Canvas om vraagt in bij het betreffende veld.
  6. Selecteer Doorgaan...
  7. Als de gebruiker is gevonden, selecteer je Ok, ziet er goed uit.
  8. Controleer of de gebruiker Ally is toegevoegd aan de lijst.

Stap 4: Een toegangstoken genereren

In deze laatste stap genereren we een toegangstoken die de Ally-service kan gebruiken voor een veilige interactie met de REST API.

  1. Meld je aan als de gebruiker Ally.

    Als je inlogt met de credentials van de gebruiker Ally, werkt dit niet voor deze stappen aangezien Canvas niet toestaat dat beheerders een toegangstoken instellen namens een andere gebruiker.

  2. Navigeer naar de instellingen van de gebruiker door in de navigatie aan de linkerkant Account te selecteren en daarna in het nieuwe venster de koppeling Instellingen.
  3. Selecteer Nieuwe toegangstoken.
  4. Voer Ally.ac integratie in als doel van de token. Het verlooptijdstempelveld kan leeg blijven.
  5. Selecteer Token genereren.
  6. Er verschijnt een nieuw venster met de toegangstoken. Kopieer deze token nu, want als je deze pagina verlaat, kun je de token niet meer weergeven.