Open WebUI: Zugriffe verwalten auf die Dokumente

Sobald eine Open WebUI-Instanz mehreren Abteilungen dient, lautet die Frage nicht mehr nur „Antwortet das Modell gut?“, sondern „Wer kann welche Dokumente abfragen?“. Open WebUI: Der Zugriff auf Dokumente wird über drei Mechanismen verwaltet (Rollen, Gruppen, Sichtbarkeit jeder Wissensdatenbank), die auf nicht immer intuitive Weise zusammenwirken. Dieser Leitfaden erklärt dieses Modell, schlägt ein Verfahren zur Isolierung nach Gruppen vor und anschließend eine Methode, jedes Konto einzeln zu testen und Überschneidungen aufzuspüren. Er verspricht keine vollständige Abschottung: Nur ein Teil des Ablaufs wurde von der Redaktion beobachtet, und dies ist entsprechend gekennzeichnet.
#Warum Dokumente in Open WebUI abschotten
Eine Wissensdatenbank (Knowledge) von Open WebUI ist eine Sammlung von Dateien, die in Abschnitte zerlegt und indexiert werden. Wenn ein Benutzer sie im Chat mit # zitiert oder sie an ein Modell angebunden ist, sucht Open WebUI die zur Frage passenden Abschnitte heraus und fügt sie in den Kontext ein. Das Modell kann diese Abschnitte dann wiedergeben, manchmal wortwörtlich.
Unmittelbare Folge: Wer Zugriff auf eine Wissensdatenbank hat, kann ihren Inhalt lesen, auch ohne die Datei jemals zu öffnen. Wer auf einer Team-Instanz öffentliche Verfahrensanweisungen, Gehaltsabrechnungen und Lieferantenverträge in einer einzigen Datenbank mischt, gibt all diese Dokumente jeder Person, die sie abfragen kann. Die Abschottung erfolgt daher Datenbank für Datenbank und nicht Datei für Datei: Ein sensibles Dokument gehört in eine Datenbank, deren Zugriffsbereich seiner Sensibilität entspricht.
Self-Hosting löst die Frage der Übermittlung an einen externen Anbieter, nicht die der internen Zugriffe. Die Leitfäden dieser Website zur DSGVO erinnern daran, dass der Grundsatz der Datenminimierung auch gegenüber Kollegen gilt: Eine Person sollte nur auf die Daten zugreifen, die sie für ihre Aufgabe benötigt.
#Rollen, Gruppen und Sichtbarkeit der Datenbanken
Profitiere von unserer Erfahrung und einem geführten Lernpfad, um dein lokales RAG aufzubauen und mit deinen eigenen Dokumenten zu arbeiten.
- Lebenslanger Online-Zugang
- PDF + Dateien
- Erstattung binnen 30 Tagen
Die Zugriffskontrolle von Open WebUI beruht auf drei Ebenen. Sie zu verwechseln ist die häufigste Fehlerquelle.
- Die Rollen
- Jedes Konto hat eine Rolle: Administrator, Benutzer oder ausstehend (pending). Ein ausstehendes Konto kann nichts tun, solange ein Administrator es nicht freigegeben hat. Ein Administrator verwaltet die Instanz und sieht mit den Standardeinstellungen den Inhalt des Arbeitsbereichs der anderen Konten. Die Rolle ist daher eine grobe Barriere: Sie trennt diejenigen, die administrieren, von denen, die nutzen.
- Die Gruppen
- Sie werden im Administrationsbereich angelegt (Abschnitt Benutzer > Gruppen) und dienen zwei Zwecken: funktionale Berechtigungen zu tragen (Wissensdatenbanken erstellen, freigeben, bestimmte Funktionen nutzen dürfen) und als Ziel zu dienen, wenn eine Ressource freigegeben wird. Ein Benutzer kann mehreren Gruppen angehören.
- Die Sichtbarkeit einer Ressource
- Jede Wissensdatenbank hat, wie jedes benutzerdefinierte Modell, jeder Prompt und jedes Tool, eine Zugriffseinstellung. Privat: Nur der Eigentümer (und die Administratoren, je nach der weiter unten beschriebenen Einstellung) hat Zugriff, dazu die ausdrücklich hinzugefügten Gruppen. Öffentlich: Alle Benutzer der Instanz können sie lesen. Für jede hinzugefügte Gruppe wählt man in der Regel Lese- oder Schreibzugriff.
Die Isolierung nach Gruppen besteht also darin, die Wissensdatenbanken privat zu halten und dann nur die betreffende(n) Gruppe(n) hinzuzufügen, für die meisten Mitglieder mit Lesezugriff. Schreibzugriff (Dateien hinzufügen, ersetzen, löschen) bleibt wenigen Personen vorbehalten, idealerweise über eine von den Lesern getrennte Gruppe.
#Rechte, die sich addieren: die Falle der Standardberechtigungen
Laut der offiziellen Dokumentation sind die Berechtigungen von Open WebUI kumulativ: Ein Benutzer erhält die Vereinigung der Standardberechtigungen (die für alle Benutzer gelten) und der Berechtigungen aller seiner Gruppen. Die weitreichendste Berechtigung hat Vorrang. Es gibt keine „Verbots“-Gruppe, die ein anderweitig gewährtes Recht entziehen würde.
Zwei praktische Folgen. Erstens: Wenn die Standardberechtigungen eine Aktion erlauben (zum Beispiel eine Datenbank öffentlich zu teilen), kann keine Gruppe sie einem Benutzer entziehen: Sie müssen den Standard einschränken und die Aktion dann nur für die Gruppen wieder freigeben, die sie benötigen. Zweitens: Die Mitgliedschaft in einer zusätzlichen Gruppe kann die Zugriffe nur erweitern. Wenn Sie eine Person zur Gruppe „Geschäftsleitung“ hinzufügen, ohne sie aus „Praktikanten“ zu entfernen, erhält sie beide Bereiche.
- Standardberechtigungen
- Als Erstes einzustellen, so restriktiv wie vernünftigerweise möglich: keine öffentliche Freigabe, eingeschränkte Erstellung von Wissensdatenbanken, sofern die Instanz keine Sandbox ist.
- Gruppenberechtigungen
- Geben Funktionen für eine Teilmenge wieder frei: zum Beispiel eine Gruppe „Dokumentationsredaktion“, die Wissensdatenbanken erstellen und freigeben darf.
- Zugriff pro Ressource
- Unabhängig von den Funktionsberechtigungen: Wer Datenbanken erstellen darf, erhält dadurch keinen Zugriff auf die Datenbanken anderer. Die Einstellung jeder einzelnen Datenbank entscheidet, wer sie lesen kann.
#Voraussetzungen
- Eine aktuelle Open WebUI-Instanz
- Installiert und mit Ollama verbunden (standardmäßig unter http://localhost:11434), mit einem funktionierenden Embedding-Modell. Der Leitfaden „Open WebUI mit Ollama: vollständiger Leitfaden“ behandelt die Installation.
- Eine überprüfte Sicherung
- Zugriffe neu zu organisieren bedeutet, täglich genutzte Wissensdatenbanken zu ändern. Archivieren Sie das Docker-Volume, bevor Sie beginnen (siehe „Open WebUI und Ollama nach einem Ausfall wiederherstellen“).
- Eine Übersicht der Dokumente
- Eine einfache Tabelle: welche Wissensdatenbank, welche Dokumente, welche Sensibilität, welche Abteilungen lesen müssen, wer schreiben muss. Ohne sie erfolgt die Konfiguration Anfrage für Anfrage und gerät aus dem Ruder.
- Testkonten
- Mindestens ein Nicht-Administratorkonto pro zu prüfender Gruppe sowie ein Konto, das keiner Gruppe angehört. Tests mit einem Administratorkonto beweisen nichts über die Zugriffe der Benutzer.
- Zugelassene API-Schlüssel
- Für Tests über die Kommandozeile muss der Administrator API-Schlüssel zulassen (Administratoreinstellungen); jedes Testkonto erzeugt einen unter Einstellungen > Konto.
#Dokumentzugriffe in Open WebUI verwalten: 5 Schritte
- 011. Standardberechtigungen einschränkenÖffnen Sie im Administrationsbereich die Standardberechtigungen der Benutzer. Deaktivieren Sie das öffentliche Teilen von Wissensdatenbanken und Modellen, und schränken Sie das Erstellen von Datenbanken ein, wenn nicht alle es benötigen. Prüfen Sie außerdem die Rolle, die neu registrierten Benutzern zugewiesen wird: „Ausstehend“ verhindert, dass ein versehentlich angelegtes Konto sofort auf irgendetwas zugreift.
- 022. Gruppen erstellenEine Gruppe pro Dokumentenbereich („Personal“, „Buchhaltung“, „Support“), bei Bedarf zusätzlich eine Bearbeitergruppe pro Bereich. Benennen Sie sie wie die entsprechenden Datenbanken: So lassen sich die Einstellungen leichter überprüfen. Wenn Ihre Gruppen über OAuth oder LDAP aus einem Verzeichnisdienst stammen, prüfen Sie in der Dokumentation Ihrer Version, wie die Gruppensynchronisierung konfiguriert wird und ob eine im Verzeichnis entfernte Gruppe auch in Open WebUI entfernt wird.
- 033. Datenbanken erstellen oder neu organisierenUnter Arbeitsbereich > Wissen eine Datenbank pro Bereich. Um ein sensibles Dokument aus einer breit zugänglichen in eine eingeschränkte Datenbank zu verschieben, müssen Sie es ausdrücklich aus der ersten entfernen: Eine in zwei Datenbanken importierte Datei existiert zweimal, mit zwei Zugriffseinstellungen.
- 044. Den Zugriff auf jede Datenbank festlegenBelassen Sie die Datenbank als privat, fügen Sie die betreffende Gruppe mit Lesezugriff und die Gruppe der Bearbeiter mit Schreibzugriff hinzu. Vermeiden Sie es, Personen einzeln hinzuzufügen: Individuelle Zugriffe gehen bei Austritten und Stellenwechseln verloren, während eine Gruppe an einer einzigen Stelle aktuell gehalten wird.
- 055. Modelle mit zugeordneten Datenbanken kontrollierenEinem benutzerdefinierten Modell (Arbeitsbereich > Modelle) können Datenbanken zugeordnet sein. Legen Sie den Zugriff auf das Modell mindestens so streng fest wie den Zugriff auf die Datenbanken, die es enthält, und testen Sie diesen Fall gezielt (siehe den Abschnitt zu Überschneidungen).
#Die Zugriffe jedes Benutzers einzeln testen
Die Administrationsoberfläche zeigt, was konfiguriert ist, nicht aber, was ein Benutzer tatsächlich erhält. Die einzige aussagekräftige Prüfung besteht darin, sich in die Lage jedes einzelnen Kontos zu versetzen. Zwei sich ergänzende Methoden: ein privates Browserfenster pro Testkonto (um die Listen und den Chat so zu sehen wie der Benutzer) und API-Aufrufe mit dem Schlüssel jedes Kontos (um reproduzierbare und mit Zeitstempel versehene HTTP-Codes zu erhalten).
Das folgende Skript fragt für jedes Testkonto die Liste der sichtbaren Wissensdatenbanken und anschließend eine bestimmte Datenbank ab und protokolliert die Antwortcodes. Die Schlüssel werden aus privaten Dateien gelesen, eine pro Konto, und niemals im Klartext im Befehl übergeben. Die Routen /api/v1/knowledge/ sind die der API von Open WebUI; überprüfen Sie sie für Ihre Version. Port 3000 entspricht dem gängigsten Docker-Befehl (-p 3000:8080).
Ein Code 200 für die Wissensbasis bedeutet, dass das Konto sie über die API lesen kann; ein Code 401 oder 403 bedeutet eine Ablehnung. Der Code der Liste ist bei jedem gültigen Konto in der Regel 200: Entscheidend ist ihr Inhalt. Der folgende Befehl zeigt die Namen der für ein Konto sichtbaren Wissensbasen an; je nach Version ist die Antwort ein Array oder ein Objekt, das ein Array enthält, daher der Filter, der beide Fälle abdeckt.
Erstellen Sie anschließend eine Matrix: eine Zeile pro Konto, eine Spalte pro Datenbank, mit dem erwarteten Wert (Lesen, Schreiben, nichts) und dem beobachteten Wert. Jedes Feld, in dem der beobachtete Zugriff weiter reicht als der erwartete, ist ein Mangel, der behoben werden muss, bevor echte Dokumente importiert werden. Spielen Sie die Matrix nach jedem Update von Open WebUI und nach jeder Gruppenänderung erneut durch: Eine heute korrekte Einstellung kann durch eine Migration oder einen Bedienfehler verändert werden.
#Zu prüfende Überschneidungen
Den direkten Zugriff auf eine Wissensdatenbank zu verweigern, reicht nicht als Nachweis, dass ein Konto nicht an ihren Inhalt gelangen kann. In einer Open WebUI-Instanz gibt es mehrere indirekte Wege; ihr Verhalten hängt von Version und Konfiguration ab, und keiner davon wurde von der Redaktion getestet. Es handelt sich um Hypothesen, die mit dem Kontrolldokument zu überprüfen sind, nicht um festgestellte Sicherheitslücken.
- Modell mit zugeordneter Datenbank
- Ein Benutzer hat Zugriff auf ein benutzerdefiniertes Modell, an das eine Wissensdatenbank angebunden ist, aber nicht auf die Datenbank selbst: Erhält er die Textabschnitte der Datenbank, wenn er mit dem Modell chattet? Testen Sie dies, indem Sie dem Modell eine Frage zum Kontrollsatz stellen.
- Direkter Verweis über die ID
- Die Completion-API akzeptiert eine Liste von Dateien oder Collections, die als Kontext verwendet werden sollen. Kann ein nicht berechtigtes Konto, das die ID einer Wissensdatenbank kennt, diese auf diese Weise referenzieren? Siehe den Testaufruf unten.
- Geteilte Unterhaltungen
- Eine per Link geteilte Unterhaltung enthält die bereits generierten Antworten und damit möglicherweise Auszüge aus Dokumenten. Der Link kann außerhalb der Gruppe weitergegeben werden. Prüfen Sie, wer Freigabelinks erstellen kann und was ein Konto sieht, das ihn öffnet.
- An den Chat angehängte Dateien
- Ein in eine Unterhaltung gezogenes Dokument ist keine Wissensdatenbank und unterliegt nicht denselben Einstellungen. Ein Benutzer der Personalgruppe, der eine Gehaltsabrechnung an eine geteilte Unterhaltung anhängt, hebt die Abschottung auf.
- Zugriff der Administratoren
- Standardmäßig sehen Administratoren die Ressourcen der anderen Konten. Die Dokumentation erwähnt eine Umgebungsvariable (BYPASS_ADMIN_ACCESS_CONTROL), um dieses Verhalten zu ändern; prüfen Sie ihren Namen und ihre Wirkung für Ihre Version. In jedem Fall behält ein Administrator den Zugriff auf den Server und die Datenbank: Begrenzen Sie die Anzahl der Administratorkonten.
- Aus dem Verzeichnisdienst übernommene Gruppen
- Bei einer Synchronisierung über OAuth oder LDAP muss sich ein Ausscheiden oder ein Abteilungswechsel in den Gruppen widerspiegeln. Testen Sie den Fall eines Kontos, das im Verzeichnis aus einer Gruppe entfernt wurde, nachdem es sich erneut angemeldet hat.
Erscheint die Kontrollzeichenfolge, gibt die Wissensdatenbank über diesen Weg Daten preis: Entfernen Sie die Datenbank aus den für dieses Konto zugänglichen Modellen und melden Sie das Verhalten dem Projekt unter Angabe Ihrer Versionsnummer. Erscheint sie nicht, ist der Test nur für diese Version, dieses Modell und dieses Konto negativ. Ein Modell kann auch die Antwort verweigern oder umformulieren: Prüfen Sie die vollständige Antwort und nicht nur die Suche nach der Zeichenfolge.
#Fehlerbehebung
- Ein Benutzer sieht eine für seine Gruppe freigegebene Wissensdatenbank nicht
- Prüfen Sie, ob er tatsächlich Mitglied der Gruppe ist (und nicht einer gleichnamigen Gruppe) und ob er sich neu angemeldet hat. Öffnen Sie eine neue Unterhaltung: Die mit # angebotene Liste wird beim Öffnen erstellt.
- Ein Benutzer sieht eine Wissensdatenbank, die er nicht sehen sollte
- Suchen Sie in dieser Reihenfolge: Datenbank auf öffentlich gestellt, versehentlich hinzugefügte breite Gruppe, Mitgliedschaft in einer zweiten Gruppe, zu weit gefasste Standardberechtigung. Da sich Rechte summieren, ist die Ursache fast immer eine Hinzufügung, keine fehlende Entfernung.
- Der API-Test liefert für alle Konten 401
- API-Schlüssel vom Administrator deaktiviert, Schlüssel mit einem Leerzeichen kopiert oder falsche URL. Testen Sie zuerst das Administratorkonto mit einer Datenbank, die ihm gehört.
- Die Tests über die API bestehen, aber der Chat zeigt die Wissensdatenbank an
- Vergleichen Sie mit demselben Konto in einem privaten Fenster, ohne dass im selben Browser eine Administratorsitzung geöffnet ist. Ein versehentlich mit einer Admin-Sitzung durchgeführter Test ist die häufigste Ursache für falsche Ergebnisse.
- Nach einem Update haben sich die Einstellungen geändert
- Migrationen können Berechtigungen umbenennen oder neu organisieren. Spielen Sie die vollständige Matrix erneut durch und lesen Sie die Versionshinweise des installierten Releases.
#Was überprüft wurde – und was nicht
Am 30.10.2026 hat die Redaktion ein isoliertes Docker-Image von Open WebUI ohne Netzwerkzugang und ohne GPU mit zwei Testkonten gestartet. Eine private, leere Wissensdatenbank, die vom Administratorkonto erstellt wurde, wurde über die API abgefragt: Antwort HTTP 200 für den Administrator, HTTP 401 für das Benutzerkonto. Dies ist die einzige direkte Beobachtung in diesem Leitfaden. Die genaue Version des Images wird hier nicht angegeben.
Nicht getestet wurden: eine Wissensbasis mit Dokumenten, Gruppen und die Freigabe über Gruppen, Schreibrechte, die öffentliche Freigabe, Modelle mit angebundener Wissensbasis, die direkte Referenzierung über die ID, geteilte Unterhaltungen, die Gruppensynchronisierung über einen Verzeichnisdienst sowie ein vollständiges Audit der Instanz. Die Skripte in diesem Leitfaden werden als Methode bereitgestellt; maßgeblich sind allein ihre Ergebnisse auf Ihrer Instanz. Für die anvisierte Suchanfrage wurde kein Suchvolumen gemessen.
#Weiterführende Informationen
- Open WebUI mit Ollama: der komplette Guide
- Installation, Konten und Grundeinstellungen der Oberfläche: https://quelllm.fr/guide/open-webui-ollama-tutoriel
- KI-Chatbot für das Team im Intranet deployen
- Reverse Proxy, Authentifizierung und Betrieb einer Mehrbenutzer-Instanz: https://quelllm.fr/guide/deployer-chatbot-ia-equipe-intranet
- Lokales RAG mit Ollama ohne Programmieren
- Funktionsweise der Wissensdatenbanken in der Benutzeroberfläche: https://quelllm.fr/guide/rag-local-ollama-sans-coder
- Primärquelle
- Open WebUI, offizielle Dokumentation, Authentication & Access > RBAC > Permissions: https://docs.openwebui.com/features/authentication-access/rbac/permissions/ (am 20.11.2026 nicht erneut geprüft; an der installierten Version überprüfen).
Haben Sie Feedback, einen Fehler entdeckt oder möchten Sie etwas präzisieren? Geben Sie uns Bescheid – so wird der Guide für alle besser.