BrillianzeHomelab
Vergleich
BsN-Ochsenkopf in Schwarz-Rot-Gold mit goldenem C

Proxmox API-Tokens: Rechte wirksam begrenzen

Ein API-Token macht eine Integration bequem, darf aber kein zweites root-Passwort in einer Konfigurationsdatei werden. Proxmox-Tokens sind für viele REST-Endpunkte gedacht, nicht für die System- oder VM-Konsole. Ein Token lässt sich separat widerrufen und mit einem Ablaufzeitpunkt versehen. Die wesentliche Frage ist, welche Rechte er tatsächlich besitzt: Mit Privilege Separation ist die wirksame Berechtigung die Schnittmenge von Nutzer- und Tokenrechten. Damit ist die menschliche Identität allein noch kein ausreichender Prüfgegenstand. [1]

Zwei Berechtigungsebenen statt einer

Neu angelegte Tokens nutzen laut Proxmox standardmäßig getrennte Rechte. Ein solcher Token braucht eine eigene ACL und kann trotzdem nie mehr dürfen als sein Nutzerkonto. Das erklärt einen häufigen Fehlversuch: Ein Token erhält am VM-Pfad eine Rolle, der zugehörige Benutzer jedoch nicht. Der API-Aufruf wird abgewiesen; weitere Token-ACLs heilen das fehlende Nutzerrecht nicht. Umgekehrt kann ein Adminnutzer mit schmalem Token zwar effektiv begrenzt sein, aber sein kompromittiertes Benutzerpasswort bleibt ein erhebliches Risiko. Ein eigenes Dienstkonto vereinfacht die Schadensbegrenzung. [1]

Wird Privilege Separation deaktiviert, übernimmt der Token die Rechte des zugehörigen Nutzers vollständig. Diese Einstellung ist keine Reparatur für einen misslungenen ACL-Test, sondern eine bewusste Ausweitung. Die Proxmox-Referenz dokumentiert beim Token die Option zur Privilege Separation und bei ACLs eine gesonderte Tokenzuordnung. Deshalb müssen beide Ebenen im Review sichtbar sein: Benutzerrechte und Tokenrechte. Eine an der Clusterwurzel vergebene Rolle ist für eine Integration, die nur einen bestimmten Gast lesen soll, in der Regel zu breit. [2]

Lebensdauer und Geheimnis verwalten

Das Tokengeheimnis wird nach Erzeugung nur einmal angezeigt und kann später nicht erneut ausgelesen werden. Sichere es deshalb in einem geeigneten Secret-Store, nicht im Git-Repository oder in Logausgaben. Ein Ablaufdatum verhindert, dass vergessene Integrationen unbegrenzt weiterlaufen; es ersetzt keine geplante Rotation. Dokumentiere Besitzer, Zweck, Berechtigungspfad, Erneuerung und Widerruf. Für den Transport gelten zusätzlich die üblichen TLS- und Zertifikatsgrenzen; Rechtekontrolle schützt keinen im Klartext abgegriffenen Schlüssel. [1]

Für getrennte Automationen eignen sich getrennte Tokens, weil ein gezielter Widerruf dann nicht gleich sämtliche Integrationen trifft. Prüfe, ob die Anwendung nach einem Widerruf tatsächlich aufhört, statt heimlich auf gespeicherte Zugangsdaten auszuweichen. Die Proxmox-Backup-Jobs sind ein Beispiel: Wer nur deren Status abfragen will, braucht keine pauschale Fähigkeit zur Änderung von VMs oder Datenträgern. Beschreibe die tatsächlich benötigten API-Aktionen, bevor du Rollen verteilst. [1]

Testmatrix für wirksame Rechte

Erzeuge ein eigenes Testkonto und einen Token mit Privilege Separation. Vergib für beide Ebenen nur die vorgesehenen ACLs am passenden Pfad. Teste zuerst einen erlaubten, lesenden API-Aufruf und danach einen verboten ausgewählten Aufruf gegen ein fremdes Objekt. Erwartet sind ein erfolgreicher Positivtest und ein verweigerter Negativtest. Scheitert der Positivtest, vergleiche Benutzer- und Tokenpfad getrennt, statt die Trennung pauschal abzuschalten. Die CLI-Referenz ist dabei die Quelle für die tatsächlichen ACL-Objekte. [2]

Lege abschließend ein kurzes Ablaufdatum im Test fest und prüfe nach dessen Überschreitung die Ablehnung; widerrufe anschließend einen weiteren Testtoken und wiederhole den Aufruf. Notiere, ob der Client korrekte Fehler meldet oder endlos wiederholt. Erwarte keine Konsolenfunktion über den Token, denn diese Endpunkte sind laut Dokumentation ausgenommen. Die Betriebsfreigabe gilt nur für genau die geprüften Aktionen und Pfade. Bei späteren Änderungen der Nutzerrechte muss auch die effektive Tokenschnittmenge erneut getestet werden. [1]

ACL-Pfad und Vererbung nachhalten

Eine ACL besteht nicht nur aus einer Rolle: Pfad und Vererbung bestimmen, auf welchen Objekten sie wirkt. Inventarisiere daher für Benutzer und Token getrennt die Zuordnung am konkreten Gastpfad. Prüfe mit einem zweiten Gast außerhalb des Zielpfads, ob eine geerbte Berechtigung unbeabsichtigt mehr sichtbar macht. Die Benutzersicht der GUI ist kein Ersatz für den Token-Test: Beide API-Operationen müssen wirklich denselben Token verwenden. Der Rechteentwurf gilt erst dann als überprüft, wenn ein positiver und ein negativer API-Test denselben tatsächlich eingesetzten Token verwenden. [2]

Offizielle Quellen