Open WebUI: gestionar los accesos a las documentos

En cuanto una instancia de Open WebUI da servicio a varios departamentos, la pregunta ya no es solo «¿responde bien el modelo?», sino «¿quién puede consultar qué documentos?». Open WebUI: gestionar el acceso a los documentos depende de tres mecanismos (roles, grupos y visibilidad de cada base de conocimiento) que se combinan de una forma no siempre intuitiva. Esta guía explica ese modelo, propone un procedimiento de aislamiento por grupo y, después, un método para probar cada cuenta por separado y buscar solapamientos. No promete una estanqueidad total: la redacción solo ha observado una parte del recorrido, y así se indica.
#Por qué aislar los documentos en Open WebUI
Una base de conocimiento (Knowledge) de Open WebUI es una colección de archivos divididos en fragmentos e indexados. Cuando un usuario la menciona con # en el chat, o cuando está vinculada a un modelo, Open WebUI busca los fragmentos relacionados con la pregunta y los inyecta en el contexto. El modelo puede entonces reproducir esos fragmentos, a veces palabra por palabra.
Consecuencia directa: tener acceso a una base significa poder leer su contenido, aunque nunca se abra el archivo. En una instancia de equipo, mezclar en una sola base los procedimientos públicos, las nóminas y los contratos con proveedores equivale a dar todos esos documentos a cualquier persona que pueda consultarla. Por tanto, la separación se hace base por base, y no archivo por archivo: un documento sensible debe estar en una base cuyo ámbito de acceso corresponda a su nivel de sensibilidad.
El autoalojamiento resuelve la cuestión de la transferencia a un proveedor externo, pero no la de los accesos internos. Las guías del sitio sobre el RGPD recuerdan que el principio de minimización también se aplica a los compañeros: una persona solo debería acceder a los datos necesarios para su función.
#Roles, grupos y visibilidad de las bases
Aprovecha nuestra experiencia y un recorrido guiado para construir tu RAG local y trabajar con tus propios documentos.
- Espacio en línea de por vida
- PDF + archivos
- Reembolsado 30 d
El control de acceso de Open WebUI se basa en tres capas. Confundirlas es la principal fuente de errores.
- Los roles
- Cada cuenta tiene un rol: administrador, usuario o pendiente (pending). Una cuenta pendiente no puede hacer nada hasta que un administrador la valide. Un administrador gestiona la instancia y, con los ajustes predeterminados, ve el contenido del espacio de trabajo de las demás cuentas. Por tanto, el rol es una barrera poco precisa: separa a quienes administran de quienes usan.
- Los grupos
- Se crean en el panel de administración (sección Usuarios > Grupos) y sirven para dos cosas: llevar permisos funcionales (poder crear bases, compartir, usar ciertas funciones) y servir de destino cuando se comparte un recurso. Un usuario puede pertenecer a varios grupos.
- La visibilidad de un recurso
- Cada base de conocimiento, al igual que cada modelo personalizado, prompt o herramienta, tiene un ajuste de acceso. Privada: solo accede su propietario (y los administradores, según el ajuste descrito más abajo), además de los grupos añadidos explícitamente. Pública: todos los usuarios de la instancia pueden leerla. Para cada grupo añadido, normalmente se elige lectura o escritura.
Así pues, el aislamiento por grupo consiste en mantener las bases privadas y añadir únicamente el grupo o los grupos correspondientes, con permiso de lectura para la mayoría de los miembros. La escritura (añadir, reemplazar o eliminar archivos) se reserva a unas pocas personas, idealmente mediante un grupo distinto del de los lectores.
#Permisos que se suman: la trampa de los permisos predeterminados
Según la documentación oficial, los permisos de Open WebUI son acumulativos: un usuario obtiene la unión de los permisos predeterminados (los que se aplican a todos los usuarios) y los de todos sus grupos. Prevalece el permiso más amplio. No existe ningún grupo de «denegación» que retire un permiso concedido en otro lugar.
Dos consecuencias prácticas. En primer lugar, si los permisos predeterminados autorizan una acción (por ejemplo, compartir públicamente una base), ningún grupo puede quitársela a un usuario: hay que restringir el valor predeterminado y luego volver a habilitar la acción solo para los grupos que la necesiten. En segundo lugar, pertenecer a un grupo adicional solo puede ampliar el acceso. Añadir a una persona al grupo «Dirección» sin quitarla de «Becarios» le da ambos ámbitos.
- Permisos predeterminados
- Es lo primero que debes configurar, de la forma más restrictiva razonable: sin uso compartido público y con la creación de bases limitada si la instancia no es un entorno de pruebas.
- Permisos de grupo
- Vuelven a habilitar funciones para un subconjunto: por ejemplo, un grupo «Editores de documentación» que puede crear y compartir bases.
- Acceso por recurso
- Independiente de los permisos funcionales: poder crear bases no da acceso a las bases de los demás. Es la configuración de cada base la que decide quién puede leerla.
#Prerrequisitos
- Una instancia de Open WebUI actualizada
- Instalada y conectada a Ollama (por defecto en http://localhost:11434), con un modelo de embeddings operativo. La guía «Open WebUI con Ollama: guía completa» cubre la instalación.
- Una copia de seguridad verificada
- Reorganizar los accesos implica modificar bases que se usan a diario. Archiva el volumen de Docker antes de empezar (consulta «Restaurar Open WebUI y Ollama tras una avería»).
- Un mapa de los documentos
- Una tabla sencilla: qué base, qué documentos, qué nivel de sensibilidad, qué departamentos deben leer y quién debe escribir. Sin ella, la configuración se hace a medida que llegan las solicitudes y acaba desviándose.
- Cuentas de prueba
- Al menos una cuenta sin permisos de administrador por cada grupo que haya que verificar, además de una cuenta que no pertenezca a ningún grupo. Las pruebas realizadas con una cuenta de administrador no demuestran nada sobre el acceso de los usuarios.
- Las claves de API autorizadas
- Para las pruebas desde la línea de comandos, el administrador debe permitir las claves de API (ajustes de administración); cada cuenta de prueba genera una desde Ajustes > Cuenta.
#Gestionar el acceso a los documentos en Open WebUI: 5 pasos
- 011. Restringir los permisos predeterminadosEn el panel de administración, abre los permisos predeterminados de los usuarios. Desactiva el uso compartido público de las bases de conocimiento y de los modelos, y limita la creación de bases si no todos la necesitan. Comprueba también el rol que se asigna a los nuevos registros: «pendiente» evita que una cuenta creada por error acceda de inmediato a cualquier cosa.
- 022. Crear los gruposUn grupo por ámbito documental («RR. HH.», «Contabilidad», «Soporte») y, si hace falta, un grupo de editores por ámbito. Ponles el mismo nombre que a las bases correspondientes: así te resultará más sencillo revisar la configuración. Si tus grupos provienen de un directorio mediante OAuth o LDAP, consulta en la documentación de tu versión cómo se configura la sincronización de grupos y si un grupo eliminado en el directorio también se elimina en Open WebUI.
- 033. Crear o reorganizar las basesEn Espacio de trabajo > Conocimiento, una base por ámbito. Para trasladar un documento sensible de una base amplia a una base restringida, tienes que eliminarlo explícitamente de la primera: un archivo importado en dos bases existe dos veces, con dos configuraciones de acceso.
- 044. Configurar el acceso de cada baseDeja la base como privada, añade el grupo correspondiente con permiso de lectura y el grupo de editores con permiso de escritura. Evita añadir a las personas una por una: el acceso individual se pierde con las bajas y los cambios de puesto, mientras que un grupo se mantiene actualizado en un único lugar.
- 055. Controlar los modelos que llevan basesUn modelo personalizado (Espacio de trabajo > Modelos) puede tener bases vinculadas. Configura el acceso al modelo de forma al menos tan estricta como el de las bases que lleva, y prueba este caso en particular (consulta la sección sobre los solapamientos).
#Probar los accesos de cada usuario por separado
La interfaz de administración muestra lo que está configurado, no lo que un usuario obtiene realmente. La única comprobación concluyente consiste en ponerse en la piel de cada cuenta. Dos métodos complementarios: una ventana de navegación privada por cada cuenta de prueba (para ver las listas y el chat como los ve el usuario) y llamadas a la API con la clave de cada cuenta (para obtener códigos HTTP reproducibles y fechados).
El script de abajo consulta, para cada cuenta de prueba, la lista de bases visibles y luego una base concreta, y registra los códigos de respuesta. Las claves se leen desde archivos privados, una por cuenta, y nunca se pasan en claro en el comando. Las rutas /api/v1/knowledge/ son las de la API de Open WebUI; confírmalas en tu versión. El puerto 3000 corresponde al comando de Docker más habitual (-p 3000:8080).
Un código 200 en la base significa que la cuenta puede leerla por la API; un código 401 o 403 significa un rechazo. El código de la lista suele ser 200 para cualquier cuenta válida: lo que importa es su contenido. El siguiente comando muestra los nombres de las bases visibles para una cuenta; según la versión, la respuesta es un array o un objeto que contiene un array, de ahí el filtro que gestiona ambos casos.
Después, construye una matriz: una fila por cuenta, una columna por base, el valor esperado (lectura, escritura, ninguno) y el valor observado. Cualquier celda en la que lo observado sea más amplio que lo esperado es un fallo que debes corregir antes de importar documentos reales. Vuelve a ejecutar la matriz después de cada actualización de Open WebUI y de cada modificación de grupos: una configuración correcta hoy puede verse alterada por una migración o por un error de manipulación.
#Solapamientos que hay que verificar
Denegar el acceso directo a una base no basta para demostrar que una cuenta no puede obtener su contenido. En una instancia de Open WebUI existen varias vías indirectas; su comportamiento depende de la versión y de la configuración, y la redacción no ha probado ninguna de ellas. Son hipótesis que hay que poner a prueba con el documento testigo, no vulnerabilidades constatadas.
- Modelo con base vinculada
- Un usuario que tiene acceso a un modelo personalizado que lleva asociada una base, pero no a la base en sí: ¿obtiene los fragmentos de la base al conversar con el modelo? Pruébalo haciéndole al modelo una pregunta sobre la frase testigo.
- Referencia directa por identificador
- La API de completado acepta una lista de archivos o colecciones para usarlos como contexto. ¿Puede una cuenta no autorizada que conozca el identificador de una base mencionarla de este modo? Consulta la llamada de prueba de abajo.
- Conversaciones compartidas
- Una conversación compartida mediante enlace contiene las respuestas ya generadas y, por tanto, posiblemente fragmentos de documentos. El enlace puede circular fuera del grupo. Comprueba quién puede crear enlaces para compartir y qué ve una cuenta que lo abre.
- Archivos adjuntos al chat
- Un documento arrastrado a una conversación no es una base de conocimiento y no se rige por la misma configuración. Un usuario del grupo de RR. HH. que adjunta una nómina en una conversación compartida anula el aislamiento.
- Acceso de los administradores
- De forma predeterminada, los administradores ven los recursos de las demás cuentas. La documentación menciona una variable de entorno (BYPASS_ADMIN_ACCESS_CONTROL) para cambiar este comportamiento; comprueba su nombre y su efecto en tu versión. En cualquier caso, un administrador conserva el acceso al servidor y a la base de datos: limita el número de cuentas de administrador.
- Grupos heredados del directorio
- Con una sincronización OAuth o LDAP, una baja o un cambio de departamento debe reflejarse en los grupos. Prueba el caso de una cuenta eliminada de un grupo en el directorio, después de que vuelva a iniciar sesión.
Si aparece la cadena testigo, la base tiene una fuga por esa vía: retira la base de los modelos accesibles para esa cuenta e informa del comportamiento al proyecto indicando tu número de versión. Si no aparece, la prueba solo es negativa para esa versión, ese modelo y esa cuenta. Un modelo también puede negarse a responder o reformular: examina la respuesta completa, y no te limites a buscar la cadena.
#Solución de problemas
- Un usuario no ve una base compartida con su grupo
- Comprueba que sea realmente miembro del grupo (y no de un grupo con el mismo nombre) y, después, que haya vuelto a iniciar sesión. Abre una conversación nueva: la lista que se ofrece con # se genera al abrirla.
- Un usuario ve una base que no debería ver
- Revisa en este orden: base cambiada a pública, grupo amplio añadido por error, pertenencia a un segundo grupo, permiso predeterminado demasiado amplio. Como los permisos se acumulan, la causa casi siempre es algo que se añadió, no algo que faltó quitar.
- La prueba de la API devuelve 401 para todas las cuentas
- Claves de API desactivadas por el administrador, clave copiada con un espacio o URL incorrecta. Prueba primero la cuenta de administrador en una base de su propiedad.
- Las pruebas pasan por la API, pero el chat muestra la base
- Compara con la misma cuenta en navegación privada, sin ninguna sesión de administrador abierta en el mismo navegador. Una prueba hecha por error con una sesión de administrador es la causa más frecuente de resultados falsos.
- Tras una actualización, los ajustes han cambiado
- Las migraciones pueden renombrar o reorganizar los permisos. Vuelve a ejecutar la matriz completa y revisa las notas de la versión instalada.
#Lo que se verificó y lo que no
El 30/10/2026, la redacción ejecutó una imagen Docker de Open WebUI aislada, sin acceso a la red ni GPU, con dos cuentas ficticias. Se solicitó mediante la API una base de conocimiento privada y vacía, creada por la cuenta de administrador: respuesta HTTP 200 para el administrador y HTTP 401 para la cuenta de usuario. Es la única observación directa de esta guía. La versión exacta de la imagen no se indica aquí.
No se han probado: una base que contenga documentos, los grupos y el uso compartido por grupo, los permisos de escritura, el uso compartido público, los modelos que llevan una base, la referencia directa por identificador, las conversaciones compartidas, la sincronización de grupos mediante directorio ni una auditoría completa de la instancia. Los scripts de esta guía se ofrecen como método; los únicos resultados que cuentan son los que obtengas en tu instancia. No se ha medido ningún volumen de búsqueda para la consulta objetivo.
#Para ir más allá
- Open WebUI con Ollama: guía completa
- Instalación, cuentas y ajustes básicos de la interfaz: https://quelllm.fr/guide/open-webui-ollama-tutoriel
- Desplegar un chatbot de IA para tu equipo en una intranet
- Proxy inverso, autenticación y operación de una instancia multiusuario: https://quelllm.fr/guide/deployer-chatbot-ia-equipe-intranet
- RAG local con Ollama sin programar
- Funcionamiento de las bases de conocimiento en la interfaz: https://quelllm.fr/guide/rag-local-ollama-sans-coder
- Fuente primaria
- Open WebUI, documentación oficial, Authentication & Access > RBAC > Permissions: https://docs.openwebui.com/features/authentication-access/rbac/permissions/ (no revisada el 20/11/2026; comprobar en la versión instalada).
¿Un comentario, un error, una precisión? Avísanos, eso mejora la guía para todos.