​

Google Cloud — Discovery

​

Was SecureAI importiert

• Vertex AI: Agenten (Agent Engine), Serving-Endpunkte, laufende Batch- und Tuning-Jobs sowie Modelle – die Model Registry plus jedes verwendete Publisher-Modell (Gemini, Claude, offene Modelle).
• Agent Builder / Gemini Enterprise und Dialogflow CX (optional): Engines von Agent Builder (Discovery Engine) mit ihren Datenspeichern, abgefragt an den Standorten global, us und eu; sowie Dialogflow CX-Agenten, abgefragt in global und an den Vertex AI-Standorten, die Sie konfigurieren.
• Nutzung pro Modell der letzten 30 Tage: Anfragen (und wie viele davon fehlgeschlagen sind), Eingabe- und Ausgabe-Token sowie Prompt-Cache-Token.
• Nutzung pro Anmeldeinformation der letzten 30 Tage (Cloud Monitoring): Anfragen insgesamt und Anfragen an KI-APIs (Vertex AI, Gemini API, Agent Builder, Dialogflow) für jedes Dienstkonto und jeden API-Schlüssel. Der Verkehr von OAuth-Clients (Personen und Tools wie die Console oder gcloud) wird separat summiert. Außerdem liefert sie die letzte Nutzung dieser Konten und Schlüssel.
• Nutzung nach Modell und Identität (optional): welches Dienstkonto oder welche Person welches Vertex AI-Modell aufgerufen hat, entnommen aus den Audit-Protokollen zum Datenzugriff (Data Access), sofern Sie diese aktiviert haben. Siehe Nutzung nach Modell und Identität.
• Vertex AI außerhalb von SecureAI genutzt: Identitäten, die Vertex AI oder Gemini direkt aufgerufen haben, ohne die Inferenzverbindung von SecureAI. Siehe Vertex AI außerhalb von SecureAI genutzt.
• Kosten der letzten 30 Tage: die tatsächlichen KI-Ausgaben dieses Projekts aus Ihrem BigQuery-Abrechnungsexport oder eine Schätzung zum Listenpreis.
• NHIs: Dienstkonten, vom Nutzer verwaltete Dienstkontoschlüssel, API-Schlüssel, Pools und Anbieter der Workload Identity Federation sowie OAuth-Clients – mit ihrer letzten Nutzung (aus Policy Analyzer und aus der Nutzung pro Anmeldeinformation) und ihrem Privilegienrisiko. Widerrufbar und wiederherstellbar über das NHI-Inventar, manuell oder mit automatischen Richtlinien.
• IAM-Rollenbindungen des Projekts.
• Cloud-Audit-Protokolle der KI- und Identitätsdienste (Vertex AI, IAM, IAM Credentials, STS, API Keys, Resource Manager): die letzten 200 Ereignisse der vergangenen 30 Tage.

​

Voraussetzungen

​

Aktivierte APIs

​

Rollen

​

Anmeldeinformationen

​

Wo man sie bekommt

1. Gehen Sie in der Google Cloud Console zu IAM & Verwaltung → Dienstkonten → Dienstkonto erstellen (z. B. secureai-discovery).
2. Gehen Sie zu IAM & Verwaltung → IAM → Zugriff gewähren, geben Sie die E-Mail-Adresse des Dienstkontos als Hauptkonto ein und fügen Sie die Rollen aus Voraussetzungen hinzu.
3. Öffnen Sie wieder unter Dienstkonten das Konto → Schlüssel → Schlüssel hinzufügen → Neuen Schlüssel erstellen → JSON und laden Sie die Datei herunter.
4. Fügen Sie das gesamte JSON in Service Account JSON ein und löschen Sie anschließend die heruntergeladene Datei.

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
# Optional: letzte Nutzung, Nutzung nach Modell und Identität, Agent Builder und 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. Erstellen Sie das Dienstkonto und gewähren Sie ihm die Rollen (Schritte 1 und 2 oben).
2. Im Verbindungsformular von SecureAI nennt der Hilfetext des Felds Service account to impersonate (keyless — instead of the JSON) das SecureAI-Konto, das Sie autorisieren müssen. Öffnen Sie in Google Cloud Ihr Dienstkonto → Berechtigungen → Zugriff gewähren, geben Sie dieses Konto als Hauptkonto ein und weisen Sie ihm roles/iam.serviceAccountTokenCreator zu. Mit gcloud:
   gcloud iam service-accounts add-iam-policy-binding $SA \
     --member=serviceAccount:SECUREAI_ACCOUNT --role=roles/iam.serviceAccountTokenCreator
   
3. Geben Sie die E-Mail-Adresse Ihres Dienstkontos in das Feld ein und lassen Sie das JSON leer.

​

Separates Dienstkonto für den Widerruf

1. Erstellen Sie ein zweites Dienstkonto (z. B. secureai-revoke) und gewähren Sie ihm nur die Widerrufsrollen aus Voraussetzungen.
2. Gewähren Sie für dieses Konto roles/iam.serviceAccountTokenCreator dem SecureAI-Konto, das im Hilfetext des Felds Service account for revocation (optional — separate from reading) genannt wird.
3. Geben Sie seine E-Mail-Adresse in dieses Feld ein.

​

Modus Organisation oder Ordner

• SecureAI findet die aktiven Projekte mit Cloud Asset Inventory und liest jedes so, als wäre es ein Connector für ein einzelnes Projekt. Die Google Cloud Project ID bleibt das Kontingent- und Abrechnungsprojekt.
• Gewähren Sie dem Dienstkonto für die Organisation oder den Ordner: roles/cloudasset.viewer, roles/iam.securityReviewer und roles/aiplatform.viewer, dazu roles/monitoring.viewer und roles/logging.viewer für Nutzung und Audit.
• Aktivieren Sie cloudasset.googleapis.com für das Projekt des Dienstkontos.

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

​

Verbinden

1. Admin → Integrations → Cloud → Google Cloud — Erkennung → Integration verbinden.
2. Geben Sie die Projekt-ID, den Standort (oder mehrere unter More Vertex AI Locations) und entweder den JSON-Schlüssel oder das Dienstkonto für den Identitätswechsel ein. Wenn Sie sie verwenden, fügen Sie das Dienstkonto für den Widerruf, die Organisation oder den Ordner sowie die Abrechnungsfelder hinzu.
3. Klicken Sie auf Verbinden. SecureAI prüft die Anmeldeinformationen vor dem Speichern mit einem echten Lesezugriff auf das Projekt – das dauert einige Sekunden. Kann es das Projekt nicht lesen, zeigt es den Grund an und speichert nichts; Ihre Eingaben bleiben im Formular erhalten. Die möglichen Meldungen finden Sie unter Fehlerbehebung.
4. Wenn gespeichert wird, aber Rollen fehlen, listet eine Warnung sie auf. Gewähren Sie sie und synchronisieren Sie erneut.
5. Synchronisieren Sie jetzt mit der Aktualisieren-Schaltfläche auf der Karte. Danach synchronisiert SecureAI automatisch alle 6 Stunden.

​

Überprüfen

• Cloud Sensors listet die erkannten Agenten auf. Klicken Sie auf die Google Cloud-Karte, um das GCP-Panel zu öffnen: Nutzung und Kosten (Anfragen, Fehler, Token, Cache, Kosten und deren Quelle), Modelle und Bereitstellungen, Identität und Zugriff (Dienstkonten und Schlüssel mit ihrer letzten Nutzung, IAM-Bindungen) sowie Audit.
• Wenn das Panel Discovery could not read everything anzeigt, prüfen Sie jede Zeile (siehe Fehlerbehebung) und synchronisieren Sie erneut.
• Das NHI-Inventar zeigt die Dienstkonten und Schlüssel.

​

Nutzung nach Modell und Identität

• SecureAI liest sie nur, wenn Protokolle vom Typ DATA_READ oder DATA_WRITE für aiplatform.googleapis.com (oder für alle Dienste) aktiviert sind. SecureAI erkennt das in der IAM-Richtlinie; es aktiviert sie niemals selbst.
• Ihre Aktivierung verursacht Aufnahmekosten in Cloud Logging zu den Preisen von Google. Sie aktivieren sie unter IAM & Verwaltung → Audit-Logs → Vertex AI API → Datenlesevorgang.
• Das Dienstkonto benötigt roles/logging.privateLogViewer.
• Pro Projekt und Synchronisierung liest SecureAI bis zu 5.000 Einträge oder 20 Sekunden lang, je nachdem, was zuerst eintritt.
• Sind sie deaktiviert, zeigt das Panel eine optionale Lücke mit einer Erklärung, wie man sie aktiviert. Wenn Sie sie auf Organisations- oder Ordnerebene aktiviert haben, aber ein einzelnes Projekt verbinden, kann SecureAI das nicht anhand der Richtlinie des Projekts erkennen und zeigt die Lücke trotzdem an.

​

Privilegienrisiko

• Inhaber (roles/owner) oder Bearbeiter (roles/editor);
• eine beliebige Administratorrolle (roles/<service>.admin oder endend auf Admin);
• roles/iam.serviceAccountTokenCreator oder roles/iam.serviceAccountUser, mit denen der Inhaber als andere Dienstkonten handeln kann.

​

Vertex AI außerhalb von SecureAI genutzt

• Mit aktivierten Audit-Protokollen zum Datenzugriff (Data Access) (siehe Nutzung nach Modell und Identität) nennt jede Zeile, welche Modelle wie oft aufgerufen wurden, und es werden nur Inferenzaufrufe gezählt.
• Ohne sie stammt die Zahl aus Cloud Monitoring pro Anmeldeinformation (Dienstkonto oder API-Schlüssel) und umfasst jeden Aufruf einer KI-API (Vertex AI, Gemini API, Agent Builder, Dialogflow), nicht nur Inferenz.
• Das Dienstkonto der Inferenzverbindung und das des Konnektors werden nie gezählt. Personen werden nicht einzeln aufgeführt: Ihre Aufrufe stehen in einer einzigen zusammengefassten Zeile (People (Google accounts) oder People and tools (OAuth): Console, gcloud, Apps).
• Konnte SecureAI die Inferenzverbindung bei dieser Synchronisierung nicht lesen, klassifiziert es nichts, meldet dies als optionale Lücke und behält das Ergebnis der vorherigen Synchronisierung.
• Daraus entsteht die Insights-Feststellung Google Vertex AI / Gemini is being used outside SecureAI: mittel, und kritisch, wenn der Aufrufer ein API-Schlüssel ist (eine langlebige Anmeldeinformation). Sie ist OWASP LLM02, ISO/IEC 42001 A.4.2 und A.6.2.6 sowie NIST AI RMF MAP-1.1 und GOVERN-6.1 zugeordnet.

​

Kosten

• Mit der Tabelle des Abrechnungsexports: die tatsächlichen Ausgaben dieses Projekts für KI-Dienste (Vertex AI, Gemini API, Agent Builder, Dialogflow, …), abzüglich Gutschriften, in der Währung Ihres Rechnungskontos. Wenn Gutschriften die Nutzung abdecken, kann der Nettobetrag null sein; das Panel zeigt dann daneben den Betrag vor Gutschriften an. Google aktualisiert den Export mit einer Verzögerung von mehreren Stunden.
• Ohne: eine Schätzung – Token aus Cloud Monitoring × Listenpreis, einschließlich Claude und Prompt-Cache-Token. Rabatte oder Verträge mit zugesicherter Nutzung werden nicht berücksichtigt.

​

Widerruf und Wiederherstellung

• Wiederhergestellt werden kann nur, was SecureAI in Google Cloud widerrufen hat, manuell oder über eine automatische Richtlinie. Für eine Sperre nur am Gateway von SecureAI wird es nicht angeboten, ebenso wenig für eine Identität, die Ihr Team direkt in Google Cloud deaktiviert hat.
• Ein gelöschter Dienstkontoschlüssel kann nicht wiederhergestellt werden: SecureAI lehnt dies ab, ohne Google aufzurufen.
• Die Wiederherstellung verwendet dieselben Rollen wie der Widerruf.

• Das Dienstkonto, das der Connector verwendet, und seine Schlüssel können nicht über SecureAI widerrufen werden – das würde die Erkennung unterbrechen. Dasselbe gilt für das Dienstkonto für den Widerruf. Rotieren Sie sie in Google Cloud.
• Ebenso wenig kann das Dienstkonto widerrufen werden, mit dem sich die Verbindung für Vertex AI-Inferenz authentifiziert, oder der Schlüssel, mit dem sie signiert: Das würde jeden gesteuerten Aufruf stoppen. Bei der schlüssellosen Option (Identitätswechsel) ist nur das Dienstkonto geschützt: Seine Schlüssel können weiterhin widerrufen werden, da SecureAI mit keinem davon signiert. Kann SecureAI nicht prüfen, welche Identität die Inferenzverbindung verwendet, widerruft es kein Dienstkonto und keinen Dienstkontoschlüssel (API-Schlüssel sind davon nicht betroffen).
• Die Standarddienstkonten von Google (Compute Engine-Standarddienstkonto, App Engine, Cloud Build, Dienst-Agents) verlangen eine zweite Bestätigung: Wird eines davon deaktiviert, stoppt jede VM, App oder jeder Build, die bzw. der unter diesem Konto läuft.
• Fehlt dem Connector die Rolle für eine Aktion, nennt die Fehlermeldung diese Rolle.

​

Automatische NHI-Richtlinien

• Simulation mode (dryRun) ist standardmäßig aktiviert: Damit trennt keine auf Revoke gesetzte Regel etwas; sie listet nur auf, was sie tun würde. Erst das Ausschalten ermöglicht echte Trennungen. Simulate with this configuration zeigt die Auswirkung, bevor Sie speichern.
• Revocation cap per run: standardmäßig 5 (1 bis 50). Wenn die Revoke-Regeln in einem Durchlauf auf mehr Identitäten zutreffen als die Obergrenze, wird nichts getrennt und ein Alarm gesendet.
• Exclusions: Keine Regel greift bei einer Identität, deren Inhaber, Name oder Ressource einem Muster entspricht; * ist der einzige Platzhalter.
• Ausgewertet werden nur vollständige Schlüssellisten.
• Eine Anmeldeinformation, die SecureAI verwendet (die des Connectors, des Widerrufskontos oder der Vertex AI-Inferenz), wird nie getrennt. Schlüssel der Standarddienstkonten von Google werden nie automatisch getrennt: Die Regel alarmiert nur, und ein Mensch entscheidet.

​

Fehlerbehebung

​

Beim Verbinden

​

Lücken im Panel

​

Verwandte

• Google Vertex AI — Inferenz in Ihrem Konto
• Übersicht Cloud-KI-Anbieter
• Google Workspace SSO
• NHI-Inventar