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.
- Descarga e instala la CLI gdcloud si aún no lo has hecho.
- Para usar la API con
kubectl, se requiere una configuración adicional:
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
- Inicia sesión en la consola de GDC.
- 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.
- En el menú de navegación, haz clic en Identidad y acceso > Acceso.
- Haz clic en Añadir miembro.
- Elige si quieres añadir usuarios o grupos.
- En la lista Proveedor de identidades, selecciona un proveedor de identidades.
- En el campo Nombre de usuario o alias de grupo, introduce el nombre de usuario, la dirección de correo o el alias.
- 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.
- Haz clic en Añadir.
El miembro aparecerá en la lista Miembro autorizado.
gdcloud
Asegúrate de que tienes instalada la CLI gdcloud.
Inicia sesión con el comando
gdcloud auth loginpara autenticarte con tu proveedor de identidades. Para obtener más información, consulta la autenticación de la CLI gdcloud.Configura las vinculaciones de roles.
Configurar vinculaciones de roles para una organización:
gdcloud organizations add-iam-policy-binding ORGANIZATION \ --member=USER_ACCOUNT \ --role=ROLESustituye 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=ROLESustituye 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
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_EMAILHaz 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,pauldepaul@example.com).ROLE_NAME: el nombre del rol que necesita el usuario (comoproject-creator). Consulta las definiciones de roles para ver una lista de roles y su alcance.BINDING_NAMESPACE:platformpara 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).
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
- Inicia sesión en la consola de GDC.
- En el menú de navegación, haz clic en Identidad y acceso > Acceso.
- En la lista Miembros autorizados, selecciona un miembro.
- Haz clic en Quitar miembro.
- Cuando se te solicite, haz clic en Quitar miembro para confirmar la acción.
gdcloud
Asegúrate de que tienes instalada la CLI gdcloud.
Inicia sesión con el comando
gdcloud auth loginpara autenticarte con tu proveedor de identidades. Para obtener más información, consulta la autenticación de la CLI gdcloud.Quitar vinculaciones de roles.
Quitar vinculaciones de roles de una organización:
gdcloud organizations remove-iam-policy-binding ORGANIZATION \ --member=USER_ACCOUNT \ --role=ROLESustituye 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=ROLESustituye 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,pauldepaul@example.com). - ROLE_NAME: el nombre del rol que quieres quitar, como
project-creator. - BINDING_NAMESPACE: sustitúyelo por
platformen 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:
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 loginSustituye
ZONE_URLpor la URL de la consola de GDC de la zona para la que quieras revocar el acceso de los usuarios, que se parece ahttps://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.
Revoca el acceso del usuario a la zona:
gdcloud admin auth revoke --accounts USER_EMAILSustituye 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.comEn este ejemplo, la variable NUMBER hace referencia al número de sesiones de actividad activas que ha tenido el usuario.
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.comRepite los pasos anteriores para cada zona de tu universo.