Saltar a contenido

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 POST generado 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.