Wiz in Google SecOps einbinden

In diesem Dokument wird beschrieben, wie Sie Wiz in Google Security Operations (Google SecOps) einbinden.

Hinweis

Für die Verwendung der Integration benötigen Sie einen API-Root, eine Client-ID und einen Clientschlüssel.

Weitere Informationen zum Generieren dieser Anmeldedaten finden Sie unter Einstellungen für Dienstkonten.

Erforderliche Dienstkontoberechtigungen und ‑bereiche

Achten Sie darauf, dass Ihrem Wiz-Dienstkonto die entsprechenden API-Berechtigungsbereiche für die Vorgänge gewährt werden, die Sie in Google SecOps ausführen möchten.

Lese- und Abfragevorgänge

Vorgang / Zweck Verwendet von Erforderliche Berechtigungen / Bereiche
Konnektivität testen Aktion „Pingen“ read:issues
Problemdetails abrufen Aktion zum Abrufen von Problemdetails read:issues
read:posture_issues
read:threat_issues
read:comments
Ergebnisse zu Sicherheitslücken für Ressourcen auflisten Aktion zum Auflisten von Ergebnissen zu Sicherheitslücken in Ressourcen read:vulnerabilities
Blue Agent-Analyse abrufen Aktion „Blue Agent Analysis“ abrufen read:threat_issues

Schreib- und Änderungsoperationen (Mutationen)

Vorgang / Zweck Verwendet von Erforderliche Berechtigungen / Bereiche
Problem reaktivieren Aktion zum Wiedereröffnen von Problemen write:issue_status
update:posture_issue_status
write:threat_issue_status
Problem beheben Aktion zum Beheben des Problems write:threat_issue_status
write:threat_issues
Problem ignorieren Aktion „Problem ignorieren“ update:posture_issue_ignore
write:issue_ignore
Kommentar zum Problem hinzufügen Aktion „Kommentar zum Problem hinzufügen“ write:issue_comments
write:threat_issue_comments
write:comments

Integrationsparameter

Für die Wiz-Integration sind die folgenden Parameter erforderlich:

Parameter Beschreibung
API Root

Erforderlich.

Die GraphQL API-Endpunkt-URL für Ihren Wiz-Mandanten.

Der Endpunkt muss dem Format https://api.<region>.app.wiz.io/graphql (oder https://api.<region>.app.wiz.us/graphql für Wiz for Gov) entsprechen, wobei <region> die zugewiesene Wiz-Rechenzentrumsregion (z. B. us1, us2, eu1 oder eu2) darstellt.

Die genaue Endpunkt-URL finden Sie in den Details Ihres Wiz-Tenants. Verwenden Sie keine generischen, nicht nummerierten regionalen URLs.

Authentication URL

Optional.

Die Authentifizierungs-URL, die zum Generieren von OAuth-Zugriffstokens verwendet wird. Verwenden Sie für kommerzielle Umgebungen https://auth.app.wiz.io. Verwenden Sie für Wiz for Gov (FedRAMP)-Umgebungen https://auth.app.wiz.us.

Der Standardwert ist https://auth.app.wiz.io.

Client ID

Erforderlich.

Die Client-ID, die mit Ihren Wiz API-Anmeldedaten verknüpft ist.

Client Secret

Erforderlich.

Der Clientschlüssel, der mit Ihren Wiz API-Anmeldedaten verknüpft ist.

Verify SSL

Erforderlich.

Wenn diese Option ausgewählt ist, wird das SSL-Zertifikat bei der Verbindung zum Wiz-Server validiert.

Standardmäßig aktiviert.

Eine Anleitung zum Konfigurieren einer Integration in Google SecOps finden Sie unter Integrationen konfigurieren.

Bei Bedarf können Sie später Änderungen vornehmen. Nachdem Sie eine Integrationsinstanz konfiguriert haben, können Sie sie in Playbooks verwenden. Weitere Informationen zum Konfigurieren und Unterstützen mehrerer Instanzen finden Sie unter Mehrere Instanzen unterstützen.

Aktionen

Weitere Informationen zu Aktionen finden Sie unter Ausstehende Aktionen über „Mein Arbeitsbereich“ bearbeiten und Manuelle Maßnahme ausführen.

Ping

Verwenden Sie die Aktion Ping, um die Verbindung zu Wiz zu testen.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Keine.

Aktionsausgaben

Die Aktion Ping bietet die folgenden Ausgaben:

Ausgabetyp der Aktion Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle „Fall-Repository“ Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Nicht verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis. Verfügbar
Ausgabenachrichten

Die Aktion Ping kann die folgenden Ausgabenachrichten zurückgeben:

Ausgabemeldung Nachrichtenbeschreibung

Successfully connected to the Wiz server with the provided connection parameters!

Die Aktion wurde erfolgreich ausgeführt.
Failed to connect to the Wiz server! Error is ERROR_REASON

Die Aktion ist fehlgeschlagen.

Überprüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses bei Verwendung der Aktion Ping aufgeführt:

Name des Scriptergebnisses Wert
is_success True oder False

Problemdetails abrufen

Mit der Aktion Get Issue Details (Problemdetails abrufen) können Sie Informationen zu einem bestimmten Problem in Wiz abrufen.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion Get Issue Details sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Issue ID

Erforderlich.

Die eindeutige Kennung des Wiz-Problems, das abgerufen oder für das eine Aktion ausgeführt werden soll.

Aktionsausgaben

Die Aktion Get Issue Details (Problemdetails abrufen) gibt die folgenden Ausgaben zurück:

Ausgabetyp der Aktion Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle „Fall-Repository“ Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
JSON-Ergebnis

Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion Get Issue Details (Problemdetails abrufen) empfangen wird:

{
   "id": "f54e3fb9-a520-4e99-aacc-b99f6ae7f28d",
   "createdAt": "2025-07-26T11:47:43.94524Z",
   "updatedAt": "2025-07-31T07:34:54.445702Z",
   "status": "RESOLVED",
   "severity": "CRITICAL",
   "type": "TOXIC_COMBINATION",
   "description": "This container is using an image that contains a file identified as a high/critical severity malware by ReversingLabs.\n\nMalware can imply a malicious actor's presence in your environment. The malware can be used for crypto-mining, data leakage, lateral movement to other resources in your environment, etc.",
   "resolvedAt": "2025-07-31T07:34:54.445702Z",
   "entitySnapshot": {
       "cloudPlatform": "GCP",
       "id": "1971f945-3476-5b3d-a5a1-ab166c3e2eca",
       "name": "cluster-solr",
       "region": "us-central1",
       "subscriptionName": "Wiz-Labs",
       "type": "KUBERNETES_CLUSTER"
   },
   "projects": [
       {
           "id": "904cbc14-1c52-571c-a6b8-46fee263eb0f",
           "name": "GCP Lab"
       }
   ],
   "sourceRules": [
       {
           "id": "wc-id-1038",
           "name": "Container using an image infected with critical/high severity malware",
           "description": "This container is using an image that contains a file identified as a high/critical severity malware by ReversingLabs.\n\nMalware can imply a malicious actor's presence in your environment. The malware can be used for crypto-mining, data leakage, lateral movement to other resources in your environment, etc."
       }
   ]
}
Ausgabenachrichten

Die Aktion Get Issue Details (Problemdetails abrufen) kann die folgenden Ausgabemeldungen zurückgeben:

Ausgabemeldung Nachrichtenbeschreibung

Successfully returned details for the following issue using information from Wiz: ISSUE_ID

The action wasn't able to return details for the following entities using information from Wiz: ISSUE_ID

Die Aktion wurde erfolgreich ausgeführt.
Error executing action "Get Issue Details". Reason: ERROR_REASON

Die Aktion ist fehlgeschlagen.

Überprüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Get Issue Details (Problemdetails abrufen) verwendet wird:

Name des Scriptergebnisses Wert
is_success True oder False

Problem wieder öffnen

Mit der Aktion Reopen Issue (Problem wieder öffnen) können Sie ein bestimmtes Problem in Wiz wieder öffnen.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion Problem reaktivieren sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Issue ID

Erforderlich.

Die eindeutige Kennung des Problems in Wiz, das abgerufen oder aktualisiert werden soll.

Aktionsausgaben

Die Aktion Reopen Issue (Problem wieder öffnen) bietet die folgenden Ausgaben:

Ausgabetyp der Aktion Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle „Fall-Repository“ Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
JSON-Ergebnis

Das folgende Beispiel zeigt die JSON-Ausgabe, die bei Verwendung der Aktion Problem reaktivieren empfangen wird:

{
    "id": "41facd3f-29b0-4fcf-9a0c-e7fc40416aa0",
    "note": "",
    "status": "OPEN",
    "dueAt": null,
    "resolutionReason": null
}
Ausgabenachrichten

Die Aktion Reopen Issue (Problem wieder öffnen) kann die folgenden Ausgabenachrichten zurückgeben:

Ausgabemeldung Nachrichtenbeschreibung

Successfully reopened issue with ID ISSUE_ID in Wiz.

Die Aktion wurde erfolgreich ausgeführt.
Error executing action "Reopen Issue". Reason: ERROR_REASON

Die Aktion ist fehlgeschlagen.

Überprüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Reopen Issue (Problem wieder öffnen) verwendet wird:

Name des Scriptergebnisses Wert
is_success True oder False

Problem ignorieren

Mit der Aktion Problem ignorieren können Sie ein bestimmtes Problem in Wiz ignorieren.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion Problem ignorieren sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Issue ID

Erforderlich.

Die eindeutige Kennung des Problems in Wiz.

Resolution Reason

Erforderlich.

Der Grund für die Behebung des Problems.

Folgende Werte sind möglich:

  • False Positive
  • Exception
  • Won't Fix~

Der Standardwert ist False Positive.

Resolution Note

Optional.

Eine Anmerkung, die zusätzlichen Kontext für die Lösung des Problems liefert.

Aktionsausgaben

Die Aktion Problem ignorieren gibt Folgendes aus:

Ausgabetyp der Aktion Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle „Fall-Repository“ Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
JSON-Ergebnis

Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion Problem ignorieren empfangen wird:

{
    "id": "41facd3f-29b0-4fcf-9a0c-e7fc40416aa0",
    "note": "",
    "status": "REJECTED",
    "dueAt": null,
    "resolutionReason": "FALSE_POSITIVE"
}
Ausgabenachrichten

Die Aktion Problem ignorieren kann die folgenden Ausgabenachrichten zurückgeben:

Ausgabemeldung Nachrichtenbeschreibung

Successfully ignored issue with ID ISSUE_ID in Wiz.

Die Aktion wurde erfolgreich ausgeführt.
Error executing action "Ignore Issue". Reason: ERROR_REASON

Die Aktion ist fehlgeschlagen.

Überprüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Problem ignorieren verwendet wird:

Name des Scriptergebnisses Wert
is_success True oder False

Problem beheben

Mit der Aktion Problem beheben können Sie ein bestimmtes Problem in Wiz beheben.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion Problem beheben sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Issue ID

Erforderlich.

Die eindeutige Kennung des Problems in Wiz.

Resolution Reason

Erforderlich.

Der Grund für die Behebung des Problems.

Folgende Werte sind möglich:

  • Malicious Threat
  • Not Malicious Threat
  • Security Test Threat
  • Planned Action Threat
  • Inconclusive Threat

Der Standardwert ist Not Malicious Threat.

Resolution Note

Optional.

Eine Anmerkung, die zusätzlichen Kontext zur Lösung bietet.

Aktionsausgaben

Die Aktion Resolve Issue (Problem beheben) gibt die folgenden Ausgaben zurück:

Ausgabetyp der Aktion Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle „Fall-Repository“ Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
JSON-Ergebnis

Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion Resolve Issue (Problem beheben) empfangen wird:

{
    "id": "0db2222f-7d1f-501a-9ad5-fe669c7da036",
    "resolutionNote": "",
    "status": "RESOLVED",
    "dueAt": null,
    "resolutionReason": "NOT_MALICIOUS_THREAT"
}
Ausgabenachrichten

Die Aktion Resolve Issue (Problem beheben) kann die folgenden Ausgabenachrichten zurückgeben:

Ausgabemeldung Nachrichtenbeschreibung

Successfully resolved issue with ID ISSUE_ID in Wiz.

Die Aktion wurde erfolgreich ausgeführt.
Error executing action "Resolve Issue". Reason: ERROR_REASON

Die Aktion ist fehlgeschlagen.

Überprüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Problem beheben verwendet wird:

Name des Scriptergebnisses Wert
is_success True oder False

Kommentar zum Problem hinzufügen

Mit der Aktion Add Comment To Issue (Kommentar zum Problem hinzufügen) können Sie einem bestimmten Problem in Wiz einen Kommentar hinzufügen.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion Add Comment To Issue sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Issue ID

Erforderlich.

Die eindeutige Kennung des Problems in Wiz.

Comment

Erforderlich.

Der Text des Kommentars, der dem Problem hinzugefügt werden soll.

Aktionsausgaben

Die Aktion Add Comment To Issue (Kommentar zum Problem hinzufügen) bietet die folgenden Ausgaben:

Ausgabetyp der Aktion Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle „Fall-Repository“ Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
JSON-Ergebnis

Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion Add Comment To Issue (Kommentar zum Problem hinzufügen) empfangen wird:

{
  "createdAt": "2025-08-01T11:59:00.843434941Z", "id":
  "6f997da2-85a0-4be2-b205-83ea19e9b17a", "text": "testing"
}
Ausgabenachrichten

Die Aktion Add Comment To Issue (Kommentar zum Problem hinzufügen) kann die folgenden Ausgabemeldungen zurückgeben:

Ausgabemeldung Nachrichtenbeschreibung

Successfully added a comment to the issue with ID ISSUE_ID in Wiz.

Die Aktion wurde erfolgreich ausgeführt.
Error executing action "Add Comment To Issue". Reason: ERROR_REASON

Die Aktion ist fehlgeschlagen.

Überprüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Add Comment To Issue verwendet wird:

Name des Scriptergebnisses Wert
is_success True oder False

Blue Agent-Analyse abrufen

Mit der Aktion Get Blue Agent Analysis (Blue Agent-Analyse abrufen) können Sie Analysedetails vom Wiz Blue Agent für eine bestimmte Bedrohung abrufen.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion Get Blue Agent Analysis sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Threat ID

Erforderlich.

Die eindeutige Kennung der Wiz-Bedrohungs-ID.

Aktionsausgaben

Die Aktion Get Blue Agent Analysis (Blue Agent-Analyse abrufen) gibt die folgenden Ausgaben zurück:

Ausgabetyp der Aktion Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle „Fall-Repository“ Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
JSON-Ergebnis

Im folgenden Beispiel sehen Sie die JSON-Ergebnisausgabe, die bei Verwendung der Aktion Get Blue Agent Analysis (Blue-Agent-Analyse abrufen) empfangen wird:

{
  "id": "threat-12345",
  "threatType": "MALWARE_DETECTION",
  "status": "COMPLETED",
  "analysis": {
    "summary": "Blue Agent analysis details",
    "riskScore": "HIGH"
  }
}
Ausgabenachrichten

Die Aktion Get Blue Agent Analysis kann die folgenden Ausgabenachrichten zurückgeben:

Ausgabemeldung Nachrichtenbeschreibung

Successfully retrieved blue agent analysis for threat ID THREAT_ID in Wiz.

Die Aktion wurde erfolgreich ausgeführt.
Error executing action "Get Blue Agent Analysis". Reason: ERROR_REASON

Die Aktion ist fehlgeschlagen.

Überprüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Get Blue Agent Analysis verwendet wird:

Name des Scriptergebnisses Wert
is_success True oder False

Jobs

Weitere Informationen zu Jobs finden Sie unter Neuen Job konfigurieren und Erweiterte Planung.

Bidirektionaler Synchronisierungsauftrag für Wiz und Google SecOps

Mit dem Wiz and Google SecOps Bi-directional Sync Job (Bidirektionaler Synchronisierungsjob zwischen Wiz und Google SecOps) können Sie eine kontinuierliche Synchronisierung zwischen Wiz-Bedrohungen und Google SecOps-Vorgängen aufrechterhalten.

Jobparameter

Für den bidirektionalen Synchronisierungsjob für Wiz und Google SecOps sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Environment Name

Erforderlich.

Name der Umgebung, in der Fälle synchronisiert werden sollen.

Der Standardwert ist Default Environment.

Wiz API Root

Erforderlich.

Der Wiz GraphQL API-Endpunkt für Ihren Mandanten.

Der Endpunkt muss dem Format https://api.<region>.app.wiz.io/graphql (oder https://api.<region>.app.wiz.us/graphql für Wiz for Gov) entsprechen, wobei <region> die zugewiesene Wiz-Rechenzentrumsregion (z. B. us1, us2, eu1 oder eu2) darstellt.

Die genaue Endpunkt-URL finden Sie in den Details Ihres Wiz-Tenants. Verwenden Sie keine generischen, nicht nummerierten regionalen URLs.

Der Standardwert für den Platzhalter ist https://api.<region>.app.wiz.io/graphql. Ersetzen Sie <region> durch die Ihnen zugewiesene Wiz-Rechenzentrumsregion.

Wiz Authentication URL

Optional.

Die Authentifizierungs-URL, die zum Generieren von OAuth-Zugriffstokens verwendet wird. Verwenden Sie für kommerzielle Umgebungen https://auth.app.wiz.io. Verwenden Sie für Wiz for Gov (FedRAMP)-Umgebungen https://auth.app.wiz.us.

Der Standardwert ist https://auth.app.wiz.io.

Wiz Client ID

Erforderlich.

Client-ID für das Wiz API-Dienstkonto.

Wiz Client Secret

Erforderlich.

Clientschlüssel für das Wiz API-Dienstkonto.

Max Hours Backwards

Optional.

Anzahl der Stunden vor der ersten Jobiteration, ab der aktualisierte Fälle abgerufen werden sollen (Bereich: 1 bis 720, Standard: 24). Dieser Parameter gilt für den ersten Joblauf oder als Fallback, wenn der Zeitstempel des letzten Laufs zurückgesetzt wird.

Verify SSL

Erforderlich.

Wenn diese Option ausgewählt ist, wird das SSL-Zertifikat bei der Verbindung zum Wiz-Server validiert.

Standardmäßig ausgewählt.

Fields to sync

Erforderlich.

Eine durch Kommas getrennte Liste von Elementen, die festlegen, welche Felder synchronisiert werden sollen. Es werden nur die hier explizit aufgeführten Felder synchronisiert. Mögliche Werte: Status, Comments, Product Link, Severity.

Der Standardwert ist Status, Comments, Product Link, Severity.

Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten