En esta página, se describe cómo crear y administrar roles personalizados en Google Distributed Cloud (GDC) aislado. Los roles personalizados te permiten administrar el acceso más allá de los conjuntos de permisos estándar disponibles en los roles predefinidos, lo que te permite configurar permisos para que cumplan con tus criterios específicos.
Los roles personalizados siguen el principio de privilegio mínimo y son útiles para otorgar el acceso mínimo necesario para las tareas sensibles, mitigar los riesgos de seguridad y evitar conflictos de intereses.
Crear un rol personalizado te permite hacer lo siguiente:
- Define el alcance del acceso: Elige aplicar permisos en toda tu organización, en todos los proyectos o restringirlos a proyectos específicos.
- Adapta el acceso detallado: Selecciona uno o más 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 vinculados al permiso en el que se crean. El acceso al rol personalizado solo se puede otorgar dentro de la misma organización o proyecto en el que se creó el rol personalizado.
Esta página está dirigida a públicos dentro del grupo de administradores de la plataforma, como administradores de TI o ingenieros de seguridad, que desean administrar de forma segura el acceso a los recursos de la organización. Para obtener más información, consulta Públicos de la documentación de GDC aislado.
Consulta Descripciones de roles predefinidos y Definiciones de roles para obtener más información sobre los roles.
Antes de comenzar
Antes de crear o administrar roles personalizados, debes solicitar los permisos necesarios y preparar tu entorno.
Solicita roles de IAM de la organización
Para crear, actualizar y borrar roles personalizados en una organización o dentro de un
proyecto, comunícate con el administrador de la organización de IAM para solicitar el
rol de administrador de la organización de roles personalizados (custom-role-org-admin).
Obtén más información para asignar permisos de roles a organizaciones.
Solicita roles de IAM del proyecto
Para crear, actualizar y borrar roles personalizados dentro de un proyecto específico, comunícate
con el administrador de IAM del proyecto para solicitar el rol de administrador de roles personalizados del proyecto
(custom-role-project-admin).
Obtén más información para asignar permisos de roles en proyectos.
Prepara el entorno
Para usar las herramientas de línea de comandos con el objetivo de crear o administrar 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 a
kubectl.
Consulta los 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 existentes y combínalos para que se adapten a tus necesidades. Los permisos que puedes incluir en un rol personalizado dependen del permiso en el que creas el rol: organización o proyecto.
En esta sección, se explica cómo enumerar los roles disponibles (tanto predefinidos como personalizados) y ver los permisos que contienen. Puedes usar esta información para hacer lo siguiente:
- Identifica los permisos para los roles personalizados nuevos: Descubre las cadenas de permisos específicas que se requieren para la marca
--permissionscuando usas la CLI de gdcloud para crear un rol personalizado. - Revisa los roles existentes: Examina los permisos asociados con cualquier rol predefinido o personalizado en el permiso seleccionado (organización o proyecto).
Enumera los roles y examina sus permisos con la consola de GDC o la CLI de gdcloud:
Console
- Accede a la consola de GDC.
- En el selector de proyectos, elige la organización o el proyecto en el que deseas ver los roles.
En el menú de navegación, haz clic en Identidad y acceso > Roles.
Aparecerá una lista de 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 enumeran para los roles predefinidos en el permiso actual (organización o proyecto) son los que están disponibles para incluirse en un nuevo rol personalizado.
gdcloud
- Asegúrate de tener instalada la CLI de gdcloud. Para obtener más información, consulta la página de descripción general de la CLI de gdcloud.
Enumera los roles disponibles:
gdcloud iam roles list \ --type=ROLE_TYPE \ --project=PROJECTReemplaza lo siguiente:
ROLE_TYPE: Es el tipo de roles que se mostrarán. Los valores válidos sonpredefined,customoall.PROJECT: Es el espacio de nombres del proyecto en el que deseas ver los roles. Omite la marca--projectpara los roles con alcance de organización.
Visualiza los permisos específicos de un rol:
gdcloud iam roles describe ROLE_NAME \ --project=PROJECTReemplaza lo siguiente:
ROLE_NAME: Es el nombre del recurso de Kubernetes del rol.PROJECT: Es el espacio de nombres del proyecto en el que deseas ver los permisos de los roles. Omite la marca--projectpara los roles con alcance de organización.
Consulta gdcloud iam roles list y gdcloud iam roles describe para obtener más detalles sobre los comandos y ejemplos de uso.
Crea un rol personalizado
Crear un rol personalizado nuevo agrupando permisos de roles predefinidos Los roles personalizados heredan las capacidades de varias zonas de IAM de los roles predefinidos en los que se basan. Después de crear un rol personalizado, puedes otorgar acceso a los usuarios.
Crea un rol personalizado con la consola de GDC, la CLI de gdcloud o la API:
Console
- Accede a la consola de GDC.
- En el selector de proyectos, elige la organización o el proyecto en el que deseas 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, ingresa el título de tu rol personalizado.
- En el campo Descripción, proporciona una descripción del propósito de tu rol personalizado.
En el campo ID, ingresa el identificador único para tu rol personalizado.
Los IDs de los roles personalizados pueden tener hasta 10 caracteres alfanuméricos en minúscula y no se pueden cambiar después de la creación del rol.
Selecciona una etapa de lanzamiento.
Selecciona el permiso de tu rol personalizado.
Si seleccionas Organización, el rol personalizado se aplica a todos los recursos de la organización. Si seleccionas Proyectos, el rol personalizado se aplica a todos los proyectos actuales y futuros de la organización. Puedes seleccionar Limitar a los proyectos seleccionados si deseas especificar qué proyectos pueden acceder al rol personalizado.
Haz clic en Agregar permisos.
Selecciona la casilla de verificación junto a uno o más de los permisos admitidos que deseas asignar a tu rol personalizado.
Los permisos disponibles se limitan al permiso seleccionado. Si cambias el permiso después de agregar permisos, debes confirmar que se restablezcan todos los permisos asignados con anterioridad.
Haz clic en Save.
Haga clic en Crear.
Tu nuevo rol personalizado aparecerá en la página Roles.
gdcloud
- Asegúrate de tener instalada la CLI de gdcloud. Para obtener más información, consulta la página de descripción general de la CLI de gdcloud.
Crea un rol personalizado:
gdcloud iam roles create ROLE_ID \ --title=TITLE \ --description=DESCRIPTION \ --permissions=PERMISSIONS --stage=LAUNCH_STAGEReemplaza lo siguiente:
ROLE_ID: Es el identificador único de tu rol personalizado. Los IDs de los roles personalizados pueden tener hasta 10 caracteres alfanuméricos en minúscula y pueden contener guiones. Los IDs de los roles personalizados no se pueden cambiar después de la creación del rol.TITLE: Es un título fácil de usar para el rol personalizado.DESCRIPTION: una descripción del propósito del rol personalizadoPERMISSIONS: Es una lista separada por comas de los permisos que deseas otorgar para el rol personalizado.Para obtener detalles sobre cómo encontrar las cadenas de permisos correctas, consulta Visualiza los roles y sus permisos. Cada cadena de permiso debe tener el formato que se indica en la guía en gdcloud iam roles create, donde
iamRoleNamees el nombre del recurso de Kubernetes del rol predefinido que contiene el permiso. Puedes encontrar el nombre del recurso de Kubernetes de un rol en la página Definiciones de roles o con el comando gdcloud iam roles list.LAUNCH_STAGE: Opcional Es la etapa de lanzamiento del rol personalizado. Los valores válidos sonALPHA,BETA,GAoDISABLED. El valor predeterminado esALPHAsi se omite esta marca.
Consulta gdcloud iam roles create para obtener una lista completa de las marcas obligatorias y opcionales, así como ejemplos de uso.
Como alternativa, puedes definir el rol personalizado en un archivo YAML y usar la marca
--file:gdcloud iam roles create ROLE_ID --file=YAML_FILE_PATHReemplaza
YAML_FILE_PATHpor la ruta de acceso al 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
Reemplaza lo siguiente:
ROLE_NAME: Es el nombre del recurso de Kubernetes del rol.NAMESPACE: Es el espacio de nombres para el rol personalizado. Usaplatformpara los roles con alcance de organización y para varios proyectos. Usa el espacio de nombres del proyecto (comomy-project) para los roles con alcance de proyecto y los proyectos individuales.DESCRIPTION: una descripción del propósito del rol personalizadoROLE_ID: Es el identificador único de tu rol personalizado. Los IDs de los roles personalizados pueden tener hasta 10 caracteres alfanuméricos en minúscula y pueden contener guiones. Los IDs de los roles personalizados 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 del proyecto.LAUNCH_STAGE: Opcional Es la etapa de lanzamiento del rol personalizado. Los valores válidos sonALPHA,BETA,GAoDISABLED. El valor predeterminado esALPHAsi se omite este campo.TITLE: Es un título fácil de usar para el rol personalizado.RULES_TYPE: Es el alcance de las reglas. Reemplaza porglobalRules(para los permisos en la API global),zonalRules(para los permisos en la API zonal) o ambos.RULES_LIST: Es una lista con sangría de objetos de regla de RBAC de Kubernetes estándar. Cada objeto de la lista otorga permisos. Puedes determinar los valores correctos deapiGroups,resourcesyverbssi examinas los permisos dentro de los roles predefinidos congdcloud iam roles describe, como se muestra en Visualiza roles y sus permisos.En el siguiente ejemplo, se muestra la estructura de un solo elemento dentro 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 diferente de permisos.
Administra un rol personalizado
Eres responsable de administrar el ciclo de vida de tus roles personalizados. Cuando Distributed Cloud agrega permisos, funciones o servicios nuevos, actualiza los roles predefinidos. Las actualizaciones, como borrar un rol predefinido o quitar permisos de un rol predefinido, pueden hacer que los roles personalizados que dependen de esos permisos no funcionen. Debes supervisar estas actualizaciones y ajustar manualmente los roles personalizados afectados para asegurarte de que sigan funcionando como se espera.
Puedes editar, inhabilitar o borrar un rol personalizado, pero no puedes editar, inhabilitar ni borrar un rol predefinido. Para ver una lista de todos los roles y sus permisos específicos, consulta Visualiza los roles y sus permisos.
Edita una función personalizada
Edita un rol personalizado con la consola de GDC, la CLI de gdcloud o la API:
Console
- Accede a la consola de GDC.
- En el selector de proyectos, elige la organización o el proyecto en el que deseas 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 deseas 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 etapa de lanzamiento
- De manera opcional, agrega o quita los permisos asignados.
- Haz clic en Agregar permisos para seleccionar de la lista de permisos disponibles.
- Para quitar un permiso asignado, selecciona la casilla de verificación junto al permiso que deseas quitar y haz clic en Quitar.
Haz clic en Save.
Aparecerá un mensaje para confirmar que se guardaron los cambios.
gdcloud
- Asegúrate de tener instalada la CLI de gdcloud. Para obtener más información, consulta la página de descripción general de la CLI de gdcloud.
Sigue estos pasos para editar un rol personalizado:
gdcloud iam roles update ROLE_ID \ --title=TITLE \ --description=DESCRIPTION \ --permissions=PERMISSIONS --stage=LAUNCH_STAGEReemplaza lo siguiente:
ROLE_ID: Es el identificador único de tu rol personalizado.TITLE: Es un título fácil de usar para el rol personalizado.DESCRIPTION: una descripción del propósito del rol personalizadoPERMISSIONS: Es una lista separada por comas de los permisos que deseas otorgar para el rol personalizado.Para obtener detalles sobre cómo encontrar las cadenas de permisos correctas, consulta Visualiza los roles y sus permisos. Cada cadena de permiso debe tener el formato que se indica en la guía en gdcloud iam roles create, donde
iamRoleNamees el nombre del recurso de Kubernetes del rol predefinido que contiene el permiso. Puedes encontrar el nombre del recurso de Kubernetes de un rol en la página Definiciones de roles o con el comando gdcloud iam roles list.LAUNCH_STAGE: Opcional Es la etapa de lanzamiento del rol personalizado. Los valores válidos sonALPHA,BETA,GAoDISABLED. El valor predeterminado esALPHAsi se omite esta marca.
Consulta gdcloud iam roles update para obtener una lista completa de las marcas obligatorias y opcionales, así como ejemplos de uso.
Como alternativa, puedes actualizar el rol personalizado en su archivo YAML y usar la marca
--file:gdcloud iam roles update ROLE_ID --file=YAML_FILE_PATHReemplaza
YAML_FILE_PATHpor la ruta de acceso al 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
Edita un 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
Reemplaza lo siguiente:
ROLE_NAME: Es el nombre del recurso de Kubernetes del rol.NAMESPACE: Es el espacio de nombres para el rol personalizado. Usaplatformpara los roles con alcance de organización y para varios proyectos. Usa el espacio de nombres del proyecto (comomy-project) para los roles con alcance de proyecto y los proyectos individuales.DESCRIPTION: una descripción del propósito del rol personalizadoROLE_ID: Es el identificador único de tu rol personalizado. Los IDs de los roles personalizados pueden tener hasta 10 caracteres alfanuméricos en minúscula y pueden contener guiones. Los IDs de los roles personalizados 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 del proyecto.LAUNCH_STAGE: Opcional Es la etapa de lanzamiento del rol personalizado. Los valores válidos sonALPHA,BETA,GAoDISABLED. El valor predeterminado esALPHAsi se omite este campo.TITLE: Es un título fácil de usar para el rol personalizado.RULES_TYPE: Es el alcance de las reglas. Reemplaza porglobalRules(para los permisos en la API global),zonalRules(para los permisos en la API zonal) o ambos.RULES_LIST: Es una lista con sangría de objetos de regla de RBAC de Kubernetes estándar. Cada objeto de la lista otorga permisos. Puedes determinar los valores correctos deapiGroups,resourcesyverbssi examinas los permisos dentro de los roles predefinidos congdcloud iam roles describe, como se muestra en Visualiza roles y sus permisos.En el siguiente ejemplo, se muestra la estructura de un solo elemento dentro 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 diferente de permisos.
Inhabilita un rol personalizado
Los roles personalizados inhabilitados permanecen en tu lista de roles y se pueden asignar a los usuarios, pero el rol no tiene efecto. Puedes volver a habilitar el rol personalizado en cualquier momento.
Inhabilita un rol personalizado con la consola de GDC, la CLI de gdcloud o la API:
Console
- Accede a la consola de GDC.
- En el selector de proyectos, elige la organización o el proyecto en el que deseas 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 deseas inhabilitar.
- En la página de detalles del rol personalizado, haz clic en Inhabilitar.
gdcloud
- Asegúrate de tener instalada la CLI de gdcloud. Para obtener más información, consulta la página de descripción general de la CLI de gdcloud.
Inhabilita un rol personalizado:
gdcloud iam roles update ROLE_ID --stage=DISABLEDReemplaza lo siguiente:
ROLE_ID: Es el identificador único de tu rol personalizado.
Consulta gdcloud iam roles update para obtener más información.
API
Inhabilita un recurso personalizado 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 deseas 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
Reemplaza lo siguiente:
ROLE_NAME: Es el nombre del recurso de Kubernetes del rol.NAMESPACE: Es el espacio de nombres para el rol personalizado. Usaplatformpara los roles con alcance de organización y para varios proyectos. Usa el espacio de nombres del proyecto (comomy-project) para los roles con alcance de proyecto y los proyectos individuales.DESCRIPTION: una descripción del propósito del rol personalizadoROLE_ID: Es el identificador único de tu rol personalizado. Los IDs de los roles personalizados pueden tener hasta 10 caracteres alfanuméricos en minúscula y pueden contener guiones. Los IDs de los roles personalizados 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 del proyecto.TITLE: Es un título fácil de usar para el rol personalizado.RULES_TYPE: Es el alcance de las reglas. Reemplaza porglobalRules(para los permisos en la API global),zonalRules(para los permisos en la API zonal) o ambos.RULES_LIST: Es una lista con sangría de objetos de regla de RBAC de Kubernetes estándar. Cada objeto de la lista otorga permisos. Puedes determinar los valores correctos deapiGroups,resourcesyverbssi examinas los permisos dentro de los roles predefinidos congdcloud iam roles describe, como se muestra en Visualiza roles y sus permisos.En el siguiente ejemplo, se muestra la estructura de un solo elemento dentro 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 diferente de permisos.
Borra un rol personalizado
Los roles borrados se quitan de forma permanente del sistema. Sin embargo, puedes crear un rol nuevo con el mismo nombre.
Borra un rol personalizado con la CLI de gdcloud o la API:
gdcloud
- Asegúrate de tener instalada la CLI de gdcloud. Para obtener más información, consulta la página de descripción general de la CLI de gdcloud.
Borra un rol personalizado:
gdcloud iam roles delete ROLE_ID --project=PROJECTReemplaza lo siguiente:
ROLE_ID: Es el identificador único de tu rol personalizado.PROJECT: el espacio de nombres del proyecto en el que deseas borrar el rol personalizado. Si no se especifica la marca--project, se borra el rol con alcance de organización.
Consulta gdcloud iam roles delete para obtener más información y ejemplos de uso.
API
Borra un recurso personalizado CustomRole con kubectl:
kubectl delete -f CUSTOM_ROLE
Reemplaza CUSTOM_ROLE por la ruta de acceso a tu
archivo YAML CustomRole. Este es el mismo archivo que usaste para crear o
actualizar el rol.