Open WebUI: gestire gli accessi alle documenti

Non appena un'istanza Open WebUI serve più reparti, la domanda non è più solo «il modello risponde bene?» ma «chi può interrogare quali documenti?». Open WebUI: gestire gli accessi ai documenti passa per tre meccanismi (ruoli, gruppi, visibilità di ogni knowledge base) che si combinano in un modo non sempre intuitivo. Questa guida spiega questo modello, propone una procedura di isolamento per gruppo e poi un metodo per testare ogni account separatamente e cercare le sovrapposizioni. Non promette una tenuta stagna globale: solo una parte del percorso è stata osservata dalla redazione, ed è indicato.
#Perché separare i documenti in Open WebUI
Una base di conoscenza (Knowledge) di Open WebUI è una raccolta di file suddivisi in passaggi e indicizzati. Quando un utente la richiama con # nella chat, o quando è collegata a un modello, Open WebUI cerca i passaggi più pertinenti alla domanda e li inserisce nel contesto. Il modello può quindi riprodurre questi passaggi, a volte parola per parola.
Conseguenza diretta: avere accesso a una base significa poterne leggere il contenuto, anche senza mai aprire il file. Su un'istanza di team, mescolare in un'unica base le procedure pubbliche, le buste paga e i contratti con i fornitori equivale a consegnare tutti questi documenti a chiunque possa interrogarla. La compartimentazione si fa quindi base per base, non file per file: un documento sensibile deve stare in una base il cui perimetro di accesso corrisponda alla sua sensibilità.
Il self-hosting risolve la questione del trasferimento verso un fornitore esterno, non quella degli accessi interni. Le guide del sito sul GDPR ricordano che il principio di minimizzazione si applica anche ai colleghi: una persona dovrebbe accedere solo ai dati necessari alla propria mansione.
#Ruoli, gruppi e visibilità delle knowledge base
Approfitta della nostra esperienza e di un percorso guidato per costruire il tuo RAG locale e lavorare con i tuoi documenti.
- Spazio online a vita
- PDF + file
- Garanzia di rimborso di 30 giorni
Il controllo degli accessi di Open WebUI si basa su tre livelli. Confonderli è la prima fonte di errori.
- I ruoli
- Ogni account ha un ruolo: amministratore, utente o in attesa (pending). Un account in attesa non può fare nulla finché un amministratore non lo approva. Un amministratore gestisce l'istanza e, con le impostazioni predefinite, vede il contenuto dello spazio di lavoro degli altri account. Il ruolo è quindi una barriera grossolana: separa chi amministra da chi utilizza.
- I gruppi
- Creati nel pannello di amministrazione (sezione Utenti > Gruppi), servono a due cose: attribuire permessi funzionali (poter creare basi, condividere, usare determinate funzioni) e fungere da destinatari quando si condivide una risorsa. Un utente può appartenere a più gruppi.
- La visibilità di una risorsa
- Ogni base di conoscenza, così come ogni modello personalizzato, prompt o strumento, ha un'impostazione di accesso. Privata: vi accede solo il proprietario (e gli amministratori, in base all'impostazione descritta più sotto), oltre ai gruppi aggiunti esplicitamente. Pubblica: tutti gli utenti dell'istanza possono leggerla. Per ogni gruppo aggiunto si sceglie in genere tra lettura e scrittura.
L'isolamento per gruppo consiste quindi nel mantenere private le basi e poi aggiungere soltanto il gruppo o i gruppi interessati, in lettura per la maggior parte dei membri. La scrittura (aggiungere, sostituire, eliminare file) va riservata a poche persone, idealmente tramite un gruppo distinto da quello dei lettori.
#Diritti che si sommano: la trappola dei permessi predefiniti
Secondo la documentazione ufficiale, i permessi di Open WebUI sono cumulativi: un utente ottiene l'unione dei permessi predefiniti (quelli che si applicano a tutti gli utenti) e di quelli di tutti i suoi gruppi. Prevale il permesso più ampio. Non esiste un gruppo «divieto» che revochi un diritto concesso altrove.
Due conseguenze pratiche. Innanzitutto, se i permessi predefiniti autorizzano un'azione (per esempio condividere pubblicamente una knowledge base), nessun gruppo può toglierla a un utente: bisogna restringere il valore predefinito e poi riabilitare l'azione solo per i gruppi che ne hanno bisogno. Inoltre, l'appartenenza a un gruppo aggiuntivo può solo ampliare gli accessi. Aggiungere una persona al gruppo «Direction» senza toglierla da «Stagiaires» le dà entrambi gli ambiti.
- Permessi predefiniti
- Da configurare per primi, al livello più restrittivo ragionevole: nessuna condivisione pubblica, creazione di basi limitata se l'istanza non è un ambiente sandbox.
- Permessi di gruppo
- Riaprono funzioni per un sottoinsieme di utenti: per esempio, un gruppo «Editor documentazione» che può creare e condividere basi.
- Accesso per risorsa
- Indipendente dai permessi funzionali: poter creare knowledge base non dà accesso alle knowledge base degli altri. È l'impostazione di ciascuna knowledge base a decidere chi può leggerla.
#Prerequisiti
- Un'istanza Open WebUI aggiornata
- Installata e collegata a Ollama (per impostazione predefinita su http://localhost:11434), con un modello di embedding funzionante. La guida «Open WebUI avec Ollama: guide complet» tratta l'installazione.
- Un backup verificato
- Riorganizzare gli accessi significa modificare basi usate ogni giorno. Archivia il volume Docker prima di iniziare (vedi «Ripristinare Open WebUI e Ollama dopo un guasto»).
- Una mappatura dei documenti
- Una semplice tabella: quale base, quali documenti, quale livello di sensibilità, quali reparti devono leggere, chi deve scrivere. Senza di essa, la configurazione si fa man mano che arrivano le richieste e finisce per andare alla deriva.
- Account di test
- Almeno un account non amministratore per ogni gruppo da verificare, più un account che non appartiene a nessun gruppo. I test fatti con un account amministratore non dimostrano nulla sugli accessi degli utenti.
- Le chiavi API autorizzate
- Per i test da riga di comando, l'amministratore deve abilitare le chiavi API (impostazioni di amministrazione); ogni account di test ne genera una da Impostazioni > Account.
#Gestire gli accessi ai documenti in Open WebUI: 5 passaggi
- 011. Restringere i permessi predefinitiNel pannello di amministrazione, apri i permessi predefiniti degli utenti. Disattiva la condivisione pubblica delle knowledge base e dei modelli, e limita la creazione di knowledge base se non è necessaria a tutti. Verifica anche il ruolo assegnato ai nuovi iscritti: «in attesa» evita che un account creato per errore acceda immediatamente a qualsiasi cosa.
- 022. Creare i gruppiUn gruppo per ambito documentale («RH», «Comptabilité», «Support») e, se necessario, un gruppo di editor per ambito. Dai loro lo stesso nome delle knowledge base corrispondenti: così la revisione delle impostazioni sarà più semplice. Se i tuoi gruppi provengono da una directory tramite OAuth o LDAP, verifica nella documentazione della tua versione come è configurata la sincronizzazione dei gruppi e se un gruppo rimosso dalla directory viene rimosso anche in Open WebUI.
- 033. Creare o riorganizzare le knowledge baseIn Area di lavoro > Conoscenza, una knowledge base per ambito. Spostare un documento sensibile da una knowledge base ampia a una ristretta richiede di rimuoverlo esplicitamente dalla prima: un file importato in due knowledge base esiste due volte, con due impostazioni di accesso.
- 044. Configurare l'accesso di ogni knowledge baseLascia la knowledge base privata, aggiungi il gruppo interessato in lettura e il gruppo degli editor in scrittura. Evita di aggiungere le persone una per una: l'accesso individuale si perde con le uscite e i cambi di ruolo, mentre un gruppo si tiene aggiornato in un unico punto.
- 055. Controllare i modelli che contengono knowledge baseUn modello personalizzato (Area di lavoro > Modelli) può avere knowledge base collegate. Configura l'accesso al modello in modo almeno altrettanto restrittivo di quello delle knowledge base che contiene, e testa questo caso in particolare (vedi la sezione sulle sovrapposizioni).
#Testare separatamente gli accessi di ogni utente
L'interfaccia di amministrazione mostra ciò che è configurato, non ciò che un utente ottiene realmente. L'unico controllo probante consiste nel mettersi nei panni di ogni account. Due metodi complementari: una finestra di navigazione privata per ogni account di test (per vedere gli elenchi e la chat come li vede l'utente) e chiamate all'API con la chiave di ciascun account (per ottenere codici HTTP riproducibili e datati).
Lo script qui sotto interroga, per ogni account di test, l'elenco delle basi visibili e poi una base specifica, e registra nel log i codici di risposta. Le chiavi vengono lette da file privati, una per account, e non vengono mai passate in chiaro nel comando. Le route /api/v1/knowledge/ sono quelle dell'API di Open WebUI; verificale sulla tua versione. La porta 3000 corrisponde al comando Docker più comune (-p 3000:8080).
Un codice 200 sulla knowledge base significa che l'account può leggerla tramite l'API; un codice 401 o 403 indica un rifiuto. Il codice dell'elenco è in genere 200 per qualsiasi account valido: è il suo contenuto che conta. Il comando seguente mostra i nomi delle knowledge base visibili a un account; a seconda della versione, la risposta è un array o un oggetto contenente un array, da qui il filtro che gestisce entrambi i casi.
Costruisci poi una matrice: una riga per account, una colonna per knowledge base, il valore atteso (lettura, scrittura, nessuno) e il valore osservato. Ogni cella in cui il valore osservato è più ampio di quello atteso è un difetto da correggere prima di importare documenti reali. Riesegui la matrice dopo ogni aggiornamento di Open WebUI e dopo ogni modifica dei gruppi: un'impostazione corretta oggi può essere modificata da una migrazione o da un errore di manipolazione.
#Sovrapposizioni da verificare
Negare l'accesso diretto a una base non basta a dimostrare che un account non possa ottenerne il contenuto. In un'istanza Open WebUI esistono diversi percorsi indiretti; il loro comportamento dipende dalla versione e dalla configurazione, e nessuno è stato testato dalla redazione. Sono ipotesi da mettere alla prova con il documento testimone, non vulnerabilità accertate.
- Modello con knowledge base collegata
- Un utente che ha accesso a un modello personalizzato a cui è collegata una base, ma non alla base stessa: ottiene i passaggi della base conversando con il modello? Fai la prova ponendo al modello una domanda sulla frase testimone.
- Riferimento diretto tramite identificativo
- L'API di completamento accetta un elenco di file o di raccolte da usare come contesto. Un account non autorizzato che conosce l'identificativo di una base può richiamarla in questo modo? Vedi la chiamata di test qui sotto.
- Conversazioni condivise
- Una conversazione condivisa tramite link contiene le risposte già generate, quindi potenzialmente estratti di documenti. Il link può circolare al di fuori del gruppo. Verifica chi può creare link di condivisione e cosa vede un account che lo apre.
- File allegati alla chat
- Un documento trascinato in una conversazione non è una knowledge base e non segue le stesse impostazioni. Un utente del gruppo RH che allega una busta paga in una conversazione condivisa annulla la separazione.
- Accesso degli amministratori
- Per impostazione predefinita, gli amministratori vedono le risorse degli altri account. La documentazione menziona una variabile d'ambiente (BYPASS_ADMIN_ACCESS_CONTROL) per modificare questo comportamento; verifica il suo nome e il suo effetto sulla tua versione. In ogni caso, un amministratore mantiene l'accesso al server e al database: limita il numero di account amministratore.
- Gruppi ereditati dalla directory
- Con una sincronizzazione OAuth o LDAP, l'uscita di una persona o un cambio di reparto devono riflettersi nei gruppi. Testa il caso di un account rimosso da un gruppo lato directory, dopo che ha effettuato di nuovo l'accesso.
Se la stringa testimone compare, la base perde dati attraverso questo percorso: rimuovi la base dai modelli accessibili a quell'account e segnala il comportamento al progetto indicando il tuo numero di versione. Se non compare, il test è negativo solo per questa versione, questo modello e questo account. Un modello può anche rifiutarsi di rispondere o riformulare: esamina la risposta completa, non limitarti a cercare la stringa.
#Risoluzione dei problemi
- Un utente non vede una base condivisa con il suo gruppo
- Verifica che sia effettivamente membro del gruppo (e non di un gruppo omonimo), poi che abbia effettuato di nuovo l'accesso. Apri una nuova conversazione: l'elenco proposto con # viene costruito all'apertura.
- Un utente vede una base che non dovrebbe vedere
- Cerca in quest'ordine: knowledge base resa pubblica, gruppo ampio aggiunto per errore, appartenenza a un secondo gruppo, permesso predefinito troppo ampio. Poiché i diritti sono cumulativi, la causa è quasi sempre un'aggiunta, non una rimozione mancata.
- Il test API risponde 401 per tutti gli account
- Chiavi API disattivate dall'amministratore, chiave copiata con uno spazio o URL sbagliato. Testa prima l'account amministratore su una knowledge base di sua proprietà.
- I test via API vanno a buon fine ma la chat mostra la base
- Confronta con lo stesso account in navigazione privata, senza una sessione da amministratore aperta nello stesso browser. Un test fatto per errore con una sessione da amministratore è la causa più frequente di risultati falsati.
- Dopo l'aggiornamento, le impostazioni sono cambiate
- Le migrazioni possono rinominare o riorganizzare i permessi. Riesegui la matrice completa e rileggi le note di rilascio della release installata.
#Cosa è stato verificato e cosa no
Il 30/10/2026 la redazione ha avviato un'immagine Docker di Open WebUI isolata, senza accesso alla rete né GPU, con due account fittizi. Una knowledge base privata e vuota, creata dall'account amministratore, è stata richiesta tramite l'API: risposta HTTP 200 per l'amministratore, HTTP 401 per l'account utente. È l'unica osservazione diretta di questa guida. La versione esatta dell'immagine non è riportata qui.
Non sono stati testati: una knowledge base contenente documenti, i gruppi e la condivisione per gruppo, i permessi di scrittura, la condivisione pubblica, i modelli associati a una knowledge base, il riferimento diretto tramite identificativo, le conversazioni condivise, la sincronizzazione dei gruppi tramite directory, né un audit completo dell'istanza. Gli script di questa guida sono forniti come metodo; i risultati che ottieni sulla tua istanza sono gli unici che contano. Non è stato misurato alcun volume di ricerca per la query di riferimento.
#Per approfondire
- Open WebUI con Ollama: guida completa
- Installazione, account e impostazioni di base dell'interfaccia: https://quelllm.fr/guide/open-webui-ollama-tutoriel
- Distribuire un chatbot IA per il proprio team sull'intranet
- Reverse proxy, autenticazione e gestione di un'istanza multiutente: https://quelllm.fr/guide/deployer-chatbot-ia-equipe-intranet
- RAG locale con Ollama senza scrivere codice
- Funzionamento delle knowledge base lato interfaccia: https://quelllm.fr/guide/rag-local-ollama-sans-coder
- Fonte primaria
- Open WebUI, documentazione ufficiale, Authentication & Access > RBAC > Permissions: https://docs.openwebui.com/features/authentication-access/rbac/permissions/ (non riletta il 20/11/2026; da verificare sulla versione installata).
Un feedback, un errore, una precisazione? Facci sapere, così la guida migliora per tutti.