> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-trino-dialect.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Gestionar roles personalizados
> En esta página se describe cómo los administradores pueden agregar, modificar y eliminar roles personalizados
export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
if (link) {
return
Beta
;
}
return
Funcionalidad beta
;
};
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return ;
};
Esta guía está dirigida a usuarios con el rol Admin en ClickHouse Cloud.
Los clientes de ClickHouse Cloud pueden elegir entre roles del sistema predefinidos o crear roles personalizados para asignarlos a los usuarios. Para obtener más información sobre los roles del sistema y los permisos asociados, consulte [Console roles and permissions](/es/products/cloud/reference/security/console-roles). Esta guía proporciona información detallada sobre cómo gestionar roles personalizados.
## Crear roles personalizados
Los roles personalizados pueden incluir una combinación de permisos de organización, servicio y base de datos. Los permisos pueden aplicarse a todos los servicios y bases de datos o a un subconjunto de ellos.
En la página de servicios, seleccione el nombre de su organización. En el menú emergente, seleccione la opción `Users and roles`.
Seleccione la pestaña Roles} id="roles-tab">
Seleccione la pestaña `Roles` en la parte superior central de la pantalla.
Seleccione Create new role en la esquina superior derecha} id="create-new-role">
Seleccione el botón `Create new role` en la esquina superior derecha de la pantalla.
Introduzca un nombre descriptivo para el rol. Este será el nombre que verá al asignar roles a usuarios y claves de API.
Haga clic en Allow y seleccione el alcance de los permisos} id="scope-permissions">
Haga clic en el botón `Allow` y seleccione permisos de organización, servicio y/o base de datos. Para ver una descripción de todos los permisos, consulte [Console roles and permissions](/es/products/cloud/reference/security/console-roles).
Asegúrese de que los usuarios que iniciarán sesión en la consola tengan, como mínimo, el permiso Organization > Access organization.
**Acceso a la pestaña Data Sources**
Para acceder a la pestaña **Data Sources**, el rol requiere actualmente el permiso `Manage selected services`.
Revise los permisos asignados a su nuevo rol antes de finalizar. Cuando haya terminado, haga clic en `Create role`.
## Administrar roles de base de datos (beta)
Además de los permisos de la consola, los roles personalizados pueden incluir permisos de datos que controlan el acceso a las bases de datos de los servicios seleccionados. Esto permite administrar el acceso a la consola y a las bases de datos desde un único lugar, en vez de mantener roles independientes en cada base de datos.
Esta función se encuentra en beta y está disponible para servicios que ejecutan ClickHouse versión 26.4 o posterior.
Al añadir permisos de datos a un rol personalizado, ClickHouse Cloud crea un rol correspondiente en cada servicio seleccionado con el prefijo `cloud:`. Por ejemplo, un rol personalizado llamado `readonly` aparece en la base de datos como `cloud:readonly`. Los miembros del rol personalizado reciben estos permisos de base de datos al conectarse al servicio mediante la autenticación sin contraseña de SQL Console.
Los roles asignados manualmente en la base de datos mediante la [convención de nomenclatura `sql-console-role:`](/es/products/cloud/guides/security/cloud-access-management/manage-database-users#sql-console-users-and-roles) tienen prioridad sobre los roles asignados mediante la consola.
[Cree un rol personalizado](#create-custom-role) o edite uno existente. En el cuadro de diálogo del rol, haga clic en el botón `Allow permissions` y seleccione `Data`.
Seleccione el servicio al que se aplicarán los permisos. Añada más servicios para aplicar permisos a varios servicios.
Seleccione el acceso `Read-only`, `Admin` o `Custom`. Con el acceso `Custom`, defina permisos específicos de acceso a datos mediante sentencias [`GRANT`](/es/reference/statements/grant) de ClickHouse.
Haga clic en `Create role`. Los roles de base de datos se crearán en los servicios seleccionados.
### Verificar roles de base de datos
Los roles administrados mediante la consola se crean en la base de datos con el prefijo `cloud:` y el tipo de almacenamiento `cloud`. Para listarlos, consulte la tabla `system.roles` del servicio:
```sql theme={null}
SELECT * FROM system.roles;
```
```response theme={null}
┌─name───────────┬─id───────────────────────────────────┬─storage─┐
│ cloud:readonly │ 9a4910f4-abcf-4904-466a-717c8c75ac42 │ cloud │
└────────────────┴──────────────────────────────────────┴─────────┘
```
## Actualizar roles personalizados
Los roles personalizados pueden actualizarse después de crearse. Los usuarios perderán los permisos que se eliminen del rol y obtendrán los permisos que se agreguen.
Los permisos de los usuarios se acumulan. Si un usuario tiene permiso para realizar una operación a través de varios roles, es posible que no pierda el acceso de inmediato si el permiso se elimina de solo uno de ellos.
1. Accede a la configuración de la organización y selecciona `Users and roles`
2. Selecciona la pestaña `Roles`
3. Selecciona los tres puntos junto al rol que quieres actualizar
4. Selecciona `Edit`
5. Modifica los permisos
6. Selecciona `Edit role`
## Eliminar roles personalizados
Los roles personalizados se pueden eliminar en cualquier momento.
Debe haber al menos un usuario en la organización con permisos administrativos. Si al eliminar el rol se eliminan los permisos administrativos del último usuario, no podrá eliminarlo. Para solucionarlo, asigne a al menos un usuario el rol del sistema Admin antes de eliminar el rol personalizado.
1. Acceda a la configuración de la organización y seleccione `Users and roles`
2. Seleccione la pestaña `Roles`
3. Seleccione los tres puntos junto al rol que desea eliminar
4. Revise los usuarios y las claves de API que perderán acceso cuando se elimine el rol. Ajuste las asignaciones según sea necesario.
5. Seleccione `Eliminar rol` para completar el proceso