Conceder y revocar el acceso

Cada sujeto (un usuario o un grupo) sigue un proceso de dos pasos para obtener acceso al servidor de la API global. Concede permisos a un sujeto en el servidor de la API global usando IAMRoleBinding para un IAMRole predefinido. Todos los roles y las vinculaciones de roles son globales.

Esta página está dirigida a las audiencias del grupo de administradores de la plataforma que gestionan los permisos de su organización. Para obtener más información, consulta la documentación sobre las audiencias de GDC aislado.

Antes de empezar

Antes de gestionar las vinculaciones de roles o revocar el acceso, debes solicitar los permisos necesarios y preparar tu entorno. Los roles específicos que se necesitan dependen de si estás gestionando vinculaciones de roles o revocando el acceso de usuarios.

Solicitar roles de gestión de identidades y accesos

Ponte en contacto con el admin. de la org. de gestión de identidades y accesos para solicitar los roles en función de las tareas que necesites realizar:

  • Administrador de gestión de identidades y accesos de la organización (organization-iam-admin): crea, actualiza y elimina vinculaciones de roles a nivel de organización y de proyecto.
  • Administrador de la organización de la sesión (org-session-admin): revoca las sesiones activas y el acceso de un usuario en una zona específica.

Prepara tu entorno

Para usar las herramientas de línea de comandos para gestionar las vinculaciones de roles o revocar el acceso, completa la siguiente configuración.

Configurar vinculaciones de roles

Puedes configurar vinculaciones de roles que den acceso a los miembros del equipo a los recursos a nivel de organización o de proyecto.

Asignar un rol a un miembro autorizado:

Consola

  1. Inicia sesión en la consola de GDC.
  2. Selecciona una organización o un proyecto en el selector de permisos.
    • Para configurar vinculaciones de roles en una organización, selecciona una organización.
    • Para configurar las vinculaciones de roles de un proyecto, selecciona un proyecto.
  3. En el menú de navegación, haz clic en Identidad y acceso > Acceso.
  4. Haz clic en Añadir miembro.
  5. Elige si quieres añadir usuarios o grupos.
  6. En la lista Proveedor de identidades, selecciona un proveedor de identidades.
  7. En el campo Nombre de usuario o alias de grupo, introduce el nombre de usuario, la dirección de correo o el alias.
  8. En la lista Rol, selecciona el rol que quieras asignar al usuario o al grupo, como Lector de organización a nivel de organización o Creador del proyecto a nivel de proyecto.
  9. Haz clic en Añadir.

El miembro aparecerá en la lista Miembro autorizado.

gdcloud

  1. Asegúrate de que tienes instalada la CLI gdcloud.

  2. Inicia sesión con el comando gdcloud auth login para autenticarte con tu proveedor de identidades. Para obtener más información, consulta la autenticación de la CLI gdcloud.

  3. Configura las vinculaciones de roles.

    • Configurar vinculaciones de roles para una organización:

      gdcloud organizations add-iam-policy-binding ORGANIZATION \
        --member=USER_ACCOUNT \
        --role=ROLE
      

      Sustituye las siguientes variables:

      • ORGANIZATION: el nombre de la organización para la que estás configurando la vinculación de roles.
      • USER_ACCOUNT: la cuenta de usuario a la que quieres conceder el rol. Esta marca acepta una dirección de correo de usuario con el prefijo del proveedor de identidades (user:idpprefix-user@example.com) o un nombre de cuenta de servicio con el proyecto de cuenta de servicio (serviceAccount:projectName:serviceAccountName).
      • ROLE: el nombre del rol predefinido o personalizado que quieres asignar al usuario.
    • Configura las vinculaciones de roles de un proyecto:

      gdcloud projects add-iam-policy-binding PROJECT \
        --member=USER_ACCOUNT \
        --role=ROLE
      

      Sustituye las siguientes variables:

      • PROJECT: el nombre del proyecto para el que estás configurando la vinculación de roles.
      • USER_ACCOUNT: la cuenta de usuario a la que quieres conceder el rol. Esta marca acepta una dirección de correo de usuario con el prefijo del proveedor de identidades (user:idpprefix-user@example.com) o un nombre de cuenta de servicio con el proyecto de cuenta de servicio (serviceAccount:projectName:serviceAccountName).
      • ROLE: el nombre del rol predefinido o personalizado que quieres asignar al usuario.

API

  1. Exporta las variables de entorno de la vinculación de roles:

    export GLOBAL_API_SERVER_KUBECONFIG=GLOBAL_API_SERVER_KUBECONFIG
    export USERNAME=IDP_PREFIX-USERNAME
    export ROLE_NAME=ROLE_NAME
    export BINDING_NAMESPACE=BINDING_NAMESPACE
    export USER_EMAIL=IDP_PREFIX-USER_EMAIL
    

    Haz los cambios siguientes:

    • GLOBAL_API_SERVER_KUBECONFIG: la ruta al archivo kubeconfig del servidor de la API global.
    • IDP_PREFIX: el prefijo del proveedor de identidades.
    • USERNAME: la parte del nombre de usuario de la dirección de correo del usuario antes del símbolo @ (por ejemplo, paul de paul@example.com).
    • ROLE_NAME: el nombre del rol que necesita el usuario (como project-creator). Consulta las definiciones de roles para ver una lista de roles y su alcance.
    • BINDING_NAMESPACE: platform para los roles de organización o el nombre del espacio de nombres del proyecto de destino para los roles de proyecto.
    • USER_EMAIL: la dirección de correo de la cuenta de usuario a la que quieres asignar el rol (por ejemplo, paul@example.com).
  2. Crea y aplica un recurso personalizado de IAMRoleBinding:

    cat <<EOF | kubectl --kubeconfig ${GLOBAL_API_SERVER_KUBECONFIG} apply -f -
    apiVersion: iam.global.gdc.goog/v1
    kind: IAMRoleBinding
    metadata:
      name: ${USERNAME}-${ROLE_NAME}-binding
      namespace: ${BINDING_NAMESPACE}
    spec:
      roleRef:
        apiGroup: iam.global.gdc.goog
        kind: IAMRole
        name: ${ROLE_NAME}
      subjects:
      - apiGroup: rbac.authorization.k8s.io
        kind: User
        name: ${USER_EMAIL}
    EOF
    

Quitar vinculaciones de roles

Cuando ya no sea necesario el acceso, quita al miembro y sus roles, permisos y accesos asociados.

Para quitar miembros, sigue estos pasos:

Consola

  1. Inicia sesión en la consola de GDC.
  2. En el menú de navegación, haz clic en Identidad y acceso > Acceso.
  3. En la lista Miembros autorizados, selecciona un miembro.
  4. Haz clic en Quitar miembro.
  5. Cuando se te solicite, haz clic en Quitar miembro para confirmar la acción.

gdcloud

  1. Asegúrate de que tienes instalada la CLI gdcloud.

  2. Inicia sesión con el comando gdcloud auth login para autenticarte con tu proveedor de identidades. Para obtener más información, consulta la autenticación de la CLI gdcloud.

  3. Quitar vinculaciones de roles.

    • Quitar vinculaciones de roles de una organización:

      gdcloud organizations remove-iam-policy-binding ORGANIZATION \
        --member=USER_ACCOUNT \
        --role=ROLE
      

      Sustituye las siguientes variables:

      • ORGANIZATION: el nombre de la organización de la que vas a quitar la vinculación de roles.
      • USER_ACCOUNT: la cuenta de usuario de la que quieres quitar el rol. Esta marca acepta una dirección de correo de usuario con el prefijo del proveedor de identidades (user:idpprefix-user@example.com) o un nombre de cuenta de servicio con el proyecto de cuenta de servicio (serviceAccount:projectName:serviceAccountName).
      • ROLE: el nombre del rol predefinido o personalizado que quieres quitar de la cuenta de usuario.
    • Quitar vinculaciones de roles de un proyecto:

      gdcloud projects remove-iam-policy-binding PROJECT \
        --member=USER_ACCOUNT \
        --role=ROLE
      

      Sustituye las siguientes variables:

      • PROJECT: el nombre del proyecto del que vas a quitar la vinculación de roles.
      • USER_ACCOUNT: la cuenta de usuario de la que quieres quitar el rol. Esta marca acepta una dirección de correo de usuario con el prefijo del proveedor de identidades (user:idpprefix-user@example.com) o un nombre de cuenta de servicio con el proyecto de cuenta de servicio (serviceAccount:projectName:serviceAccountName).
      • ROLE: el nombre del rol predefinido o personalizado que quieres quitar de la cuenta de usuario.

kubectl

Elimina el IAMRoleBinding para revocar el permiso concedido a la cuenta de PA:

kubectl --kubeconfig GLOBAL_API_SERVER_KUBECONFIG \
delete iamrolebinding IDP_PREFIX-USERNAME-ROLE_NAME-binding -n BINDING_NAMESPACE

Haz los cambios siguientes:

  • GLOBAL_API_SERVER_KUBECONFIG: la ruta al archivo kubeconfig del servidor de la API global.
  • IDP_PREFIX: el prefijo del proveedor de identidades.
  • USERNAME: la parte del nombre de usuario de la dirección de correo del usuario antes del símbolo @ (por ejemplo, paul de paul@example.com).
  • ROLE_NAME: el nombre del rol que quieres quitar, como project-creator.
  • BINDING_NAMESPACE: sustitúyelo por platform en el caso de los roles de organización o por el nombre del espacio de nombres del proyecto de destino en el caso de los roles de proyecto.

Revocar el acceso de un usuario

Si un miembro abandona tu organización o equipo, puedes revocar su acceso a Google Distributed Cloud (GDC) aislado. Al revocar el acceso de un usuario, se cierra su sesión en Distributed Cloud y se eliminan sus roles y permisos. También puedes mostrar la actividad y las sesiones del usuario a partir de su hora de inicio y de finalización.

Para revocar el acceso de un usuario en un universo de GDC, debes revocar el acceso de cada zona por separado. Sigue estos pasos en cada zona:

  1. Asegúrate de haber iniciado sesión en la zona cuyo acceso quieras revocar. Por ejemplo, define la configuración de URL de zona para la CLI gdcloud y, a continuación, inicia sesión:

    gdcloud config set organization_console_url ZONE_URL
    gdcloud auth login
    

    Sustituye ZONE_URL por la URL de la consola de GDC de la zona para la que quieras revocar el acceso de los usuarios, que se parece a https://console.ORG_NAME.ZONE_NAME.ORG_SUFFIX.

    Para obtener más información sobre cómo cambiar de contexto de zona, consulta Acceder a zonas con tus herramientas.

  2. Revoca el acceso del usuario a la zona:

    gdcloud admin auth revoke --accounts USER_EMAIL
    

    Sustituye USER_EMAIL por el correo del usuario al que quieras revocar el acceso.

    Después de ejecutar el comando, verás un resultado similar al siguiente. En este ejemplo, se revoca el acceso del usuario ariel@example.com:

    Success: NUMBER of sessions revoked for user ariel@example.com
    

    En este ejemplo, la variable NUMBER hace referencia al número de sesiones de actividad activas que ha tenido el usuario.

  3. Confirma que has revocado el acceso del usuario volviendo a ejecutar el comando gdcloud admin auth revoke. Si se completa correctamente, verás lo siguiente:

    No sessions found for account: ariel@example.com
    
  4. Repite los pasos anteriores para cada zona de tu universo.