Home A - Z
Page Index

Blame

4c9e2b Manuel Weiser 2026-02-23 11:58:00
docs: Restructure and expand German documentation by replacing a single handbook file with multiple topic-specific pages.
1 
# 11. Admin-Bereich
2
57076d Manuel Weiser 2026-02-23 16:43:14
update
3
**URL:** `http(s)://url/admin`
4c9e2b Manuel Weiser 2026-02-23 11:58:00
docs: Restructure and expand German documentation by replacing a single handbook file with multiple topic-specific pages.
4
5
![Admin-Panel](../images/admin-panel.png)
6
7
> ⚠️ **Hinweis:** Der Admin-Bereich ist nur für Benutzer mit **Administrator-Rolle** sichtbar und zugänglich.
8
9
Das Admin-Panel ist die zentrale Anlaufstelle für die **Systemadministration**. Es bietet Zugriff auf folgende Bereiche:
10
11
| Kachel | Beschreibung |
12
|--------|--------------|
13
| **Users** | Benutzerverwaltung |
14
| **Roles & Permissions** | Rollen und Berechtigungen |
15
| **Devices** | Geräte-Token-Verwaltung |
16
| **System Extra Fields** | Systemweite Zusatzfelder für Spulen und Filamente |
17
| **System** | Plugins und Systemverwaltung |
f48813 Manuel Weiser 2026-03-02 13:55:54
docs: Add SpoolmanDB Import and Spoolman API plugin documentation; update login and admin sections for SSO support
18
| **OIDC / SSO** | OpenID Connect Single Sign-On Konfiguration |
4c9e2b Manuel Weiser 2026-02-23 11:58:00
docs: Restructure and expand German documentation by replacing a single handbook file with multiple topic-specific pages.
19
20
---
21
22
## 11.1 Benutzerverwaltung (Users)
23
57076d Manuel Weiser 2026-02-23 16:43:14
update
24
**URL:** `http(s)://url/admin/users`
4c9e2b Manuel Weiser 2026-02-23 11:58:00
docs: Restructure and expand German documentation by replacing a single handbook file with multiple topic-specific pages.
25
26
![Benutzerverwaltung](../images/admin-users.png)
27
28
Hier können Administratoren alle Benutzer des Systems verwalten. Die Tabelle zeigt:
29
30
| Spalte | Beschreibung |
31
|--------|-------------|
32
| **EMAIL** | E-Mail-Adresse des Benutzers (dient als Login) |
33
| **DISPLAY NAME** | Anzeigename in der Anwendung |
34
| **STATUS** | Aktiv / Inaktiv |
35
| **ROLES** | Zugewiesene Rollen (z. B. Superadmin, User) |
36
| **ACTIONS** | Edit / Reset PW |
37
38
Verfügbare Aktionen:
39
- **Add User** (oben rechts) – Neuen Benutzer mit E-Mail, Passwort und Rolle erstellen
40
- **Edit** – E-Mail, Name oder Rolle eines Users ändern
41
- **Reset PW** – Passwort eines Benutzers zurücksetzen
42
43
---
44
45
## 11.2 Rollen & Berechtigungen (Roles & Permissions)
46
57076d Manuel Weiser 2026-02-23 16:43:14
update
47
**URL:** `http(s)://url/admin/roles`
4c9e2b Manuel Weiser 2026-02-23 11:58:00
docs: Restructure and expand German documentation by replacing a single handbook file with multiple topic-specific pages.
48
49
![Rollen & Berechtigungen](../images/admin-roles.png)
50
51
FilaMan enthält drei **Standard-Systemrollen**, die nicht gelöscht werden können:
52
53
| Rolle | Kennung | Beschreibung |
54
|-------|---------|--------------|
55
| **Administrator** | `admin` | Vollzugriff auf alle Funktionen und den Admin-Bereich |
56
| **User** | `user` | Standard-Benutzer mit Lese- und Schreibzugriff |
57
| **Viewer** | `viewer` | Nur-Lese-Zugriff |
58
59
Über **„Create Role"** (oben rechts) können eigene Rollen mit benutzerdefinierten Berechtigungen angelegt werden. Mit **„Edit Permissions"** lassen sich die Berechtigungen jeder Rolle granular anpassen.
60
61
Klicken Sie auf eine Rolle, um die zugeordneten Berechtigungen im rechten Bereich (**Permissions**) einzusehen und zu bearbeiten.
62
63
---
64
65
## 11.3 Geräte (Devices)
66
57076d Manuel Weiser 2026-02-23 16:43:14
update
67
**URL:** `http(s)://url/admin/devices`
4c9e2b Manuel Weiser 2026-02-23 11:58:00
docs: Restructure and expand German documentation by replacing a single handbook file with multiple topic-specific pages.
68
69
![Geräte-Verwaltung](../images/admin-devices.png)
70
ae873c Manuel Weiser 2026-02-26 21:17:39
Add BambuLab plugin documentation and integration details - Updated contents in German and English to include a new section for the BambuLab plugin. - Modified printer management documentation to reflect BambuLab printer specifics. - Enhanced admin area with device actions and auto-assign configuration for BambuLab integration. - Added detailed configuration and parameter management for BambuLab printers. - Included migration notes for users updating from older versions of the BambuLab plugin.
71
Hier werden **externe Geräte** verwaltet, die über die FilaMan-API kommunizieren (z. B. ESP32-Waagen mit RFID-Scanner). Jedes Gerät erhält einen eigenen API-Token für die Authentifizierung.
4c9e2b Manuel Weiser 2026-02-23 11:58:00
docs: Restructure and expand German documentation by replacing a single handbook file with multiple topic-specific pages.
72
ae873c Manuel Weiser 2026-02-26 21:17:39
Add BambuLab plugin documentation and integration details - Updated contents in German and English to include a new section for the BambuLab plugin. - Modified printer management documentation to reflect BambuLab printer specifics. - Enhanced admin area with device actions and auto-assign configuration for BambuLab integration. - Added detailed configuration and parameter management for BambuLab printers. - Included migration notes for users updating from older versions of the BambuLab plugin.
73
### Geräte-Aktionen
74
75
- **Gerät hinzufügen** – Neues Gerät mit Name und optionalem Gerätecode erstellen
76
- **Token erstellen** – Neuen API-Token für ein Gerät generieren
4c9e2b Manuel Weiser 2026-02-23 11:58:00
docs: Restructure and expand German documentation by replacing a single handbook file with multiple topic-specific pages.
77
- **Token widerrufen** – Zugang eines Geräts deaktivieren
ae873c Manuel Weiser 2026-02-26 21:17:39
Add BambuLab plugin documentation and integration details - Updated contents in German and English to include a new section for the BambuLab plugin. - Modified printer management documentation to reflect BambuLab printer specifics. - Enhanced admin area with device actions and auto-assign configuration for BambuLab integration. - Added detailed configuration and parameter management for BambuLab printers. - Included migration notes for users updating from older versions of the BambuLab plugin.
78
- **Bearbeiten** – Gerätename und Einstellungen ändern
79
80
### Auto-Assign Konfiguration
81
82
Für jedes Gerät können folgende Einstellungen für die **automatische Spulenzuordnung** konfiguriert werden:
83
84
| Einstellung | Beschreibung |
85
|-------------|-------------|
86
| **Auto-Assign aktiviert** | Wenn aktiviert, wird nach dem Wiegen einer Spule auf diesem Gerät automatisch ein Pending-Auftrag an alle verbundenen Drucker gesendet. Sobald die Spule in einen AMS-Slot eingelegt wird, werden die Filament-Einstellungen automatisch übertragen. |
87
| **Auto-Assign Timeout** | Zeit in Sekunden, nach der ein ausstehender Zuordnungsauftrag automatisch verworfen wird (Standard: 60 Sekunden). Wenn innerhalb dieser Zeit keine Spule eingelegt wird, verfällt der Auftrag. |
88
89
> **Hinweis:** Auto-Assign wird pro Gerät konfiguriert, nicht pro Drucker. Wenn Auto-Assign für ein Gerät aktiviert ist, werden ALLE verbundenen Drucker benachrichtigt. Die Zuordnung erfolgt dann automatisch bei dem Drucker, in den die Spule tatsächlich eingelegt wird.
90
fe70cf Manuel Weiser 2026-03-09 08:10:11
Update documentation links to use consistent casing and absolute paths - Changed links in German documentation to use absolute paths with consistent casing. - Updated links in English documentation to follow the same format. - Ensured all navigation links point to the correct sections across all documents.
91
Weitere Informationen zum Ablauf: → [Drucker: Automatische Spulenzuordnung](/Docs/De/09-Drucker#automatische-spulenzuordnung-auto-assignment)
4c9e2b Manuel Weiser 2026-02-23 11:58:00
docs: Restructure and expand German documentation by replacing a single handbook file with multiple topic-specific pages.
92
93
---
94
95
## 11.4 Zusatzfelder (Extra Fields)
96
57076d Manuel Weiser 2026-02-23 16:43:14
update
97
**URL:** `http(s)://url/admin/extra-fields`
4c9e2b Manuel Weiser 2026-02-23 11:58:00
docs: Restructure and expand German documentation by replacing a single handbook file with multiple topic-specific pages.
98
99
![Zusatzfelder](../images/admin-extra-fields.png)
100
101
Mit **System Extra Fields** können Administratoren zusätzliche Datenfelder für Spulen und Filamente definieren, die über die Standardfelder hinausgehen. Diese Felder werden automatisch zu allen Filamenten oder Spulen hinzugefügt.
102
103
| Spalte | Beschreibung |
104
|--------|-------------|
105
| **TARGET TYPE** | Ob das Feld für Filamente oder Spulen gilt |
106
| **KEY (JSON)** | Interner JSON-Schlüssel für das Feld |
107
| **DISPLAY LABEL** | Anzeigetext in der Benutzeroberfläche |
108
| **DEFAULT VALUE (OPTIONAL)** | Optionaler Standardwert |
109
110
Klicken Sie auf **„Add Field"** (oben rechts), um ein neues Zusatzfeld zu erstellen.
111
112
Beispiele für Zusatzfelder:
113
- „Trocknungszeit" für Spulen
114
- „Drucktemperatur" für Filamente
115
- „Lieferant" als ergänzendes Herstellerfeld
116
117
Wenn Zusatzfelder erstellt wurden, erscheinen diese als neue Eingabefelder in den entsprechenden Formularen (Spule hinzufügen, Filament hinzufügen).
118
119
---
120
ae873c Manuel Weiser 2026-02-26 21:17:39
Add BambuLab plugin documentation and integration details - Updated contents in German and English to include a new section for the BambuLab plugin. - Modified printer management documentation to reflect BambuLab printer specifics. - Enhanced admin area with device actions and auto-assign configuration for BambuLab integration. - Added detailed configuration and parameter management for BambuLab printers. - Included migration notes for users updating from older versions of the BambuLab plugin.
121
## 11.5 System (Plugin-Verwaltung)
4c9e2b Manuel Weiser 2026-02-23 11:58:00
docs: Restructure and expand German documentation by replacing a single handbook file with multiple topic-specific pages.
122
57076d Manuel Weiser 2026-02-23 16:43:14
update
123
**URL:** `http(s)://url/admin/system`
4c9e2b Manuel Weiser 2026-02-23 11:58:00
docs: Restructure and expand German documentation by replacing a single handbook file with multiple topic-specific pages.
124
125
![System-Einstellungen](../images/admin-system.png)
126
ae873c Manuel Weiser 2026-02-26 21:17:39
Add BambuLab plugin documentation and integration details - Updated contents in German and English to include a new section for the BambuLab plugin. - Modified printer management documentation to reflect BambuLab printer specifics. - Enhanced admin area with device actions and auto-assign configuration for BambuLab integration. - Added detailed configuration and parameter management for BambuLab printers. - Included migration notes for users updating from older versions of the BambuLab plugin.
127
Der System-Bereich ist die zentrale Stelle für die **Plugin-Verwaltung**. Hier werden alle installierten Plugins angezeigt und verwaltet.
128
129
### Plugin-Übersicht
130
131
Die Plugin-Tabelle zeigt alle installierten Plugins mit folgenden Spalten:
132
133
| Spalte | Beschreibung |
134
|--------|-------------|
135
| **NAME** | Name und kurze Beschreibung des Plugins |
136
| **VERSION** | Installierte Version (z. B. 2.1.10) |
137
| **TYPE** | Art des Plugins: **Driver** (Druckertreiber), **Import** (Datenimport) oder **Integration** (Drittanbieter-Anbindung) |
138
| **AUTHOR** | Autor des Plugins |
139
| **STATUS** | Aktiviert/Deaktiviert — per Toggle-Schalter umschaltbar |
66cf3f Manuel Weiser 2026-02-27 13:14:37
docs: Update plugin management details and add new printer models for BambuLab integration
140
|| **ACTIONS** | Details / Aktualisieren (wenn Update verfügbar) / Öffnen / Deinstallieren |
ae873c Manuel Weiser 2026-02-26 21:17:39
Add BambuLab plugin documentation and integration details - Updated contents in German and English to include a new section for the BambuLab plugin. - Modified printer management documentation to reflect BambuLab printer specifics. - Enhanced admin area with device actions and auto-assign configuration for BambuLab integration. - Added detailed configuration and parameter management for BambuLab printers. - Included migration notes for users updating from older versions of the BambuLab plugin.
141
142
### Plugin installieren
143
144
Klicken Sie auf **„Install Plugin"** oben rechts. Es öffnet sich ein Dialog mit zwei Installationsmöglichkeiten:
145
146
#### Option 1: Aus der Plugin-Registry installieren (empfohlen)
147
148
1. Im Dropdown **„Install from Registry"** werden alle verfügbaren Plugins angezeigt
149
2. Die Liste wird automatisch aus dem offiziellen Plugin-Repository ([Fire-Devils/filaman-plugins](https://github.com/Fire-Devils/filaman-plugins)) auf GitHub geladen
150
3. Wählen Sie das gewünschte Plugin aus dem Dropdown — Name, Version und Beschreibung werden angezeigt
151
4. Klicken Sie auf **„Install Plugin"** um die Installation zu starten
152
5. FilaMan lädt das Plugin automatisch herunter, validiert es und installiert es
153
154
#### Option 2: ZIP-Datei manuell hochladen
155
156
1. Unterhalb des Registry-Dropdowns befindet sich der Bereich **„Plugin ZIP File"**
157
2. Ziehen Sie eine `.zip`-Datei per **Drag & Drop** in den markierten Bereich — oder klicken Sie darauf, um eine Datei auszuwählen
158
3. Die Datei wird automatisch validiert (Struktur, Manifest, Sicherheit)
159
4. Bei erfolgreicher Validierung erscheint eine Bestätigung mit Plugin-Details
160
5. Klicken Sie auf **„Install Plugin"** um die Installation abzuschließen
161
162
> **Hinweis:** Manuelle ZIP-Uploads sind für Entwickler oder für Plugins gedacht, die noch nicht in der offiziellen Registry verfügbar sind.
163
164
### Updates prüfen
165
166
Klicken Sie auf **„Check for Updates"** oben rechts neben dem Install-Button.
167
168
- FilaMan vergleicht die installierten Plugin-Versionen mit den neuesten Versionen in der Registry
169
- Wenn Updates verfügbar sind, wird eine Benachrichtigung mit der Anzahl der verfügbaren Updates angezeigt
66cf3f Manuel Weiser 2026-02-27 13:14:37
docs: Update plugin management details and add new printer models for BambuLab integration
170
- Jedes Plugin mit verfügbarem Update erhält in der Plugin-Tabelle einen **Update-Button** mit der neuen Versionsnummer
171
- Klicken Sie auf diesen Button, um das jeweilige Plugin direkt auf die neueste Version zu aktualisieren
ae873c Manuel Weiser 2026-02-26 21:17:39
Add BambuLab plugin documentation and integration details - Updated contents in German and English to include a new section for the BambuLab plugin. - Modified printer management documentation to reflect BambuLab printer specifics. - Enhanced admin area with device actions and auto-assign configuration for BambuLab integration. - Added detailed configuration and parameter management for BambuLab printers. - Included migration notes for users updating from older versions of the BambuLab plugin.
172
173
### Plugin aktivieren / deaktivieren
174
175
Jedes Plugin kann über den **Toggle-Schalter** in der Status-Spalte aktiviert oder deaktiviert werden:
176
177
- **Aktiviert** — Das Plugin ist aktiv und seine Funktionen stehen zur Verfügung (z. B. Druckertreiber werden geladen)
178
- **Deaktiviert** — Das Plugin bleibt installiert, ist aber inaktiv. Bereits verbundene Drucker werden getrennt
179
180
### Plugin deinstallieren
181
182
1. Klicken Sie auf **„Uninstall"** in der Actions-Spalte des Plugins
183
2. Bestätigen Sie die Deinstallation im Bestätigungsdialog
184
3. Es erscheint eine zusätzliche Abfrage, ob auch die **Plugin-Daten** (z. B. Zusatzfelder, Drucker-Parameter) gelöscht werden sollen:
185
- **Ja** — Entfernt das Plugin und alle zugehörigen Daten (Zusatzfelder, gespeicherte Parameter)
186
- **Nein** — Entfernt nur das Plugin, die Daten bleiben erhalten (nützlich bei Neuinstallation)
187
188
### Plugin-Details
189
190
Klicken Sie auf **„Details"** um ausführliche Informationen zu einem Plugin anzuzeigen:
191
192
- Plugin-Name, Version und Beschreibung
193
- Plugin-Typ (Driver / Import / Integration)
194
- Autor und Homepage
195
- Unterstützte Fähigkeiten (z. B. AMS-Unterstützung, RFID, Auto-Match)
196
- Liste der vom Plugin erstellten Drucker-Parameter
4c9e2b Manuel Weiser 2026-02-23 11:58:00
docs: Restructure and expand German documentation by replacing a single handbook file with multiple topic-specific pages.
197
198
---
199
f48813 Manuel Weiser 2026-03-02 13:55:54
docs: Add SpoolmanDB Import and Spoolman API plugin documentation; update login and admin sections for SSO support
200
## 11.6 OIDC / SSO
201
202
**URL:** `http(s)://url/admin/oidc`
203
204
> ⚠️ **Hinweis:** Die OIDC-Kachel im Admin-Panel ist nur klickbar, wenn FilaMan über **HTTPS** aufgerufen wird. Bei HTTP-Verbindungen zeigt die Kachel einen Hinweis, dass OIDC nur über HTTPS funktioniert, und ist nicht klickbar.
205
206
In diesem Bereich können Administratoren **OpenID Connect (OIDC)** für Single Sign-On (SSO) konfigurieren. Benutzer können sich dann über einen externen Identity Provider anmelden (z. B. Authentik, Keycloak, Azure AD).
207
208
### Konfigurationsfelder
209
210
| Einstellung | Beschreibung |
211
|-------------|-------------|
212
| **Aktiviert** | Toggle zum Aktivieren/Deaktivieren des OIDC-Logins |
213
| **Issuer URL** | Die Issuer-URL des OIDC-Providers (muss `https://` sein) |
214
| **Client ID** | Die beim OIDC-Provider registrierte Client-ID |
215
| **Client Secret** | Das Client-Secret (wird verschlüsselt in der Datenbank gespeichert) |
216
| **Scopes** | Angeforderte OIDC-Scopes (Standard: `openid email profile`) |
217
| **Button-Text** | Benutzerdefinierter Text für den SSO-Button auf der Login-Seite (z. B. „Login mit Authentik") |
218
219
### Voraussetzungen
220
221
- **HTTPS erforderlich** — OIDC funktioniert nur, wenn FilaMan über HTTPS aufgerufen wird
222
- **Umgebungsvariable `OIDC_ENC_KEY`** — Muss gesetzt sein, um das Client-Secret zu verschlüsseln. Generieren mit:
223
```bash
224
openssl rand -hex 32
225
```
226
- **Nur bestehende Benutzer** — Nur Benutzer, die bereits in FilaMan existieren, können sich per OIDC anmelden. Die E-Mail-Adresse des Providers muss mit einem bestehenden Benutzerkonto übereinstimmen. Die E-Mail muss vom Provider als verifiziert markiert sein.
227
- **Keine automatische Erstellung** — OIDC-Login erstellt keine neuen Benutzerkonten
228
229
---
230
231
## 11.7 Gefahrenzone
4c9e2b Manuel Weiser 2026-02-23 11:58:00
docs: Restructure and expand German documentation by replacing a single handbook file with multiple topic-specific pages.
232
233
Am unteren Ende des Admin-Panels befindet sich die rot markierte **Danger Zone** mit einer kritischen Aktion:
234
235
> ⛔ **„Delete all data"**
236
> Löscht **dauerhaft** alle Spulen, Filamente, Hersteller, Farben, Lagerorte und Drucker einschließlich aller Logs und Ereignisse.
237
> **Benutzerkonten, Rollen, Berechtigungen und Geräte bleiben davon unberührt.**
238
> Diese Aktion kann **nicht rückgängig gemacht** werden!
239
240
---
241
fe70cf Manuel Weiser 2026-03-09 08:10:11
Update documentation links to use consistent casing and absolute paths - Changed links in German documentation to use absolute paths with consistent casing. - Updated links in English documentation to follow the same format. - Ensured all navigation links point to the correct sections across all documents.
242
← [Zurück: Einstellungen](/Docs/De/10-Einstellungen) | [Weiter: Farbverwaltung →](/Docs/De/12-Farbverwaltung)