Roles y acceso¶
Esta página explica cómo decide OS lo que alguien puede hacer en una organización: roles, grupos, atributos, el documento de reglas de la organización, cómo llega un socio a las organizaciones que tiene debajo, y por qué nadie puede dar más de lo que tiene. No contiene pasos; las páginas de tareas de Administrar muestran cómo configurarlo.
En resumen¶
Por defecto nadie puede hacer nada. Todo lo que alguien puede hacer se le ha dado: mediante un rol,
un grupo o el documento de reglas. Solo el rol member lo recibe cada miembro automáticamente.
También hay un «no», una regla que deniega, y siempre prevalece sobre un «sí». Con una cosa puedes
hacer cuatro cosas: verla (lo que no puedes ver no existe para ti), usarla, crearla o
modificarla y eliminarla.
De abajo arriba, funciona así:
- Las reglas son la base. Cada permiso es una regla: «quien [condición] puede [acción] sobre [cosa]». Los roles integrados también están hechos de reglas. Consulta Una regla decide.
- Un rol es un paquete de reglas con nombre. Das a alguien un rol en lugar de reglas sueltas. Las reglas que no están en ningún rol están en el documento de reglas: valen para toda la organización, y su condición decide para quién. Consulta Roles y El documento de reglas.
- Los atributos son datos sobre una persona, como departamento = Ventas. Por sí solos no dan ningún permiso; solo cuentan cuando una regla los lee. Son el «si» de una regla. Consulta Atributos.
- Los grupos dan cosas a muchas personas a la vez: roles y valores de atributos. Quien está en el grupo los tiene; quien sale los pierde. Consulta Grupos.
- Un rol tiene un alcance. Vale en tu propia organización, o en esta organización y todo lo que está debajo. Así un socio ayuda a sus clientes sin ser miembro de ellas. Consulta Socios y las organizaciones que están debajo.
Persona ──── está en ────────────> Grupo
│ │
├── tiene rol <───────────────────┤ da rol
│ (rol = paquete de reglas) │
└── tiene atributo <──────────────┘ da valor de atributo
(departamento, oficina …)
Una persona también puede recibir un rol o un atributo directamente, sin grupo.
Regla: «quien [rol, grupo o atributo] puede [acción] sobre [tipo de cosa, con o sin etiqueta]»
Un ejemplo. La organización conoce el atributo «departamento», con los valores Ventas y RR. HH. El administrador crea un rol propio «Personal del propio departamento»; no es un rol integrado, lo crea él mismo. Ese rol contiene una regla: «puede ver y modificar a los miembros cuyo departamento es el mismo que el mío». El grupo «Equipo de RR. HH.» da departamento = RR. HH. y ese rol. Quien está en el equipo de RR. HH. administra solo a las personas de RR. HH. Dar ese rol a alguien es un solo paso: añadirlo al grupo.
Los roles integrados son member (cada miembro), org-admin (todo en la propia
organización), people-admin (miembros y grupos), assistant-editor (asistentes), auditor
(leer el registro de auditoría) y consultant (la mesa del chat directo). operator es solo para los
operadores del entorno. Además puedes crear hasta 100 roles propios. Lo que permite exactamente cada rol integrado
está en Roles.
Dos reglas de seguridad. Nunca das más de lo que tienes (Nadie da más de lo que tiene), y cada cambio en el acceso queda en el registro de auditoría. Además, todo queda dentro del servicio de la organización.
Dónde se configura. En Gestión, en Personas y acceso:
- Usuarios: para cada miembro, las pestañas Roles, Atributos y Grupos;
- Grupos de usuarios: para cada grupo, las pestañas Miembros, Roles y Atributos;
- Roles, Atributos, Documento de reglas y Cuentas de servicio.
Dar a un grupo un valor de atributo se hace en la pestaña Atributos del grupo (Dar un valor); cada miembro del grupo tiene ese valor mientras esté en el grupo. Quién puede usar algo se configura además en la propia cosa: en un asistente, Quién puede ver y usar este asistente; en un proyecto, Ajustes › Compartir; y en una herramienta, Se ofrece a (para personas, o solo para asistentes). Los botones que ves dependen de lo que puedes hacer (Lo que ves en OS).
Una regla decide¶
Todo lo que alguien puede hacer en OS proviene de reglas. Una regla dice, sobre un tipo de
cosa (un grupo, un miembro, un agente, una conversación), si lo permite (permit) o lo deniega
(forbid), para qué acciones y bajo qué condiciones.
Hay cuatro acciones:
| Acción | Significado |
|---|---|
see |
ver la cosa: en una lista o al abrirla |
use |
usar la cosa: un agente en una conversación, dar un rol a otra persona |
write |
crear o modificar la cosa |
delete |
eliminar la cosa |
Tres convenciones deciden cada caso:
- Nada se puede hacer sin una regla que lo permita. El orden de las reglas no importa.
- Una regla que deniega prevalece. Si encaja un
forbid, OS deniega, diga lo que diga unpermit. - Ninguna acción incluye otra. Quien puede modificar pero no ver, no encuentra la cosa. Lo que no puedes ver no existe para ti: OS responde como si no estuviera.
Una regla puede poner condiciones a la cosa (el nombre, o una etiqueta que lleva) y a la persona (un atributo que tiene). Una regla solo vale si se cumplen todas sus condiciones; quien quiera permitir dos valores escribe dos reglas. Cómo es exactamente una regla está en Tipos y acciones.
Roles¶
Un rol es un conjunto de reglas con nombre. Quien tiene un rol queda sujeto a sus reglas. Un miembro recibe un rol directamente, o mediante un grupo al que pertenece.
Todas las organizaciones tienen los mismos roles integrados. Son iguales en todas partes y no se modifican.
| Rol | Para quién | Qué puede hacer |
|---|---|---|
member |
todo miembro activo, automáticamente | ver la organización, sus grupos y los roles integrados, y su propia membresía |
people-admin |
administrador de personas | ver y administrar miembros e invitaciones, retirar invitaciones, ver y administrar grupos, dar los roles member y people-admin; seguir, iniciar, detener y eliminar las ejecuciones de los empleados virtuales y activarlos o desactivarlos, sin crearlos ni cambiarlos |
org-admin |
administrador | todo en la propia organización: miembros, invitaciones, grupos, roles, atributos, el documento de reglas, el registro de auditoría, dominios, el inicio de sesión de tu empresa y la lectura de su servicio |
auditor |
auditor | leer el registro de auditoría |
operator |
los operadores del entorno | lo que org-admin puede en cualquier organización; además, decidir dónde están sus datos y administrar los planes; solo se puede dar en la organización más alta |
consultant |
equipo de soporte | todo lo que puede member, y la mesa del chat directo: tomar un chat que una persona pasó a un compañero, responder, devolverlo o cerrarlo |
assistant-editor |
editores de asistentes | todo lo que puede member, y crear, cambiar y eliminar los asistentes de sus valores (ver Editores de asistentes), las evaluaciones, y seguir, iniciar y eliminar las ejecuciones de los empleados virtuales |
Además, un administrador crea roles propios para su organización: por ejemplo un rol «Jefe de equipo» que puede administrar a los miembros de su propio departamento. Una organización tiene como máximo 100, cada uno con como máximo 200 reglas. Consulta Administrar roles.
Lo que permiten los roles integrados en las funciones de IA¶
Los roles integrados también contienen reglas sobre las funciones de IA: modelos, agentes, conocimiento, archivos y conversaciones.
Todos los roles integrados pueden usar todos los modelos, herramientas, agentes, prompts, skills, planificaciones, workflows, conocimiento y archivos de la organización. Lo que el servicio de la organización no contiene, tampoco puede un rol integrado. De las conversaciones, la memoria, los archivos guardados y las filas del datastore, un miembro accede a las suyas y a las compartidas, que no son de nadie en particular.
Un administrador nunca ve las conversaciones, la memoria ni los archivos de un compañero. Tampoco
org-admin accede de esas filas más que a las suyas y a las compartidas. Quien quiera otra cosa
escribe para ello una regla propia, y solo puede hacerlo si él mismo tiene ese acceso
(más abajo).
Ajustes para toda la organización¶
Algunas cosas valen para todos en la organización a la vez y no dependen de la persona. Por eso no están en un rol sino en el documento de reglas:
- si las funciones de IA pueden escribir memoria: por defecto, nadie;
- si los archivos y páginas guardados pueden compartirse mediante un enlace: por defecto, nadie;
- si se pueden descargar los archivos que creó una herramienta: por defecto, todo miembro;
- qué enrutadores de modelos se pueden usar: por defecto, todos, para todo miembro;
- a qué direcciones externas pueden llegar las funciones de IA. Sin una regla al respecto son las direcciones que tu operador permite para la organización; una regla puede restringirlo.
Escribir memoria y compartir mediante un enlace se activan en cuanto el documento de reglas los
permite, y entonces para todos, nunca para una sola persona. Solo quien los tiene, org-admin u
operator, puede escribir una regla así (cómo). Un
rol propio no puede decir nada sobre estas cosas.
Grupos¶
Un grupo reúne miembros, por ejemplo un equipo o un departamento. Un grupo puede tener roles y valores de atributos, y todo miembro del grupo los tiene también. Quien sale del grupo, o cuyo grupo desaparece, pierde lo que daba el grupo. Consulta Administrar grupos.
Atributos¶
Un atributo es un dato sobre un miembro que las reglas pueden leer, como department
(departamento) u office (oficina). El administrador decide qué atributos conoce la organización y
si los valores son libres o salen de una lista fija. Un miembro tiene los valores que recibió él
mismo más los de sus grupos. Consulta Administrar atributos.
Tres atributos los lee OS siempre por sí mismo y no puedes crearlos:
role: cada rol que tiene el miembro, directamente o mediante un grupo;group: cada grupo al que pertenece el miembro;subject: quién es el miembro, para que una regla pueda decir «esto es mío».
OS vuelve a determinar estos datos en cada solicitud a partir de lo que ha registrado la organización. Un miembro no puede indicar por sí mismo sus propios atributos.
El documento de reglas¶
Además de roles, cada organización tiene un documento de reglas: reglas que valen para todo miembro activo. En él pones lo que vale para todos, como «nadie usa el modelo caro» o «los becarios no usan agentes del departamento de finanzas». Aquí están también los ajustes para toda la organización. Consulta El documento de reglas.
Para un miembro valen, pues, en conjunto: las reglas de sus roles, el documento de reglas y
member.
Socios y las organizaciones que están debajo¶
Un rol se da con un alcance:
organisation(por defecto): el rol vale en la organización que lo dio.descendants: el rol vale en esa organización y en todas las que están debajo.
Así trabajan las personas de un socio en las organizaciones de sus clientes, sin ser miembros de
ellas. Un empleado de soporte que tiene org-admin con alcance descendants en el socio administra
también a los clientes que están bajo el socio. Del socio solo cuenta en una organización cliente lo
que se dio con alcance descendants; el documento de reglas del socio y sus roles con alcance
organisation no llegan hacia abajo.
Una organización no puede quitar la administración que una organización superior da con alcance
descendants: sobre la administración no existen reglas que deniegan. Sobre las funciones de IA sí:
un forbid en el documento de reglas de una organización vale allí también para las personas de un
socio. El registro de auditoría de la organización indica en cada cambio desde qué organización
actuó la persona.
El primer administrador de una organización nueva recibe org-admin con alcance descendants, para
que también administre los departamentos que cree más tarde bajo su organización.
Nadie da más de lo que tiene¶
Todo cambio que permita a alguien hacer más es una concesión: dar un rol, poner a un miembro en un grupo, dar a un grupo un rol o un valor, dar un valor de atributo, escribir las reglas de un rol propio o el documento de reglas, e invitar con alguno de estos. OS solo permite una concesión si tú mismo puedes hacer el cambio y tienes lo que das:
- un rol lo tienes si lo tienes tú (con al menos el mismo alcance), o si tienes todas sus reglas;
- un valor de atributo lo tienes si lo tienes tú, o si puedes conceder ese atributo (
org-adminpuede hacerlo para cualquier atributo); - un grupo lo tienes si tienes todos los roles y todos los valores que da el grupo;
- una regla la tienes si una de tus propias reglas permite lo mismo, sobre las mismas cosas, y ninguna regla que deniega le quita nada.
Una concesión rechazada no cambia nada, y OS indica lo que no tienes. Una invitación se comprueba al enviarla y de nuevo al aceptarla.
No puedes escribir una regla que deniegue sobre la administración (organizaciones, miembros, invitaciones, grupos, roles, reglas y atributos). Una regla así también podría quitar derechos a los propios administradores. Sobre las funciones de IA sí puedes denegar.
Dentro del servicio de la organización¶
Todo lo que permiten roles, grupos y reglas vale solo dentro del servicio de la organización: lo que contienen sus planes y excepciones. Una regla sobre algo que no está en el servicio no permite nada. El servicio hace, pues, más pequeños los roles, nunca más grandes, y una regla que deniega sigue valiendo siempre.
Quien concede un rol propio, un grupo o una regla que llega más allá del servicio recibe 403 con
This is not part of your organisation's service, incluso antes de comprobar si tienes lo que das
(más arriba). Los roles integrados siempre puedes darlos: son
iguales en todas partes y el servicio solo los hace más pequeños. La propia administración de la
organización (miembros, invitaciones, grupos, roles, atributos, reglas, el registro de auditoría y
la lectura del servicio) está siempre en el servicio (Siempre en el servicio).
Lo que ves en OS¶
OS muestra botones y menús exactamente para lo que puedes hacer, dentro del servicio de la organización: en cada cosa figura qué acciones puedes hacer sobre ella, y por tipo, qué acciones puedes hacer sobre al menos una cosa de ese tipo. Lo que no ves, no puedes hacerlo. Cómo lo lee un programa está en La API de acceso.
El registro de auditoría¶
Todo cambio en las personas, grupos, roles, atributos, reglas, invitaciones y ajustes de una organización queda en su registro de auditoría: cuándo, quién, desde qué organización y qué cambió. El registro no contiene contraseñas, claves ni direcciones de correo electrónico. Consulta Leer el registro de auditoría.