> For the complete documentation index, see [llms.txt](https://docs.stoik.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stoik.io/help/help-center-en-es/herramientas-de-prevencion/cloud-scan/gcp.md).

# Configuración: GCP

Concede al análisis en la nube acceso de solo lectura a un proyecto de Google Cloud creando una cuenta de servicio que Stoïk pueda usar.

## Requisitos previos

* Se requiere una cuenta de administrador para realizar esta implementación.
* Se requiere un asesor técnico para la supervisión continua y la remediación de vulnerabilidades.
* Una sola persona realiza toda la configuración, de principio a fin: un usuario de Stoïk Protect autorizado a editar herramientas de prevención, que además es administrador del proyecto de GCP.

## Configuración

{% stepper %}
{% step %}

### Seleccione Google Cloud Platform

Ve a `Cloud Scan` > `Configuración`, haga clic en `Nuevo proveedor`, y seleccione `Google Cloud Platform`.

<figure><img src="https://1731397918-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDGGQ49Oui29Ft0kJjSm%2Fuploads%2FDw2b46xxHQFAG4OCkigt%2FScreenshot%202026-04-07%20at%2018.57.56.png?alt=media&amp;token=72ccef3f-3cb8-4f54-b98b-6c748f5e3e92" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Abra su consola de Cloud

Vaya al [Consola de Google Cloud](https://console.cloud.google.com/) e inicie sesión con su cuenta de administrador.

<figure><img src="https://1731397918-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDGGQ49Oui29Ft0kJjSm%2Fuploads%2FUTcz9AktGTD9Cczz9KPB%2Fcloud-scan-google-cloud-console.png?alt=media&amp;token=4f6d18c5-3eec-4040-9d46-12ae365c6dd7" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Abra la biblioteca de API

Ve a `APIs y servicios` > `Biblioteca` en el menú de la izquierda.

<figure><img src="https://1731397918-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDGGQ49Oui29Ft0kJjSm%2Fuploads%2FH7VRpz11JW2ppKogPQ4y%2Fcloud-scan-console-api-services-library.png?alt=media&amp;token=e0153ae0-5695-4746-b3bc-da256ee2d1bb" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Busque la API de Cloud Resource Manager

Busque `API de Cloud Resource Manager` y haga clic en ella.

<figure><img src="https://1731397918-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDGGQ49Oui29Ft0kJjSm%2Fuploads%2F4f8FTY2S563Lm31xK7Np%2Fcloud-scan-cloud-resource-manager-api.png?alt=media&amp;token=0aafc7a8-1d1d-40fc-b08d-b6eb064cb3d1" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Habilite la API

Haga clic en `Habilitar`.

<figure><img src="https://1731397918-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDGGQ49Oui29Ft0kJjSm%2Fuploads%2FqHVrHGykLoST9s0PycrJ%2Fcloud-scan-resource-manager-api-enable.png?alt=media&amp;token=20c69a92-2c79-4568-a5c9-86c5806db366" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Abra las cuentas de servicio

Ve a `IAM y administración` > `Cuentas de servicio` en el menú de la izquierda.

<figure><img src="https://1731397918-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDGGQ49Oui29Ft0kJjSm%2Fuploads%2FskzJLLEd9DokDw9pHIJF%2Fcloud-scan-iam-admin-service-accounts.png?alt=media&amp;token=c83333e7-9f3c-4fc9-9678-ff91daec5658" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Cree la cuenta de servicio

Haga clic en `Crear cuenta de servicio`.

<figure><img src="https://1731397918-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDGGQ49Oui29Ft0kJjSm%2Fuploads%2FBTbAgGb6fSK20BVXuuSz%2Fcloud-scan-create-service-account.png?alt=media&amp;token=168d4f6e-46ff-4420-a503-9002c33b3f2a" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Nombre de la cuenta de servicio

Introduzca `stoik-scanner` como nombre de la cuenta de servicio, luego haga clic en `Crear y continuar`.

<figure><img src="https://1731397918-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDGGQ49Oui29Ft0kJjSm%2Fuploads%2F6whuJGKh4PNGgftwZqLV%2Fcloud-scan-create-service-account-name.png?alt=media&amp;token=d00f2170-bd90-455f-a9f3-94da30e44b62" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Asigne roles

Añada los siguientes 3 roles: `Lector`, `Revisor de seguridad`, `Lector de cuentas de Stackdriver`.

<figure><img src="https://1731397918-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDGGQ49Oui29Ft0kJjSm%2Fuploads%2FCChwue8tVQSHKCpMIlCe%2Fcloud-scan-create-service-account-permissions.png?alt=media&amp;token=26b9ac91-e109-412d-8cd8-37548092f78b" alt=""><figcaption></figcaption></figure>

Deje el paso 3 en blanco y haga clic en `Hecho`.
{% endstep %}

{% step %}

### Abra la cuenta de servicio

Haga clic en la cuenta de servicio que acaba de crear, luego haga clic en `Principales con acceso`.

<figure><img src="https://1731397918-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDGGQ49Oui29Ft0kJjSm%2Fuploads%2Ft4z2qlijQGNNDA4ISbLi%2Fcloud-scan-open-service-account.png?alt=media&amp;token=94f014b7-d982-4152-bfd9-8d3af5436de8" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1731397918-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDGGQ49Oui29Ft0kJjSm%2Fuploads%2FiCKjOoUMiZUKJDD9lcDz%2Fcloud-scan-service-account-grant-access.png?alt=media&amp;token=362b9a8b-d905-4d37-ad5f-b8017951ebe0" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Conceder acceso

1. Seleccione su cuenta de servicio y haga clic en `Conceder acceso`.
2. Introduzca `stoik-scanner@stoik-gcp-scan-prod.iam.gserviceaccount.com` en el `Nuevos principales` campo.
3. Asigne el rol de `Creador de tokens de cuenta de servicio` , luego haga clic en `Guardar`.

<figure><img src="https://1731397918-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDGGQ49Oui29Ft0kJjSm%2Fuploads%2FtA2nkzIqHpx65ok06gqr%2Fcloud-scan-service-account-add-principals.png?alt=media&amp;token=f1c62da6-496e-4804-9afc-161d71df3c2b" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Copie el correo electrónico de la cuenta de servicio

1. Haga clic en `Detalles` en GCP.
2. Copie la dirección de correo electrónico de la cuenta de servicio creada.

<figure><img src="https://1731397918-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDGGQ49Oui29Ft0kJjSm%2Fuploads%2FBbOUrFQXlScFI32CxLgR%2Fcloud-scan-service-account-copy-email.png?alt=media&amp;token=4fa17999-bb77-4764-bfff-99c2a20735f6" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Complete la configuración

<figure><img src="https://1731397918-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDGGQ49Oui29Ft0kJjSm%2Fuploads%2F6yEDTO51V6cbdB8McEz4%2FScreenshot%202026-04-07%20at%2018.59.05.png?alt=media&amp;token=1568ad28-5e33-4283-8b3c-d415d7606fce" alt=""><figcaption></figcaption></figure>

1. Pegue la dirección de correo electrónico de la cuenta de servicio en el campo `Correo electrónico de la cuenta de servicio` en Stoïk Protect.
2. Haga clic en `Complete la configuración`.

{% hint style="info" %}
Actualice la página de Stoïk Protect si es necesario.
{% endhint %}
{% endstep %}
{% endstepper %}

## Proyectos para analizar

Configure los proyectos que contienen sus servidores y bases de datos: un proyecto creado solo para Stoïk está vacío, así que no hay nada que analizar. La API debe habilitarse un proyecto a la vez.

## Solución de problemas

<details>

<summary>La configuración falló y luego funcionó cuando lo volví a intentar</summary>

Los nuevos roles, permisos y APIs tardan unos minutos en aplicarse. Espere 5 minutos y vuelva a hacer clic.

</details>

<details>

<summary>"role/stackdriver.accounts.viewer debe asignarse"</summary>

`Visor de Stackdriver` y `Lector de cuentas de Stackdriver` son dos roles diferentes. La cuenta de servicio necesita exactamente `Lector`, `Revisor de seguridad` y `Lector de cuentas de Stackdriver`.

</details>

<details>

<summary>"no pertenecen a un cliente permitido"</summary>

La política de su organización **Compartición restringida por dominio** (`iam.allowedPolicyMemberDomains`) bloquea la cuenta de servicio de Stoïk. Su administrador añade el ID de cliente de Stoïk `C01isw1kw` a los valores permitidos, en `IAM y administración` > `Políticas de la organización`. Esto requiere el rol de `Administrador de políticas de la organización` a nivel de la organización: ser Propietario del proyecto no es suficiente.

</details>

<details>

<summary>"La integración con GCP falló" / getAccessToken denegado</summary>

Dos causas habituales:

* La API de Cloud Resource Manager no está habilitada, o se habilitó hace solo unos minutos.
* `stoik-scanner@stoik-gcp-scan-prod.iam.gserviceaccount.com` no obtuvo el `Creador de tokens de cuenta de servicio` rol en su cuenta de servicio.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.stoik.io/help/help-center-en-es/herramientas-de-prevencion/cloud-scan/gcp.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.