Ordnerberechtigungen¶
Teamraum-Ordner besitzen grundsätzlich die gleichen Rechte, wie der Teamraum selbst. Die Berechtigungen können jedoch explizit unterbrochen und neu gesetzt werden. Dazu wird der @role-inheritance
Endpoint verwendet.
Vererbungsstatus überprüfen:¶
Ein GET Request auf den @role-inheritance
Endpoint gibt zurück, ob die Vererbung momentan unterbrochen ist oder nicht:
Beispiel-Request:
GET /workspace-1/folder-1/@role-inheritance HTTP/1.1 Accept: application/json
Beispiel-Response:
HTTP/1.1 200 OK Content-Type: application/json { "blocked": false }
Vererbung unterbrechen:¶
Mit einem POST Request kann die Rollenvererbung unterbrochen werden.
Wird eine Vererbung unterbrochen, wird der aktuelle Benutzer als neuen und einzigen Admin hinzugefügt.
Beispiel-Request:
POST /workspace-1/folder-1/@role-inheritance HTTP/1.1 Accept: application/json { "blocked": true }
Beispiel-Response:
HTTP/1.1 200 OK Content-Type: application/json { "blocked": true }
Vererbung unterbrechen mit Rollen-Kopie¶
Mit der Option copy_roles auf dem @role-inheritance Endpoint werden bestehende Berechtigungen nach dem Unterbrechen der Vererbung automatisch kopiert.
Beispiel-Request:
POST /workspace-1/folder-1/@role-inheritance HTTP/1.1 Accept: application/json { "blocked": true, "copy_roles": true }
Beispiel-Response:
HTTP/1.1 200 OK Content-Type: application/json { "blocked": true, }
Berechtigungen vererben:¶
Sollen die Berechtigungen wieder vom übergeordneten Objekt vererbt werden, wird ein folgender POST Request verwendet.
ACHTUNG: Lokale Berechtigungen werden dadurch komplett gelöscht und können nicht mehr wiederhergestellt werden.
Beispiel-Request:
POST /workspace-1/folder-1/@role-inheritance HTTP/1.1 Accept: application/json { "blocked": false, }
Beispiel-Response:
HTTP/1.1 200 OK Content-Type: application/json { "blocked": true }