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
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
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
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
Sehen Sie sich die Token-Beschreibung an [1]. Um Details zum Token anzuzeigen, klicken Sie auf den Link Detail [ 2].
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
Um ein Zugangs-Token zu löschen, klicken Sie auf das Symbol Löschen [5].
Löschung bestätigen
Um die Löschung zu bestätigen, klicken Sie auf die Schaltfläche OK.