Ein API-Token erstellen

Mit einem API-Token kann ein Skript oder ein Tool wie rclone auf Ihr Drime-Konto zugreifen, ohne Ihr Passwort zu kennen. Sie legen fest, was jedes Token darf, und können es jederzeit widerrufen.

Persönliche Tokens sind für Ihre eigenen Skripte, Backups und Tools gedacht, die mit Ihrem eigenen Konto arbeiten. Eine App, die andere Drime-Nutzer mit ihrem Konto verbinden, verwendet stattdessen OAuth und darf nie nach deren Passwort fragen: siehe die Dokumentation der Drime-API.

#Ein Token erstellen

1. Klicken Sie oben rechts auf Ihren Avatar und dann auf Einstellungen.

2. Klicken Sie auf Entwickler.

3. Klicken Sie unter API-Zugriffstoken auf Token erstellen.

   

4. Geben Sie dem Token unter Token-Name einen Namen, an dem Sie es wiedererkennen.

   Nennen Sie das Tool oder den Computer, der es verwendet, zum Beispiel „rclone auf meinem NAS“. Der Name muss 3 bis 100 Zeichen lang sein.

5. Legen Sie unter Berechtigungen fest, was das Token darf.

   • Alle: Vollzugriff auf alle Ressourcen.

   • Nur lesen: reiner Lesezugriff auf alle Ressourcen.

   • Eingeschränkt: Zugriff nur auf die Ressourcen, die Sie auswählen, jeweils mit Kein Zugriff, Gelesen oder Schreiben.

   Siehe Die passenden Berechtigungen wählen.

   

6. Klicken Sie auf Erstellen.

7. Klicken Sie auf Kopieren, um das Token zu kopieren, und dann auf Fertig.

   Sobald das Token in Ihrer Zwischenablage ist, zeigt die Schaltfläche Kopiert! an.

   

Das Token erscheint anschließend unter API-Zugriffstoken und funktioniert sofort. Es läuft nicht ab: Es funktioniert, bis Sie es löschen.

#Die passenden Berechtigungen wählen

Geben Sie einem Token nur die Rechte, die es braucht.

Bei einem Token mit Eingeschränkt stehen diese Ressourcen zur Auswahl: Dateien (einschließlich Versionen und Papierkorb), Ordner, Freigabe, Arbeitsbereiche, Vault, Signieren, Whiteboards, Dateinanforderungen, Senden & Verfolgen, Kontakte, Tags und Analysen. Analysen (die Speichernutzung) kann nur gelesen werden, daher lauten die Optionen dort Kein Zugriff und Zugriff. Bewegen Sie den Mauszeiger auf das Hilfesymbol neben einer Ressource, um zu sehen, was sie umfasst.

Nur ein Token mit Alle kann auf Ihre Konto-, Sicherheits- und Abrechnungseinstellungen zugreifen. Tokens mit Nur lesen oder Eingeschränkt können das nie.

Die Berechtigungen eines Tokens lassen sich nach dem Erstellen nicht mehr ändern. Um sie zu ändern, erstellen Sie ein neues Token mit den passenden Berechtigungen, aktualisieren Ihr Tool und löschen dann das alte Token.

#Das Token verwenden

Senden Sie das Token bei jeder Anfrage im Authorization-Header mit:

Authorization: Bearer YOUR_ACCESS_TOKEN

Der Link Dokumentation neben API-Zugriffstoken öffnet die Dokumentation der Drime-API. Wie Sie ein Token mit rclone verwenden, lesen Sie unter Rclone, Drime CLI und WebDAV.

#Ihre Tokens anzeigen und löschen

API-Zugriffstoken listet die Tokens auf, die Sie erstellt haben, und die Tokens, die die Drime-Apps für sich selbst erstellen: Drime Desktop, Drime Mobile und die Browsererweiterung. Jede Zeile zeigt:

• den Namen des Tokens oder die App und ihre Plattform, zum Beispiel Desktop-App · Windows;

• seine Berechtigung, zum Beispiel Vollzugriff;

• wann es zuletzt verwendet wurde, oder Nie verwendet.

Wenn Sie noch kein Token haben, zeigt der Abschnitt Sie haben noch keine persönlichen Zugriffstoken an.

So widerrufen Sie ein Token:

1. Klicken Sie am Ende seiner Zeile auf Token löschen (das Papierkorb-Symbol).

   

2. Klicken Sie zur Bestätigung auf Löschen.

   Der Dialog warnt: Dieses Token wird sofort und dauerhaft gelöscht. Nach dem Löschen kann es nicht mehr für API-Anfragen verwendet werden. Die Meldung Token gelöscht erscheint, und jedes Tool, das dieses Token verwendet, funktioniert ab sofort nicht mehr.

Die Drime-Apps können Sie auch unter Sitzungen und Geräte anzeigen und abmelden abmelden.

#Wenn es nicht funktioniert

#Nächste Schritte

• Rclone, Drime CLI und WebDAV

• Sitzungen und Geräte anzeigen und abmelden