Zum Inhalt

API-Token

Ein Zugriffstoken erlaubt es Ihnen, sich ohne Ihren Account über Coscine zu authentifizieren und somit z.B. bestimmte Abläufe zu automatisieren.


Allgemein

Sie können für jede von Ihnen verwendete Anwendung, die Zugriff auf die Coscine-API benötigt, ein persönliches Zugriffstoken generieren. Mit diesem Zugriffstoken kann die Anwendung Coscine-Funktionen und -Daten zu und in Ihren Projekten abrufen und ändern. Das Token sollte daher wie ein Passwort behandelt und nicht leichtfertig in Klartext oder für andere sichtbar gespeichert werden.

Image

Abbildung 1 - Token erstellen im Nutzerprofil

Token erstellen

Geben Sie in der Sektion "Zugriffstoken erstellen" in Ihrem Nutzerprofil einen Token Namen und ein Ablaufdatum an (siehe Abbildung oben). Danach können Sie auf die Schaltfläche Zugriffstoken Erstellen klicken um Ihr Token zu generieren. Es öffnet sich eine Pop-Up Mitteilung mit Ihrem persönlichen Token (siehe Abbildung unten).

Token erstellen

Abbildung 2 - Kopieren des neu erstellten Tokens

Achtung

Ihr Token ist nur einmal und nur bei der Erstellung sichtbar. Nachdem Sie die Pop-up Mitteilung mit Ihrem Token schließen, haben Sie nie wieder die Möglichkeit auf Ihr Token zugreifen zu können. Kopieren Sie daher das Token in den Zwischenspeicher und legen Sie es an einem sicheren Ort auf Ihrem PC oder in einem Passwortmanager ab, bevor Sie die Pop-Up Mitteilung schließen.

Nachdem die Erstellung abgeschlossen ist, erscheint in der Auflistung aktiver Token Ihr neues Token mit dem vorher vergebenen Namen.

Zugriffstoken löschen

Zugriffstoken werden nach Ablauf des Ablaufdatums automatisch deaktiviert. Möchten Sie Ihr Token vorher deaktivieren, beispielsweise weil es kompromittiert wurde oder Sie es nicht länger benötigen, so können Sie in der Liste mit Ihren Token auf die Schaltfläche "Widerrufen" klicken (siehe Abbildung unten). Das jeweilige Token wird dann gelöscht.

Image

Abbildung 3 - Token widerrufen