REVIEWITDocumentación
ProcedimientoAl día · verificada el 12 noviembre 2026

Preparar una identidad de Google Cloud

Traducción automática, aún no revisadaEsta página fue traducida por un modelo a partir de la versión francesa, que es la que da fe. Leer la versión francesa.

01En resumen #sec_ca35eb77

REVIEWIT recopila una organización de Google Cloud mediante una cuenta de servicio dedicada. Esta cuenta de servicio recibe un rol personalizado de lectura en el nodo de la organización: los proyectos y carpetas lo heredan. Todo es de lectura: REVIEWIT nunca lee el valor de un secreto, el contenido de un objeto ni los datos de una tabla.

REVIEWIT actúa bajo esta cuenta de servicio de dos maneras, a elección:

  • sin clave (recomendado): su organización confía en esta conexión únicamente, mediante la federación de identidad de carga de trabajo. REVIEWIT firma un token corto con una clave que nunca sale de su bóveda. No hay secretos que crear, confiar o renovar, y ninguna excepción a la política que prohíbe las claves;
  • con una clave: crea una clave JSON de la cuenta de servicio y la pega en REVIEWIT.

Lo que hay que conceder depende de los recursos que quiera recopilar. Dos caminos, el mismo resultado:

  • el paso Preparar del asistente de conexión genera el rol exacto de los recursos que marque, y los comandos gcloud que lo asignan;
  • el script de Cloud Shell que aparece a continuación asigna el rol de todo el catálogo de Google Cloud, crea la cuenta de servicio y activa las API de su proyecto.
Archivo adjuntoZIP

Script de Cloud Shell y rol personalizado de la conexión de Google Cloud

Descargar
Versión13/11/2026IdiomaTodos los idiomasTamaño5 KB
Huella SHA-256 — Compare esta huella con la del archivo descargado antes de confiar en él.5c10a1570f7569577a1abf6e196e62cb934efafd94e08e34fbdb242b39b8dc1c

021. Elegir el proyecto anfitrión #sec_91fcbbe4

REVIEWIT conecta una organización de Google Cloud: un proyecto «sin organización» no es compatible. La cuenta de servicio vive en un proyecto anfitrión de su elección, idealmente un proyecto dedicado (por ejemplo reviewit-connector) dentro de una carpeta de seguridad.

El proyecto anfitrión no necesita ningún cuenta de facturación: REVIEWIT activa solo siete API de organización (Resource Manager, Service Usage, IAM, Org Policy, Cloud Billing, Recommender, Privileged Access Manager), que se activan sin facturación. Las lecturas de un proyecto se contabilizan en este proyecto: un proyecto que contiene recursos ya tiene las API correspondientes.

032. Ejecutar el script #sec_dcebd435

Abra Cloud Shell con una cuenta que tenga, en la organización, los roles Administrador de la organización y Administrador de roles de organización (un superadministrador de Google Workspace no los tiene por defecto: puede asignárselos en IAM y administración › IAM), cargue allí el script y luego:

HOST_PROJECT=reviewit-connector bash reviewit-gcp-setup.sh

El script, en orden:

  1. activa las siete API de organización en el proyecto anfitrión;
  2. crea (o actualiza) el rol personalizado REVIEWIT_Read en la organización;
  3. crea la cuenta de servicio reviewit-collector en el proyecto anfitrión;
  4. le asigna el rol en el nodo de la organización.

No crea ninguna clave ni modifica ninguna política de organización sin que usted lo pida (sección 3 b). Vuelva a ejecutarlo tras una evolución del catálogo: actualiza el rol.

043. Elegir el método #sec_0afbfc3f

a. Sin clave (recomendado)

En el asistente de conexión, paso Identificador, elija Sin clave (federación), luego Generar la clave de esta conexión. REVIEWIT hace nacer la clave en su bóveda y le devuelve su parte pública. Copie los comandos de Cloud Shell y ejútelos en Cloud Shell, después del script de la sección 2. Es necesario ser propietario del proyecto anfitrión, o tener los roles Administrador de pools de identidades de carga de trabajo y Administrador de cuentas de servicio.

Estos comandos, en orden:

  1. activan dos API en el proyecto anfitrión (sts, iamcredentials);
  2. crean el pool de identidades reviewit, si aún no existe;
  3. crean en él un proveedor OIDC propio de esta conexión: conoce la clave pública de REVIEWIT y solo admite el sujeto de esta conexión;
  4. autorizan a este único sujeto a actuar como reviewit-collector (rol Usuario de Workload Identity).

Finalmente muestran la cuenta de servicio y el proveedor para informar en el asistente (sección 4). Otra conexión de REVIEWIT, incluso del mismo cliente, nunca abre esta organización: tiene su propia clave y su propio sujeto.

b. Con una clave

Las organizaciones creadas desde 2024 prohíben por defecto la creación de claves de cuenta de servicio (política de organización Disable service account key creation, aplicada automáticamente). Es una buena práctica: una clave es un secreto de larga duración. Por eso se recomienda la conexión sin clave.

Para la conexión por clave, levante la prohibición solo en el proyecto anfitrión, luego cree la clave:

HOST_PROJECT=reviewit-connector ALLOW_KEY_EXCEPTION=yes CREATE_KEY=yes bash reviewit-gcp-setup.sh

Para ello necesita el rol de administrador de reglas de administración (roles/orgpolicy.policyAdmin). Una regla levantada tarda de uno a varios minutos en aplicarse: durante este tiempo, Google rechaza la clave (CUSTOM_ORG_POLICY_VIOLATION) y el script vuelve a intentarlo solo. El script escribe reviewit-collector-key.json: pegue su contenido en REVIEWIT (sección 4), luego elimine el archivo.

054. Declarar y verificar #sec_05593f95

Vuelva al asistente, paso Identificador:

  • sin clave: informe la cuenta de servicio y el proveedor ( projects/…/workloadIdentityPools/reviewit/providers/… ) que los comandos han mostrado;
  • con una clave: pegue la clave JSON .

Si nombra a sus propietarios con una etiqueta diferente a owner , indique su clave. Luego Verificar . No hay ningún identificador de organización que ingresar: REVIEWIT lo descubre.

REVIEWIT obtiene el acceso de la cuenta de servicio, descubre la organización ( organizations/… ), ve los proyectos, luego le pide a Google, permiso por permiso , lo que la cuenta de servicio tiene derecho a hacer en la organización — herencia y roles personalizados incluidos. Muestra el veredicto de cada recurso, y nombra las API que aún deben activarse en el proyecto anfitrión; lo que falte lleva de vuelta a la etapa Preparar . Sin clave, un rechazo nombra la etapa en cuestión: el proveedor que rechaza el token (reinicie los comandos), o el derecho de actuar como cuenta de servicio que falta. Google tarda de uno a dos minutos en aplicar este derecho: una verificación iniciada justo después de los comandos puede ser rechazada por esta razón; reiníciela dos minutos más tarde.

Una clave se guarda en la bóveda de REVIEWIT, nunca en texto claro; también puede confiarla a SEAL , que firma en su nombre sin nunca devolverla. Para renovarla, cree una nueva clave, actualice el identificador en REVIEWIT, luego elimine la anterior. Sin clave, no hay nada que renovar.

06Quién responde de un recurso #sec_f86c62c9

REVIEWIT lee el propietario en la etiqueta que elija ( owner por defecto): primero en el recurso, luego en su proyecto. Un valor de etiqueta no admite ni « @ » ni « . »: indique la parte local de la dirección ( marie-dupont para marie-dupont@votre-domaine) ; REVIEWIT la resuelve en los dominios de su organización. Sin etiqueta, son los titulares directos del rol Owner del proyecto; de lo contrario, el recurso se reporta como huérfano .

07Lo que REVIEWIT nunca hace #sec_6e5ae848

  • No despliega nada ni se otorga ningún derecho: su administrador lanza el script o asigna el rol.
  • No lee ni el valor de un secreto ( secretmanager.versions.access ), ni el contenido de un objeto ( storage.objects.get ), ni los datos de una tabla ( bigquery.tables.getData ): ninguna de estas permisos se solicita.
  • No exige Cloud Asset Inventory: si está activado, REVIEWIT lo usa para enumerar más rápido; de lo contrario, nada cambia.

08Para ir más allá #sec_06d33e2c

  • Comprender una conexión de recolección
  • Referencia de derechos por recurso
  • Leer un veredicto
Esc
↑↓ navegar↵ abrirVer todos los resultados →