Roles y permisos
Otorga a las personas y los servicios la autoridad que necesitan para su trabajo y conoce cómo se combinan los roles, las concesiones de acceso a recursos y los derechos.
Alguien de tu equipo que consulta la configuración de un motor de localización no necesariamente necesita modificarla, traducir con él ni aprobar sus resultados. Los permisos separan esas responsabilidades. El acceso efectivo combina la pertenencia a la organización, los permisos del rol, las concesiones de acceso a recursos, los derechos de acceso a funciones y las comprobaciones que realiza la propia operación.
Los roles y las concesiones de acceso suman autoridad. Darle a alguien acceso a un motor de localización no restringe un rol que ya otorga acceso a todos los motores. Empieza por la responsabilidad que necesita asumir y luego revisa cada fuente de permisos que le permite hacerlo.
Catálogo de permisos #
| Área | Permisos |
|---|---|
| Administración de la organización | org:manage_team, org:manage_billing, org:manage_settings, org:manage_api_keys, org:manage_integrations, org:delete, org:view_audit_logs |
| Grupos de decisión | org:manage_decision_pools |
| Motores de localización y revisión | engine:read, engine:translate, engine:create, engine:edit, engine:delete, engine:review_translations, org:manage_reviews |
| Glosarios | org:glossary:read, org:glossary:edit |
| Voces de marca | org:brandvoice:read, org:brandvoice:edit |
| Conjuntos de reglas | org:ruleset:read, org:ruleset:edit |
| Sugerencias | org:suggestion:read, org:suggestion:edit |
Leer sugerencias y decidir sobre ellas #
Para que un rol permita leer sugerencias, otórgale org:suggestion:read y acceso de lectura a los motores de localización correspondientes. Para que permita aplicar o descartar sugerencias, otórgale org:suggestion:edit y acceso de edición a esos motores. Los permisos del motor, por sí solos, no incluyen permisos sobre las sugerencias.
Un miembro de la organización con una concesión explícita de acceso a un motor también puede leer las sugerencias de ese motor y decidir sobre ellas sin que su rol tenga permisos sobre las sugerencias. Esta concesión se aplica solo a ese motor; no otorga acceso a todos los motores de la organización. Sigue siendo necesario pertenecer a la organización.
Revisar traducciones #
Tomar una decisión en una revisión humana requiere una identidad de usuario, pertenecer a la organización y tener el permiso Revisar traducciones (engine:review_translations) para el motor. Un usuario con la sesión iniciada o una clave de API personal puede proporcionar esa identidad. Leer el historial de revisiones no otorga autoridad para tomar decisiones.
Al iniciar un nuevo trabajo de revisión, se comprueba si el plan cumple los requisitos. Los evaluadores autorizados pueden seguir leyendo las revisiones de documentos existentes y decidir sobre ellas después de cambiar a un plan inferior. Consulta Acceso a funciones para diagnosticar una revisión bloqueada.
Otorgar autoridad para revisar no hace que todas las traducciones deban esperar a una persona ni garantiza que la redacción revisada se conserve en las etapas posteriores; eso depende de las decisiones sobre la política de revisión.
Crear, editar o archivar grupos de decisión requiere Administrar grupos de decisión (org:manage_decision_pools). La pertenencia a un grupo interno determina quién recibe las notificaciones de revisión; no otorga el permiso Revisar traducciones. Consulta Planes y permisos para conocer todos los requisitos.
Crear y mantener roles personalizados #
Propietario es el rol de sistema administrado por la plataforma y no se puede editar ni eliminar. Los roles personalizados pertenecen a la organización. Administrarlos requiere el derecho de RBAC y org:manage_team; quien realiza la llamada no puede crear ni otorgar autoridad que exceda sus propios permisos efectivos.
En Configuración → Roles, selecciona Nuevo rol, ingresa un nombre y una descripción, elige sus permisos y selecciona Crear rol. Luego abre Configuración → Equipo y elige el rol en el selector de roles del miembro, en Miembros. Verifica que la asignación se haya guardado antes de pedirle al miembro que use el rol.
Solo un Propietario puede otorgar o quitar la autoridad de Propietario, y no se puede quitar ese rol al último Propietario ni eliminar a ese miembro. Asigna el rol de Propietario a un sucesor y verifica la asignación antes de realizar un cambio de propietario que, de otro modo, dejaría a la organización sin nadie responsable.
Antes de editar un rol personalizado, revisa qué miembros y claves de servicio lo usan. Su acceso puede cambiar sin necesidad de reemplazar una credencial. Antes de eliminar el rol, reasigna o revoca las claves de servicio que hacen referencia a él; esas referencias impiden eliminarlo.
Eliminar el rol personalizado de un miembro borra la referencia al rol sin asignarle otro rol con nombre. Ese miembro aún puede tener concesiones de acceso a recursos. Por eso, un rol en blanco no demuestra que no tenga acceso.
Concesiones de acceso a recursos #
Las concesiones de acceso a recursos amplían la autoridad de un miembro a determinados motores de localización, glosarios, voces de marca o conjuntos de reglas. Sigue siendo necesario pertenecer a la organización: una concesión almacenada no convierte a alguien externo en miembro. El acceso de lectura a un motor de localización puede dar acceso al contenido adjunto necesario para comprender su configuración.
Para otorgar acceso selectivo, combina un rol limitado con las concesiones de acceso a recursos necesarias. Si el rol ya abarca todos los motores de localización, agregar una concesión específica no limita su alcance. Si buscas restringir el acceso, quita la autoridad más amplia que otorga el rol.
Las concesiones de acceso específicas pueden requerir el uso de la API o de operaciones de MCP en lugar de un control del panel. Las concesiones a miembros humanos y el alcance de las claves de servicio son independientes y deben comprobarse por separado.
Las claves de servicio personales y de la organización están disponibles en todos los planes. Sin RBAC, una clave de servicio puede leer y traducir con todos los motores de localización de su organización, pero no puede editarlos, eliminarlos, revisar sus traducciones ni administrarlos. Los roles personalizados y las restricciones de acceso a recursos requieren RBAC de Enterprise.
Cambios de acceso #
Un cambio en el derecho de RBAC, en cualquiera de los dos sentidos, restablece a Propietario el rol de los miembros y de las invitaciones pendientes. Esto puede ampliar el acceso más allá de los roles seleccionados previamente. Coordina el cambio de facturación, revisa después todos los miembros y las invitaciones pendientes, y vuelve a asignar los roles elegidos expresamente cuando corresponda.
Cuando alguien deje la organización, revisa su pertenencia y sus credenciales por separado. Las claves de servicio de la organización no dependen de que un miembro en particular siga participando. Asegúrate de que quede otro Propietario y reemplaza las dependencias de quien realiza las llamadas antes de quitar el acceso necesario para el trabajo en curso.
Acceso a funciones ayuda a distinguir los errores relacionados con los derechos de los errores de permisos. Los registros de auditoría pueden mostrar los cambios registrados, pero el rol actual, las concesiones de acceso y la operación determinan lo que está permitido en este momento.