Roles y acceso¶
Quién puede hacer qué se declara en api/rbac/chatbot.py, con el DSL de
RBAC de tai-api. init lo copia y a partir
de ahí es tuyo: tai-api no lo pisa al regenerar.
tai-chat api rbac push -r chatbot # lleva los roles a la base de datos
tai-chat db push # también lo hace, al final
Como el resto de comandos declarativos, enseña el plan y pregunta antes de aplicar.
Lo que trae¶
source(realm_name="chatbot", dbschemas=["chatbot"])
# Las conversaciones son de quien las abrió, por su identidad
owner("chatbot", "chat", "usuario_id", compare_to="user_id")
owner("chatbot", "tokens_mensaje", "usuario_id", compare_to="user_id")
role(
name="Administrador",
api_permissions=[RealmResources.ADMIN, Chat.ADMIN, Mensaje.ADMIN, ...],
app_permissions=[gestion_usuarios, consumo, laboratorio],
)
role(
name="Usuario",
api_permissions=[Chat.READ, Mensaje.READ, TokensMensaje.READ],
)
| Rol | Qué puede |
|---|---|
| Administrador | Todo lo del chatbot: sus tablas, los usuarios de su realm y todas las pantallas |
| Usuario | Chatear: sus conversaciones, sus mensajes y su consumo |
Cada uno ve lo suyo¶
owner("chatbot", "chat", "usuario_id", compare_to="user_id") dice que una conversación es de quien la abrió. tai-api lo
aplica en el CRUD generado, y el asistente aplica la misma regla en sus rutas: un usuario solo
lee, escribe y conecta el WebSocket a sus conversaciones. La de otro le devuelve un 404, como si no
existiera.
La regla alcanza a lo que cuelga de una conversación —sus mensajes y sus llamadas a herramientas— y
no la salta nadie, tampoco el Administrador. Si un rol tuviera que ver las conversaciones de
todos, se declararía con exempt.
Es de su identidad, no de su nombre (compare_to="user_id"): la columna guarda el id del usuario en auth, el
que lleva su token, que no se reutiliza. Un nombre sí: si se elimina a «ana» y se crea otra «ana», la
nueva es otra persona y no ve nada de la anterior.
Eliminar un usuario¶
Desde la administración (o con el DELETE de /rbac), eliminar a un usuario le quita el acceso: no
puede entrar, y su sesión deja de valer en la siguiente petición. Lo suyo se conserva: sus
conversaciones, sus mensajes, su contexto y su consumo, con su identidad. No las ve nadie en la
aplicación, porque la regla de arriba acota también al Administrador; se ven en tai-chat feedback y
tai-chat consumo.
En Consumo sigue con lo que gastó, como «@ana · eliminado», y su gasto suma en los totales. Si se crea otro usuario con el mismo nombre, son dos filas: cada uno con su consumo y su límite.
Para quitar solo el acceso, sin eliminar, se desactiva.
Por qué el Usuario no escribe por el CRUD¶
El rol que chatea tiene solo permisos de lectura sobre las tablas. Crear, renombrar, ocultar o
valorar una conversación va por las rutas de /assistant, que hacen algo más que el CRUD:
- crear una conversación por el
POSTgenerado permitiría mandar en el cuerpo mensajes y consumo inventados; - ocultarla tiene que borrar también la memoria del agente;
- con permiso de escritura sobre los mensajes podría reescribir lo que contestó el asistente.
Los permisos de aplicación¶
Deciden qué pantallas enseña el front. No protegen nada: lo que protege es el permiso de API de cada endpoint.
| Permiso | Qué enseña |
|---|---|
app-gestion-usuarios |
La gestión de usuarios |
app-consumo |
El consumo de todos, los modelos, las tarifas, los límites y las bolsas |
app-lab |
Los pasos del agente en cada respuesta: herramientas, argumentos, resultados y tokens |
Añadir un rol¶
Un rol para quien, además de chatear, ve el detalle de cada respuesta:
role(
name="Analista",
description="Chatea y ve los pasos del agente",
api_permissions=[Chat.READ, Mensaje.READ, TokensMensaje.READ, ToolCall.READ],
app_permissions=[laboratorio],
)
Las constantes (Chat.READ, ToolCall.READ…) las escribe tai-chat api generate a partir del
schema: una errata no compila, y una tabla nueva las tiene en cuanto se regenera.
Si el chatbot lee datos de otros schemas con sus herramientas, el rol necesita los permisos de
esas tablas y ese schema en su source. Herramientas que leen datos lo
explica.
Sin sudo¶
Ningún rol del chatbot lleva sudo ni allresources-*. Valen para cualquier realm y cualquier
tabla, y el schema auth es del repositorio: con sudo, el admin del chatbot gestionaría los
usuarios de las demás aplicaciones. Lo suyo es administrar su realm.