Admin-Modus#

Administratoren eines Mandanten (Rolle Tenant Admin) arbeiten im Alltag mit denselben Rechten wie ihre Kolleginnen und Kollegen. Die weitreichenden Verwaltungsrechte schalten sie nur dann bewusst zu, wenn sie sie brauchen: im Admin-Modus. So passiert nichts versehentlich mit Mandantenrechten, und jede Verwaltungsaktion ist als solche erkennbar.

Neu ab Version 1.6: Die Rechte der Rolle Tenant Admin wirken nur noch im Admin-Modus. Bis Version 1.5 galten sie immer.

Was der Admin-Modus freischaltet#

Ohne Admin-Modus sieht und tut ein Tenant Admin nur das, was seine übrigen Rollen und seine Organisation erlauben. Erst im Admin-Modus kommen hinzu:

• die Gesamtsicht auf die Aufträge des Mandanten, über die eigene Organisation hinaus,
• das Einspielen von Aufträgen für einen anderen Auftraggeber,
• die Verwaltung von Konten, Rollen und Registrierungstokens,
• die Verwaltung von Organisationen (Auftraggeber und Partner),
• der Import mit Originalfeldern (historische Status-, Datums- und Partnerstände, siehe Datenaustausch).

Das eigene Profil bearbeiten Sie weiterhin auch ohne Admin-Modus.

In der App#

Öffnen Sie oben rechts das Kontomenü (Ihr Profilbild bzw. das Personensymbol). Dort steht der Schalter „Admin Mode“:

• aus: „Normale Partner-Sicht“ – Sie arbeiten mit Ihren normalen Rechten,
• an: „Admin-Rechte aktiv“ – die Verwaltungsrechte gelten zusätzlich.

Solange der Admin-Modus an ist, zeigt die Fußzeile ein rotes Abzeichen „Admin“. Schalten Sie ihn nach getaner Arbeit wieder aus. Den Schalter sehen nur Konten, die den Admin-Modus auch nutzen dürfen.

Im Kommandozeilen-Client livectl#

Hängen Sie den Schalter --admin direkt hinter livectl, vor das Kommando:

livectl --admin assignments import auftraege.csv --tenant-id <mandant> --dto fsg1
livectl --admin accounts token <konto-id>
livectl --admin roles list

Der Schalter gilt nur für diesen einen Aufruf. Ohne --admin lehnt der Server Verwaltungsaktionen mit einem Hinweis auf das fehlende Recht ab.

$ livectl roles list
policy.missing_right: Missing permission - role:read
$ livectl accounts token <konto-id>
policy.missing_right: Missing permission - token:create

Beim Einspielen für einen anderen Auftraggeber endet der Import ohne --admin mit policy.missing_grant: Missing permission.

Ein Server ab Version 1.6 nimmt livectl der Version 1.5 nicht mehr an. Laden Sie das passende livectl von der Download-Seite. Das gilt auch für automatisierte Importe, etwa über ein Gateway: Sie brauchen das neue livectl und rufen es mit --admin auf.

Über die API#

Bei direkten Aufrufen der Schnittstelle fordern Sie den Admin-Modus je Anfrage mit dem Header an:

x-live-admin-mode: on

Fehlt der Header, gelten nur die Rechte ohne Admin-Modus.