Benutzer & Rollen
DATAZONE Control verfuegt ueber ein rollenbasiertes Zugriffssystem. Benutzer erhalten Rollen, die bestimmte Berechtigungen fuer Module und Funktionen definieren.
Benutzer verwalten
Die Benutzerverwaltung erreichen Sie ueber Einstellungen > Benutzer.
Benutzer erstellen
- Klicken Sie auf Benutzer hinzufuegen
- Geben Sie folgende Daten ein:
| Feld | Beschreibung |
|---|---|
| Benutzername | Eindeutiger Login-Name |
| Anzeigename | Name fuer die Anzeige |
| E-Mail-Adresse | |
| Passwort | Initiales Passwort |
| Rollen | Eine oder mehrere Rollen zuweisen |
Benutzer bearbeiten
- Klicken Sie auf einen Benutzer in der Liste
- Aendern Sie die gewuenschten Felder
- Speichern Sie die Aenderungen
Benutzer deaktivieren
In der Benutzerliste klicken Sie in der Aktionsspalte auf das Deaktivieren-Symbol (durchgestrichene Person). Ein erneuter Klick (Symbol mit Haken) aktiviert den Benutzer wieder.
Die Deaktivierung wirkt sofort: Der gesperrte Benutzer wird ab dem naechsten Request aus allen Zugaengen ausgesperrt – Web-Oberflaeche, API-Key und MCP-Token. Der Benutzer bleibt samt allen zugeordneten Daten im System erhalten (z.B. fuer Audit-Zwecke).
Deaktivieren statt loeschen
Verwenden Sie immer Deaktivieren statt Loeschen. So bleibt der Audit-Trail (wer hat was getan) nachvollziehbar und referenzierte Daten (Tasks, Script-Ausfuehrungen, Zeitplaene) bleiben intakt.
Hinweis: Sie koennen sich nicht selbst deaktivieren.
Rechte eines Benutzers ansehen
Ab v3.63.0 öffnet das Schlüssel-Symbol in der Aktionsspalte die Übersicht Rechte von …. Sie zeigt, was der Benutzer insgesamt darf, also alle Rollen zusammen:
- Administrator: Ja, wenn eine Rolle
*hat oder „Benutzer verwalten“ und „Rollen verwalten“ zusammen. Dann darf der Benutzer alles, auch was in keiner Rolle einzeln angehakt ist. - Kundenbindung: Ein kundengebundener Benutzer sieht nur Hosts, Jobs und Daten seines Kunden. Verwaltungsbereiche bleiben gesperrt, auch mit dem Recht.
- Rollen und darunter je Modul die Zahl der erteilten Rechte.
- Allgemeine Rechte und eine Tabelle Recht × Modul. Mit Nur erteilte sehen Sie nur, was der Benutzer wirklich darf. Fahren Sie mit der Maus über ein Häkchen, um zu sehen, aus welcher Rolle es kommt.
Die Übersicht ist nur zum Ansehen. Ändern Sie die Rechte über die Rollen.
Automatischer Logout (Sitzungs-Timeout)
Web-Sitzungen laufen nach einer Phase der Inaktivitaet automatisch ab; der Benutzer muss sich dann neu anmelden. Solange aktiv gearbeitet wird, bleibt die Sitzung bestehen (gleitender Ablauf) – bei Stillstand (z.B. ueber Nacht) endet sie.
- Standard: 8 Stunden Inaktivitaet.
- Konfigurierbar: Umgebungsvariable
SESSION_INACTIVITY_MINUTESin der.env(Wert in Minuten), danach Backend neu starten. - Betrifft nur Web-Logins; MCP-Tokens (API/Automatisierung) sind davon nicht betroffen.
Einmaliger Re-Login nach Update
Nach dem Einspielen dieser Funktion werden alle bestehenden Sitzungen einmalig ungueltig – alle Benutzer muessen sich einmal neu anmelden.
Rollen verwalten
Unter Einstellungen › Rollen stehen links die Rollen mit der Zahl ihrer Benutzer, rechts die Rechte der gewählten Rolle. Jeder Haken wird sofort gespeichert.
Vordefinierte Rollen
| Rolle | Für wen | Was sie darf |
|---|---|---|
| Administrator | Techniker mit Vollzugriff | Alles. Wer „Benutzer verwalten“ und „Rollen verwalten“ hat, gilt immer als Administrator, auch wenn einzelne Haken fehlen. |
| Operator | Techniker ohne Benutzer- und Rollenverwaltung | Hosts aller Module ansehen, bearbeiten, Aufgaben, Updates, Jobs, Tunnel; Scripts, Gruppen, Berichte, Richtlinien, Einrichtungsprofile, Script-Variablen, Benachrichtigungen, Tactical-Umzug, QuickSupport, Fernsteuerung und Dateien. |
| Support | Erste Hilfe am Telefon | Lesen, Shell, Aufgaben-Log, gespeicherte Scripts ausführen, Fernsteuerung, QuickSupport, Dateien (Firewalls nur lesen). |
| Viewer | Nur lesen | Alle Module und Ansichten lesen, keine sensiblen Rechte. |
Neue Rechte aus einem Update bekommen die vordefinierten Rollen automatisch, wenn sie dort vorgesehen sind. Was du einer Systemrolle abwählst, bleibt abgewählt.
Rolle erstellen
- Einstellungen › Rollen öffnen.
- Auf + klicken, Namen und Farbe vergeben, Erstellen.
- Rechte in den Reitern Allgemein und Module anhaken.
Rechte
Reiter Allgemein
Die Rechte außerhalb der Host-Module, sortiert nach Bereich. Je Zeile gibt es die Spalten Ansehen und Verwalten (bei QuickSupport Benutzen). Der Haken vor einem Bereich setzt alle Rechte darin.
| Bereich | Enthält |
|---|---|
| Verwaltung | Benutzer, Rollen, Einstellungen, Kunden, Custom Fields, Onboarding |
| Automatisierung | Scripts, Script-Variablen, Checks, Playbooks, Gruppen, Richtlinien und Verträge, Einrichtungsprofile |
| Überwachung und Berichte | Benachrichtigungen, Berichte, Wazuh |
| Fernwartung | QuickSupport, Tactical-Umzug |
| Sonstiges | Tools |
Seit v3.63.0 haben diese Bereiche eigene Rechte, vorher durften das nur Administratoren:
| Recht | Erlaubt |
|---|---|
policies.manage | Richtlinien und Verträge anlegen, ändern, löschen. Richtlinien an Kunden und Standorte zuweisen bleibt bei Kunden verwalten. |
provisioning.manage | Einrichtungsprofile pflegen |
scriptvars.manage | Script-Variablen ansehen und pflegen, auch geheime Werte setzen (Werte werden nie angezeigt). Anlegen, Ändern und Löschen braucht seit v3.65.10 zusätzlich Scripts verwalten, weil die Werte direkt im Script-Text landen. |
notifications.manage | Benachrichtigungskanäle, Alarm- und SMTP-Einstellungen. Wer ohne Admin-Rechte SMTP-Server, Port, Verschlüsselung oder Benutzer ändert, muss das SMTP-Passwort neu eingeben. Ein geänderter ntfy-Server braucht einen neuen Token. |
tactical.manage | Tactical-Umzüge starten und steuern. Zugang und API-Key bleiben bei Administratoren. Verträge im Startdialog setzen braucht zusätzlich Kunden verwalten. |
scripts.execute | Seit v3.72.0: gespeicherte Scripts auf Hosts ausführen (Scripts-Seite, Rechtsklick am Host, Sammelaktion, Gruppen). Zusätzlich braucht es im Modul des Hosts ein Aufgaben-Recht (Aufgaben, Bearbeiten, Updates ausführen oder Neustart). Kundengebundene Benutzer erreichen nur Hosts ihres Kunden; ist ein fremder Host dabei, startet gar nichts. Vorher durften das nur Administratoren. Operator und Support haben das Recht von Haus aus. |
scripts.manage | Scripts anlegen, ändern, löschen, ältere Versionen zurückholen. Wirkt seit v3.72.0 auch ohne Admin-Rechte, nicht für kundengebundene Benutzer. System-Scripts (z. B. Update-Scripts) ändern weiter nur Administratoren. |
Diese Bereiche gelten für alle Kunden. Benutzer mit Kundenbindung bekommen sie deshalb nie, auch nicht mit dem Recht. Per MCP-Token sind sie nur mit Admin-Scope erreichbar.
Einstellungen ansehen (settings.view) zeigt ab v3.63.0 die Bereiche Parameter, Run-URLs, Branding und Lizenz zum Lesen; geheime Werte bleiben maskiert. Ändern dürfen dort nur Administratoren. MCP-Tokens und Audit-Log sind nur für Administratoren sichtbar.
Gruppen anlegen, ändern und löschen geht seit v3.63.0 mit Gruppen verwalten (vorher nur Administratoren). Richtlinien brauchen Richtlinien verwalten, virtuelle Module bleiben bei Administratoren.
Reiter Module
Eine Tabelle mit den Rechten als Zeilen und den Modulen (OPNsense, PVE, PBS, Linux, Windows, macOS) als Spalten. „–“ heißt: Das Recht gibt es in diesem Modul nicht. Mit den Haken im Spaltenkopf setzt du alle Rechte eines Moduls, mit der Spalte Alle ein Recht in allen Modulen.
| Abschnitt | Rechte |
|---|---|
| Grundrechte | Anzeigen, Bearbeiten, Löschen, Gruppen |
| Reiter | Aufgaben-Log, Checks, Jobs, Agent |
| Updates und Neustart | Updates ansehen und ausführen, Zeitpläne, Neustart, Paket-/Windows-/macOS-Updates |
| Ansichten | Hardware, Festplatten, Netzwerk, Dienste, Prozesse, Ereignisanzeige, Software, VMs, Sicherheit … |
| Dienste und Software verwalten | Dienste, Docker, Software starten, stoppen, installieren |
| Zugriff | Shell, Tunnel, RDP, RustDesk |
| Sensible Rechte | Fernsteuerung, Dateien, Prozesse beenden, Host isolieren, Diagnose, Config-Backups, Firewall-Log, Paketmitschnitt |
Sensible Rechte werden nie automatisch über „alle Reiter“ vergeben, sie müssen einzeln angehakt werden.
Die Suche oben rechts filtert nach Name, Beschreibung und Schlüssel (z. B. files).
Multi-Faktor-Authentifizierung (MFA)
MFA aktivieren
- Klicken Sie auf Ihren Benutzernamen (unten links in der Seitenleiste).
- Oeffnen Sie den Reiter Sicherheit und klicken Sie auf 2FA einrichten.
- Die Einrichtung fuehrt in drei Schritten: App oeffnen, QR-Code scannen, Code eingeben. Wer nicht scannen kann, gibt den angezeigten Schluessel manuell ein (zeitbasiert/TOTP, 6 Ziffern, 30 Sekunden). Der Schluessel ist zunaechst verdeckt und kann kopiert werden.
- Nach der sechsten Ziffer wird 2FA automatisch aktiviert. Ein falscher Code wird direkt unter dem Eingabefeld gemeldet.
2FA verpflichtend
Verlangt ein Administrator 2FA fuer ein Konto (2FA erforderlich in der Benutzerverwaltung) und ist sie dort noch nicht eingerichtet, erscheint nach der Anmeldung statt der Oberflaeche die Seite Zwei-Faktor-Anmeldung einrichten mit denselben drei Schritten. Nach dem ersten gueltigen Code geht es direkt weiter, ohne neue Anmeldung. Abmelden beendet die Sitzung.
Seit v3.15.3 setzt der Server die Pflicht durch, nicht nur die Oberflaeche: Bis zur Einrichtung beantwortet er fuer dieses Konto nur das eigene Profil, die 2FA-Einrichtung und das Abmelden. Daten, Tasks, Shell, Tunnel, Live-Verbindung und MCP-Tokens des Kontos sind gesperrt. Setzt ein Administrator die Pflicht, waehrend der Benutzer angemeldet ist, wechselt dessen Oberflaeche beim naechsten Zugriff auf die Einrichtungsseite. Eine bereits aktive 2FA laesst sich nicht durch eine neue Einrichtung ersetzen; dafuer erst deaktivieren (mit Passwort) oder vom Administrator zuruecksetzen lassen.
Anmeldung mit 2FA
Nach Benutzername und Passwort zeigt die Anmeldung, fuer welchen Benutzer der Code abgefragt wird. Der Code wird in sechs Kaestchen eingegeben (Einfuegen und Passwort-Manager funktionieren) und nach der sechsten Ziffer automatisch geprueft. Bei einem falschen Code leert sich das Feld fuer den naechsten Versuch. Anderer Benutzer fuehrt zurueck zur Anmeldung.
Unterstuetzte Apps
- Google Authenticator
- Microsoft Authenticator
- Authy
- Jede TOTP-kompatible App
MFA zuruecksetzen
Als Administrator koennen Sie MFA fuer andere Benutzer zuruecksetzen:
- Oeffnen Sie den Benutzer in der Verwaltung
- Klicken Sie auf MFA zuruecksetzen
- Der Benutzer kann MFA beim naechsten Login neu einrichten
Sicherheitsempfehlung
Aktivieren Sie MFA fuer alle Benutzer mit administrativen Rechten. Dies schuetzt vor unbefugtem Zugriff selbst bei kompromittierten Passwoertern.
Zugriffsregeln seit v3.14.2
- Aufgaben anlegen (Updates, Neustart, Scripts, Agent-Update - ueber die Oberflaeche, die API und Bulk-Aktionen) braucht ein Schreibrecht im Modul: Aufgaben, Bearbeiten, Updates ausfuehren oder Neustart. Ein reines Anzeigen-Recht reicht nicht mehr. Kundengebundene Benutzer erreichen nur Hosts ihres Kunden.
- Freier Script-Inhalt in einer Aufgabe ist Administratoren und Benutzern mit
scripts.managevorbehalten; alle anderen fuehren gespeicherte Scripts aus. - Aufgaben lesen (
/api/tasks) zeigt nur Module mit Anzeigerecht und nur Hosts des eigenen Kunden; Parameter wie Schluessel oder Passwoerter sind fuer Nicht-Administratoren maskiert. - Live-Aktualisierungen (Host-Daten, Task-Ausgaben) erhalten kundengebundene Benutzer nur fuer ihren Kunden.
- Update-Laeufe abbrechen/fortsetzen erfordert Updates ausfuehren im Modul OPNsense.
- Kundenweite Ausnahmen/Stummschaltungen von Alarmen: siehe Benachrichtigungen.
Zugriffsregeln seit v3.48.2 / v3.48.4
Ein reines Anzeigen-Recht erlaubt keine Aenderungen mehr. Vorher reichte bei einigen Funktionen ein beliebiges Leserecht.
| Aktion | Benoetigtes Recht |
|---|---|
| Jobs anlegen, aendern, klonen, loeschen | Jobs/Zeitplaene im Modul (<modul>.schedules); Ausfuehren auch Updates ausfuehren |
| Hosts anlegen und bearbeiten, Gruppen zuweisen | Bearbeiten im Modul (Gruppen auch Gruppen) |
| Tunnel anlegen, schliessen, aktivieren | Tunnel im Modul (<modul>.tunnels) |
| Kunden und Standorte bearbeiten | customers.manage |
| Playbooks anlegen, ausfuehren, stoppen | playbooks.manage oder scripts.manage |
| Wazuh-Ausnahmen | wazuh.manage |
| Wake-on-LAN, Task abbrechen, freigegebene Windows-Updates installieren | wie Aufgabe anlegen |
| OPNsense Update-Laeufe starten | Updates ausfuehren |
| PBS-Wartung (GC, Verify, Prune, Sync) | Aufgaben im Modul PBS |
Kundengebundene Benutzer sehen und bearbeiten Jobs, Tunnel, Berichte und Playbook-Laeufe nur fuer Hosts ihres Kunden. Jobs auf Gruppen oder alle Hosts sind fuer sie ausgeblendet. Das SSH-Passwort eines Agent-SSH-Tunnels erscheint nur mit dem Recht Tunnel oder Shell.
Weitere Aenderungen:
- Passwort aendern beendet alle anderen Anmeldungen des Kontos. Ein Admin-Reset oder das Deaktivieren beendet alle Anmeldungen.
- MCP-Tokens verlieren ihre Wirkung, sobald der Ersteller eine verpflichtende 2FA noch einrichten muss. Ein Token mit Admin-Bereich gilt nur, solange der Ersteller Administrator ist. Tokens mit dem Bereich Lesen sehen keine Agent-Tokens und kein Onboarding-Token.
- Tunnel-Client-Zugaenge pruefen bei jeder Verbindung die aktuellen Rechte des Benutzers. Ein geloeschter Zugang oder ein deaktiviertes Konto trennt sofort.
- Web-Shell verbindet sich nach einem Verbindungsabbruch nicht mehr selbst neu, sondern ueber Verbinden.
Benutzer loeschen und Admin-Schutz (ab v3.48.6)
- Ein Benutzer mit Eintraegen im Audit-Log laesst sich nicht mehr loeschen, sondern nur deaktivieren. So bleibt im Audit-Log nachvollziehbar, wer was getan hat.
- Control verhindert Aenderungen, nach denen kein aktiver Administrator mehr uebrig waere: das letzte Admin-Konto deaktivieren oder loeschen, die eigene Admin-Rolle entfernen, der Rolle Administrator die Benutzer- und Rollenverwaltung entziehen.
- Entzogene Rechte von Systemrollen bleiben entzogen. Vorher setzte jeder Neustart sie wieder.
- Das Konto
adminlegt Control nur bei einer leeren Installation an, nicht mehr nach dem Loeschen. - Das Audit-Log sehen nur Administratoren ohne Kundenbindung.
- Standorte anlegen und bearbeiten darf, wer
customers.manageoder in einem Modul Bearbeiten hat.
Sicherheit ab v3.48.8
- 2FA-Codes: Nach 5 falschen Codes ist die Zwei-Faktor-Anmeldung des Kontos 15 Minuten gesperrt. Ein Code gilt nur einmal. Das richtige Passwort setzt den Fehlerzaehler nicht mehr zurueck.
- Kundengebundene Benutzer erreichen keine Hosts ohne Kundenzuordnung mehr.
- Berichte: Vorlagen, Zeitplaene, Erzeugen, Vorschau und Versand per E-Mail brauchen
reports.manage. Lesen und Herunterladen bleibt wie bisher, kundengebundene Benutzer sehen nur Berichte ihres Kunden. Die Daten im Bericht folgen den Modulrechten des Benutzers, das Audit-Log nur fuer Administratoren. PDF-Berichte laden keine externen Dateien oder Adressen mehr, nur eingebettete Bilder und das Logo.
Sicherheit ab v3.48.10
- Wazuh-Daten (Alarme, Schwachstellen, FIM, SCA) sehen Benutzer nur fuer Module mit Leserecht, kundengebundene Benutzer nur fuer Hosts ihres Kunden.
- RustDesk-Passwort anzeigen braucht das RustDesk-Recht des Moduls und steht im Audit-Log.
- Config-Downloads von OPNsense (Klartext-
config.xml) sind mit MCP-Tokens gesperrt. - Web-Shell: Nach Abmelden, Sperren oder Passwortwechsel nimmt eine offene Shell keine Eingaben mehr an.
- Agent-Konfiguration (
agent.json) ist nur noch fuer root bzw. SYSTEM und Administratoren lesbar (Installer ab 3.48.10, bestehende Hosts mit dem neuen Agent).
Sicherheit ab v3.48.15
- Checks bearbeiten: Kundengebundene Benutzer koennen keine Checks anlegen oder aendern. Bei kritischem Ergebnis Host isolieren einschalten (oder Schwellen eines isolierenden Checks aendern) braucht das Recht Host isolieren in den betroffenen Modulen, Scripts und Remediation braucht
scripts.manage. - Wazuh-Daten folgen fuer alle Nicht-Administratoren den Modulrechten.
- Gespeicherte Berichte sehen Benutzer ohne Kundenbindung nur mit
reports.view. Berichte mit Audit-Daten nur Administratoren. - MCP-Tokens koennen keine Dateien uebertragen, keine Agent-Aufrufe starten und keine Isolation aufheben.