Benutzer & Gruppen

Unter Benutzer & Gruppen werden die Konten verwaltet, mit denen auf die Freigaben zugegriffen wird, und die Administratoren der Weboberfläche.

Rollen

Rolle	Weboberfläche	Freigaben
Administrator	darf sich anmelden und alles ändern	Zugriff wie ein Benutzer
Benutzer	keine Anmeldung möglich, auch nicht an der API	nur die Freigaben, die ihm oder seinen Gruppen freigegeben sind

Administrator ist, wer Mitglied der Linux-Gruppe bunkerbox-admin ist. Die Rolle wird beim Benutzer eingestellt; die Mitglieder der Gruppe bunkerbox-admin lassen sich nicht direkt bearbeiten.

Was ein NAS-Benutzer ist

Ein Benutzer ist ein normales Linux-Konto mit einem Samba-Konto:

• ohne Login-Shell (/usr/sbin/nologin) und ohne Home-Verzeichnis (/nonexistent): eine Anmeldung per SSH oder an der Konsole ist nicht möglich;
• primäre Gruppe users, weitere Gruppen nach Auswahl;
• ein Samba-Konto mit demselben Passwort, damit der Zugriff per SMB funktioniert.

Konten, die schon vorher auf dem System angelegt waren (zum Beispiel ein eigener Benutzer mit Shell), erscheinen ebenfalls in der Liste und können bearbeitet werden. Ihre Shell und ihr Home-Verzeichnis bleiben unverändert.

Benutzer anlegen und bearbeiten

Neuer Benutzer fragt Benutzername, vollständigen Namen, Passwort, Rolle und Gruppen ab.

• Benutzername: Kleinbuchstaben, Ziffern, - und _, beginnend mit einem Buchstaben oder _, höchstens 32 Zeichen. Er kann später nicht geändert werden. Namen, die schon ein Benutzer oder eine Gruppe des Systems trägt, und reservierte Namen (root, nobody, users, guest, everyone, bunkerbox, bunkerbox-admin) werden abgelehnt.
• Vollständiger Name: höchstens 64 Zeichen, ohne :, ,, =, Anführungszeichen und Backslashes.
• Passwort: 8 bis 256 Zeichen, ohne Zeilenumbrüche.

Beim Bearbeiten lassen sich vollständiger Name, Rolle, Gruppen und der Schalter Konto aktiv ändern. Mitgliedschaften in Systemgruppen, die die Oberfläche nicht anzeigt (zum Beispiel sudo oder docker), bleiben dabei erhalten.

Passwort setzen

Passwort setzt das Linux- und das Samba-Passwort gleichzeitig. Fehlt das Samba-Konto noch (Spalte Samba-Konto zeigt „Kein Konto“), wird es dabei angelegt. Ein deaktiviertes Konto bleibt deaktiviert.

Deaktivieren

Ein deaktiviertes Konto behält alle Daten und Mitgliedschaften, kann sich aber weder per SMB noch an der Oberfläche anmelden: Das Linux-Passwort wird gesperrt (usermod -L) und das Samba-Konto deaktiviert (smbpasswd -d).

Löschen

Löschen entfernt das Linux- und das Samba-Konto. Zur Bestätigung muss der Benutzername eingetippt werden. Dateien des Benutzers auf den Freigaben bleiben erhalten.

Das Löschen wird abgelehnt, solange

• der Benutzer in einer Freigabe noch eine Zugriffsregel hat (erst in der Freigabe entfernen),
• er noch verbunden ist (zum Beispiel mit einer SMB-Freigabe).

Schutzregeln

• Systemkonten (uid bzw. gid unter 1000 sowie nobody/nogroup) werden nie angezeigt oder verändert. Ausnahme ist die Gruppe bunkerbox-admin, die nur über die Rollen gepflegt wird.
• Der letzte aktive Administrator kann weder gelöscht noch deaktiviert noch zum Benutzer gemacht werden.
• Das eigene Konto kann man nicht löschen, deaktivieren oder herabstufen.
• Wird einem Administrator das Passwort geändert, die Rolle entzogen, das Konto deaktiviert oder gelöscht, enden alle seine Sitzungen. Wer das eigene Passwort ändert, muss sich danach neu anmelden.

Gruppen

Gruppen fassen Benutzer zusammen, damit Freigaben nicht jedem Benutzer einzeln zugewiesen werden müssen. Eine Gruppe hat einen Namen (gleiche Regeln wie Benutzernamen), eine Beschreibung und Mitglieder.

• Die Beschreibung speichert Bunkerbox selbst (data/groups.json), weil Linux-Gruppen kein Beschreibungsfeld haben.
• Private Gruppen, die Linux für einzelne Benutzer anlegt (gleicher Name wie der Benutzer), werden nicht angezeigt.
• Eine Gruppe kann nicht gelöscht werden, solange eine Freigabe eine Zugriffsregel für sie hat oder sie die primäre Gruppe eines Benutzers ist. Zur Bestätigung muss der Gruppenname eingetippt werden.

Im Hintergrund

Alle Änderungen laufen über die Debian-Werkzeuge useradd, usermod, userdel, groupadd, gpasswd, groupdel, chpasswd, smbpasswd und pdbedit. Namen werden vorher streng geprüft, Passwörter werden nur über die Standardeingabe übergeben und tauchen nie in Prozesslisten auf.

Mock-Modus

Im Mock-Modus zeigt die Seite eine simulierte Familien-NAS (Administratoren admin und daniel, Benutzer wie anna, max und die deaktivierte lena, Gruppen family, media, backup, photos). Änderungen wirken nur im Speicher und sind nach einem Neustart verschwunden. Die Anmeldung bleibt immer admin / admin.