> 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-fr/outils-de-prevention/cloud-scan/gcp.md).

# Configuration : GCP

Donnez au scan cloud un accès en lecture seule à un projet Google Cloud en créant un compte de service que Stoïk pourra utiliser.

## Prérequis

* Un compte administrateur est requis pour effectuer ce déploiement.
* Un conseiller technique est requis pour la supervision continue et la remédiation des vulnérabilités.
* Une seule personne effectue toute la configuration, du début à la fin : un utilisateur de Stoïk Protect autorisé à modifier les outils de prévention, qui est aussi administrateur du projet GCP.

## Configuration

{% stepper %}
{% step %}

### Sélectionnez Google Cloud Platform

Accédez à `Scan Cloud` > `Paramètres`, cliquez sur `Nouveau fournisseur`, puis sélectionnez `Google Cloud Platform`.

<figure><img src="https://1428753877-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 %}

### Ouvrez votre Console Cloud

Allez sur le [Console Google Cloud](https://console.cloud.google.com/) et connectez-vous avec votre compte administrateur.

<figure><img src="https://1428753877-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 %}

### Ouvrez la bibliothèque d’API

Accédez à `API et services` > `Bibliothèque` dans le menu de gauche.

<figure><img src="https://1428753877-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 %}

### Trouvez l’API Cloud Resource Manager

Recherchez `API Cloud Resource Manager` et cliquez dessus.

<figure><img src="https://1428753877-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 %}

### Activez l’API

Cliquez sur `Activer`.

<figure><img src="https://1428753877-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 %}

### Ouvrez les comptes de service

Accédez à `IAM et administration` > `Comptes de service` dans le menu de gauche.

<figure><img src="https://1428753877-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 %}

### Créez le compte de service

Cliquez sur `Créer un compte de service`.

<figure><img src="https://1428753877-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 %}

### Nommez le compte de service

Saisissez `stoik-scanner` comme nom du compte de service, puis cliquez sur `Créer et continuer`.

<figure><img src="https://1428753877-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 %}

### Attribuer des rôles

Ajoutez les 3 rôles suivants : `Lecteur`, `Examinateur de sécurité`, `Lecteur des comptes Stackdriver`.

<figure><img src="https://1428753877-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>

Laissez l’étape 3 vide et cliquez sur `Terminer`.
{% endstep %}

{% step %}

### Ouvrez le compte de service

Cliquez sur le compte de service que vous venez de créer, puis cliquez sur `Principaux ayant accès`.

<figure><img src="https://1428753877-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://1428753877-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 %}

### Accorder l’accès

1. Sélectionnez votre compte de service et cliquez sur `Accorder l’accès`.
2. Saisissez `stoik-scanner@stoik-gcp-scan-prod.iam.gserviceaccount.com` dans le champ `Nouveaux principaux` .
3. Attribuez le rôle `Créateur de jetons de compte de service` puis cliquez sur `Enregistrer`.

<figure><img src="https://1428753877-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 %}

### Copiez l’adresse e-mail du compte de service

1. Cliquez sur `Détails` dans GCP.
2. Copiez l’adresse e-mail du compte de service créé.

<figure><img src="https://1428753877-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 %}

### Terminer la configuration

<figure><img src="https://1428753877-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. Collez l’adresse e-mail du compte de service dans le champ `Adresse e-mail du compte de service` dans Stoïk Protect.
2. Cliquez sur `Terminer la configuration`.

{% hint style="info" %}
Actualisez la page Stoïk Protect si nécessaire.
{% endhint %}
{% endstep %}
{% endstepper %}

## Projets à analyser

Configurez les projets qui contiennent vos serveurs et bases de données : un projet créé uniquement pour Stoïk est vide, il n’y a donc rien à analyser. L’API doit être activée un projet à la fois.

## Dépannage

<details>

<summary>La configuration a échoué, puis a fonctionné lorsque j’ai réessayé</summary>

Les nouveaux rôles, autorisations et API mettent quelques minutes à s’appliquer. Attendez 5 minutes et cliquez à nouveau.

</details>

<details>

<summary>« role/stackdriver.accounts.viewer doit être attribué »</summary>

`Lecteur Stackdriver` et `Lecteur des comptes Stackdriver` sont deux rôles différents. Le compte de service a besoin exactement de `Lecteur`, `Examinateur de sécurité` et `Lecteur des comptes Stackdriver`.

</details>

<details>

<summary>« n’appartiennent pas à un client autorisé »</summary>

Votre stratégie d’organisation **Partage restreint par domaine** (`iam.allowedPolicyMemberDomains`) bloque le compte de service Stoïk. Votre administrateur ajoute l’ID client de Stoïk `C01isw1kw` aux valeurs autorisées, dans `IAM et administration` > `Stratégies d’organisation`. Cela nécessite le rôle `Administrateur des stratégies d’organisation` au niveau de l’organisation : être propriétaire du projet ne suffit pas.

</details>

<details>

<summary>« L’intégration avec GCP a échoué » / getAccessToken refusé</summary>

Deux causes habituelles :

* L’API Cloud Resource Manager n’est pas activée, ou ne l’a été que depuis quelques minutes.
* `stoik-scanner@stoik-gcp-scan-prod.iam.gserviceaccount.com` n’a pas obtenu le `Créateur de jetons de compte de service` rôle sur votre compte de service.

</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-fr/outils-de-prevention/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.