Hoe beheer ik als beheerder API-toegangstokens?

Je kunt API-toegangstokens beheren met behulp van je Gebruikersinstellingen. Toegangstokens geven toegang tot Canvas-bronnen via de Canvas API. Toegangstokens kunnen automatisch worden gegenereerd voor toepassingen van derden, maar kunnen ook handmatig worden gemaakt.

Met behulp van de Canvas API heeft de houder van het toegangstoken toegang tot dezelfde Canvas-bronnen als jij. Toepassingen van derden, met inbegrip van apparaten waarmee je de mobiele app van Canvas hebt geopend, zijn gemachtigd namens jou Canvas te openen. API-oproepen vereisen autorisatie en worden verzonden namens een geautoriseerde gebruiker.  Raadpleeg de documentatie bij Canvas API voor meer informatie over Canvas API.

Zodra je aanmeldgegevens voor Canvas hebt, kun je een van deze toegangstokens aanmaken en ze gebruiken om je ontwikkelprojecten te testen. Dit token moet als een URL-queryparameter worden opgenomen in elke API-oproep die naar Canvas worden verzonden.

Canvas-tokens zijn gekoppeld aan Canvas-machtigingen. Als je Canvas-account wordt verwijderd, worden je tokens ingetrokken. Als je niet langer een beheerdersrol hebt in Canvas, worden de eerder tokens die je eerder hebt gegenereerd aangepast aan je nieuwe machtigingen.

Opmerking:

  • Gebruikers met privileges om maskers toe te passen kunnen geen token verwijderen namens andere gebruikers.
  • Canvas-beheerders kunnen niet in bulk API-toegangstokens verwijderen voor gebruikers van hun instituut.

Gebruikersinstellingen openen

Gebruikersinstellingen openen

Klik in Globale navigatie op de link Account [1] en klik daarna op de link Instellingen (Settings) [2].

Toegangstokens bekijken

Toepassingen van derden met toegangstokens en door gebruikers gegenereerde toepassingstokens worden vermeld in de sectie Goedgekeurde integraties [1].

Voor elk toegangstoken kun je de naam [2], het doel [3], de vervaldatum [4] en de datum van het laatste gebruik [5] bekijken.

Toegangstoken toevoegen

Toegangstoken toevoegen

Klik je op de knop Nieuw toegangstoken toevoegen (Add New Access Token) om een toegangstoken toe te voegen.

Tokendetails toevoegen

Tokendetails toevoegen

Voer in het veld Doel (Purpose) [1] een beschrijving in voor je toegangstoken. Je kunt ook een vervaldatum selecteren door op het kalenderpictogram te klikken [2]. Voor een token zonder vervaldatum laat je het veld Vervalt (Expires) leeg.

Klik op de knop Token genereren (Generate Token) [3] om een nieuw toegangstoken te maken.

Toegangstoken bekijken

Toegangstoken bekijken

Bekijk de beschrijving bij het token [1]. Klik op link details [2] om details van het token te bekijken.

Tokendetails bekijken

Tokendetails bekijken

De toegangstokendetails omvatten een token waarmee API-aanroepen namens jou kunnen worden gemaakt [1].

Klik op de knop Token opnieuw genereren (Regenerate Token) [2] om een toegangstoken opnieuw te genereren.

Toegangstoken verwijderen

Toegangstoken verwijderen

Klik op het pictogram Verwijderen om een toegangstoken te verwijderen.

Verwijdering bevestigen

Verwijdering bevestigen

Klik op OK om het verwijderen te bevestigen.