Berechtigungsumfänge und Rechte der Drive-API

Drive-Berechtigungsumfänge bestimmen genau, was ein API-Token oder MCP-Agent mit TrekMail Drive tun darf. Ein gutes Token ist eng begrenzt: Es besitzt nur die für eine Aufgabe nötigen Umfänge, einen klaren Namen und ein Ablaufdatum.

Die Drive-API hat 11 Berechtigungsumfänge für Konto-Drive, Postfach-Drive, Freigabelinks, endgültiges Löschen, den Status des Drive-Add-ons und Passwörter von Synchronisierungsgeräten. Diese Umfänge gehören zu Betriebstokens (tm_live_...). Nachrichtentokens (tm_msg_...) sind weiterhin für E-Mail-Vorgänge bestimmt.

Übersicht der Berechtigungsumfänge

Lesen, Schreiben, Freigeben und endgültiges Löschen

Drive trennt häufige Aufgaben in vier Berechtigungsstufen:

• Lesen erlaubt das Auflisten von Bereichen, Durchsuchen von Ordnern, Prüfen von Metadaten, Anzeigen des Papierkorbs und Anfordern von Download-URLs.
• Schreiben erlaubt Hochladen, Ordnererstellung, Umbenennen, Verschieben, Ablegen im Papierkorb und Wiederherstellen.
• Freigeben erlaubt das Erstellen, Auflisten und Widerrufen öffentlicher Freigabelinks.
• Endgültiges Löschen erlaubt das dauerhafte Löschen von Elementen im Papierkorb oder das Leeren des Papierkorbs.

Geben Sie einem allgemeinen Assistenten keine Berechtigung zum endgültigen Löschen. Erstellen Sie für automatische Bereinigung ein eigenes, nach dieser Aufgabe benanntes Token, lassen Sie es in MCP bis zur Nutzung deaktiviert und prüfen Sie nach jedem Lauf das Auditprotokoll.

Zugriff über Tarif und Add-on

Der Zugriff auf die Drive-API ist verfügbar, wenn das Konto Drive über einen bezahlten Tarif oder ein aktives Drive-Speicher-Add-on nutzen darf. Ein kostenloses Konto mit aktivem Add-on kann Drive-Umfänge zur Speicherautomatisierung nutzen, ähnlich wie Umfänge des E-Mail-Prüfers unabhängig vom vollständigen Infrastruktur-API-Zugriff verfügbar sind.

Wird ein Drive-Add-on gekündigt und beginnt seine Kulanzfrist, kann der Lesezugriff zum Prüfen und Exportieren von Dateien bestehen bleiben. Schreib-, Freigabe- und Löschzugriff können eingeschränkt sein, bis das Konto wieder einen aktiven Speicherstatus besitzt.

Konto-Drive und Postfach-Drive

Die Umfänge für Konto-Drive und Postfach-Drive sind bewusst getrennt. Ein Abrechnungs- oder Betriebsagent benötigt möglicherweise nur das Konto-Drive. Ein Postfachassistent braucht vielleicht nur Zugriff auf das Drive eines einzigen Postfachs.

Verwenden Sie beim Erstellen eines Tokens für Postfachautomatisierung Postfachgrenzen. Ein eingeschränktes Token sieht nur erlaubte Postfachbereiche. Anfragen für andere Postfächer erhalten eine Antwort nach Art von „nicht gefunden“, sodass die Kontostruktur einer eng begrenzten Integration verborgen bleibt.

Der Umfang des Drive-Add-ons ist schreibgeschützt

Mit drive:addon:read kann ein Agent Status, Preise und Kündigungsvorschau des Add-ons lesen. Er kann keinen Speicher kaufen, die Kapazität ändern, ein Abonnement kündigen oder eine Zahlung auslösen.

Diese Grenze ist beabsichtigt. Änderungen an der Speicherabrechnung bleiben im Dashboard, wo ein Mensch Kapazität, Preis, Währung, Abrechnungszeitraum und Zahlungsbestätigung prüfen kann. Es gibt keinen Umfang drive:addon:write.

Passwörter von Synchronisierungsgeräten

drive:devices:read und drive:devices:write verwalten die separaten Passwörter von WebDAV-Synchronisierungs-Apps. Sie entsprechen nicht dem API-Token. Ein neu erstelltes Gerätepasswort wird einmal angezeigt; speichern Sie es dann in der Synchronisierungs-App oder einem Passwortmanager. Trennen Sie die Geräteverwaltung möglichst von allgemeinen Tokens zur Dateiautomatisierung und widerrufen Sie ein Gerätepasswort, wenn sein Computer oder seine App keine Verbindung mehr herstellen soll.

Antworten zum Auflisten, Erstellen und Wechseln von Geräten enthalten server_url. Verwenden Sie diese Adresse, statt /dav selbst zusammenzusetzen: Konten mit vollständig bereitgestellter White-Label-Mailzone erhalten ihren eigenen DAV-Hostnamen, alle anderen den funktionierenden Plattform-Hostnamen.

Empfohlene Tokenmuster

Was bei fehlendem Umfang geschieht

Fehlt einem Token der benötigte Drive-Umfang, gibt die API einen Berechtigungsfehler zurück. Schließt die Einschränkung des Tokens ein Postfach oder eine Ressource aus, kann die API „nicht gefunden“ zurückgeben. So bleibt die private Kontostruktur vor Integrationen verborgen, die sie nicht kennen sollen.