​

Google Cloud — Discovery

​

Ce que SecureAI importe

• Vertex AI : agents (Agent Engine), points de terminaison de serving, jobs de batch et de tuning en cours, et modèles — le Model Registry ainsi que chaque modèle d’éditeur utilisé (Gemini, Claude, modèles ouverts).
• Agent Builder / Gemini Enterprise et Dialogflow CX (facultatif) : les moteurs Agent Builder (Discovery Engine) avec leurs data stores, interrogés dans les emplacements global, us et eu ; et les agents Dialogflow CX, interrogés dans global et dans les emplacements Vertex AI que vous configurez.
• Utilisation par modèle sur les 30 derniers jours : requêtes (et combien ont échoué), jetons d’entrée et de sortie, et jetons du cache de prompts.
• Utilisation par identifiant sur les 30 derniers jours (Cloud Monitoring) : total des requêtes et requêtes vers les API d’IA (Vertex AI, Gemini API, Agent Builder, Dialogflow) pour chaque compte de service et chaque clé API. Le trafic des clients OAuth (personnes et outils comme la console ou gcloud) est totalisé à part. Elle fournit aussi la dernière utilisation de ces comptes et de ces clés.
• Utilisation par modèle et par identité (facultatif) : quel compte de service ou quelle personne a appelé quel modèle Vertex AI, d’après les journaux d’audit d’accès aux données (Data Access) si vous les avez activés. Voir Utilisation par modèle et par identité.
• Vertex AI utilisé en dehors de SecureAI : les identités qui ont appelé Vertex AI ou Gemini directement, sans passer par la connexion d’inférence de SecureAI. Voir Vertex AI utilisé en dehors de SecureAI.
• Coût sur les 30 derniers jours : les dépenses réelles de ce projet en IA, issues de votre exportation de la facturation vers BigQuery, ou une estimation au prix catalogue.
• NHI : comptes de service, clés de compte de service gérées par l’utilisateur, clés API, pools et fournisseurs de Workload Identity Federation, et clients OAuth — avec leur dernière utilisation (d’après Policy Analyzer et l’utilisation par identifiant) et leur risque de privilège. Révocables et restaurables depuis l’Inventaire des NHI, à la main ou avec des politiques automatiques.
• Liaisons de rôles IAM du projet.
• Journaux d’audit cloud des services d’IA et d’identité (Vertex AI, IAM, IAM Credentials, STS, API Keys, Resource Manager) : les 200 derniers événements des 30 derniers jours.

​

Prérequis

​

API activées

​

Rôles

​

Identifiants

​

Où les trouver

1. Dans la Console Google Cloud, accédez à IAM et administration → Comptes de service → Créer un compte de service (par exemple secureai-discovery).
2. Accédez à IAM et administration → IAM → Accorder l’accès, saisissez l’adresse e-mail du compte de service comme compte principal et ajoutez les rôles indiqués dans Prérequis.
3. De retour dans Comptes de service, ouvrez le compte → Clés → Ajouter une clé → Créer une clé → JSON, puis téléchargez le fichier.
4. Collez l’intégralité du JSON dans Service Account JSON, puis supprimez le fichier téléchargé.

PROJECT=my-project-123
gcloud services enable cloudresourcemanager.googleapis.com iam.googleapis.com aiplatform.googleapis.com \
  apikeys.googleapis.com monitoring.googleapis.com logging.googleapis.com policyanalyzer.googleapis.com \
  --project=$PROJECT
gcloud iam service-accounts create secureai-discovery --project=$PROJECT --display-name="SecureAI discovery"
SA=secureai-discovery@$PROJECT.iam.gserviceaccount.com
for ROLE in roles/aiplatform.viewer roles/iam.securityReviewer roles/monitoring.viewer roles/logging.viewer; do
  gcloud projects add-iam-policy-binding $PROJECT --member=serviceAccount:$SA --role=$ROLE --condition=None
done
# Facultatif : dernière utilisation, utilisation par modèle et par identité, Agent Builder et Dialogflow CX
for ROLE in roles/policyanalyzer.activityAnalysisViewer roles/logging.privateLogViewer roles/discoveryengine.viewer roles/dialogflow.reader; do
  gcloud projects add-iam-policy-binding $PROJECT --member=serviceAccount:$SA --role=$ROLE --condition=None
done
gcloud iam service-accounts keys create secureai-discovery.json --iam-account=$SA

1. Créez le compte de service et accordez-lui les rôles (étapes 1 et 2 ci-dessus).
2. Dans le formulaire de connexion de SecureAI, le texte d’aide du champ Service account to impersonate (keyless — instead of the JSON) indique le compte SecureAI à autoriser. Dans Google Cloud, ouvrez votre compte de service → Autorisations → Accorder l’accès, saisissez ce compte comme compte principal et attribuez-lui roles/iam.serviceAccountTokenCreator. Avec gcloud :
   gcloud iam service-accounts add-iam-policy-binding $SA \
     --member=serviceAccount:SECUREAI_ACCOUNT --role=roles/iam.serviceAccountTokenCreator
   
3. Saisissez l’adresse e-mail de votre compte de service dans le champ et laissez le JSON vide.

​

Compte de service distinct pour la révocation

1. Créez un second compte de service (par exemple secureai-revoke) et accordez-lui uniquement les rôles de révocation indiqués dans Prérequis.
2. Sur ce compte, accordez roles/iam.serviceAccountTokenCreator au compte SecureAI indiqué dans le texte d’aide du champ Service account for revocation (optional — separate from reading).
3. Saisissez son adresse e-mail dans ce champ.

​

Mode organisation ou dossier

• SecureAI trouve les projets actifs avec Cloud Asset Inventory et lit chacun d’eux comme s’il s’agissait d’un connecteur à projet unique. Le Google Cloud Project ID reste le projet de quota et de facturation.
• Accordez au compte de service, sur l’organisation ou le dossier : roles/cloudasset.viewer, roles/iam.securityReviewer et roles/aiplatform.viewer, plus roles/monitoring.viewer et roles/logging.viewer pour l’utilisation et l’audit.
• Activez cloudasset.googleapis.com sur le projet du compte de service.

ORG=123456789012
for ROLE in roles/cloudasset.viewer roles/iam.securityReviewer roles/aiplatform.viewer roles/monitoring.viewer roles/logging.viewer; do
  gcloud organizations add-iam-policy-binding $ORG --member=serviceAccount:$SA --role=$ROLE --condition=None
done
gcloud services enable cloudasset.googleapis.com --project=$PROJECT

​

Se connecter

1. Admin → Integrations → Cloud → Google Cloud — Découverte → Connecter l’Intégration.
2. Saisissez l’ID du projet, l’emplacement (ou plusieurs dans More Vertex AI Locations) et soit la clé JSON, soit le compte de service dont emprunter l’identité. Si vous les utilisez, ajoutez le compte de service de révocation, l’organisation ou le dossier, et les champs de facturation.
3. Cliquez sur Connecter. Avant d’enregistrer, SecureAI vérifie les identifiants par une lecture réelle du projet — cela prend quelques secondes. S’il ne peut pas lire le projet, il en indique la raison et n’enregistre rien ; ce que vous avez saisi reste dans le formulaire. Les messages possibles figurent dans Dépannage.
4. Si l’enregistrement réussit mais que des rôles manquent, un avertissement les liste. Accordez-les et synchronisez à nouveau.
5. Synchronisez maintenant avec le bouton d’actualisation de la carte. Ensuite, SecureAI synchronise automatiquement toutes les 6 heures.

​

Vérifier

• Cloud Sensors liste les agents découverts. Cliquez sur la carte Google Cloud pour ouvrir le panneau GCP : utilisation et coûts (requêtes, échecs, jetons, cache, coût et sa source), modèles et déploiements, identité et accès (comptes de service et clés avec leur dernière utilisation, liaisons IAM), et audit.
• Si le panneau affiche Discovery could not read everything, examinez chaque ligne (voir Dépannage) et synchronisez à nouveau.
• L’Inventaire des NHI affiche les comptes de service et les clés.

​

Utilisation par modèle et par identité

• SecureAI ne les lit que si les journaux DATA_READ ou DATA_WRITE sont activés pour aiplatform.googleapis.com (ou pour tous les services). SecureAI le détecte dans la stratégie IAM ; il ne les active jamais.
• Les activer entraîne un coût d’ingestion Cloud Logging, aux tarifs de Google. Vous les activez dans IAM et administration → Journaux d’audit → Vertex AI API → Lecture des données.
• Le compte de service a besoin de roles/logging.privateLogViewer.
• Par projet et par synchronisation, SecureAI lit jusqu’à 5 000 entrées ou pendant 20 secondes, selon la première limite atteinte.
• S’ils sont désactivés, le panneau affiche une lacune facultative qui explique comment les activer. Si vous les avez activés au niveau de l’organisation ou du dossier mais que vous connectez un seul projet, SecureAI ne peut pas le voir dans la stratégie du projet et affiche quand même la lacune.

​

Risque de privilège

• Propriétaire (roles/owner) ou Éditeur (roles/editor) ;
• tout rôle d’administration (roles/<service>.admin ou se terminant par Admin) ;
• roles/iam.serviceAccountTokenCreator ou roles/iam.serviceAccountUser, qui permettent à leur détenteur d’agir en tant qu’autres comptes de service.

​

Vertex AI utilisé en dehors de SecureAI

• Avec les journaux d’audit d’accès aux données (Data Access) activés (voir Utilisation par modèle et par identité), chaque ligne indique quels modèles ont été appelés et combien de fois, et seuls les appels d’inférence sont comptés.
• Sans eux, le nombre provient de Cloud Monitoring par identifiant (compte de service ou clé API) et inclut tout appel à une API d’IA (Vertex AI, Gemini API, Agent Builder, Dialogflow), pas seulement l’inférence.
• Le compte de service de la connexion d’inférence et celui du connecteur ne sont jamais comptés. Les personnes ne sont pas listées une par une : leurs appels sont regroupés sur une seule ligne (People (Google accounts), ou People and tools (OAuth) : console, gcloud, applications).
• Si SecureAI n’a pas pu lire la connexion d’inférence lors de cette synchronisation, il ne classe rien, le signale comme lacune facultative et conserve le résultat de la synchronisation précédente.
• Cela génère le constat Insights Google Vertex AI / Gemini is being used outside SecureAI : modéré, et critique si l’appelant est une clé API (un identifiant de longue durée). Il est associé à OWASP LLM02, ISO/IEC 42001 A.4.2 et A.6.2.6, et NIST AI RMF MAP-1.1 et GOVERN-6.1.

​

Coût

• Avec la table d’exportation de la facturation : les dépenses réelles de ce projet en services d’IA (Vertex AI, Gemini API, Agent Builder, Dialogflow, …), déduction faite des crédits, dans la devise de votre compte de facturation. Lorsque des crédits couvrent l’utilisation, le montant net peut être nul ; le panneau affiche alors à côté le montant avant crédits. Google met à jour l’exportation avec un délai de plusieurs heures.
• Sans elle : une estimation — jetons de Cloud Monitoring × prix catalogue, y compris Claude et les jetons du cache de prompts. Elle ne reflète ni les remises ni les contrats d’engagement d’utilisation.

​

Révocation et restauration

• Seul ce que SecureAI a révoqué dans Google Cloud peut être restauré, à la main ou par une politique automatique. Ce n’est pas proposé pour un blocage appliqué uniquement sur la passerelle de SecureAI, ni pour une identité que votre équipe a désactivée directement dans Google Cloud.
• Une clé de compte de service supprimée ne peut pas être restaurée : SecureAI refuse sans appeler Google.
• La restauration utilise les mêmes rôles que la révocation.

• Le compte de service utilisé par le connecteur, ainsi que ses clés, ne peuvent pas être révoqués depuis SecureAI — cela couperait la découverte. Il en va de même pour le compte de service de révocation. Effectuez leur rotation dans Google Cloud.
• Le compte de service avec lequel s’authentifie la connexion d’inférence Vertex AI, ni la clé avec laquelle elle signe, ne peuvent pas non plus être révoqués : cela arrêterait chaque appel gouverné. Avec l’option sans clé (emprunt d’identité), seul le compte de service est protégé : ses clés peuvent être révoquées, car SecureAI ne signe avec aucune d’elles. Si SecureAI ne peut pas vérifier quelle identité utilise la connexion d’inférence, il ne révoque aucun compte de service ni aucune clé de compte de service (les clés API ne sont pas concernées).
• Les comptes de service par défaut de Google (compte par défaut de Compute Engine, App Engine, Cloud Build, agents de service) demandent une seconde confirmation : en désactiver un arrête chaque VM, application ou build qui s’exécute sous son identité.
• S’il manque au connecteur le rôle d’une action, l’erreur indique ce rôle.

​

Politiques NHI automatiques

• Simulation mode (dryRun) est activé par défaut : avec lui, aucune règle réglée sur Revoke ne coupe quoi que ce soit ; elle liste seulement ce qu’elle ferait. Le désactiver est la seule chose qui permet des coupures réelles. Simulate with this configuration montre l’effet avant d’enregistrer.
• Revocation cap per run : 5 par défaut (de 1 à 50). Si, lors d’une exécution, les règles Revoke correspondent à plus d’identités que le plafond, rien n’est coupé et une alerte est envoyée.
• Exclusions : aucune règle n’agit sur une identité dont le propriétaire, le nom ou la ressource correspond à un motif ; * est le seul caractère générique.
• Seules les listes de clés complètes sont évaluées.
• Un identifiant utilisé par SecureAI (celui du connecteur, celui du compte de révocation ou celui de l’inférence Vertex AI) n’est jamais coupé. Les clés des comptes de service par défaut de Google ne sont jamais coupées automatiquement : la règle se contente d’alerter, et une personne décide.

​

Dépannage

​

Lors de la connexion

​

Lacunes du panneau

​

Connexes

• Google Vertex AI — Inférence sur votre compte
• Présentation des fournisseurs Cloud AI
• Google Workspace SSO
• Inventaire des NHI