Saltar a contenido

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í:

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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 un permit.
  • 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-admin puede 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.