En esta página se describe cómo crear y gestionar roles personalizados en Google Distributed Cloud (GDC) aislado. Los roles personalizados te permiten gestionar el acceso más allá de los conjuntos de permisos estándar disponibles en los roles predefinidos, lo que te permite configurar los permisos para que cumplan tus criterios específicos.
Los roles personalizados siguen el principio de mínimos accesos y son útiles para conceder el acceso mínimo necesario para realizar tareas sensibles, mitigar los riesgos de seguridad y evitar conflictos de intereses.
Crear un rol personalizado te permite:
- Define el ámbito de acceso: elige si quieres aplicar los permisos a toda tu organización, a todos los proyectos o solo a proyectos específicos.
- Personalizar el acceso granular: selecciona uno o varios permisos que ya estén disponibles a través de roles predefinidos para personalizar el acceso a tareas o responsabilidades específicas.
Los roles personalizados están limitados por el ámbito en el que se crean. El acceso al rol personalizado solo se puede conceder en la misma organización o proyecto donde se haya creado el rol personalizado.
Esta página está dirigida a los administradores de plataformas, como administradores de TI o ingenieros de seguridad, que quieran gestionar de forma segura el acceso a los recursos de la organización. Para obtener más información, consulta la documentación sobre las audiencias de GDC aislado.
Consulta las descripciones de los roles predefinidos y las definiciones de los roles para obtener más información sobre los roles.
Antes de empezar
Antes de crear o gestionar roles personalizados, debes solicitar los permisos necesarios y preparar tu entorno.
Solicitar roles de organización de gestión de identidades y accesos
Para crear, actualizar y eliminar roles personalizados en una organización o en un proyecto, ponte en contacto con el admin. de la org. de gestión de identidades y accesos para solicitar el rol de administrador de la organización de roles personalizados (custom-role-org-admin).
Consulta más información sobre cómo asignar permisos de roles para organizaciones.
Solicitar roles de proyecto de gestión de identidades y accesos
Para crear, actualizar y eliminar roles personalizados en un proyecto específico, ponte en contacto con el administrador de proyectos de gestión de identidades y accesos para solicitar el rol de administrador de proyectos de roles personalizados (custom-role-project-admin).
Consulta más información sobre cómo asignar permisos de roles para proyectos.
Prepara tu entorno
Para usar las herramientas de línea de comandos para crear o gestionar roles personalizados, completa la siguiente configuración:
Para usar la API con
kubectl, se requiere una configuración adicional:- Instala la CLI de kubectl.
- Genera el archivo kubeconfig para el servidor de la API global para configurar el acceso de
kubectl.
Ver roles y sus permisos
Un rol personalizado se compone de un grupo de permisos que puedes asignar a los usuarios. Para crear un rol personalizado, selecciona permisos de roles predefinidos y combínalos según tus necesidades. Los permisos que puedes incluir en un rol personalizado dependen del ámbito en el que crees el rol: organización o proyecto.
En esta sección se explica cómo mostrar los roles disponibles (tanto predefinidos como personalizados) y ver los permisos que incluyen. Puedes usar esta información para hacer lo siguiente:
- Identificar permisos para nuevos roles personalizados: descubre las cadenas de permisos específicas que se necesitan para la marca
--permissionsal usar la CLI gdcloud para crear un rol personalizado. - Revisa los roles que ya tienes: examina los permisos asociados a cualquier rol predefinido o personalizado en el ámbito seleccionado (organización o proyecto).
Enumera los roles y examina sus permisos con la consola de GDC o la CLI gdcloud:
Consola
- Inicia sesión en la consola de GDC.
- En el selector de proyectos, selecciona la organización o el proyecto en el que quieras ver los roles.
En el menú de navegación, haz clic en Identidad y acceso > Roles.
Aparecerá una lista con los roles predefinidos y personalizados disponibles.
Haz clic en el nombre de un rol para ver sus detalles, incluidos los permisos asignados.
Los permisos que se indican para los roles predefinidos en el ámbito actual (organización o proyecto) son los que se pueden incluir en un nuevo rol personalizado.
gdcloud
- Asegúrate de que tienes instalada la CLI gdcloud. Para obtener más información, consulta la página Descripción general de la CLI gdcloud.
Lista de roles disponibles:
gdcloud iam roles list \ --type=ROLE_TYPE \ --project=PROJECTHaz los cambios siguientes:
ROLE_TYPE: el tipo de roles que se van a mostrar. Los valores válidos sonpredefined,customoall.PROJECT: el espacio de nombres del proyecto en el que quieres ver los roles. Omite la marca--projectpara los roles de organización.
Ver los permisos específicos de un rol:
gdcloud iam roles describe ROLE_NAME \ --project=PROJECTHaz los cambios siguientes:
ROLE_NAME: el nombre del recurso de Kubernetes del rolPROJECT: el espacio de nombres del proyecto en el que quieres ver los permisos de los roles. Omite la marca--projectpara los roles de organización.
Consulta gdcloud iam roles list y gdcloud iam roles describe para obtener más información sobre los comandos y ejemplos de uso.
Crear una función personalizada
Crea un rol personalizado agrupando permisos de roles predefinidos. Los roles personalizados heredan las capacidades multizona de gestión de identidades y accesos de los roles predefinidos en los que se basan. Después de crear un rol personalizado, puedes dar acceso a los usuarios.
Crea un rol personalizado con la consola de GDC, la CLI gdcloud o la API:
Consola
- Inicia sesión en la consola de GDC.
- En el selector de proyectos, selecciona la organización o el proyecto en el que quieras crear un rol personalizado.
- En el menú de navegación, haz clic en Identidad y acceso > Roles.
- Haz clic en Crear rol personalizado.
- En el campo Título, introduce el título del rol personalizado.
- En el campo Descripción, describe la finalidad del rol personalizado.
En el campo ID, introduce el identificador único de tu rol personalizado.
Los IDs de rol personalizado pueden tener hasta 10 caracteres alfanuméricos en minúsculas y no se pueden cambiar después de crear el rol.
Selecciona una fase de lanzamiento.
Selecciona el ámbito de tu rol personalizado.
Si seleccionas Organización, el rol personalizado se aplicará a todos los recursos de la organización. Si seleccionas Proyectos, el rol personalizado se aplicará a todos los proyectos actuales y futuros de la organización. Puedes seleccionar Limitar a los proyectos seleccionados si quieres especificar qué proyectos pueden acceder al rol personalizado.
Haz clic en Añadir permisos.
Selecciona la casilla situada junto a uno o varios de los permisos admitidos que quieras asignar a tu rol personalizado.
Los permisos disponibles se limitan al ámbito que hayas seleccionado. Si cambias el ámbito después de añadir permisos, debes confirmar que se restablezcan todos los permisos asignados anteriormente.
Haz clic en Guardar.
Haz clic en Crear.
El nuevo rol personalizado aparecerá en la página Roles.
gdcloud
- Asegúrate de que tienes instalada la CLI gdcloud. Para obtener más información, consulta la página Descripción general de la CLI gdcloud.
Crear un rol personalizado:
gdcloud iam roles create ROLE_ID \ --title=TITLE \ --description=DESCRIPTION \ --permissions=PERMISSIONS --stage=LAUNCH_STAGEHaz los cambios siguientes:
ROLE_ID: el identificador único de tu rol personalizado. Los IDs de rol personalizado pueden tener hasta 10 caracteres alfanuméricos en minúscula y pueden contener guiones. Los IDs de rol personalizado no se pueden cambiar después de crear el rol.TITLE: un título fácil de usar para el rol personalizado.DESCRIPTION: descripción de la finalidad del rol personalizadoPERMISSIONS: lista separada por comas de los permisos que quieres conceder al rol personalizadoPara obtener más información sobre cómo encontrar las cadenas de permisos correctas, consulta Ver roles y sus permisos. Cada cadena de permiso debe tener el formato que se indica en las directrices de gdcloud iam roles create, donde
iamRoleNamees el nombre del recurso de Kubernetes del rol predefinido que contiene el permiso. Puedes encontrar el nombre de recurso de Kubernetes de un rol en la página Definiciones de roles o mediante el comando gdcloud iam roles list.LAUNCH_STAGE: opcional. La fase de lanzamiento del rol personalizado. Los valores válidos sonALPHA,BETA,GAoDISABLED. Si se omite esta marca, se asigna el valorALPHAde forma predeterminada.
Consulta gdcloud iam roles create para ver una lista completa de las marcas obligatorias y opcionales, así como ejemplos de uso.
También puedes definir el rol personalizado en un archivo YAML y usar la marca
--file:gdcloud iam roles create ROLE_ID --file=YAML_FILE_PATHSustituye
YAML_FILE_PATHpor la ruta del archivo YAML que contiene las marcas obligatorias y opcionales. Si usas la marca--file, se ignorarán todas las demás marcas, como--title,--descriptiony--permissions.
API
Crea y aplica el recurso personalizado CustomRole con kubectl:
kubectl apply -f - <<EOF
apiVersion: iam.global.gdc.goog/v1
kind: CustomRole
metadata:
name: ROLE_NAME
namespace: NAMESPACE
spec:
metadata:
description: DESCRIPTION
id: ROLE_ID
scope: SCOPE
stage: LAUNCH_STAGE
title: TITLE
RULES_TYPE:
- RULES_LIST
EOF
Haz los cambios siguientes:
ROLE_NAME: el nombre del recurso de Kubernetes del rolNAMESPACE: el espacio de nombres del rol personalizado. Usaplatformpara roles de organización y para varios proyectos. Usa el espacio de nombres del proyecto (comomy-project) para los roles de proyecto y los proyectos individuales.DESCRIPTION: descripción de la finalidad del rol personalizadoROLE_ID: el identificador único de tu rol personalizado. Los IDs de rol personalizado pueden tener hasta 10 caracteres alfanuméricos en minúscula y pueden contener guiones. Los IDs de rol personalizado no se pueden cambiar después de crear el rol.SCOPE: usaorganizationpara los roles creados en el espacio de nombresplatform. Usaprojectpara los roles creados en un espacio de nombres de proyecto.LAUNCH_STAGE: opcional. La fase de lanzamiento del rol personalizado. Los valores válidos sonALPHA,BETA,GAoDISABLED. Si se omite este campo, se asignará el valorALPHAde forma predeterminada.TITLE: un título fácil de usar para el rol personalizado.RULES_TYPE: el ámbito de las reglas. Sustituye porglobalRules(para permisos de la API global),zonalRules(para permisos de la API de zona) o ambos.RULES_LIST: una lista con sangría de objetos de reglas de RBAC de Kubernetes estándar. Cada objeto de la lista concede permisos. Puedes determinar los valores correctos deapiGroups,resourcesyverbsexaminando los permisos de los roles predefinidos congdcloud iam roles describe, tal como se muestra en Ver roles y sus permisos.En el siguiente ejemplo se muestra la estructura de un solo elemento de un objeto
globalRules:globalRules: - apiGroups: ["storage.global.gdc.goog"] resources: ["buckettypes"] verbs: ["get", "list", "watch"]Puedes incluir varios elementos en la lista, cada uno de los cuales define un conjunto de permisos diferente.
Gestionar un rol personalizado
Eres responsable de gestionar el ciclo de vida de tus roles personalizados. Cuando Distributed Cloud añade nuevos permisos, funciones o servicios, actualiza los roles predefinidos. Las actualizaciones, como eliminar un rol predefinido o quitar permisos de un rol predefinido, pueden hacer que los roles personalizados que dependen de esos permisos dejen de funcionar. Debes monitorizar estas actualizaciones y ajustar manualmente los roles personalizados afectados para asegurarte de que sigan funcionando como se espera.
Puedes editar, inhabilitar o eliminar un rol personalizado, pero no puedes editar, inhabilitar ni eliminar un rol predefinido. Para ver una lista de todos los roles y sus permisos específicos, consulta Ver los roles y sus permisos.
Editar un rol personalizado
Editar un rol personalizado con la consola de GDC, la CLI gdcloud o la API:
Consola
- Inicia sesión en la consola de GDC.
- En el selector de proyectos, selecciona la organización o el proyecto en el que quieras editar un rol personalizado.
- En el menú de navegación, haz clic en Identidad y acceso > Roles.
- En la lista de roles, selecciona el rol personalizado que quieras editar.
- En la página de detalles del rol personalizado, haz clic en Editar.
- Editar los detalles de tu rol personalizado, como el título, la descripción, el ID o la fase de lanzamiento.
- Si quieres, puedes añadir o quitar permisos asignados.
- Haz clic en Añadir permisos para seleccionar uno de la lista de permisos disponibles.
- Para quitar un permiso asignado, selecciona la casilla situada junto al permiso que quieras quitar y haz clic en Quitar.
Haz clic en Guardar.
Aparecerá un mensaje para confirmar que has guardado los cambios.
gdcloud
- Asegúrate de que tienes instalada la CLI gdcloud. Para obtener más información, consulta la página Descripción general de la CLI gdcloud.
Editar un rol personalizado:
gdcloud iam roles update ROLE_ID \ --title=TITLE \ --description=DESCRIPTION \ --permissions=PERMISSIONS --stage=LAUNCH_STAGEHaz los cambios siguientes:
ROLE_ID: identificador único de tu rol personalizadoTITLE: un título fácil de usar para el rol personalizado.DESCRIPTION: descripción de la finalidad del rol personalizadoPERMISSIONS: lista separada por comas de los permisos que quieres conceder al rol personalizadoPara obtener más información sobre cómo encontrar las cadenas de permisos correctas, consulta Ver roles y sus permisos. Cada cadena de permiso debe tener el formato que se indica en las directrices de gdcloud iam roles create, donde
iamRoleNamees el nombre del recurso de Kubernetes del rol predefinido que contiene el permiso. Puedes encontrar el nombre de recurso de Kubernetes de un rol en la página Definiciones de roles o mediante el comando gdcloud iam roles list.LAUNCH_STAGE: opcional. La fase de lanzamiento del rol personalizado. Los valores válidos sonALPHA,BETA,GAoDISABLED. Si se omite esta marca, se asigna el valorALPHAde forma predeterminada.
Consulta gdcloud iam roles update para ver una lista completa de las marcas obligatorias y opcionales, así como ejemplos de uso.
También puedes actualizar el rol personalizado en su archivo YAML y usar la marca
--file:gdcloud iam roles update ROLE_ID --file=YAML_FILE_PATHSustituye
YAML_FILE_PATHpor la ruta del archivo YAML que contiene las marcas obligatorias y opcionales actualizadas. Si usas la marca--file, se ignorarán todas las demás marcas, como--title,--descriptiony--permissions.
API
Editar un recurso personalizado de CustomRole con kubectl:
kubectl apply -f - <<EOF
apiVersion: iam.global.gdc.goog/v1
kind: CustomRole
metadata:
name: ROLE_NAME
namespace: NAMESPACE
spec:
metadata:
description: DESCRIPTION
id: ROLE_ID
scope: SCOPE
stage: LAUNCH_STAGE
title: TITLE
RULES_TYPE:
- RULES_LIST
EOF
Haz los cambios siguientes:
ROLE_NAME: el nombre del recurso de Kubernetes del rolNAMESPACE: el espacio de nombres del rol personalizado. Usaplatformpara roles de organización y para varios proyectos. Usa el espacio de nombres del proyecto (comomy-project) para los roles de proyecto y los proyectos individuales.DESCRIPTION: descripción de la finalidad del rol personalizadoROLE_ID: el identificador único de tu rol personalizado. Los IDs de rol personalizado pueden tener hasta 10 caracteres alfanuméricos en minúscula y pueden contener guiones. Los IDs de rol personalizado no se pueden cambiar después de crear el rol.SCOPE: usaorganizationpara los roles creados en el espacio de nombresplatform. Usaprojectpara los roles creados en un espacio de nombres de proyecto.LAUNCH_STAGE: opcional. La fase de lanzamiento del rol personalizado. Los valores válidos sonALPHA,BETA,GAoDISABLED. Si se omite este campo, se asignará el valorALPHAde forma predeterminada.TITLE: un título fácil de usar para el rol personalizado.RULES_TYPE: el ámbito de las reglas. Sustituye porglobalRules(para permisos de la API global),zonalRules(para permisos de la API de zona) o ambos.RULES_LIST: una lista con sangría de objetos de reglas de RBAC de Kubernetes estándar. Cada objeto de la lista concede permisos. Puedes determinar los valores correctos deapiGroups,resourcesyverbsexaminando los permisos de los roles predefinidos congdcloud iam roles describe, tal como se muestra en Ver roles y sus permisos.En el siguiente ejemplo se muestra la estructura de un solo elemento de un objeto
globalRules:globalRules: - apiGroups: ["storage.global.gdc.goog"] resources: ["buckettypes"] verbs: ["get", "list", "watch"]Puedes incluir varios elementos en la lista, cada uno de los cuales define un conjunto de permisos diferente.
Inhabilitar un rol personalizado
Los roles personalizados inhabilitados permanecen en tu lista de roles y se pueden seguir asignando a usuarios, pero no tienen ningún efecto. Puedes volver a habilitar el rol personalizado en cualquier momento.
Inhabilitar un rol personalizado mediante la consola de GDC, la CLI gdcloud o la API:
Consola
- Inicia sesión en la consola de GDC.
- En el selector de proyectos, selecciona la organización o el proyecto en el que quieras inhabilitar un rol personalizado.
- En el menú de navegación, haz clic en Identidad y acceso > Roles.
- En la lista de roles, selecciona el rol personalizado que quieras inhabilitar.
- En la página de detalles del rol personalizado, haz clic en Inhabilitar.
gdcloud
- Asegúrate de que tienes instalada la CLI gdcloud. Para obtener más información, consulta la página Descripción general de la CLI gdcloud.
Inhabilitar un rol personalizado:
gdcloud iam roles update ROLE_ID --stage=DISABLEDHaz los cambios siguientes:
ROLE_ID: identificador único de tu rol personalizado
Consulta gdcloud iam roles update para obtener más información.
API
Inhabilita un recurso personalizado de CustomRole cambiando el campo stage a DISABLED. Asegúrate de que todos los demás campos coincidan con los valores actuales del rol personalizado que quieras inhabilitar.
kubectl apply -f - <<EOF
apiVersion: iam.global.gdc.goog/v1
kind: CustomRole
metadata:
name: ROLE_NAME
namespace: NAMESPACE
spec:
metadata:
description: DESCRIPTION
id: ROLE_ID
scope: SCOPE
stage: DISABLED
title: TITLE
RULES_TYPE:
- RULES_LIST
EOF
Haz los cambios siguientes:
ROLE_NAME: el nombre del recurso de Kubernetes del rolNAMESPACE: el espacio de nombres del rol personalizado. Usaplatformpara roles de organización y para varios proyectos. Usa el espacio de nombres del proyecto (comomy-project) para los roles de proyecto y los proyectos individuales.DESCRIPTION: descripción de la finalidad del rol personalizadoROLE_ID: el identificador único de tu rol personalizado. Los IDs de rol personalizado pueden tener hasta 10 caracteres alfanuméricos en minúscula y pueden contener guiones. Los IDs de rol personalizado no se pueden cambiar después de crear el rol.SCOPE: usaorganizationpara los roles creados en el espacio de nombresplatform. Usaprojectpara los roles creados en un espacio de nombres de proyecto.TITLE: un título fácil de usar para el rol personalizado.RULES_TYPE: el ámbito de las reglas. Sustituye porglobalRules(para permisos de la API global),zonalRules(para permisos de la API de zona) o ambos.RULES_LIST: una lista con sangría de objetos de reglas de RBAC de Kubernetes estándar. Cada objeto de la lista concede permisos. Puedes determinar los valores correctos deapiGroups,resourcesyverbsexaminando los permisos de los roles predefinidos congdcloud iam roles describe, tal como se muestra en Ver roles y sus permisos.En el siguiente ejemplo se muestra la estructura de un solo elemento de un objeto
globalRules:globalRules: - apiGroups: ["storage.global.gdc.goog"] resources: ["buckettypes"] verbs: ["get", "list", "watch"]Puedes incluir varios elementos en la lista, cada uno de los cuales define un conjunto de permisos diferente.
Eliminar un rol personalizado
Los roles eliminados se quitan de forma permanente del sistema, pero puedes crear un rol con el mismo nombre.
Elimina un rol personalizado con la CLI gdcloud o la API:
gdcloud
- Asegúrate de que tienes instalada la CLI gdcloud. Para obtener más información, consulta la página Descripción general de la CLI gdcloud.
Eliminar un rol personalizado:
gdcloud iam roles delete ROLE_ID --project=PROJECTHaz los cambios siguientes:
ROLE_ID: identificador único de tu rol personalizadoPROJECT: el espacio de nombres del proyecto en el que quieres eliminar el rol personalizado. Si no se especifica la marca--project, se elimina el rol de la organización.
Consulta gdcloud iam roles delete para obtener más información y ejemplos de uso.
API
Elimina un recurso personalizado de CustomRole con kubectl:
kubectl delete -f CUSTOM_ROLE
Sustituye CUSTOM_ROLE por la ruta de tu archivo YAML CustomRole. Es el mismo archivo que has usado para crear o actualizar el rol.