Wie verwalte ich als Admin API-Zugangs-Token?

Sie können API-Zugangstoken über Ihre Benutzereinstellungen verwalten. Zugangs-Token ermöglichen den Zugriff auf Canvas-Ressourcen über die Canvas-API. Zugangs-Token können automatisch für Anwendungen von Drittanbietern generiert oder manuell erstellt werden.

Die Verwendung der Canvas-API ermöglicht dem Inhaber des Zugangs-Tokens den Zugriff auf dieselben Canvas-Ressourcen, auf die Sie zugreifen können. Beispielsweise sind Anwendungen von Drittanbietern, einschließlich Geräten, die Sie zum Öffnen der Canvas-App für Mobilgeräte verwendet haben, berechtigt, in Ihrem Namen auf Canvas zuzugreifen. API-Aufrufe erfordern eine Autorisierung und werden im Namen einer autorisierten Person durchgeführt.  Weitere Informationen zur Verwendung von Canvas-API finden Sie in der Canvas API documentation.

Sobald Sie sich bei Canvas angemeldet haben, können Sie eines der Zugangs-Token erstellen, das Sie zum Testen Ihrer Entwicklungsprojekte verwenden können. Dieses Token muss als URL-Abfrageparameter in allen API-Aufrufen an Canvas enthalten sein.

Canvas-Token sind mit Canvas-Berechtigungen verknüpft. Wenn Ihr Canvas-Konto gelöscht wird, werden Ihre Token widerrufen. Wenn Sie keine administrative Rolle in Canvas mehr haben, werden Ihre zuvor erstellten Token an Ihre neuen Berechtigungen angepasst.

Hinweis:

  • Benutzer*innen mit Maskierungs-Rechten können das Token nicht im Namen anderer Benutzer*innen entfernen.
  • Canvas-Admins können API-Zugangs-Token für Benutzer*innen in ihrer Institution nicht massenweise löschen.

Benutzereinstellungen öffnen

Benutzereinstellungen öffnen

Klicken Sie in der globalen Navigation auf den Link Account (Konto) link [1] und dann auf den Link Settings (Einstellungen) [2].

Zugangs-Token anzeigen

Anwendungen von Drittanbietern mit Zugangs-Token und benutzergenerierten Zugangs-Token sind im Abschnitt Approved Integrations (Genehmigte Integrationen) aufgeführt [1].

Für jedes Zugangs-Token können Sie den Namen [2], den Zweck [3], das Ablaufdatum [4] und das Datum der letzten Verwendung [5] anzeigen.

Zugangstoken hinzufügen

Zugangstoken hinzufügen

Um ein Zugangs-Token hinzuzufügen, klicken Sie auf die Schaltfläche Add New Access Token (Neues Zugangs-Token hinzufügen).

Token-Details hinzufügen

Token-Details hinzufügen

Geben Sie im Feld Purpose (Verwendungszweck) [1] eine Beschreibung für Ihr Zugangs-Token ein. Sie können auch ein Ablaufdatum auswählen, indem Sie auf das Kalendersymbol [2] klicken. Um ein Token ohne Ablaufdatum zu generieren, lassen Sie das Feld Expires (Ablauf) leer.

Um ein neues Zugangs-Token zu generieren, klicken Sie auf die Schaltfläche Generate Token (Token generieren) [3].

Zugangs-Token anzeigen

Zugangs-Token anzeigen

Sehen Sie sich die Token-Beschreibung an [1]. Um Details zum Token anzuzeigen, klicken Sie auf den Link Detail [ 2].

Token-Details hinzufügen

Token-Details hinzufügen

Die Details des Zugangs-Token enthalten ein Token, das verwendet werden kann, um API-Aufrufe in Ihrem Namen durchzuführen [1].

Um ein neues Zugangs-Token zu generieren, klicken Sie auf die Schaltfläche Regenerate Token (Token regenerieren) [2].

Zugangs-Token löschen

Zugangs-Token löschen

Um ein Zugangs-Token zu löschen, klicken Sie auf das Symbol Löschen [5].

Löschung bestätigen

Löschung bestätigen

Um die Löschung zu bestätigen, klicken Sie auf die Schaltfläche OK.