Crear una función personalizada

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:

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 --permissions al 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

  1. Inicia sesión en la consola de GDC.
  2. En el selector de proyectos, selecciona la organización o el proyecto en el que quieras ver los roles.
  3. En el menú de navegación, haz clic en Identidad y acceso > Roles.

    Aparecerá una lista con los roles predefinidos y personalizados disponibles.

  4. 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

  1. 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.
  2. Lista de roles disponibles:

    gdcloud iam roles list \
      --type=ROLE_TYPE \
      --project=PROJECT
    

    Haz los cambios siguientes:

    • ROLE_TYPE: el tipo de roles que se van a mostrar. Los valores válidos son predefined, custom o all.
    • PROJECT: el espacio de nombres del proyecto en el que quieres ver los roles. Omite la marca --project para los roles de organización.
  3. Ver los permisos específicos de un rol:

    gdcloud iam roles describe ROLE_NAME \
      --project=PROJECT
    

    Haz los cambios siguientes:

    • ROLE_NAME: el nombre del recurso de Kubernetes del rol
    • PROJECT: el espacio de nombres del proyecto en el que quieres ver los permisos de los roles. Omite la marca --project para 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

  1. Inicia sesión en la consola de GDC.
  2. En el selector de proyectos, selecciona la organización o el proyecto en el que quieras crear un rol personalizado.
  3. En el menú de navegación, haz clic en Identidad y acceso > Roles.
  4. Haz clic en Crear rol personalizado.
  5. En el campo Título, introduce el título del rol personalizado.
  6. En el campo Descripción, describe la finalidad del rol personalizado.
  7. 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.

  8. Selecciona una fase de lanzamiento.

  9. 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.

  10. Haz clic en Añadir permisos.

  11. 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.

  12. Haz clic en Guardar.

  13. Haz clic en Crear.

    El nuevo rol personalizado aparecerá en la página Roles.

gdcloud

  1. 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.
  2. Crear un rol personalizado:

    gdcloud iam roles create ROLE_ID \
      --title=TITLE \
      --description=DESCRIPTION \
      --permissions=PERMISSIONS
      --stage=LAUNCH_STAGE
    

    Haz 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 personalizado
    • PERMISSIONS: lista separada por comas de los permisos que quieres conceder al rol personalizado

      Para 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 iamRoleName es 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 son ALPHA, BETA, GA o DISABLED. Si se omite esta marca, se asigna el valor ALPHA de 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_PATH
    

    Sustituye YAML_FILE_PATH por 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, --description y --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 rol
  • NAMESPACE: el espacio de nombres del rol personalizado. Usa platform para roles de organización y para varios proyectos. Usa el espacio de nombres del proyecto (como my-project) para los roles de proyecto y los proyectos individuales.
  • DESCRIPTION: descripción de la finalidad del rol personalizado
  • 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.
  • SCOPE: usa organization para los roles creados en el espacio de nombres platform. Usa project para los roles creados en un espacio de nombres de proyecto.
  • LAUNCH_STAGE: opcional. La fase de lanzamiento del rol personalizado. Los valores válidos son ALPHA, BETA, GA o DISABLED. Si se omite este campo, se asignará el valor ALPHA de forma predeterminada.
  • TITLE: un título fácil de usar para el rol personalizado.
  • RULES_TYPE: el ámbito de las reglas. Sustituye por globalRules (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 de apiGroups, resources y verbs examinando los permisos de los roles predefinidos con gdcloud 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

  1. Inicia sesión en la consola de GDC.
  2. En el selector de proyectos, selecciona la organización o el proyecto en el que quieras editar un rol personalizado.
  3. En el menú de navegación, haz clic en Identidad y acceso > Roles.
  4. En la lista de roles, selecciona el rol personalizado que quieras editar.
  5. En la página de detalles del rol personalizado, haz clic en Editar.
  6. Editar los detalles de tu rol personalizado, como el título, la descripción, el ID o la fase de lanzamiento.
  7. Si quieres, puedes añadir o quitar permisos asignados.
    1. Haz clic en Añadir permisos para seleccionar uno de la lista de permisos disponibles.
    2. Para quitar un permiso asignado, selecciona la casilla situada junto al permiso que quieras quitar y haz clic en Quitar.
  8. Haz clic en Guardar.

    Aparecerá un mensaje para confirmar que has guardado los cambios.

gdcloud

  1. 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.
  2. Editar un rol personalizado:

    gdcloud iam roles update ROLE_ID \
      --title=TITLE \
      --description=DESCRIPTION \
      --permissions=PERMISSIONS
      --stage=LAUNCH_STAGE
    

    Haz los cambios siguientes:

    • ROLE_ID: identificador único de tu rol personalizado
    • TITLE: un título fácil de usar para el rol personalizado.
    • DESCRIPTION: descripción de la finalidad del rol personalizado
    • PERMISSIONS: lista separada por comas de los permisos que quieres conceder al rol personalizado

      Para 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 iamRoleName es 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 son ALPHA, BETA, GA o DISABLED. Si se omite esta marca, se asigna el valor ALPHA de 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_PATH
    

    Sustituye YAML_FILE_PATH por 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, --description y --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 rol
  • NAMESPACE: el espacio de nombres del rol personalizado. Usa platform para roles de organización y para varios proyectos. Usa el espacio de nombres del proyecto (como my-project) para los roles de proyecto y los proyectos individuales.
  • DESCRIPTION: descripción de la finalidad del rol personalizado
  • 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.
  • SCOPE: usa organization para los roles creados en el espacio de nombres platform. Usa project para los roles creados en un espacio de nombres de proyecto.
  • LAUNCH_STAGE: opcional. La fase de lanzamiento del rol personalizado. Los valores válidos son ALPHA, BETA, GA o DISABLED. Si se omite este campo, se asignará el valor ALPHA de forma predeterminada.
  • TITLE: un título fácil de usar para el rol personalizado.
  • RULES_TYPE: el ámbito de las reglas. Sustituye por globalRules (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 de apiGroups, resources y verbs examinando los permisos de los roles predefinidos con gdcloud 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

  1. Inicia sesión en la consola de GDC.
  2. En el selector de proyectos, selecciona la organización o el proyecto en el que quieras inhabilitar un rol personalizado.
  3. En el menú de navegación, haz clic en Identidad y acceso > Roles.
  4. En la lista de roles, selecciona el rol personalizado que quieras inhabilitar.
  5. En la página de detalles del rol personalizado, haz clic en Inhabilitar.

gdcloud

  1. 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.
  2. Inhabilitar un rol personalizado:

    gdcloud iam roles update ROLE_ID --stage=DISABLED
    

    Haz 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 rol
  • NAMESPACE: el espacio de nombres del rol personalizado. Usa platform para roles de organización y para varios proyectos. Usa el espacio de nombres del proyecto (como my-project) para los roles de proyecto y los proyectos individuales.
  • DESCRIPTION: descripción de la finalidad del rol personalizado
  • 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.
  • SCOPE: usa organization para los roles creados en el espacio de nombres platform. Usa project para 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 por globalRules (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 de apiGroups, resources y verbs examinando los permisos de los roles predefinidos con gdcloud 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

  1. 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.
  2. Eliminar un rol personalizado:

    gdcloud iam roles delete ROLE_ID --project=PROJECT
    

    Haz los cambios siguientes:

    • ROLE_ID: identificador único de tu rol personalizado
    • PROJECT: 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.