# Roles personalizados





Los roles personalizados te permiten crear conjuntos de permisos a la medida que se adaptan a las necesidades específicas de tu organización. Esta página cubre los roles personalizados y los pasos para crearlos y gestionarlos.

## ¿Qué son los roles personalizados?

Los roles personalizados te permiten crear conjuntos de permisos adaptados a tu organización. Puedes asignar roles personalizados a usuarios individuales o a equipos.
Los usuarios y equipos reciben un rol principal o un rol personalizado, pero no ambos.

Utiliza roles personalizados cuando los roles principales de Docker no se adapten a tus necesidades.

## Requisitos previos

Para configurar roles personalizados, necesitas tener permisos de propietario (Owner) en tu organización de Docker.

## Crear un rol personalizado

Antes de poder asignar un rol personalizado a los usuarios, debes crearlo en la Admin Console (Consola de administración):

1. Inicia sesión en [Docker Home](https://app.docker.com).
2. Selecciona **Admin Console** (Consola de administración).
3. Bajo **User management** (Gestión de usuarios), selecciona **Roles** > **Create role** (Crear rol).
4. Elige un nombre y describe el propósito del rol:
   - Proporciona un **Label** (Etiqueta)
   - Introduce un identificador de **Name** (Nombre) único (no se puede cambiar más adelante)
   - Añade una **Description** (Descripción) opcional
5. Establece los permisos para el rol desplegando las categorías de permisos y seleccionando las casillas de verificación correspondientes. Para obtener una lista completa de los permisos disponibles, consulta la [referencia de permisos de roles personalizados](#referencia-de-permisos-de-roles-personalizados).
6. Selecciona **Review** (Revisar) para revisar la configuración del rol personalizado y ver un resumen de los permisos seleccionados.
7. Selecciona **Create** (Crear).

Con el rol personalizado creado, ahora puedes [asignar roles personalizados a los usuarios](#asignar-roles-personalizados).

## Editar un rol personalizado

1. Inicia sesión en [Docker Home](https://app.docker.com).
2. Selecciona **Admin Console** (Consola de administración).
3. Bajo **User management** (Gestión de usuarios), selecciona **Roles**.
4. Busca tu rol personalizado en la lista y selecciona el **Actions menu** (Menú de acciones).
5. Selecciona **Edit** (Editar).
6. Puedes editar los siguientes ajustes del rol personalizado:
   - Label (Etiqueta)
   - Description (Descripción)
   - Permissions (Permisos)
7. Cuando hayas terminado de editar, selecciona **Save** (Guardar).

## Asignar roles personalizados

**Usuarios individuales**



1. Inicia sesión en [Docker Home](https://app.docker.com).
2. Selecciona **Members** (Miembros).
3. Localiza al miembro al que deseas asignar un rol personalizado, luego selecciona el **Actions menu** (Menú de acciones).
4. En el menú desplegable, selecciona **Change role** (Cambiar rol).
5. En el menú desplegable **Select a role** (Seleccionar un rol), elige tu rol personalizado.
6. Selecciona **Save** (Guardar).

**Usuarios en lote**



1. Inicia sesión en [Docker Home](https://app.docker.com).
2. Selecciona **Members** (Miembros).
3. Usa las casillas de verificación en la columna de nombres de usuario para seleccionar a todos los usuarios a los que deseas asignar un rol personalizado.
4. Selecciona **Change role** (Cambiar rol).
5. En el menú desplegable **Select a role** (Seleccionar un rol), elige tu rol personalizado o un rol principal.
6. Selecciona **Save** (Guardar).

**Equipos**



1. Inicia sesión en [Docker Home](https://app.docker.com).
2. Selecciona **Teams** (Equipos).
3. Localiza al equipo al que deseas asignar un rol personalizado, luego selecciona el **Actions menu** (Menú de acciones).
4. Selecciona **Assign role** (Asignar rol).
5. Selecciona tu rol personalizado, luego selecciona **Assign** (Asignar).

La columna de roles se actualizará con el nuevo rol asignado.



## Ver asignaciones de roles

Para ver qué usuarios y equipos tienen asignados determinados roles:

1. Inicia sesión en [Docker Home](https://app.docker.com).
2. Selecciona **Admin Console** (Consola de administración).
3. Bajo **User management** (Gestión de usuarios), selecciona **Roles**.
4. En la lista de roles, revisa las columnas **Users** (Usuarios) y **Teams** (Equipos) para ver la cantidad de asignaciones.
5. Selecciona un rol específico para ver sus permisos y asignaciones en detalle.

## Reasignar roles personalizados

**Usuarios individuales**



1. Inicia sesión en [Docker Home](https://app.docker.com).
2. Selecciona **Members** (Miembros).
3. Localiza al miembro que deseas reasignar, luego selecciona el **Actions menu** (Menú de acciones).
4. Selecciona **Change role** (Cambiar rol).
5. En el menú desplegable **Select a role** (Seleccionar un rol), elige el nuevo rol.
6. Selecciona **Save** (Guardar).

**Usuarios en lote**



1. Inicia sesión en [Docker Home](https://app.docker.com).
2. Selecciona **Members** (Miembros).
3. Usa las casillas de verificación en la columna de nombres de usuario para seleccionar a todos los usuarios que deseas reasignar.
4. Selecciona **Change role** (Cambiar rol).
5. En el menú desplegable **Select a role** (Seleccionar un rol), elige el nuevo rol.
6. Selecciona **Save** (Guardar).

**Equipos**



1. Inicia sesión en [Docker Home](https://app.docker.com).
2. Selecciona **Teams** (Equipos).
3. Localiza al equipo, luego selecciona el **Actions menu** (Menú de acciones).
4. Selecciona **Change role** (Cambiar rol).
5. En la ventana emergente, selecciona un rol del menú desplegable y luego selecciona **Save** (Guardar).



## Eliminar un rol personalizado

Antes de eliminar un rol personalizado, debes reasignar a todos los usuarios y equipos a roles diferentes.

1. Inicia sesión en [Docker Home](https://app.docker.com).
2. Selecciona **Admin Console** (Consola de administración).
3. Bajo **User management** (Gestión de usuarios), selecciona **Roles**.
4. Busca tu rol personalizado en la lista y selecciona el **Actions menu** (Menú de acciones).
5. Si el rol tiene usuarios o equipos asignados:
   - Ve a la página **Members** (Miembros) y cambia el rol para todos los usuarios asignados a este rol personalizado
   - Ve a la página **Teams** (Equipos) y reasigna a todos los equipos que tengan este rol personalizado
6. Una vez que no haya usuarios ni equipos asignados, regresa a **Roles**.
7. Busca tu rol personalizado y selecciona el **Actions menu** (Menú de acciones).
8. Selecciona **Delete** (Eliminar).
9. En la ventana de confirmación, selecciona **Delete** (Eliminar) para confirmar.

## Referencia de permisos de roles personalizados

Los roles personalizados se construyen seleccionando permisos específicos en diferentes categorías. Las siguientes tablas enumeran todos los permisos disponibles que puedes asignar a un rol personalizado.

### Gestión de organización

| Permiso                           | Descripción                                                                                                  |
| :-------------------------------- | :----------------------------------------------------------------------------------------------------------- |
| View teams                        | Ver equipos y miembros de equipos                                                                            |
| Manage teams                      | Crear, actualizar y eliminar equipos y miembros de equipos                                                   |
| Manage registry access            | Controlar a qué registros pueden acceder los miembros                                                        |
| Manage image access               | Establecer políticas sobre qué imágenes pueden descargar y usar los miembros                                 |
| Update organization information   | Actualizar la información de la organización, como el nombre y la ubicación                                  |
| Member management                 | Gestionar miembros, invitaciones y roles de la organización                                                  |
| View custom roles                 | Ver los roles personalizados existentes y sus permisos                                                       |
| Manage custom roles               | Acceso completo a la gestión y asignación de roles personalizados                                            |
| Manage organization access tokens | Crear, actualizar y eliminar repositorios en esta organización. No incluye acciones de registro ni push/pull |
| View activity logs                | Acceder a los registros de auditoría y al historial de actividad de la organización                          |
| View domains                      | Ver dominios y ajustes de auditoría de dominios                                                              |
| Manage domains                    | Gestionar dominios verificados y ajustes de auditoría de dominios                                            |
| View SSO and SCIM                 | Ver las configuraciones de inicio de sesión único y de aprovisionamiento de usuarios                         |
| Manage SSO and SCIM               | Acceso completo a la gestión de SSO y SCIM                                                                   |
| Manage Desktop settings           | Configurar políticas de ajustes de Docker Desktop y ver informes de uso                                      |

### Docker Hub

| Permiso             | Descripción                                                |
| :------------------ | :--------------------------------------------------------- |
| View repositories   | Ver los detalles y contenidos de los repositorios          |
| Manage repositories | Crear, actualizar y eliminar repositorios y sus contenidos |

### Facturación

| Permiso        | Descripción                                                      |
| :------------- | :--------------------------------------------------------------- |
| View billing   | Ver la información de facturación de la organización             |
| Manage billing | Acceso completo para gestionar la facturación de la organización |